From ee43e5df42540d9d17b7a9223ddac45c641a89d6 Mon Sep 17 00:00:00 2001 From: qyh15 Date: Tue, 10 Nov 2026 11:43:01 +0800 Subject: [PATCH] =?UTF-8?q?feat(workbench):=20=E8=A1=A5=20POST=20/artifact?= =?UTF-8?q?=EF=BC=8C=E6=88=90=E6=9E=9C=E5=8F=AF=E4=BB=A5=E4=B8=8D=E7=BB=8F?= =?UTF-8?q?=E5=A5=91=E7=BA=A6=E8=A1=8C=E7=9B=B4=E6=8E=A5=E7=99=BB=E8=AE=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 路由 12 → 13;带 revisesArtifactId 时版本号自动 +1,跨项目引用仍 CROSS_PROJECT - 新增路由测试:首版 revision=1、未注入 fileExists 时 existence 如实为 unknown、修订版 revision=2 - 契约文档补两张接口表行;218/218 --- docs/v0.1-接线与契约.md | 4 +++- workbench/host/routes.mjs | 15 ++++++++++++ workbench/test/assembly.test.mjs | 2 +- workbench/test/routes.test.mjs | 40 ++++++++++++++++++++++++++++---- 4 files changed, 55 insertions(+), 6 deletions(-) diff --git a/docs/v0.1-接线与契约.md b/docs/v0.1-接线与契约.md index 7caff3d..b77ff20 100644 --- a/docs/v0.1-接线与契约.md +++ b/docs/v0.1-接线与契约.md @@ -81,6 +81,8 @@ workbench/panel/… 浏览器端(右栏部门树 + 任务/成 | POST | `/dispatch` | `projectId`, `taskId`, `idempotencyKey`, `sourceRoleId?`, `targetRoleId`, `targetSessionId?`, `bindingGeneration?`, `packet?`, `sourceSessionId?`, `mode?`, `roleName?` | 派发任务单;有会话层时真投递,没有就只落账 `prepared`(UI 必须显示尚未接通) | | POST | `/ingest` | `projectId`, `roleId`, `text` | 解析 Agent 输出里的契约行并落账(四动作) | | POST | `/result` | `projectId`, `taskId`, `attemptId?`, `report?`, `runTerminal?`, `artifactRefs?`, `checks?`, `remainingItems?`, `blockedReason?`, `sourceMessageRef?`, `reportVersion?` | 登记结构化报告 / 运行终态;重复登记按 `attemptId+reportVersion` 与 `sourceMessageRef` 去重 | +| POST | `/artifact` | `projectId`, `taskId`, `displayName`, `mediaType?`, `fileRef?`, `versionOrHash?`, `verification?`, `sourceResultId?`, `revisesArtifactId?` | 直接登记成果(契约行 `registerArtifact` 之外的入口);带 `revisesArtifactId` 时版本号自动 +1 | +| POST | `/artifact/revision` | `projectId`, `artifactId`, `instruction`, `ownerRoleId?`, `status?` | 找主责部门改一份成果:只开一条修订任务,不重跑全链 | | GET | `/events` | `?projectId=&since=` | 长轮询(默认 25s,内部 1s 轮询账本)增量事件;`since` 之后的才算新 | 错误码:`INVALID_INPUT` / `INVALID_ROLE` / `NOT_FOUND` / `CROSS_PROJECT` / @@ -178,7 +180,7 @@ import { createWorkbenchHost } from './workbench/host/index.mjs' | 依赖 | 当场没有时 | 补挂方式 | 补挂后 | |---|---|---|---| -| `webServer` | 路由不注册,`warnings` 记一条 | `ctx.inject(['webServer'], …)` 再注册一次 | 12 条接口可用 | +| `webServer` | 路由不注册,`warnings` 记一条 | `ctx.inject(['webServer'], …)` 再注册一次 | 13 条接口可用 | | `sessionController` | 会话层为空,`hasSessions=false`,派发只落账 | `ctx.inject(['sessionController'], …)` → `shell.attachSessions(controller)` | 可以接通部门、真投递 | 两条补挂都**只做一次且幂等**:已经挂上就不再换(`attachSessions` 第二次调用返回 `true` diff --git a/workbench/host/routes.mjs b/workbench/host/routes.mjs index 4e40aec..0541e94 100644 --- a/workbench/host/routes.mjs +++ b/workbench/host/routes.mjs @@ -346,6 +346,21 @@ export function buildRouteTable(service, options = {}) { returnTarget: body.returnTarget, }), }, + [`${ROUTE_PREFIX}/artifact`]: { + method: 'POST', + handler: async ({ body }) => service.registerArtifact({ + projectId: select(body), + taskId: body.taskId, + ownerRoleId: body.ownerRoleId, + fileRef: body.fileRef, + displayName: body.displayName, + mediaType: body.mediaType, + versionOrHash: body.versionOrHash, + verification: body.verification, + sourceResultId: body.sourceResultId, + revisesArtifactId: body.revisesArtifactId, + }), + }, [`${ROUTE_PREFIX}/events`]: { method: 'GET', handler: async ({ query, req, res }) => { diff --git a/workbench/test/assembly.test.mjs b/workbench/test/assembly.test.mjs index 76e80db..8069494 100644 --- a/workbench/test/assembly.test.mjs +++ b/workbench/test/assembly.test.mjs @@ -129,7 +129,7 @@ test('装配层:宿主先有 webServer、后有 sessionController 时,派发 const host = createWorkbenchHost(ctx, { store, startReconciler: false }) assert.equal(host.store, store) assert.equal(host.registered, true) - assert.equal(webServer.routes.size, 12) + assert.equal(webServer.routes.size, 13) assert.equal(host.hasSessions, false) const project = host.service.registerProject({ hostWorkspaceId: WS }).project diff --git a/workbench/test/routes.test.mjs b/workbench/test/routes.test.mjs index 34d3bf0..743f423 100644 --- a/workbench/test/routes.test.mjs +++ b/workbench/test/routes.test.mjs @@ -106,10 +106,11 @@ function seedService(service) { // ---------- 注册与降级 ---------- -test('注册:十二条 exact 路由,dispose 幂等且能全部卸载', () => { +test('注册:十三条 exact 路由,dispose 幂等且能全部卸载', () => { const { service } = makeService() const { registered, disposed, dispose } = mount(service) assert.deepEqual([...registered.keys()].sort(), [ + `${ROUTE_PREFIX}/artifact`, `${ROUTE_PREFIX}/artifact/revision`, `${ROUTE_PREFIX}/bind`, `${ROUTE_PREFIX}/bootstrap`, @@ -124,10 +125,10 @@ test('注册:十二条 exact 路由,dispose 幂等且能全部卸载', () => `${ROUTE_PREFIX}/task/cancel`, ]) assert.equal(dispose.registered, true) - assert.equal(dispose.paths.length, 12) + assert.equal(dispose.paths.length, 13) dispose() dispose() - assert.equal(disposed.length, 12, '十二条路由各卸载一次,重复调用不再卸载') + assert.equal(disposed.length, 13, '十三条路由各卸载一次,重复调用不再卸载') }) test('注册:宿主没有 webServer 时降级为 no-op,不抛', () => { @@ -161,7 +162,7 @@ test('注册:中途失败会回滚已注册的路由', () => { test('listWorkbenchRoutes 列出端点与方法', () => { const rows = listWorkbenchRoutes() - assert.equal(rows.length, 12) + assert.equal(rows.length, 13) assert.deepEqual(rows.find((row) => row.path.endsWith('/bootstrap')), { path: `${ROUTE_PREFIX}/bootstrap`, method: 'GET', @@ -414,6 +415,37 @@ test('project / bind / config / task 四个 POST 串起来走通', async () => { assert.equal(task.json.value.task.status, 'queued') }) +test('artifact:直接登记成果并按修订链累加版本', async () => { + const { service } = makeService() + const { call } = mount(service) + const { a } = seedService(service) + const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task + + const first = await call('POST', `${ROUTE_PREFIX}/artifact`, { + projectId: a.id, + taskId: task.id, + displayName: '预算表.xlsx', + mediaType: 'application/vnd.ms-excel', + fileRef: 'C:/tmp/预算表.xlsx', + verification: { status: 'verified' }, + }) + assert.equal(first.statusCode, 200) + assert.equal(first.json.value.artifact.displayName, '预算表.xlsx') + assert.equal(first.json.value.artifact.revision, 1) + // 没注入 fileExists 时不猜文件在不在,如实说未知。 + assert.equal(first.json.value.artifact.existence, 'unknown') + + const second = await call('POST', `${ROUTE_PREFIX}/artifact`, { + projectId: a.id, + taskId: task.id, + displayName: '预算表(改).xlsx', + revisesArtifactId: first.json.value.artifact.id, + }) + assert.equal(second.statusCode, 200) + assert.equal(second.json.value.artifact.revision, 2) + assert.equal(second.json.value.artifact.revisesArtifactId, first.json.value.artifact.id) +}) + test('dispatch / result / task/cancel 走通并返回去重信息', async () => { const { service } = makeService() const { call } = mount(service)