feat(web): 任务详情页下载交付文件；PM2 增加本地前端进程；本地试运行说明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

feat(web): 任务详情页下载交付文件；PM2 增加本地前端进程；本地试运行说明
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
yibo
1 parent 629459d7
Showing 5 changed files with 89 additions and 3 deletions
apps/voko-web/src/api.js
apps/voko-web/src/i18n/messages.js
apps/voko-web/src/pages/TaskPage.vue
docs/local-development.md
ecosystem.config.cjs
@@ -46,3 +46,20 @@ export async function api(method, path, body, idempotencyKey) {
   if (!response.ok) throw new Error(json.error.message)
   return json
 }
+
+/**
+ * 带登录态下载一个文件并交给浏览器保存（交付文件需要鉴权，不能直接用链接）。
+ * @param {string} path
+ * @param {string} filename
+ */
+export async function download(path, filename) {
+  const token = getToken()
+  const response = await fetch(path, { headers: token === null ? {} : { authorization: `Bearer ${token}` } })
+  if (!response.ok) throw new Error((await response.json()).error.message)
+  const url = URL.createObjectURL(await response.blob())
+  const link = document.createElement('a')
+  link.href = url
+  link.download = filename
+  link.click()
+  URL.revokeObjectURL(url)
+}
@@ -108,6 +108,8 @@ export const messages = {
       noSubmissions: 'Nothing visible yet. Submissions are shown to the publisher and the submitter; contest entries stay sealed until the deadline.',
       comments: 'Comments',
       round: 'Round {round}',
+      download: 'Download',
+      downloadFile: 'Download {filename}',
       none: 'None yet.',
     },
     world: {
@@ -290,6 +292,8 @@ export const messages = {
       noSubmissions: '暂无可见的交付。交付只对发布方和提交者本人可见；擂台赛的提交在截止前封存。',
       comments: '评论',
       round: '第 {round} 轮',
+      download: '下载',
+      downloadFile: '下载 {filename}',
       none: '暂无。',
     },
     world: {
@@ -2,9 +2,9 @@
 import { onMounted, ref } from 'vue'
 import { useI18n } from 'vue-i18n'
 import { useRoute, useRouter } from 'vue-router'
-import { Badge, Card } from '@drama/ui'
+import { Badge, Button, Card } from '@drama/ui'
  
-import { api, getToken } from '../api.js'
+import { api, download, getToken } from '../api.js'
  
 const { t } = useI18n()
 const route = useRoute()
@@ -14,6 +14,19 @@ const error = ref(&#39;&#39;)
  
 const when = (/** @type {string} */ iso) => new Date(iso).toLocaleString()
  
+/** @param {{ file_id: string, filename: string }} artifact */
+async function save(artifact) {
+  error.value = ''
+  try {
+    await download(`/api/voko/agents/${route.params.id}/files/${artifact.file_id}`, artifact.filename)
+  } catch (err) {
+    error.value = err instanceof Error ? err.message : String(err)
+  }
+}
+
+/** @param {number} bytes */
+const size = (bytes) => (bytes < 1024 ? `${bytes} B` : bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(1)} MB`)
+
 onMounted(async () => {
   if (getToken() === null) {
     await router.push({ path: '/login', query: { next: route.fullPath } })
@@ -49,7 +62,15 @@ onMounted(async () =&gt; {
       <div v-for="item in detail.submissions" :key="item.id">
         <p>{{ t('task.round', { round: item.round }) }} · {{ when(item.created_at) }}</p>
         <p class="voko-pre">{{ item.summary }}</p>
-        <ul><li v-for="artifact in item.artifacts" :key="artifact.url"><a :href="artifact.url" rel="noopener noreferrer" target="_blank">{{ artifact.note || artifact.url }}</a></li></ul>
+        <ul class="voko-artifacts">
+          <li v-for="artifact in item.artifacts" :key="artifact.file_id || artifact.url">
+            <template v-if="artifact.type === 'file'">
+              <span>{{ artifact.filename }} · {{ size(artifact.size_bytes) }}<template v-if="artifact.note"> · {{ artifact.note }}</template></span>
+              <Button variant="secondary" size="sm" :aria-label="t('task.downloadFile', { filename: artifact.filename })" @click="save(artifact)">{{ t('task.download') }}</Button>
+            </template>
+            <a v-else :href="artifact.url" rel="noopener noreferrer" target="_blank">{{ artifact.note || artifact.url }}</a>
+          </li>
+        </ul>
       </div>
     </Card>
     <Card class="voko-section">
@@ -67,4 +88,14 @@ onMounted(async () =&gt; {
 .voko-pre {
   white-space: pre-wrap;
 }
+.voko-artifacts {
+  padding-left: var(--drama-space-md);
+}
+.voko-artifacts li {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--drama-space-sm);
+  margin-bottom: var(--drama-space-sm);
+}
 </style>
@@ -28,3 +28,29 @@ pnpm --filter @voko/server worker                        # 需要时
 ## 本地管理员
  
 `pnpm dev:user <邮箱> <密码> [显示名] [admin|operator|user]` 对同邮箱 upsert，并重置密码与角色。只能用于本地开发库，禁止用于共享库。已在网页注册的账号可用 `pnpm --filter @voko/server admin:grant <邮箱>` 提升为管理员。
+
+## 本地试运行（PM2 常驻）
+
+```bash
+pm2 start ecosystem.config.cjs      # voko-server（9201）、voko-worker、voko-web（5201，开发服务器）
+pm2 restart voko-server voko-worker # 改了服务端代码之后
+pm2 logs voko-server                # 看日志
+pm2 stop voko-server voko-worker voko-web
+```
+
+| 端 | 地址 |
+| --- | --- |
+| 小镇首页（不登录可看） | http://localhost:5201/ |
+| 员工端「我的 Agent」 | http://localhost:5201/agents |
+| 运营后台 | http://localhost:5201/admin |
+| 公开 API | http://localhost:9201/v1 |
+| 给外部 Agent 的说明文件 | http://localhost:9201/skill.md 、/heartbeat.md 、/skill.json |
+
+本地测试账号（只存在于本地库，用 `pnpm dev:user` 创建，可重复执行）：
+
+```bash
+pnpm dev:user admin@example.test admin123                       # 运营 + 公会负责人
+pnpm dev:user owner@example.test owner123 "Test Owner" user     # 普通主人
+```
+
+新建的普通账号还要提交加入申请并由运营在后台通过，才能认领 Agent。
@@ -32,5 +32,13 @@ module.exports = {
       script: './src/voko-worker-main.js',
       interpreter: 'node',
     },
+    {
+      // 本地试运行用的前端开发服务器（/api 代理到 voko-server）。正式部署是 `vite build` 后的静态托管，不走这个进程。
+      ...processDefaults,
+      name: 'voko-web',
+      cwd: path.join(repoRoot, 'apps', 'voko-web'),
+      script: './node_modules/vite/bin/vite.js',
+      interpreter: 'node',
+    },
   ],
 }