功能规格追踪索引

September 6, 2026 · View on GitHub

基线:工作树 2026-08-18 用途:从验收 ID 定位当前实现、自动化证据和仍需真实验证的部分。

路径缩写:表中的 pages/stores/components/lib/agent/ 均相对于 apps/web/src/;未带目录的 *.test.ts 均相对于 scripts/regressions/tests/ui/apps/desktop/ 使用仓库根目录完整路径。

1. 证据等级

等级含义能否单独证明“已实现”
S静态结构/源码断言否;只能证明入口或约束存在
R回归/单元/协议自动化通常可以证明确定性分支
UI浏览器交互自动化可以证明界面和模拟集成行为
INT真实服务或真实 Codex 集成可以证明外部系统主流程
MAN候选产物人工验证用于操作系统、发布产物和难自动化交互

“UI mock 通过”不能替代真实 ADO、Rocket.Chat、Codex 或操作系统验证。历史测试如果依赖已删除的旧 Runtime、旧 Memory 或旧委托界面,也不能继续作为当前能力证据。

2. 首次引导、账号与连接

验收 ID主要实现自动化证据仍需验证
ONB-AC-01pages/FirstRunPage.tsxlib/firstRun.tsscripts/regressions/first-run.test.tstests/ui/core-flows.spec.ts 深色对比度新安装包 MAN
ONB-AC-02ONB-AC-03ONB-AC-04components/WorkspaceConfigImport.tsxlib/workspaceConfig.tsworkspace-config.test.tsworkspace-config-source.test.ts真实远程 Raw URL
ONB-AC-05WorkspaceConfigImport.tsxstores/auth.tsworkspace-config.test.tsonboarding.test.ts切换真实服务器
ONB-AC-06pages/LoginPage.tsxlib/loginDiagnostic.tstests/ui/core-flows.spec.ts真实错误分类
ONB-AC-07ONB-AC-08pages/FirstRunPage.tsxlib/firstRun.tslib/notify.tslib/autostart.tsfirst-run.test.tsautostart.test.tspnpm test:ui:releaseWindows/macOS/Linux 正式包首次安装与覆盖升级 MAN

3. 消息与会话

验收 ID主要实现自动化证据仍需验证
MSG-AC-01stores/chat.ts、消息动作组件chat-send-idempotency.test.tsmessage-delete.test.tsissue-232-thread-main.test.ts真实 Rocket.Chat 权限矩阵
MSG-AC-02消息列表与贴底逻辑message-scroll.test.tsmessage-output.test.ts长历史人工滚动
MSG-AC-03快速搜索、用户目录user-search.test.tsuser-directory.test.tssearch-filters.test.ts中文生产目录
MSG-AC-04components/Avatar.tsxConversationList.tsxChatArea.tsxchat-header-presence.test.ts在线状态实时切换
MSG-AC-05搜索页面与筛选模型quick-search.test.tssearch-filters.test.ts服务端正则设置
MSG-AC-06文件索引、下载与桌面桥接file-index.test.tsdownload-history.test.tstests/ui/download-history.spec.ts发布产物文件对话框
MSG-AC-07stores/chat.ts、实时客户端tests/ui/core-flows.spec.ts真实断网/恢复 INT
MSG-AC-08stores/chat.tscomponents/MessageList.tsxlib/messageScrollDiagnostics.tsmessage-scroll.test.tsdiagnostics.test.tstests/ui/core-flows.spec.tsWindows WebView2 连续切房与三平台正式包 MAN

4. 工作台与个人效率

验收 ID主要实现自动化证据仍需验证
WB-AC-01WB-AC-02WB-AC-03pages/WorkbenchPage.tsxstores/workbench.tscomponents/AdoLists.tsxworkbench-refresh.test.tscustom-query.test.tsado-open-issues.test.ts真实 ADO INT
WB-AC-04WB-AC-05lib/adoDirect.ts、工作项写动作ado-write-actions.test.ts写超时/并发冲突 INT
WB-AC-06ADO 受管 Skill 与业务 MCPado-skill-cli.test.tsapp-server-controller.test.ts自然语言真实任务 INT
WB-AC-07WB-AC-08pages/ProfileContributionsPage.tsxcomponents/ContributionHeatmap.tsxstores/profileContributions.tsprofile-contributions-ui.test.tstests/ui/core-flows.spec.ts真实 ADO 身份、时区和链接 INT
WB-AC-09WB-AC-10lib/adoContributions.tslib/adoDirect.tsprofile-contributions-data.test.tsprofile-contributions-pr-only.test.tsADO Server 2022 大实例 PR 分页、项目权限局部失败与 NTLM 取消边界 INT
PERS-AC-01stores/todos.tsmanual-todo.test.ts桌面 DB 失败注入
PERS-AC-02各本地 Store 的账号作用域manual-todo.test.tsdownload-history.test.ts真实切换账号
PERS-AC-03stores/calendar.ts日历相关 regression / UI多来源失效组合
PERS-AC-04通讯录与用户目录user-directory.test.tsuser-search.test.ts中文生产目录
PERS-AC-05下载记录与 Tauri 文件命令download-history.test.tstests/ui/download-history.spec.ts发布产物 MAN

5. 管家、目录与 Memory

验收 ID主要实现自动化证据仍需验证
BUT-AC-01BUT-AC-02agent/AppServerController.tsstores/codexWorkspace.tscomponents/ButlerConversationHistory.tsxapp-server-controller.test.tscodex-workspace.test.ts真实 Thread 生命周期 INT
BUT-AC-03ButlerConversation.tsxagent/attachments.tscodex-workspace.test.tstests/ui/butler-workspace.spec.ts真实多模态 Turn INT
BUT-AC-04stores/codexWorkspace.tscodex-workspace.test.tsbutler-stop-process.test.tsSteer/Queue 真实时序 INT
BUT-AC-05请求路由、输入卡片tests/ui/butler-host-input.regression-1.spec.ts真实 Codex 请求 INT
BUT-AC-06agent/codexTransfer.tsrefreshFromCodexcodex-transfer.test.tscodex-workspace.test.tsCodex App 顺序接续 MAN
BUT-AC-07Runtime 门禁与 unavailable 状态codex-runtime.test.tstests/ui/butler-workspace.spec.tsWeb 部署 MAN
BUT-AC-08pages/ButlerPage.tsx、启动级 AI 运行时选择、Codex/DeepSeek 视图dsh-view.test.tsbutler-entry-points.test.tstests/ui/butler-workspace.spec.ts正式桌面重启生效 MAN
BUT-AC-09pages/ButlerPage.tsxcomponents/DshConversation.tsxcomponents/DshQuestionCard.tsxagent/dsh/DshController.tsagent/dsh/HostedDshController.tsapps/desktop/src-tauri/src/dsh_bridge.mjsdsh-controller-runtime.test.tshosted-dsh-controller.test.tsdsh-bridge-script.test.tsdsh-view.test.ts官方 DSH Web iframe 宿主与 loopback URL INT
BUT-AC-10agent/dsh/DshController.tsagent/dsh/HostedDshController.tsdsh-controller-runtime.test.tshosted-dsh-controller.test.ts进程崩溃与恢复 INT
EXT-AC-01EXT-AC-02EXT-AC-03agent/AppServerController.tscomponents/ButlerPluginsPage.tsxbutler-plugin-marketplace-ui.test.tsbutler-bundled-skills.test.ts真实目录 INT
EXT-AC-04stores/codexWorkspace.ts 的安装/启停动作tests/ui/butler-workspace.spec.tsMarketplace 安装/卸载 INT
EXT-AC-05Runtime 门禁与目录错误隔离butler-plugin-marketplace-ui.test.tsWeb/no Runtime MAN
MEM-AC-01MEM-AC-02agent/AppServerController.tsstartThread/resumeThreadapp-server-controller.test.ts真正跨 Thread Memory INT
MEM-AC-03MEM-AC-04MEM-AC-05原生 Memory 架构与规格约束源码搜索 + 文档审查用户审阅/重置尚未实现

6. 已安排、共享 Agent 与审批

验收 ID主要实现自动化证据仍需验证
SCH-AC-01ButlerRoutines.tsxButlerRoutineCreateDialog.tsxbutler-routines-layout.test.tstests/ui/butler-workspace.spec.ts候选版 MAN
SCH-AC-02stores/routines.tsagent/codexAutomation.tsroutines.test.ts真实立即运行 INT
SCH-AC-03SCH-AC-04本机 scheduler/tickroutines.test.ts短周期、休眠、退出 MAN
SCH-AC-05SCH-AC-06自动化预检与 Server Request 策略routines.test.tscodex-workspace.test.ts真实审批请求 INT
SCH-AC-07本机 Storage 与页面文案routines.test.tstests/ui/butler-workspace.spec.ts双设备 MAN
AGT-AC-01stores/sharedAgent.tsshared-agent-runtime.test.ts无 Runtime MAN
AGT-AC-02stores/agentEnvironments.tscomponents/ButlerProjectConfigDialog.tsxagent-environments.test.ts两会话真实竞争
AGT-AC-03AGT-AC-04components/AgentPanel.tsxcomponents/ChatArea.tsx、请求路由agent-session.test.tsagent-context.test.tstests/ui/core-flows.spec.ts真实房间 INT
AGT-AC-05共享 Agent 租约逻辑shared-agent-runtime.test.ts两设备 INT
AGT-AC-06中断恢复与环境释放agent-session.test.tsshared-agent-runtime.test.ts进程崩溃 INT
AGT-AC-07产品/规格门禁文档与入口审查独立委托未实现
AGT-AC-08AGT-AC-09stores/sharedAgent.tscomponents/AgentPanel.tsxagent/dsh/HostedDshController.tsagent-hosting-backend.test.tshosted-dsh-controller.test.tsshared-agent-runtime.test.ts共享 Agent 继承全局启动级运行时的真实房间 INT
AGT-AC-10AGT-AC-11stores/sharedAgent.tslib/runtimeMode.tscomponents/AgentPanel.tsxcomponents/Composer.tsxcomponents/ThreadPanel.tsxagent-card.test.tsshared-agent-runtime.test.tsbutler-hosting-session-identity.test.tstests/ui/core-flows.spec.tstests/ui/ai-mention.spec.ts两设备与 Web 实服 INT
PERM-AC-01PERM-AC-02permissionSettingscomponents/ButlerConversation.tsxapp-server-controller.test.tscodex-workspace.test.ts上游 Profile 版本变化
PERM-AC-03PERM-AC-04PERM-AC-05PERM-AC-06Server Request 路由、审批与输入卡tests/ui/butler-host-input.regression-1.spec.ts真实命令/MCP 请求 INT
PERM-AC-07agent/codexAutomation.tsroutines.test.ts真实无人值守审批 INT
PERM-AC-08PERM-AC-09agent/dsh/protocol.tsagent/dsh/DshController.tsagent/dsh/HostedDshController.tsdsh-controller-runtime.test.tshosted-dsh-controller.test.tsdsh-bridge-script.test.tsDSH 原生审批/问题 INT

7. Runtime 与平台

验收 ID主要实现自动化证据仍需验证
RUN-AC-01RUN-AC-02RUN-AC-03apps/desktop/src-tauri/src/proc.rs、Runtime 探测codex-runtime.test.ts、Rust tests安装/未登录/多版本 MAN
RUN-AC-04进程管理、Controller shutdown、Store 恢复butler-stop-process.test.tsapp-server-controller.test.ts强杀进程 INT
RUN-AC-05两份 Tauri bundle 配置codex-bundled-resource.test.ts发布产物内容审计
RUN-AC-06Tauri-only transport 与 Web 门禁codex-runtime.test.ts、UI部署 Web MAN
RUN-AC-07原生 Thread resumecodex-workspace.test.tspnpm smoke:codex-lifecycle
DSH 固定运行时apps/dsh-runtime/package.jsonscripts/prepare-dsh-runtime.mjsapps/desktop/src-tauri/src/dsh.rsdsh-bundled-runtime.test.ts、Rust tests、部署树 CLI/profile/PTY/bridge smokemacOS universal 与 Linux 安装产物 INT/MAN
PLAT-AC-01主导航与管家布局tests/ui/butler-workspace.spec.ts各分辨率视觉 MAN
PLAT-AC-02平台检测、lib/autostart.ts、Tauri transportautostart.test.tscodex-runtime.test.tsWeb 部署 MAN
PLAT-AC-03apps/desktop/src-tauri/src/main.rsRust tray tests三平台发布产物 MAN
PLAT-AC-04lib/autostart.tsapps/desktop/src-tauri/src/main.rs、系统插件autostart.test.ts、Rust tests、tests/ui/core-flows.spec.tsWindows/macOS/Linux MAN
PLAT-AC-05UpdaterBridge.tsxlib/updateSource.tsapps/desktop/src-tauri/src/proc.rsupdate-source.test.ts、Rust tests签名 Release 与真实 UNC 有签名/无签名安装 MAN
PLAT-AC-06Tauri bundle/OCR 配置image-ocr.test.tscodex-bundled-resource.test.ts精简/全量产物审计
PLAT-AC-07lib/runtimeMode.tsissue-264-performance-mode.test.ts长时间资源观察
PLAT-AC-08lib/unread.tslib/tray.tstray-flash.test.tstaskbar-badge.test.ts、通知聚合 tests三平台 MAN
PLAT-AC-10lib/uiScale.tscomponents/DesktopUiScaleBridge.tsxstores/uiPrefs.ts、Tauri capabilityui-scale.test.tstests/ui/core-flows.spec.ts三平台 1080p 发布产物清晰度与快捷键 MAN
PLAT-AC-11apps/desktop/src-tauri/src/main.rs、WebView2 官方内存目标webview-memory.test.ts、Windows Release 前后进程采样macOS/Linux 系统 WebView 不适用;Windows 长时间驻留观察
PLAT-AC-12Tauri DSH resource、scripts/prepare-dsh-runtime.mjsapps/desktop/src-tauri/src/dsh.rsdsh-bundled-runtime.test.tsofficial-plugins.test.ts、桌面 Rust tests三平台 Release matrix 资源与启动 MAN

8. 每日工作循环

验收 ID主要实现自动化证据仍需验证
LOOP-AC-01stores/focus.tscomponents/FocusDialog.tsxcomponents/FocusDigestCard.tsxcomponents/NavRail.tsxstores/chat.ts 通知路由focus-mode.test.tsnotification-sound.test.ts 路由顺序锁定真实登录下专注全链路 UI/INT;三平台状态切换 MAN
LOOP-AC-02LOOP-AC-03未实现(v3 通知瀑布重组)
LOOP-AC-04LOOP-AC-06部分:消化卡与统计(v2 消化清单未实现)focus-mode.test.ts消化清单批处理 UI
LOOP-AC-05未实现(v4 消息待办自动消解)

9. 斜杠命令与团队功能

规格:slash-commands.md(2026-09-06 对 Rocket.Chat 8.6.1 实测)

验收 ID主要实现自动化证据仍需验证
SLASH-AC-01lib/clientCommands.tskernel/dispatch.tsstores/chat.ts runSlashslash-commands.test.ts、smoke 命令表覆盖断言(服务端命令缺中文说明即失败)其他 RC 版本的命令表差异 INT
SLASH-AC-02lib/poll.tscomponents/PollCard.tsxCommandDialogs.tsxpoll.test.ts、smoke 投票段(附件往返、双账号表情计票、结束标记)官方移动端表情参与 INT
SLASH-AC-03lib/kanban.tslib/oncall.tscomponents/KanbanPanel.tsxcomponents/OncallPanel.tsxkanban-oncall.test.tsthread-pagination.test.ts、judge 截图验收 9/9超长事件流真服务端压测 INT
SLASH-AC-04kernel/capabilities/host.tskernel/bridge.tskernel/chatEvents.tspackages/app-sdkkernel-host.test.tschat-events.test.ts(消息事件按 chat:read 门控有源码断言)第三方应用实战

10. 发布候选门禁

规格状态要提升为“已实现”前,至少满足:

  1. 对应 AC 有 R 或 UI 证据;依赖外部系统的主流程还要有 INT。
  2. Web/桌面、无 Runtime、未登录、权限拒绝等适用边界已验证。
  3. 发布产物相关能力完成 MAN,不以开发模式替代。
  4. 能力矩阵、对应规格与本追踪表一致。
  5. 测试失败或尚未执行时,在实施记录中如实保留,不以旧截图代替。

11. 不再接受的历史证据

  • 依赖已删除自建 Butler Memory 的测试,不能证明当前 Codex 原生 Memory。
  • 依赖已删除“派出去”界面的测试,不能证明独立委托存在。
  • Blackboard、旧 AI 页面或 mock 工具成功截图,不能证明当前管家 Runtime。
  • ADO @Me 局部快照为零,不能证明整个项目/组织工作项为零。