Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .claude/skills/verify-openminutes/features/categories.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
- `cat-list`:「全部分类」卡片列出内置分类(会议纪要、客户访谈、灵感想法、待办事项、课程学习、私人生活、未分类)和自定义分类,每行显示录音条数。内置分类的行显示「内置」,没有删除按钮。
- `cat-create`:「新增分类」卡片填写名称(最多 12 字)、选择颜色、填写说明,点「创建分类」后提示「分类已创建」。名称为空时按钮不可点。
- `cat-rename`:在「<名称> 的名称」输入框里改名,失焦后保存,提示「分类已更新」。
- `cat-recolor`:「<名称> 的颜色」取色器,修改后提示「分类已更新」。
- `cat-recolor`:「<名称> 的颜色」取色器,修改后列表重新加载;当前实现不显示单独的更新 toast。
- `cat-delete`:自定义分类行的「删除」会弹出确认框,确认后提示「分类已删除」。
- `cat-in-detail`:新建的分类会出现在详情页「整理」栏的分类下拉框,以及录音库的「按分类筛选」里。

Expand All @@ -24,8 +24,9 @@ Preconditions:
- **列表与内置项。** 运行 `browse.mjs <runId> 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/<system-id>"`。预期返回 `ok:false`,错误码为 `SYSTEM_CATEGORY`。

## Gotchas

Expand Down
4 changes: 2 additions & 2 deletions .claude/skills/verify-openminutes/features/diagnostics.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 设置 › 诊断与高级

唯一的技术细节区。默认折叠,从 `#/settings/diagnostics` 进入时自动展开。依次包含本机环境、运行时路径、传输方式(自动 / 始终无线快传 / 始终蓝牙)、最近设备操作、宿主能力、设备协议指令参考(开发者)、开发者工具和「复制诊断报告」。
唯一的技术细节区。默认折叠,从 `#/settings/diagnostics` 进入时自动展开。依次包含本机环境、运行时路径、转录任务、传输方式(自动 / 始终无线快传 / 始终蓝牙)、最近设备操作、宿主能力、设备协议指令参考(开发者)、开发者工具和「复制诊断报告」。

## Sub-features

Expand All @@ -16,7 +16,7 @@
Preconditions:满足基线条件,普通启动,doctor 的 exit 为 0。

- 运行 `browse.mjs <runId> diagnostics @.claude/skills/verify-openminutes/features/diagnostics.steps.json`。
- 预期两个读回 `eval` 分别返回 `"auto"` 和 `setting: "ble"` 的传输信息,`console.log` 为空。
- 预期页面包含「转录任务」以及其它分区;两个读回 `eval` 分别返回 `"auto"` 和 `setting: "ble"` 的传输信息,`console.log` 为空。

## Gotchas

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 <runId> 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 <runId> library-batch-all @.claude/skills/verify-openminutes/features/library-batch-all.steps.json`(不点按钮,不发起转录)。

## How to get to it (user POV)

Expand Down
2 changes: 1 addition & 1 deletion .claude/skills/verify-openminutes/features/scenes-today.md
Original file line number Diff line number Diff line change
@@ -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:空状态与日期切换

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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-<id>.json`。

Expand Down
1 change: 1 addition & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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。
5 changes: 3 additions & 2 deletions src/server/device/service.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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<true>((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();
Expand Down
3 changes: 1 addition & 2 deletions src/server/device/sync.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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);
Expand Down
1 change: 0 additions & 1 deletion src/server/device/worker.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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 });
});
Expand Down
2 changes: 1 addition & 1 deletion src/server/network-gate.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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 });
Expand Down
8 changes: 8 additions & 0 deletions tests/repair-recovery.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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();
Expand All @@ -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 {
Expand Down