diff --git a/.claude/skills/verify-openminutes/features/categories.md b/.claude/skills/verify-openminutes/features/categories.md index f5e6139..cda7fc3 100644 --- a/.claude/skills/verify-openminutes/features/categories.md +++ b/.claude/skills/verify-openminutes/features/categories.md @@ -7,7 +7,7 @@ - `cat-list`:「全部分类」卡片列出内置分类(会议纪要、客户访谈、灵感想法、待办事项、课程学习、私人生活、未分类)和自定义分类,每行显示录音条数。内置分类的行显示「内置」,没有删除按钮。 - `cat-create`:「新增分类」卡片填写名称(最多 12 字)、选择颜色、填写说明,点「创建分类」后提示「分类已创建」。名称为空时按钮不可点。 - `cat-rename`:在「<名称> 的名称」输入框里改名,失焦后保存,提示「分类已更新」。 -- `cat-recolor`:「<名称> 的颜色」取色器,修改后提示「分类已更新」。 +- `cat-recolor`:「<名称> 的颜色」取色器,修改后列表重新加载;当前实现不显示单独的更新 toast。 - `cat-delete`:自定义分类行的「删除」会弹出确认框,确认后提示「分类已删除」。 - `cat-in-detail`:新建的分类会出现在详情页「整理」栏的分类下拉框,以及录音库的「按分类筛选」里。 @@ -24,8 +24,9 @@ Preconditions: - **列表与内置项。** 运行 `browse.mjs cat '[{"goto":"#/categories"},{"waitText":"全部分类"},{"waitFor":"aria=会议纪要 的名称"},{"expectText":"内置"},{"screenshot":"01-list.png"},{"aria":"01-list.aria.txt"}]'`。 - **新建。** 在同一次调用里追加 `{"fill":"input[placeholder=\"例如:产品评审\"]","value":"验证分类"},{"fill":"input[placeholder=\"这类录音通常在什么场景下产生\"]","value":"verify run"},{"click":"text=创建分类"},{"waitText":"分类已创建"},{"waitFor":"aria=验证分类 的名称"},{"screenshot":"02-created.png"}`。读回验证:`curl -s "$URL/api/categories" | tee $E/cat/after-create.json` 中应包含「验证分类」,并且 `isSystem` 为 false。 - **改名。** 追加 `{"fill":"aria=验证分类 的名称","value":"验证分类2"},{"press":"Tab"},{"waitText":"分类已更新"}`。读回验证:接口返回的名称应为「验证分类2」。 +- **改色。** 改色后不要等待「分类已更新」toast;重新读取列表并核对该分类的颜色值。 - **删除。** 追加 `{"goto":"#/categories"},{"waitFor":"aria=验证分类2 的名称"},{"eval":"(() => { const row = document.querySelector('[aria-label=\"验证分类2 的名称\"]').closest('li'); row.querySelector('button').click(); return true; })()"},{"waitText":"分类已删除"},{"screenshot":"03-deleted.png"}`。`steps.log` 里应记录 `dialog confirm: 删除分类「验证分类2」?… -> accepted`,之后接口里不应再有这个分类。 -- **内置不可删(接口)。** 运行 `curl -s -X DELETE "$URL/api/categories/1"`。预期返回 `ok:false`,错误码为 `SYSTEM_CATEGORY`。 +- **内置不可删(接口)。** 先读取 `/api/categories`,选择 `isSystem:true` 的分类 id,再运行 `curl -s -X DELETE "$URL/api/categories/"`。预期返回 `ok:false`,错误码为 `SYSTEM_CATEGORY`。 ## Gotchas diff --git a/.claude/skills/verify-openminutes/features/diagnostics.md b/.claude/skills/verify-openminutes/features/diagnostics.md index 4065e2a..2dd07cc 100644 --- a/.claude/skills/verify-openminutes/features/diagnostics.md +++ b/.claude/skills/verify-openminutes/features/diagnostics.md @@ -1,6 +1,6 @@ # 设置 › 诊断与高级 -唯一的技术细节区。默认折叠,从 `#/settings/diagnostics` 进入时自动展开。依次包含本机环境、运行时路径、传输方式(自动 / 始终无线快传 / 始终蓝牙)、最近设备操作、宿主能力、设备协议指令参考(开发者)、开发者工具和「复制诊断报告」。 +唯一的技术细节区。默认折叠,从 `#/settings/diagnostics` 进入时自动展开。依次包含本机环境、运行时路径、转录任务、传输方式(自动 / 始终无线快传 / 始终蓝牙)、最近设备操作、宿主能力、设备协议指令参考(开发者)、开发者工具和「复制诊断报告」。 ## Sub-features @@ -16,7 +16,7 @@ Preconditions:满足基线条件,普通启动,doctor 的 exit 为 0。 - 运行 `browse.mjs diagnostics @.claude/skills/verify-openminutes/features/diagnostics.steps.json`。 -- 预期两个读回 `eval` 分别返回 `"auto"` 和 `setting: "ble"` 的传输信息,`console.log` 为空。 +- 预期页面包含「转录任务」以及其它分区;两个读回 `eval` 分别返回 `"auto"` 和 `setting: "ble"` 的传输信息,`console.log` 为空。 ## Gotchas diff --git a/.claude/skills/verify-openminutes/features/library-search.md b/.claude/skills/verify-openminutes/features/library-search.md index 216cb95..e076523 100644 --- a/.claude/skills/verify-openminutes/features/library-search.md +++ b/.claude/skills/verify-openminutes/features/library-search.md @@ -11,7 +11,7 @@ - `library-sort`:「排序方式」可选最近入库、录音时间、时长最长、重要度高。 - `library-auto-refresh`:有排队或进行中的任务时(`/api/recordings` 返回 `hasActiveTasks: true`),列表会自动刷新到终态,然后停止轮询。配方见 [转录与归类](./transcribe-organize.md) 的「批量转录自动刷新」。 - `library-empty`:实例里一条录音都没有时,显示「还没有录音」。 -- `library-batch-all`:只有「待转录」或「待归类」阶段是唯一筛选条件时,才出现「全部转录(N)」/「全部归类(N)」。N 取 `/api/overview` 的同口径阶段计数(不含已归档)。加了搜索、分类或标签后,按钮隐藏,因为服务端只按阶段选录音。配方:`--no-host` 启动,收件目录放一个 MP3,运行 `browse.mjs library-batch-all @.claude/skills/verify-openminutes/features/library-batch-all.steps.json`(不点按钮,不发起转录)。 +- `library-batch-all`:只有「待转录」或「待归类」阶段是唯一筛选条件时,才出现「全部转录(N)」/「全部归类(N)」;N 取 `/api/overview` 的同口径阶段计数,但最多显示和处理 400 条。加了搜索、分类或标签后,按钮隐藏,因为服务端只按阶段选录音。配方:`--no-host` 启动,收件目录放一个 MP3,运行 `browse.mjs library-batch-all @.claude/skills/verify-openminutes/features/library-batch-all.steps.json`(不点按钮,不发起转录)。 ## How to get to it (user POV) diff --git a/.claude/skills/verify-openminutes/features/scenes-today.md b/.claude/skills/verify-openminutes/features/scenes-today.md index 517ab7e..bb366a2 100644 --- a/.claude/skills/verify-openminutes/features/scenes-today.md +++ b/.claude/skills/verify-openminutes/features/scenes-today.md @@ -1,6 +1,6 @@ # 今日:场景时间线(拾贝 & 串珠 P1) -「今日」页(`#/today?day=YYYY-MM-DD`)把一天里所有录音的转录排成一条时间线:拾贝切场景、匹配模板,串珠按模板字段抽取。录音转录成功后,服务端自动排队整理录音所在的那一天(`scene_bots_enabled`,默认 `1`,launch 不改它);页头「整理这一天 / 重新整理」手动重跑。只读,没有收件箱。 +「今日」页(`#/today?day=YYYY-MM-DD`)把一天里所有录音的转录排成一条时间线:拾贝切场景、匹配模板,串珠按模板字段抽取。录音转录成功后,服务端自动排队整理录音所在的那一天(`scene_bots_enabled`,默认 `1`,launch 不改它);页头「整理这一天 / 重新整理」手动重跑。场景结果本身只读,但支持手动触发整理;页面没有收件箱。 ## 无 Host:空状态与日期切换 diff --git a/.claude/skills/verify-openminutes/features/transcribe-success.md b/.claude/skills/verify-openminutes/features/transcribe-success.md index 0d5c620..8b5c7ea 100644 --- a/.claude/skills/verify-openminutes/features/transcribe-success.md +++ b/.claude/skills/verify-openminutes/features/transcribe-success.md @@ -95,9 +95,9 @@ node "$S/make-voice.mjs" --output "$R/inbox/REC20261029_150200.mp3" node "$S/browse.mjs" voice-success-20261029 batch-success "@$F/batch-success.steps.json" ``` -每条命令成功后才执行下一条。脚本扫描新增两条,进入录音库精确勾选这两个文件(不全选已有成功录音),点击「批量转录」,等待「已排队 2 条转录任务」。它不刷新页面、不重新导航,按 `.table__body .row .col-status` 等待两行自动变为「待归类」,而非等待工具栏始终存在的文字。 +每条命令成功后才执行下一条。脚本扫描新增两条,进入录音库精确勾选这两个文件(不全选已有成功录音),点击「批量转录」,等待当前界面提示「已开始转录 2」。它不刷新页面、不重新导航,按 `.table__body .row .col-status` 等待两行自动变为「待归类」,而非等待工具栏始终存在的文字。 -转录完成后重新勾选这两行,点击「批量归类」,等「已排队 2 条归类任务」,仍在同一页面等三行都成为「已整理」。每阶段最多等 120 秒。`01-selected`、`02-transcribe-accepted`、`03-transcribed`、`04-organize-accepted`、`05-organized` 各保留 PNG/ARIA。 +转录完成后重新勾选这两行,点击「批量归类」,等「已开始归类 2」并仍在同一页面等三行都成为「已整理」。每阶段最多等 120 秒。`01-selected`、`02-transcribe-accepted`、`03-transcribed`、`04-organize-accepted`、`05-organized` 各保留 PNG/ARIA。 读回 `/api/recordings`,两阶段终态都要求 `hasActiveTasks=false`;分别 GET 两个新 id,转录后要求 `status=transcribed`、`transcriptChars>0`、全文含「评审」、`segments` 非空、转录 job 成功。归类后要求 `status=organized` 及第 3 节字段表的完整断言。脚本保留列表与详情响应于 `steps.log`,人工再按表核对模型语义、分类 slug 和字段一致性,并保存各 id 的 `detail-.json`。 diff --git a/AGENTS.md b/AGENTS.md index 0457dbb..f0b47d8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -88,3 +88,4 @@ - 不要对仓库外的上级目录递归 grep(例如 `grep -rln ... ../../../`):会扫到整个用户目录,命令超时转后台,连 TaskStop 都卡住。查宿主 SDK 直接去 `C:/Program Files/Floatboat/resources/workbench-sdk/`(本机 `AppData/Local/Programs/Floatboat` 下没有 resources);Host 实现在 `app.asar` 里,用 `rg -a` 搜。 - `pnpm test`(node:test)的汇总行是 `ℹ tests N` / `ℹ fail N`,不是 TAP 的 `# tests`;用 `grep '^# fail'` 过滤会得到空输出,被误读成没跑。先把输出存到 `.workbench/*.log`,看退出码,再 grep `^ℹ`。 - 多个 agent 同时改同一个工作区时,`build.mjs` 可能读到别人改了一半的文件而报 `No matching export`,doctor 也会报 `dist/ is older than src/`。先确认报错文件是不是自己改的,不是就等对方完成后重跑,不要去改别人的文件。 +- 如果一个 await 只能靠某个定时器结束(超时、看门狗、强杀兜底),这个定时器不能 `unref()`,结束后要 `clearTimeout`。Node 22 的 node:test 发现事件循环只剩 unref 的定时器时,会把挂起的用例判成 `cancelledByParent`(`Promise resolution is still pending but the event loop has already resolved`),同一文件后面的用例也会全部取消。Node 24 上不会出现,所以只有 Node 22 的 CI 任务失败(2026-11-11,PR #15)。只有纯后台定时器(空闲断开、轮询)才 unref。 diff --git a/src/server/device/service.ts b/src/server/device/service.ts index 461e229..f8da5d2 100644 --- a/src/server/device/service.ts +++ b/src/server/device/service.ts @@ -667,13 +667,14 @@ export class DeviceService { this.abort?.abort(); this.worker?.cancel(); const timeout = options.timeoutMs ?? (activity.transport === 'wifi' ? HOTSPOT_CANCEL_WAIT_MS : BLE_CANCEL_WAIT_MS); + let timer: NodeJS.Timeout | undefined; const timedOut = await Promise.race([ this.activityDone.then(() => false), new Promise((resolve) => { - const timer = setTimeout(() => resolve(true), timeout); - timer.unref?.(); + timer = setTimeout(() => resolve(true), timeout); }), ]); + clearTimeout(timer); if (timedOut && !waitingNetwork && this.worker && !this.worker.exited) this.worker.kill(); await this.activityDone.catch(() => undefined); return this.view(); diff --git a/src/server/device/sync.ts b/src/server/device/sync.ts index 3b10d20..05913e8 100644 --- a/src/server/device/sync.ts +++ b/src/server/device/sync.ts @@ -275,9 +275,8 @@ export async function runSync(rt: SyncRuntime, options: { ids?: number[] } = {}) durationMs: Date.now() - started, detail: stalled.detail ?? '' }); rt.cancelWorker?.(); killTimer = setTimeout(() => rt.killWorker?.(), rt.cancelGraceMs?.() ?? 15_000); - killTimer.unref?.(); }, Math.max(10, Math.min(5_000, Math.floor(stallMs / 4)))); - watchdog.unref?.(); + // 看门狗和强杀是卡住的拉取唯一的结束途径,不能 unref;stopWatchdog 负责清理。 const stopWatchdog = () => { clearInterval(watchdog); if (killTimer) clearTimeout(killTimer); diff --git a/src/server/device/worker.ts b/src/server/device/worker.ts index 7266772..29025d2 100644 --- a/src/server/device/worker.ts +++ b/src/server/device/worker.ts @@ -167,7 +167,6 @@ export function attachWorker(child: ChildProcessWithoutNullStreams): WorkerHandl pending.delete(id); reject(new AppError('DEVICE_TIMEOUT', undefined, `worker command ${cmd} exceeded ${options.timeoutMs}ms`)); }, options.timeoutMs); - timer.unref?.(); pending.set(id, { cmd, resolve: resolve as (value: unknown) => void, reject, onEvent: options.onEvent, timer }); send({ id, cmd, args }); }); diff --git a/src/server/network-gate.ts b/src/server/network-gate.ts index 2415626..8233b3f 100644 --- a/src/server/network-gate.ts +++ b/src/server/network-gate.ts @@ -61,8 +61,8 @@ export class NetworkGate { this.idleWaiters = this.idleWaiters.filter((waiter) => waiter !== done); resolve(value); }; + // 不 unref:超时是这个等待的结束途径之一,finish 会清掉它。 const timer = setTimeout(() => finish(false), options.waitForInFlightMs); - timer.unref?.(); const done = () => finish(true); const onAbort = () => finish(false); options.signal?.addEventListener('abort', onAbort, { once: true }); diff --git a/tests/repair-recovery.test.ts b/tests/repair-recovery.test.ts index d9869da..b06cb23 100644 --- a/tests/repair-recovery.test.ts +++ b/tests/repair-recovery.test.ts @@ -104,6 +104,11 @@ test('intent is committed before start; response lost across disposal recovers b assert.equal(input.idempotencyKey, key); return { runId: 'accepted', status: 'running', sessionId: 's', workspaceId: 'w', createdAt: 1, completedAt: null, text: '', errorCode: null }; }; + // 恢复出 runId 后,后续轮询改用 get;不桩它的话 5ms 后状态就变成 unknown,断言能否看到 running 全凭时机。 + host.agent.get = async ({ runId }) => { + assert.equal(runId, 'accepted'); + return { runId, status: 'running', sessionId: 's', workspaceId: 'w', createdAt: 1, completedAt: null, text: '', errorCode: null }; + }; const options = { host, store, workingDirectory: '/app', pollMs: 5, report: async () => report }; const first = createEnvironmentRepair(options); const submitted = first.start(); @@ -115,6 +120,9 @@ test('intent is committed before start; response lost across disposal recovers b await submitted; await second.start(); await waitFor(() => second.get().status === 'running'); + // 再跑几轮轮询,确认恢复后保持 running,而不是一闪而过。 + await new Promise((resolve) => setTimeout(resolve, 50)); + assert.equal(second.get().status, 'running'); assert.equal(starts, 1); assert.ok('runId' in second.get() && store.load().status === 'running'); } finally {