# DSH Scholar 人工验收规范

> 规范性文档。开发阶段先实现完整代码；暂时无法连接的真实环境统一在这里组织后续人工验收，不以缺少 CI 阻塞代码开发，也不把未执行场景伪装成 PASS。

本规范采用“代码优先、人工后验”的两阶段方式。

- **MANUAL-BRAND-DSH-SCHOLAR**：分别打开中文和英文 Standalone 解锁页及主工作台，检查 Header、Sidebar、浏览器标题、Chat 欢迎/导出和 Settings 卡片。预期组合字标均为 `dsh Scholar`，不再出现 `dsh Research`，同时 `Research Kernel` 等技术名保持原样。

## 1. 适用范围

优先交给人工真实环境验证的场景包括：

- Chromium/Firefox/WebKit、桌面/窄屏、键盘与辅助功能；
- 真实 DSH host、Cordis self-referential mount/unmount、插件 reload/dispose；
- 本机 Docker、固定 TeX 镜像、PDF、clean-room bundle；
- 第二台远端机器、mTLS 证书链、断线/重连/吊销、Remote PTY；
- GPU、AV scanner、网络分区、双进程/长期 recovery 和多人身份撤权。

纯单元、模块契约、静态安全边界、Schema、迁移、i18n parity 和可在开发机稳定复现的错误不得推给人工环境；它们应在代码实现阶段自动验证。

## 2. 代码交付给人工前的条件

每个功能交付人工前必须具备：

1. 生产代码路径完整，无 placeholder、fake success、只在测试生效的分支或未接线接口；
2. 负责规范、API/Schema/迁移、i18n、`acceptance-tests.md` 和 hardening 已同步；
3. 当前机器能运行的 build、typecheck、unit、module contract 和 static checks 已运行并记录；
4. 每个真实环境场景有稳定 ID、前置条件、测试数据、操作步骤、预期结果、失败判据、清理方法和证据要求；
5. 未执行真实环境场景统一记 `NOT_RUN_MANUAL_PENDING`，hardening 状态最多为“已实现未验收”。

## 3. 人工验收记录模板

每轮人工测试复制以下模板形成同目录下 `manual-acceptance-YYYYMMDD-<short-sha>.md`：

~~~markdown
# Manual acceptance report

- commit: <full SHA>
- date/timezone: <ISO time + timezone>
- operator: <name/id>
- environment: <OS/browser/DSH/Docker/TeX/remote topology/config pin>
- secrets: <只记 SecretRef/证书指纹，不记录明文>

| scenario_id | result | actual | evidence | notes |
|---|---|---|---|---|
| <acceptance-tests.md ID> | PASS/FAIL/BLOCKED | <观察结果> | <日志/截图/Artifact 路径> | <清理/偏差> |

## Failures and follow-up

- 每个 FAIL/BLOCKED 对应的规范、acceptance 和 hardening 更新位置；
- 修复后需要重跑的最小场景集合；
- 未运行场景保持 NOT_RUN_MANUAL_PENDING。
~~~

截图只能辅助说明，不能替代场景步骤、实际结果和服务端日志。报告不得包含 token、私钥、cookie、原始 secret 或未脱敏 trajectory payload。

## 4. 当前人工验收队列

当前队列直接引用 [acceptance-tests.md §21](./acceptance-tests.md#21-2026-08-11-当前复审强制回归场景)：

1. 浏览器：Init/Resume/Upload/Grill、Workspace、Interactive Terminal、TeX live preview、Trajectory/Subagent Topology、Settings/i18n；
   - **Trajectory/Topology BFF 身份转发（TRAJ-01/SUBAGENT-01，acceptance-tests.md `topology-trajectory-bff-principal-forward`）**：以项目成员打开“轨迹”和“拓扑”，空数据必须显示合法空态，不得显示“桥接错误”；展开/分页/刷新仍可读取。用非成员项目验证统一 404、浏览器伪造 `x-principal-id` 不能改变结果；Network 中项目级 `/topology`、`/trajectory`、`/trajectory-lanes` 均应 200。2026-08-12 已用 Headless Chrome 在本地 `demo1` 验证 Topology 实际 DOM：无 `.error-banner`，显示“该项目还没有子代理节点。”；更深节点展开/键盘/视觉项仍记 `NOT_RUN_MANUAL_PENDING`；
   - **调研下一步 CTA（GUIDE-01，acceptance-tests.md `ui-survey-next-action-cta`）**：准备一个处于 SCOPED 的项目且 Brief.problem 非空；点击 Overview 的 `survey_run` 卡后，必须保持当前项目、打开 Chat 并仅预填 `/survey <problem>`，右侧/底部 Dock 的既有面板不得被误当成执行结果，Runs 数量与 Corpus/Outbox 在按 Enter 前不得变化；确认发送后核对 Corpus Snapshot 出现、项目进入 SURVEYING、下一步变为 `idea_generate`，刷新后不得重新显示 `survey_run`。同时覆盖空 problem（预填 `/survey `）、zh/en 文案和旧投影 `route=runs` 的兼容归一化。代码与 HTTP 自动回归已通过，真实浏览器视觉/键盘项记 `NOT_RUN_MANUAL_PENDING`；
   - **Chat 项目隔离（CHAT-SCOPE-01，acceptance-tests.md `ui-chat-project-isolation`）**：在项目 A/B 创建同名 session 和不同草稿/附件/引用，来回切换与刷新后核对零串线；在 A 发起慢命令和大附件上传后立刻切到 B，完成结果只能回到 A；再验证 Chat 主区→右 Dock→底 Dock 不改变当前 project context。代码完成前为 BLOCKED，代码完成后真实浏览器部分记 `NOT_RUN_MANUAL_PENDING`；
   - **全页面 Panel Dock（UI-DOCK-01，acceptance-tests.md §21 `ui-sidebar-dock-all-panels`）**：全部 13 个当前页面逐一执行主区→右侧→底部→主区/关闭；验证同页仅一活实例、右/底互换不 remount、pointer/键盘 resize、刷新恢复与损坏 storage 回退、1024/720/640 响应式、zh/en/theme/ARIA/focus；对 Chat 草稿/附件、Workspace/TeX dirty 与 Preview、Run Terminal/PTY/Trajectory 实时流分别验证状态与游标连续性。代码侧纯模型测试已完成，真实浏览器观感统一记 `NOT_RUN_MANUAL_PENDING`；
   - **Intake 向导视觉项（ONBOARD-01/UPLOAD-01/GUIDE-01，hardening §5 P1 行，acceptance-tests.md §21 `init-resume-intake-grill`）**：Start 屏三入口观感与「打开已有项目」列表（未选中项目时不自动跳 projects[0]）；导入向导 begin→stage（真实 multipart 上传与 32MiB 413 提示、已 staged 文件 verdict/删除/续传、sha256 幂等复用提示）→scan（summary/observations/rejected 拒因，archive 解包展开视图）→grill（问题表单与答案持久化）→propose（pre-accept 清单）→PI adopt（AdoptionReceipt，含 import_mappings 物化报告/CodeSnapshot 结果呈现）同页观感；刷新/重开页面断点续接；Overview 面板 intake_* NextAction 卡点击打开向导；zh/en 切换即时生效——全部记 `NOT_RUN_MANUAL_PENDING`（Playwright 类环境不可用）；**服务端 archive 解包扫描与 TeX/CodeSnapshot 采用物化已实现（2026-08-11，commit 98243ff）——属代码实现阶段自动验证部分，不再进入人工队列**（证据：tests/unit/intake-materialize.test.ts 15/15、intake.test.ts 32/32、pnpm test 1026/1026、research-kernel build 全绿、run-workspace-tests.sh 48/48、run-upload-tests.sh 18/18、verify-docs 19/19；语义见 research-onboarding.md §4.2/§6.1 注记）；
   - Manuscript P0-3（TEX-01/TEX-03，hardening §5 行）视觉项：打开/rerender/tab 往返零写入；保存→debounce→preview 状态（pending/queued/running/succeeded/failed/cancelled/superseded）与 stale 标识同页实时更新、PDF 自动刷新/下载；Regenerate 确认对话框与旧版本回退；权威 Compile 与 preview 面板分离；窄屏布局——全部记 `NOT_RUN_MANUAL_PENDING`（Playwright 类环境不可用），对应 acceptance-tests.md §21 `manuscript-open-never-regenerates` / `tex-save-live-preview`；
   - **Settings 视觉项（CONFIG-01/UI-02/UI-03，hardening §5 P1 行，acceptance-tests.md §21 `settings-schema-complete-i18n`）**：动态 Settings 同页观感——7 个 ConfigScope Accordion 组（global/project/job reserved/runner-profile/orchestrator/kernel/standalone）默认折叠与展开；每字段 effective 值/secret 掩码（"已设置,不显示明文"且明文零回显）/meta chips（scope、来源、热生效/需重启、安全基线、env）；config pin 显示与「config pin 已变化」提示（改动配置后重开 Settings）；只读注记与禁用提交按钮（"当前配置只读,经 CLI/env 提供"）；zh/en 切换即时生效且无缺 key；640/720/1024 视口——全部记 `NOT_RUN_MANUAL_PENDING`（Playwright 类环境不可用）；
   - **Trajectory/Subagent Topology 视觉项（TRAJ-01/SUBAGENT-01，hardening §5 P1 行，acceptance-tests.md §21 `trajectory-topology-browser`）——UI 逻辑层已实现（commit 98243ff）**：More →「轨迹」面板双 lane（Research 权威 / Session 观察）per-lane 分页与脱敏摘要/详情展开；More →「拓扑」面板直系树懒展开、breadcrumb 逐级返回、child 详情 + 只读历史、one-shot 只读 follow-up（message_id 回执）——证据 tests/unit/trajectory-ui.test.ts 32/32。**client SSE 消费已实现（commit 98243ff）**：双 lane 增量经 `TrajectoryStreamClient`（client/sse-client.ts）消费 `GET /v1/projects/{id}/trajectory/stream?after_seq=&lane=`（lane 过滤 + entry_id 去重；流失败回退 keyset 分页；离开 tab 关闭）。剩余浏览器验收（全部记 `NOT_RUN_MANUAL_PENDING`，Playwright 类环境不可用）：双 lane 滚动/虚拟化观感（10k 节点 DOM 有界）、树展开/键盘/ARIA、进入 child 与 follow-up 交互观感、跨项目 child ID 与撤权浏览器观感、SSE 增量流浏览器事件源观感；
   - **Workspace 视觉项（WORK-01 §5 P1，hardening §5 行，acceptance-tests.md §21 `workspace-browser-workbench` / `workspace-client-tree-tabs`）——Workspace tree client 逻辑层已实现（commit 98243ff）**：More →「工作区」面板（#tab=workspace 深链）——workspace 选择器 + 工具栏（新建文件/新建目录/上传/刷新/路径搜索框）；左侧文件树懒展开（目录点击展开/收起、虚拟空目录标记、文件行 hover 移动/删除）；右侧多标签编辑区（tab 栏 dirty ● 标记、textarea 编辑 + 保存按钮、保存 409 冲突横幅 + 重新加载、二进制只读 meta + 下载、历史版本列表 + 回退）；SSE watch 流实时增量刷新（`WorkspaceWatchClient`，client/sse-client.ts，消费 `watch/stream?after_revision=`；流不可用回退 listSince 5s 轮询；离开 tab 停止）——证据 tests/unit/workspace-client.test.ts 38/38。剩余浏览器验收（全部记 `NOT_RUN_MANUAL_PENDING`，Playwright 类环境不可用）：文件树渲染观感与拖拽上传、多标签视觉/冲突横幅观感、窄屏（640/720/1024）布局、键盘导航与 a11y；Problems 面板与集成 PTY 入口；SSE watch 流浏览器事件源观感（client 消费已实现，观感仍 NOT_RUN_MANUAL_PENDING）。
   - **Interactive Web Terminal（WEBTERM-01/PTY-01，acceptance-tests.md §21 `interactive-terminal-browser`）**：旧页面只有 plain-text output 和按钮控制，不能交互，明确视为缺陷而非视觉待验收。代码关闭条件是 xterm-compatible emulator、keyboard/paste/IME→bytes、ANSI/VT/alternate-screen、增量输出、auto-fit resize、dispose 生命周期及 adapter 回归；人工步骤是在真实 LocalPtyAdapter 中输入 `printf 'WEBTERM_OK\\n'`、Unicode、方向键/Tab/Ctrl+C，运行 `vim`/`top` 等 TUI，并在主区/右 Dock/底 Dock、640/720/1024 下验证。代码完成前是 BLOCKED；代码完成后真实浏览器部分仍记 `NOT_RUN_MANUAL_PENDING`，不能用 model 单测代替。
   - **SSE 实时流服务端/BFF（acceptance-tests.md §21「SSE 实时流替代轮询」，api-contracts.md §22，commit 98243ff）**：三个增量流端点（`/v1/pty/sessions/{id}/frames/stream`、`/v1/projects/{id}/workspaces/{wid}/watch/stream`、`/v1/projects/{id}/trajectory/stream`——text/event-stream、after_seq/after_revision 重放、live 追加、命名心跳、gap/exit 结束、鉴权与对应轮询端点一致（422 principal_required / 403 owner/lease / 404 未知或非成员 / 跨项目 404））+ BFF 透传（bearer 401、CSRF GET 豁免、非成员首字节前 404、x-service-token/x-principal-id 注入）已由自动化验收闭环：tests/unit/sse-streams.test.ts 7/7 + tests/security/run-sse-tests.sh 67/67（原 23 断言不破坏；三流 kernel/BFF 真 HTTP：首字节 event、after_seq 续传无重复、live、gap/exit、跨项目 404、无 token 401、非成员首字节前 404、BFF 透传）；轮询端点保留向后兼容。剩余人工项仅为浏览器事件源消费观感（三面板断线重连/心跳/续传观感），记 `NOT_RUN_MANUAL_PENDING`。
2. DSH：Agent plugin、subagent follow-up、Cordis self-mod 隔离与 lifecycle；
   - **Private host install（PACK-01/DSH-01，acceptance-tests.md §9.0/§21 `dsh-private-registry-install`）**：在隔离机器配置 `DSH_PRIVATE_REGISTRY_URL`、短期只读 `DSH_PRIVATE_REGISTRY_TOKEN`、固定 `DSH_PRIVATE_DSH_SPEC` 和已发布/可安装的固定 `DSH_SCHOLAR_PLUGIN_SPEC`，运行 `tests/integration/run-dsh-private-registry-tests.sh`；保存脱敏的包版本、DSH profile dump、boot/apply/dispose 与 realpath 报告。当前开发机没有真实私有 registry/credential/Scholar 安装 spec 时记 `NOT_RUN_MANUAL_PENDING`，本地 checkout/symlink/fake host 结果不得替代；
   - **Latest DSH + local artifact smoke：PASS（2026-08-13，重新 source `.bashrc` 后复跑）**：权限 0600 的临时 npm userconfig 认证通过，并从 npmjs.org 解析、安装精确 `@deepseek-ai/dsh@0.0.1-rc.2`；DSH realpath 位于全新 launcher。根插件及五个当前明确未发布的本地 `@dsh-scholar/*` 运行时包均重新正式 build + pack，根插件 `@dsh-scholar/research-plugin@0.1.0` 本轮 tgz sha256 为 `0edd23f11cda4b8ed7edfecdd0387bcb129a6bf73c3d4c5b20398e24986e1cef`。全部本地包以 tgz override 安装到临时 profile，没有 checkout realpath/symlink；插件与四个直接运行时依赖均为 profile 内 `0.1.0`，`dsh plugin why` 确认宿主工具图为 `0.0.1-rc.2`，profile dump 含 `research-plugin` 与 `kernel.port=0`，真实 DSH Web/Cordis 存活 8 秒、sidecar 物化 `kernel.db`，SIGTERM dispose 为 0；自动 packaging 回归为 `11/11`。单独根插件 tgz 尝试从 registry 解析未发布内部包时出现 404 属当前预期，不计本地兼容失败；等 Scholar 发布时再要求所有正式依赖由 registry 固定版本解析，并另记 published-registry PASS。凭据未进入 argv/报告，临时目录已删除。
   - **Latest DSH checkout + local Scholar profile smoke：PASS（2026-08-17）**：拉取并构建 DSH `0.1.0-rc.7`（commit `99f6f02fec`），经其公开 CLI 将本地 Scholar checkout 加入现有 `web` profile。首轮真实 Chrome 稳定复现 `Failed to load plugins: keyed slot "settings.plugin.item" requires options.key`，证明 rc.2 mock/types 未覆盖 rc.7 keyed-slot 契约；修复为 `key='research-plugin'`、移除 `id/order`，并把所有 DSH peer 下限与开发依赖统一到 rc.7。修复后真实 Chrome 连续两次启动无 plugin/page error；已关联会话的 `/dsh-scholar-view/session-workspace` 返回 `cnn测试/SURVEYING/rev 3` 与当前 `idea` 阶段，未关联会话返回 5 个可绑定项目并显示“已有项目/新建并关联”，均不再显示阶段读取失败。3080/7412/18610 各仅一个 systemd 管理进程。此项是源码 checkout/profile 的本机兼容 smoke，不替代上方 clean tgz/profile 或未来 published-registry 验收。
   - **DSH `@next`（精确 RC8）+ 本地 Scholar 插件的 Host/Profile 运行 smoke：PASS（2026-08-20）**：`npm view @deepseek-ai/dsh dist-tags --json` 记录 `next=0.1.0-rc.8`，全局安装后的 `dsh --version` 为 `0.1.0-rc.8`，realpath 位于全局 npm 安装目录而非源码 checkout；官方 RC8 tag `dsh-v0.1.0-rc.8`（commit `141eb6fef8`）的独立源码 build 也通过。Scholar 以正式 build 后的绝对路径加入 `web` profile，`dsh --profile web --dump-config` 含 `@dsh-scholar/research-plugin`。真实 npm RC8 Web 宿主完成限定启动与 SIGTERM dispose；systemd 运行态 `3080` Web、`7412` shared Kernel、`18610` standalone 均为单一 loopback listener，Web 与 Kernel health 均返回 HTTP 200，`runtime/endpoint.json` 为 0600。全新临时 Chrome profile 经 DevTools Protocol 打开 `http://127.0.0.1:3080/`，页面达到 `readyState=complete`，标题为 `DSH Local Build`，Runtime/Log/console 的插件加载、keyed-slot、TypeError/ReferenceError/SyntaxError 扫描为 0。自动回归：整仓 97 files / 1425 tests、DSH 插件 lifecycle/security 52/52，均通过。启动前发现的 `sidecar_identity_unknown` 来自 2026-08-17 遗留且无 endpoint 的孤儿进程；停止该明确旧进程并由当前 standalone 恢复 owner 后，最小复现确认非 owner DSH dispose 不删除 owner endpoint，因此不归类为 RC8 API 兼容缺陷。此 PASS 的边界是当前 Host/Profile、Cordis apply/dispose、共享 Kernel、HTTP 启动和浏览器基础加载兼容；页签内绑定/创建、配置卡编辑和键盘交互的逐项视觉验收仍为 `NOT_RUN_MANUAL_PENDING`，也不替代 Scholar 发布后的 clean registry install。
   - **RC8 DSH Scholar 页签与配置卡浏览器验收：FAIL（2026-08-20）**：使用全局 npm `@deepseek-ai/dsh@0.1.0-rc.8` 在独立 `3082` 端口启动真实宿主，并用全新 Chrome profile 操作。已关联会话通过：页签顺序为“对话 / 轨迹 / dsh Scholar”，`cnn测试` 显示 `CONTRACT_APPROVED / rev 7`、完整阶段与权威 baseline 下一步；Settings → 插件 → dsh Scholar 配置卡可展开，Gate-only/Full-auto、无人值守、Standalone 地址、快捷键、打开新页面、复制 token 和保存控件均出现，浏览器异常与 error console 为 0。未关联会话失败：选择“你是谁”后，页签没有显示“绑定已有项目 / 新建并关联”，而是“暂时无法读取当前会话的研究阶段”；`/dsh-scholar-view/session-workspace` 虽为 HTTP 200，RPC body 为 `ok:false/internal/Scholar session workspace is unavailable`。根因已缩小为项目选项读取 422：当前 schema 要求 `execution.runner_profile_id` 键存在（可为 null），本机两条遗留项目 `panel-test`、`shift-localization` 的持久行缺该键，`listProjectsForDshSession` 对整个数组解析失败，单个坏行拖垮未关联页。关闭条件：项目持久化数据必须全部满足当前 required-nullable execution shape，项目选项投影不得因一条不合法记录让整个未关联 UI 退化为通用错误；回归必须同时覆盖 legacy-shaped row 的明确 fail-closed 处理、正常项目列表、绑定和 name-only 创建。不得把清理本机数据库或隐藏错误当作产品修复。
3. Remote：容器隔离、mTLS、fencing、binary CAS、断线恢复、Remote PTY；
   - hardening §5 RUN-REMOTE-01 两行（2026-08-11 修复轮）代码侧已闭环的**真实环境剩余项**（记 `NOT_RUN_MANUAL_PENDING`，对应 acceptance-tests.md §21 `remote-secure-container-only` / `remote-identity-fencing-manifest` / `remote-cas-binary-auth` 的剩余段）：真实远端主机上 secure kinds 经 digest-pinned container 执行、无 docker 时 environment 失败且宿主 marker 未执行（`remote-secure-container-only`）；真实 mTLS service identity（CA/第二主机证书链）、证书轮换/吊销即时生效、两主机断线重连与故障注入、`remote-identity-fencing-manifest` 全链（assignment/job/run/owner/generation/token/manifest.run_id）在两台真实机器上核对（本地 wire 的 x-service-token 等价实现仅限本机测试）；两主机间二进制 CAS（随机字节/PDF/压缩包）往返 hash/size 一致（`remote-cas-binary-auth` 剩余）；Remote PTY 跨机 wire（`pty-owner-fencing-all-operations` 剩余）。
4. Reproduction：真实 Docker/TeX、Golden Path、Release Bundle、clean-room；
   - Code Snapshot P0-4（SNAPSHOT-01/API-01，hardening §5 行）端到端项：真实 golden-path Docker 全链（fixture 经项目 workspace 归档 → CAS 物化 → 容器执行）；浏览器/DSH 侧经 `workspace_snapshot` 工具以 workspace_id + root_relative_path 归档；旧 `{path}` 形状调用被 422 拒绝的实测记录；secret 文件（.env/token/key）混入工作区时快照被拒并列出文件名的实测记录——对应 acceptance-tests.md §21 `code-snapshot-approved-workspace-only`，记 `NOT_RUN_MANUAL_PENDING`（Docker/golden 环境可用时先跑 `evals/golden-path-v2/run-golden-v2.sh`）；
5. Recovery/Security：sidecar-kernel-bearer-required（真实 sidecar 实例上直接访问 kernel 端口的读写 401 负向、health 豁免、BFF/Runner/Orchestrator 用 token 全链）、撤权即时生效、多进程、kill/restart、长期 retention 与跨项目负向。
   - **Archived project delete（PROJECT-DELETE-01，acceptance-tests.md §21 `project-delete-after-archive` / `project-delete-archived-browser-i18n`）**：真实浏览器以 PI 归档项目后从收缩操作区删除，验证 exact-name 确认、zh/en、取消零写、删除后 list/get/深链 404 与 active selection 清理；重启 Kernel/standalone 后仍不可见；用两个项目引用同一随机二进制/PDF，删除其一并执行允许的 GC 后另一项目 hash/size/下载不变；验证 researcher/operator/auditor/viewer/被撤权成员负向、同 request id 重放、Outbox/retention/released Bundle 仍保留。真实浏览器与长期 retention/GC drill 当前记 `NOT_RUN_MANUAL_PENDING`；
   - **Workspace crash-recovery drill（WORK-01 §5 P2，hardening §5 行，acceptance-tests.md §21 `workspace-crash-recovery-idempotent`，记 `NOT_RUN_MANUAL_PENDING`）**：代码侧已闭环（`scanWorkspaceIntegrity()` 启动恢复扫描 + `workspaces.quarantine` 隔离，migration 0018；unit 11/11 + HTTP 真实进程 kill+重启段 3/3 已自动验证）。真实环境剩余项：对运行中 kernel 直接 `kill -9`（非 SIGTERM）打在写路径 rename/row 更新/delete unlink/row 删除/move rename/目标 row 插入的每个窗口，重启后确认——前滚/回滚/隔离判定与 unit 一致、隔离 workspace 503 且恢复字节后重启自愈、double 重启收敛、`.ws-tmp-*` 无残留；双进程同时打开同一 dataDir 的行为；长期（跨多天）重复 crash/restart 后的 ledger/revision 单调性与历史完整性。
   - P0-2（API-01/PTY-01，hardening §5 行）已在代码实现阶段自动验证的部分（不再进入人工队列）（真实 sidecar 实例上直接访问 kernel 端口的读写 401 负向、health 豁免、BFF/Runner/Orchestrator 用 token 全链）、撤权即时生效、多进程、kill/restart、长期 retention 与跨项目负向。
   - P0-2（API-01/PTY-01，hardening §5 行）已在代码实现阶段自动验证的部分（不再进入人工队列）：BFF global-id 解析（artifact/document/pty/events 跨项目 404、成员 200、猜 ID 404、无 scope events 404）、kernel PTY principal+owner+lease 强制（direct-kernel 负向矩阵）、membership 实时撤权（同一 BFF 移除成员后下一请求 404）——证据 run-standalone-http-tests.sh P0-2 段、run-hardening-tests.sh direct-kernel PTY 段、tests/unit/pty-session.test.ts 14/14；
   - §5 P1（GOV-01/ONBOARD-01，hardening §5 行）已在代码实现阶段自动验证的部分（不再进入人工队列）：PI-only capability route table（intake adopt、project archive/unarchive 加入 governance write 表）、BFF/Kernel 双层校验（researcher/viewer/auditor 403、非成员 404、缺 principal 422、pi/operator 全链 200）、kernel direct 负向矩阵、撤权后下一请求 404——证据 run-standalone-http-tests.sh §5 P1 段、tests/unit/kernel.test.ts v1 PI-only 矩阵、tests/unit/intake.test.ts 32/32；
   - 剩余人工项（记 `NOT_RUN_MANUAL_PENDING`）：浏览器 Interactive Terminal 真实 stdin/resize/INT/TERM/KILL/detach-reconnect/after_seq-gap 全链（acceptance-tests.md §21 `interactive-terminal-browser`）、多人/多进程真实撤权观感（`membership-revocation-no-stale-cache` 的浏览器侧）、researcher 角色 UX——浏览器视图不向 researcher 呈现 adopt/archive/unarchive 操作入口（`membership-revocation-no-stale-cache` 的 UI 侧）、Remote PTY 共用同一权限 wire 的跨机验证（`pty-owner-fencing-all-operations` 剩余）。

本地可复现项不进入人工队列（§1）：`workspace-permission-under-umask` 与 `ci-current-evidence-no-exclusion`（acceptance-tests.md §21）已在代码实现阶段自动验证并标记“已实现未验收”（hardening §5 WORK-01/CI-01 行），剩余仅 CI job 绑定；不记 `NOT_RUN_MANUAL_PENDING`。

## 5. 结果回写规则

- PASS：在 hardening 对应行记录 commit、场景 ID、环境和报告链接；全部阻断场景通过后才升级“已验收”；
- FAIL：先把缺陷和关闭条件写回负责规范、`acceptance-tests.md` 与 hardening，再修改代码；
- BLOCKED：说明缺失环境或权限，保持 `NOT_RUN_MANUAL_PENDING`，不能计 PASS；
- 新需求或修复建议：遵守 docs/README.md 的文档先行规则，不得只留在人工测试聊天或截图中。

## 6. 2026-08-12 新增人工队列：Init / Upload / Models

以下场景开发期不接真实环境，统一标记 `NOT_RUN_MANUAL_PENDING`（代码侧实现与自动证据见 hardening §3 INIT-GRILL-02 / CHUNK-01 / MODEL-01 行与 acceptance-tests.md §22/§23 标注，2026-08-12）：

1. `MANUAL-INIT-GRILL-I18N`：zh/en 浏览器仅输入 project name 创建；逐题 answer/edit/skip/unknown；中途刷新/换浏览器恢复；确认前零 Gate，PI confirm 后唯一 Gate；语言切换不丢输入，所有下一步/aria 正确。
2. `MANUAL-UPLOAD-2G`：至少 50 个混合材料与一个跨 8 MiB 边界文件；暂停、断网、刷新、重放同 chunk、gap/错误 hash；完成后 hash/页数一致；在可控环境分别验证 2 GiB 默认拒绝和配置到 10 GiB 的边界，保留服务端/浏览器报告但不上传材料内容。Chat composer 在主区、右 Dock、底 Dock 都必须持续显示“上传文件”文字按钮与选择/拖放/粘贴提示，队列位于输入框内部；项目有 active Intake 时复用，没有时首次选文件自动创建隔离 Intake 且不离开 Chat。队列每文件独立显示 hashing/queued/uploading/paused/scanning/needs-input/ready/quarantined/failed，队列级显示总配额/进度/失败数与下一步；消息只保存 attachment/stage ref（浏览器观感与真实断网重连属本项）。
3. `MANUAL-EXECUTION-ENVIRONMENTS`：在 Settings 分别创建本机进程、本机 Docker、远程 SSH Target/Profile；验证 revision CAS、zh/en、secret 零回显和 safe health。trusted smoke 可选本机进程，formal 对本机进程必须拒绝；本机 Docker 验证 digest/non-root/read-only/network/resource；远程主机验证 host-key/SecretRef、容器同构、CAS/日志/Artifact、断网恢复。停机、错误 host key、撤权、能力不匹配时任务 blocked/retryable 且本机零执行；显式新 attempt 更换 target 后记录新 pin。保留脱敏 target revision/hash、RunManifest、日志和截图，不保存 credential。
3. `MANUAL-PROVIDER-SECRET`：接私有测试 Provider，创建/编辑/禁用与 restart；确认 SecretRef 明文不出浏览器、argv、日志、Trajectory/Bundle；验证非法 URL/redirect/DNS/proxy；项目选择只提交 ID，运行固定 revision/hash。
4. `MANUAL-OCR-PROVENANCE`：多页 PDF、扫描图片、中英混合、低置信度与 Provider 失败；无显式模型时不发请求、不回退；结果逐项显示 source/page/confidence，Grill 确认前不进入 Brief/Gate/Evidence。
5. `MANUAL-MINERU-CONFIG`：在 zh/en 下打开 Settings「Models & OCR」，分别以约 680px 弹窗宽度和 ≤720px 窄屏检查服务商、项目模型、SecretRef 三个分组；任何标签、说明、输入框和按钮都不得重叠、塌缩或横向溢出，窄屏字段必须单列。再以无 Token 的 Flash 和 SecretRef 精准模式分别创建/编辑/禁用 MinerU，确认默认官方 API、`flash/pipeline/vlm` 目录、revision CAS、SecretRef available 状态和错误文案；在活动项目切换 OCR model，抓包确认只发送 provider/model ID。配置完成后页面不得把任何文件标成“已 OCR”，真实 OCR 执行仍归 `MANUAL-OCR-PROVENANCE`。

每次 FAIL 先把 error code、重现条件和关闭验收补回 `init-grill-upload-models.md`、`acceptance-tests.md` 与 hardening，再修代码。

## 7. 论文复现、实验环境与 Session Terminal 人工队列

> 2026-08-12 实现轮注记：REPRO-01 代码侧已闭环（spec/attempt/report 存储与 API、纯比较器、verifier service identity、NextAction done 语义、`/reproduce` 一级命令——证据 tests/unit/reproduction.test.ts 33/33、migration 0022、run-hardening-tests.sh REPRO-01 HTTP 段；详见 hardening-v0.2-status.md §3 REPRO-01 行与 acceptance-tests.md §23 场景注记）。以下队列全部保留为真实环境验收（`NOT_RUN_MANUAL_PENDING`）。

1. `MANUAL-REPRO-PAPER`：用 DOI、arXiv 和扫描 PDF 各建一次 `/reproduce`；上传官方代码/数据并核对 source locator、commit/CodeSnapshot、license、environment pin；在真实本机 Docker 运行，比较论文目标指标/表/图并生成 Report。exit 0 + 指标越界必须显示 fail/inconclusive。
2. `MANUAL-REPRO-REMOTE-SSH`：Settings 以 SecretRef 登记两台远端 SSH Runner，验证 known-host/credential/health/revision/hash；选择 target A 执行并中途断网/重启；确认同 attempt 不落到本机/B，显式新 attempt 才可改 target。日志/浏览器/argv/Bundle 零 secret。
3. `MANUAL-CHAT-ATTACH-SLASH`：仅使用 `/new`、`/reproduce`、`/confirm-brief` 等直接命令；help/补全无 `/research`；按钮、拖拽、粘贴混合材料，暂停/刷新/恢复，scan/OCR/引用卡与 zh/en/aria 正确。
4. `MANUAL-CHAT-HARNESS-FREEFORM`：在 Brief confirmed 项目的 standalone Chat 中分别用 zh/en 输入开放讨论、状态问题、要求“继续/推进”、要求写作/审阅/生成发布包、要求运行实验/复现和要求批准 Gate。普通文本必须得到包含当前阶段、权威 NextAction 与 reason 的上下文回答，不能显示 `Unknown command` 或要求先敲 slash；状态问题执行只读 canonical operation。只在对应 NextAction 为 `ready + required=true` 时，“继续”或明确写作/审阅/发布包请求才执行 `/write`、`/review`、`/release-bundle`；blocked 时零写。实验/复现缺参数只显示可编辑命令，Gate/Brief confirm/Intake adoption/Release Decision 零 mutation。在请求期间切换 project/session，确认请求/回写仍只属于原 project/session；点击建议后焦点与 caret 在末尾。记录 project/session、projection、Network 与截图，状态 `NOT_RUN_MANUAL_PENDING`。
5. `MANUAL-SESSION-MULTI-PTY`：两个 Chat session、一个 Research session、父/子 subagent 各打开两个 PTY；切换/深链/detach/reconnect/resize/signal；确认输入只到对应 terminal。撤权、lease expiry、stale generation、跨 parent/跨项目全部拒绝；远端 PTY 复测同一 fencing。
6. `MANUAL-REPRO-MANUSCRIPT-CLEANROOM`：新 dataDir/无 checkout 隐式依赖环境重建 TeX/PDF，验证 Bundle preflight/hash、数据自包含、表图/PDF检查、signed RunManifest 与不可变 Report。
7. `MANUAL-DSH-DIRECT-CREATE-LINK`：在全新空 DSH session 不打开 standalone，直接输入“创建研究项目 OCR 复现”；确认 Harness 调用 `dsh_scholar` 并只传原文中的 exact `project_name`，同一条消息后页签显示 collecting Project、Init 当前阶段和 `intake_resume`，刷新/重放不产生第二个项目。再分别测试不带名称、名称字段与原文不一致、疑问句、中文/英文长否定句、`创建研究项目 Foo，不要创建`、`创建研究项目 Foo，然后取消`、`Create a research project named Foo, do not create`、`创建研究项目 Foo 不创建`、`创建研究项目 Foo 先别创建`、`Create a research project named Foo not create`、`创建研究项目 Foo 然后查看状态`、`Create a research project named Foo then show status`、主题讨论、并发双请求、活动 link、已删除项目墓碑 link 与人工构造的悬空 link，均不得创建或静默 relink；以空/空白专用 plugin token 启动 Kernel 时 internal create 必须拒绝；用 public v2 在 internal 前后以同 key 提交完全相同 route/session/name 原始字段，确认双向均冲突且不认领资源；分别模拟 Kernel 在 fetch、响应头、成功响应体读取/解析阶段丢失，确认 replay-only 对账后只显示一个同名项目。记录 Host 空白 shell 是否在首条消息后正常挂载 `dsh Scholar` view。
8. `MANUAL-EXECUTION-ENVIRONMENTS`：依次使用“本机开发 / Docker CPU / Docker NVIDIA / 远程 SSH”预设创建环境；Docker 分别选择两个已登记 digest，核对保存摘要、ExecutionPlan 与 RunManifest 完全一致。当前 Settings 尚无独立“测试连接”API/UI，须记录为明确产品缺口，并以提交受控 smoke Job 验证 spawn-time preflight，不能把静态保存成功当作已连接。GPU 主机上分别执行 `all` 与设备 `0,2`，CPU 模式不得获得 GPU；再移除 Docker daemon、NVIDIA Container Toolkit、驱动或指定设备，确认逐项诊断且容器未启动、无 CPU/本机 fallback。无真实 NVIDIA/第二 SSH 主机时记录 `NOT_RUN_MANUAL_PENDING`，不能用 mock 单测冒充通过。

以上均为 `NOT_RUN_MANUAL_PENDING`，需要记录 commit、环境、操作者、期望/实际结果、Report/截图/日志引用。

## 8. 全页面 Panel Dock 人工队列

`MANUAL-PANEL-DOCK` 对应 acceptance-tests.md §21 `ui-sidebar-dock-all-panels`，当前状态为 `NOT_RUN_MANUAL_PENDING`：

1. 在 1024 px 视口选择一个项目，先在 Settings → Preferences 启用 Budget，再依次检查 Chat、Overview、Approvals、Runs、Artifacts、Evidence、Budget、Manuscript、Run Terminal、Trajectory、Topology、Workspace、Interactive Terminal；每页点击“停靠到右侧”，从 Dock 选择器换页，再点击“停靠到底部”“打开到主区”“关闭”；
2. 检查任一页面在主区与 Dock 不同时出现两个活实例；右侧/底部互换前后 DOM identity、焦点、滚动位置、Chat 草稿/附件卡、Workspace/TeX dirty/选中文件/PDF Preview 不变；
3. 对活动 Run Terminal、PTY、Workspace watch 和 Trajectory 分别在输出/事件持续产生时移动；右侧/底部互换不重连，主区/Dock 变换允许重连但必须从最后 seq/revision 续接，无重复、缺口或旧 DOM 继续写入；
4. pointer 拖动分隔条；键盘使用方向键、Home、End；核对 separator role、orientation、value/min/max、按钮 aria、关闭/打开后的焦点恢复；
5. 刷新后核对活动页面、首选位置、right/bottom 两种尺寸；写入未知版本、未知 panel、越界值和损坏 JSON 后刷新，必须安全回默认；记录不得包含 localStorage 中的 token 或任何研究内容；
6. 在 720 px 与 640 px 重复关键路径：窄屏 right 首选只视觉显示 bottom，扩大视口后恢复 right；左侧 Project Sidebar 与 Panel Dock 的控件和语义不能混淆；切换 zh/en、light/dark 后 Dock chrome 即时更新且面板状态不丢失。

验收报告必须逐项列出 PASS/FAIL/BLOCKED。任何 FAIL 先回写 product-spec.md §5.13、gui-plugin-plan.md §2.3、acceptance-tests.md 与 hardening，再修代码。

## 9. 调研阶段空运行与刷新焦点人工队列

0. `MANUAL-BUDGET-PAGE-OPT-IN`：清除浏览器本地偏好并打开项目，确认“运维”菜单、Panel Dock 选择器和 Alt 快捷键顺序均不显示 Budget，手工输入 `#tab=budget` 也不能打开；在 Settings → Preferences 启用“显示预算页面”后立即出现，刷新仍保持。分别在 Budget 位于主区和 Dock 时关闭开关，确认主区回 Overview、Dock 关闭且无重复 renderer。制造预算超限后，在页面隐藏状态确认 Overview/Approvals 仍显示并可处理 Budget Gate，Kernel 用量与限制没有被禁用。重复 zh/en、640/720/1024 px、键盘与屏幕阅读器标签检查，状态记 `NOT_RUN_MANUAL_PENDING`。

1. `MANUAL-SURVEY-RUNS-SEMANTICS`：用真实 `/survey` 产生 frozen/complete Corpus Snapshot，确认项目进入 SURVEYING、NextAction 为 `idea_generate`、Jobs/Runs 为 0。zh 显示“调研已就绪”，en 显示“SURVEY READY”；Runs 空态说明调研已完成但尚无实验运行，Overview CTA 只导航不产生新对象。保存 projection/corpus/jobs/events 的脱敏摘要与 zh/en 截图。
2. `MANUAL-REFRESH-FOCUS`：在 auto refresh 开启下，依次聚焦 Project Sidebar 搜索、Chat composer、Terminal 搜索、Workspace editor/search 与 Manuscript editor；每个控件输入中英文和 IME 候选，把光标放在中间并设置选区/滚动。等待至少 17 秒并在另一会话触发一次 projection 更新，确认焦点、文本、选区、滚动和 dirty/草稿都不丢；focusout 后页面只补一次刷新。
3. 同时在 Run Terminal 和 Interactive PTY 产生持续输出；编辑控件聚焦期间 SSE/PTY 仍更新，PTY emulator DOM identity 不变。快速连点 Refresh/切换 locale/切换项目，确认延迟 API 响应不会乱序重绘。
4. `MANUAL-CHAT-NATURAL-TURN`：在 collecting 与 confirmed 项目分别输入普通中文/英文；collecting 只提交当前 Grill answer，confirmed 不得显示 unknown command。覆盖状态/想法/Gate/Jobs/Survey 同义句、歧义文本、Human-only 请求和附件内 prompt；再输入开放研究讨论，确认回答来自当前 DSH 模型且附权威 NextAction，停止 DSH model bridge 后确认回退为确定性阶段引导。保存解析 operation、执行/确认状态与最新 NextAction，确认无 Gate/adopt/release 绕过。
5. `MANUAL-CHAT-IDEA-GENERATION`：打开已完成调研且最新 Corpus 非空 frozen 的 `cnn测试` 项目，输入“生成几个idea，用来进行研究”，应生成并保存默认 3 张结构化 IdeaCard，回答不得是 `No IdeaCards`；刷新、打开 Ideas/Overview 后仍可见，所有 `corpus_snapshot_id` 与生成时 snapshot 一致。再测“我想让你提出五个研究假设”与 `/ideas generate 2` 的精确数量、`/ideas` 与“有哪些想法”的只读列表、否定句不写入。停止 DSH 模型、改为 blocked action、制造 revision 竞争和畸形模型输出，确认没有部分卡片；成功生成也不自动选择或批准 Idea Gate。保存 Network 的脱敏 `chat/ideas`、batch write 和 IdeaCard 投影证据。
6. `MANUAL-IDEA-SELECT-NEXT`：在上述 `cnn测试` 生成 3 张卡后刷新 Overview，NextAction 必须从 `idea_generate` 变为 Human `idea_select`；逐张候选可查看并有“选择并审计”按钮。选择一张后确认 Network 先完成 counter-search，再由单个 Kernel 写事务保存该卡 audit、推进 IDEATING、创建 payload 指向该卡的 pending Idea Gate；其他卡不被批准，Gate 仍需人工决定。断开 connector、并发刷新/重复点击、切项目和使用非 PI 角色，确认零部分写、无跨项目选择、无 payload-less Gate；最后批准 Gate 后才进入 IDEA_APPROVED。
7. `MANUAL-CONTRACT-NEXT`：在 `cnn测试` 批准 Idea Gate 后确认获胜 IdeaCard 显示 approved，Overview 出现可执行“生成实验合同草案”；点击、自然语言输入“继续”和 `/contract draft` 三种入口必须进入同一写路径。成功后检查 Project=CONTRACT_PENDING、仅一份新 draft Contract、仅一个 pending Contract Gate 且 payload.contract_id 精确匹配；拒绝后应重新出现生成/修订入口而非全 blocked。批准后 Contract=approved、Project=CONTRACT_APPROVED，下一步为可执行 baseline_reproduce。重复点击、并发刷新、非 PI、篡改 idea/project id 时不得留下 Contract/状态/Gate 的部分写。
8. `MANUAL-CONTRACT-BASELINE-HANDOFF`：批准 `cnn测试` 的 Contract Gate 后立即打开 Runs；即使 Jobs=0，也必须看到“基线运行待准备”任务、缺失的代码快照/可执行命令/实验环境和 Chat/Workspace/Settings 入口，不能看到无解释空白。先在 Chat 用自然语言要求准备基线，确认系统逐项追问且不伪造 Job；在 Workspace 创建/上传代码并冻结 CodeSnapshot，配置本机 Docker 或远端 SSH target，再提供 argv 启动。Network 中必须只有一次 atomic baseline-runs 请求；成功后 Project=BASELINE_REPRO、Runs 出现同一 queued Job、准备卡消失。重复发送、断网重放、stale revision、错误 snapshot/target/image 均不得产生第二个或半写 Job。保存 projection、Network、Runs/Chat/Workspace zh/en 截图，状态 `NOT_RUN_MANUAL_PENDING`。
9. `MANUAL-CHAT-SCROLL`：先在底部等待两次刷新和新消息，确认继续贴底；再上滚到历史中间，记录首条可见消息和像素偏移，触发流式回答、投影刷新、locale 切换、main/right/bottom Dock 与 A/B 项目/session 往返，确认不回顶、不强拉底；点击“跳到最新”恢复跟随。
10. `MANUAL-WORKSPACE-TEX-FACADE`：在 Workspace 打开 manuscript 的 `paper.tex` 与 `main.bib`，确认 tree/read 均成功、大小为有限值或 `0 B`、编辑/保存/刷新后仍可读；Network 中 generic nodes read 为 200，真正缺失路径才 404。
11. `MANUAL-CHAT-SLASH-CARET`：等待 DSH Chat 与 standalone Chat 初始加载完全稳定后分别聚焦空 composer，逐键输入 `/`、`s`；第一次 `/` 后必须立即看到非空命令候选，不能依赖再次聚焦或后台重绘。在菜单初开与候选 settle 后核对焦点仍在原 textarea、caret 分别为 1/2、最终值为 `/s`；这一步必须在浏览器 DevTools 中确认页面级监听收到的 retargeted target 不会误触发全局快捷键。再覆盖从非编辑区域触发全局 `/`、starter、命令面板和鼠标/键盘选择补全项，预填后继续输入必须追加在末尾。使用 IME、长按、后台刷新和会话切换重复，禁止 caret 跳到开头或候选不出现。
12. `MANUAL-ARTIFACT-PREVIEW-DOWNLOAD`：创建两个项目并登记相同 PDF 字节（共享 CAS blob、各自 Artifact scope），从两个项目各自的 Artifacts 页预览和下载；Network 必须含对应 `project_id` 且为 200，PDF iframe 内嵌预览正常，下载名为登记文件名而非 `.bin`/artifact id。再分别上传 PNG/JPEG/GIF/WebP/AVIF/BMP、MP3/WAV、MP4/WebM、Markdown/Rmd/Qmd、JSON/NDJSON/ipynb、CSV/TSV、代码/日志/TeX/Bib、HTML/SVG/XML、DOCX/XLSX/PPTX、ZIP/TAR.GZ、模型、Parquet/HDF5/NetCDF 与随机二进制：可预览族按格式展示且可下载，active/Office/archive/model/scientific/unknown 只显示安全元数据与按需下载，打开弹窗时 Network body 应被取消，不能出现脚本执行、乱码文本、解包或反序列化。用损坏 PNG、浏览器不支持 codec 验证可访问错误；用标准多行 ipynb、大整数/`-0`/重复键/16,000 层 JSON 验证类型与字面量不变且页面不卡死；覆盖超大文本、长列表/表格截断、zh/en、Shadow DOM 键盘关闭/下载/新窗口，并在下载未完成时关闭/切项目验证请求取消且无迟到下载。用 Range 请求验证 206、Content-Range/Accept-Ranges 与精确字节；切项目、关闭预览、连续打开多个产物后核对 Blob URL 全部回收。

13. `MANUAL-ARTIFACT-MANUSCRIPT-LIFECYCLE`：让 A 项目 Artifact 大文件预览/批量下载和 Manuscript PDF/preview-build fetch 保持未完成，立即切到 B 项目或离开 Artifacts/Manuscript 面板；确认 A 的请求与轮询被取消、A 的 PDF/构建/下载不会在 B 显示或迟到触发、Object URL 清零。制造 >2 秒且乱序的 builds/preview-builds 响应，确认每路最多一个 in-flight 且旧 response 不覆盖；连续两次 Compile 时权威区按新 build_id 替换 PDF、绝不显示 preview build；再构造旧 build 有 PDF、最新 succeeded build 无 `pdf_artifact`，确认权威与 preview 两区都立即清空旧 PDF；最新 queued/running/failed 时允许保留旧 PDF但 PDF 区必须显示 stale；让较新 succeeded build 的 PDF 请求 404/断网，确认仍展示的旧 PDF 因 build_id 不匹配明确标 stale。打开已有主 PDF 后在 TeX textarea 输入并把光标留在中间，确认主 PDF 无全页重绘地立即标 stale，textarea DOM、焦点与选区不变。脏保存的 preview hook、Compile 或 Regenerate 未完成时切项目，确认请求被取消且不对 B 继续提交/刷新；模拟 manuscript GET 401/500/断网，确认不会 POST ensure。分别用遮罩、Escape、关闭按钮关闭 Artifact 详情与预览，再切 zh/en，确认文案/ARIA 即时更新且焦点统一回到触发行；打开弹层后触发同项目背景重绘，再关闭时必须聚焦替换后的同 Artifact 行或安全面板控件。用无/错误 `Content-Length` 的 chunked >1 MiB 文本确认只读到预算即停止；用空 `Content-Type` + 登记 active MIME 确认仍只下载。

14. `MANUAL-BRIEF-CONVERSATION`：创建只有名称的项目并进入 standalone Chat；确认当前 Brief 问题像 assistant 消息一样位于 transcript 末尾，页面只有底部普通 Chat composer 可输入答案，绝不能再出现独立 Brief textarea/Submit 卡。分别用 composer 回答、问题消息上的“跳过”和“暂时未知”推进七题，核对 transcript 留痕、进度/placeholder/下一题、焦点与滚动；在回答请求期间切换 session/project、等待两次 8 秒刷新，并在 main/right/bottom 三种 surface 与 zh/en 间往返，不能重复问题、串写、丢草稿或抢焦点。全部处理后只在同一问题位置出现 Brief preview + PI confirm，确认前无 Scope Gate。
15. `MANUAL-DSH-BRIEF-QUESTIONS`：在真实 DeepSeek Harness 新 root session 中用自然语言创建 name-only 项目，确认 Chat composer 被 DSH 原生 user-question UI 接管，`dsh Scholar` 紧凑页签不出现第二套表单；每次只显示当前一题，free text、原生 Skip 和“暂时未知”都能推进且完整 Scholar 页面同步相同进度。中途取消、切换 session、让另一页面先回答当前题并恢复，必须 fail closed 或刷新到新题，不得重复/错项目写入。七题后原生 UI 退出，DSH 回复引导打开 Scholar 由 PI confirm，不能自动创建 Scope Gate。再停用 userQuestions provider，确认插件/提问明确 fail closed、零 answer 写入且旧内嵌表单不会重新出现；保存 zh/en、exact root/child agent、Network/Kernel audit 脱敏记录。

以上真实 IME、多轮询、自然语言模型路由和持续流观感在人工完成前均记 `NOT_RUN_MANUAL_PENDING`；自动 headless 回归不代替本队列。

## 10. DSH Scholar 会话入口与 Token 复制人工队列

1. `MANUAL-SHARED-KERNEL-PROJECT-PARITY`：启动 DSH Web 与 standalone，确认进程表只有一个 Research Kernel，endpoint identity 的 dataDir 为 `~/.dsh/research-kernel`，standalone BFF 目录中没有运行中的 `kernel.db`。使用同一 DSH 稳定操作员分别在 standalone 和不同 DSH session 创建项目；未绑定页签的项目选择项与 standalone 项目列表 project id/name/status/revision 集合必须一致，`cnn测试` 必须可见，其他 Principal 项目不得出现。任选一处重命名、归档并恢复，另一处下一轮刷新看到相同状态；Network 不得访问 17413 或旧 standalone Kernel。
2. `MANUAL-DSH-SCHOLAR-VIEW`：启动本机 standalone 与 DSH Web，确认会话顶部顺序为 Chat、Trajectory、dsh Scholar；打开未绑定会话后只出现项目选择、name-only 创建和“打开完整 Scholar”，DOM 内不得有 iframe、完整项目侧栏、Scholar 全局导航、Chat composer、Workspace 或编辑器。选择已有项目并绑定后只显示当前项目阶段、NextAction、Gate/Job 摘要；新会话输入名称创建后立即显示 collecting/Init。切换三页签后 Chat 草稿、焦点与 Trajectory 状态不丢。
3. 对已绑定 session 重复绑定同一项目应幂等；尝试绑定不同项目、归档项目、其他 Principal 项目、墓碑/悬空 link 或并发改绑必须失败且不改变原 link。mutation 未完成时切换 session，旧请求必须 abort，新页签不能遗留 busy/错误或迟到覆盖。
4. 在 Plugin config 把 URL 改为允许的 loopback 地址，重启 DSH 后显式“在新页面打开”和 `Alt+Shift+S` 必须同时指向新地址；新窗口必须无 opener/referrer。聚焦 Chat composer、Settings input、Workspace/TeX editor 与 Terminal 时按快捷键不得触发；IME composition、长按重复和插件 dispose 后也不得触发。
5. `MANUAL-DSH-CONFIG-COPY-STANDALONE-TOKEN`：打开配置卡但不点击复制，检查 DOM/aria/Network/Settings snapshot/URL/localStorage/sessionStorage/日志均无 Token；用鼠标和键盘分别显式触发复制，Clipboard 内容应精确通过 standalone `/api/token-check`，页面只显示“已复制”而不显示值。
6. 分别构造 Token 文件缺失、空值、超过上限、权限非 `0600` 与 symlink，确认 Clipboard 不变且仅显示本地化错误；拒绝 Clipboard 权限时不得创建 textarea/input fallback。确认 `kernel.token`、service token、Provider/SSH secret 无复制入口。
7. 切换 zh/en、light/dark 和 1280/720/640 px 窄容器，核对绑定/创建表单、阶段 grid、按钮、快捷键说明、复制成功/失败状态即时更新且键盘可达；窄容器只改单列，不出现横向压缩的完整 Scholar 页面。记录截图和脱敏 Network/Host 日志，状态为 `NOT_RUN_MANUAL_PENDING` 直到真实浏览器完成。
8. `MANUAL-STANDALONE-CSP-STYLE`：在 8443 独立新页面解锁工作台，Network 确认 HTML/client.js/API 均 200；DevTools 检查 ShadowRoot 主 `<style>` 带当前响应 nonce、`sheet.cssRules.length > 0`、`.panel` computed display 为 flex，控制台没有 `style-src` violation。刷新两次并确认 nonce 每次变化且布局仍正常。
9. `MANUAL-DSH-NEW-NAME-ONLY`：在全新空 DSH session 直接输入 `/new cnn测试`，不提供 `brief-json`；确认命令成功且 Kernel 只有一个同名 `DRAFT/collecting` Project、一个 active Init Intake、当前 session link 和零 Scope Gate。打开 `dsh Scholar` 页签，在可见态最多等待 4 秒，Host-owned session workspace 必须显示相同 project id/name/status/brief status 与 `intake_resume`；再打开完整 standalone，确认同一 project id/name/status/brief status 可见。用 `/new 名称 含空格` 验证完整名称保留，并用仅 `/new` 验证只有真正缺名才返回用法错误。

### 10.1 当前实现后的人工状态

- 旧的 DSH iframe smoke 证据不再适用于当前产品形态，不能用于验收新的 session workspace。
- 新的绑定/创建、窄容器、焦点、键盘、屏幕阅读器和完整工作台新页面流程均保持 `NOT_RUN_MANUAL_PENDING`，完成后按本节 1–9 记录环境、commit、Network 与截图。

## 11. 2026-08-20 数据升级连续性诊断与修复验收

- **历史故障。** 修复前权威 Kernel `~/.dsh/research-kernel/kernel.db` 有 11 个 Project、2 个 Workspace、3 个 Workspace node 和 3 个 Artifact；退役 standalone 库仍有 25 个 Project（`cnn-mnist-digits`、`demo-10step-live-1` 为 `RELEASE_READY`）、5 个 Workspace、9 个 Workspace node、179 个 Artifact、7 个 TeX document/14 个 TeX file。数据未物理删除，但未导入共享 Kernel。
- **根因证据。** 2026-08-17 的 shared-Kernel 切换把 standalone 默认 Kernel 从其 BFF dataDir/旧端口改为 `127.0.0.1:7412` + `~/.dsh/research-kernel`，并把旧 Kernel 标记为 retired；当时约束明确写成“不做静默合并”，但没有同时提供显式 inventory/adoption/import 流程或阻止空工作台启动。此行为不是物理删除，却违反“升级后继续既有研究”的数据连续性要求。
- **实现。** 正常 `KernelSidecarLifecycle` 不再自动发现、读取或修补退役 standalone 库，也不消费 `DSH_SCHOLAR_LEGACY_KERNEL_DIRS`；它只对 canonical `~/.dsh/research-kernel` 执行 backup-first 同目录 schema migration。跨目录接管必须在版本切换前由 Operator 显式、离线调用：先备份目标，再只读 snapshot 源库，在事务内完整合表/FK 校验，DB 成功后才逐文件校验/复制 CAS、Workspace、PTY workspace，全部成功才写 receipt。migration checksum 漂移直接拒绝，不能改写 snapshot。运行态只读一个 canonical Kernel，无双读/fallback。
- **真实数据接管：PASS（本机数据层 + HTTP，2026-08-20）。** 接管收据：`~/.dsh/research-kernel/data-imports/e65823a3-45b2-45c4-bf49-888a5c8ff1cf.json`；接管前备份 `kernel-2026-08-20T05-12-14-722Z.db` + inventory，Principal/receipt 升级前再备份 `kernel-2026-08-20T05-15-00-106Z.db` + inventory。新增 2,990 行、190 个文件；合并后 36 Project、182 Artifact、7 Workspace、12 Workspace node、7 TeX document、14 TeX file、64 Job、27 Run。稳定 principal `dsh:e8d7…` 对 36/36 项目有 membership。BFF `/v1/projects` 返回 200，active 列表含两个旧 `RELEASE_READY` 项目；两个旧 Workspace 的 `baseline/train/data` 节点通过 18610 BFF 均返回 200；`/api/model` 200，CSRF 正常，bootstrap HTML 不再包含 `notifyFrameReady`。
- **自动证据。** `tests/unit/data-upgrade.test.ts` 覆盖目标预存数据、源 checksum 历史漂移只在 disposable snapshot 审计修复、backup-first、DB/CAS/Workspace merge、源库不变、稳定 Principal 对源/目标项目接管、旧 receipt 升级与重复运行幂等；migrations 0027 把旧 `runner_profile` 一次性变成显式 `runner_profile_id:null`，不静默选择执行环境。整仓 unit `98 files / 1427 tests` + research-ui 两套 strict typecheck 全绿；`pnpm build` 全包与 plugin bundle 全绿；standalone HTTP `264/264`（新增默认 stable principal 正向/伪造负向）；docs verifier `22/22`、`git diff --check` 全绿。正式安装的 `/home/dev/.local/bin/dsh` 解析到 `@deepseek-ai/dsh@0.1.0-rc.8`；同一 profile dump 包含 `@dsh-scholar/research-plugin`，npm RC8 host 在隔离端口 3081 完成 ready→持续存活→SIGTERM exit 0，零 plugin load failure。Headless Chrome dump 未产生可判定 DOM，故不计浏览器 PASS。
- **剩余人工项。** 全新与已保存 token 的真实浏览器 console、zh/en/theme 视觉、Archived tab 全量 36 项、TeX/PDF preview 仍为 `NOT_RUN_MANUAL_PENDING`；不得用本节 HTTP PASS 冒充浏览器 PASS。旧源与两份备份暂不删除。

## 12. 方法论与知识层人工验收队列

以下项目在逐项记录环境、commit、操作者、脱敏 Network/Kernel audit、截图或终端证据之前，状态全部固定为 `NOT_RUN_MANUAL_PENDING`。纯 Module、Store 单元测试、headless projection 或测试文件存在都不能替代本节。

1. `MANUAL-METH-ASSURANCE-REVIEWER`：对同一冻结 TeX/Evidence 输入分别运行 deterministic、same-model、same-family、cross-family 与 Human reviewer。确认 execution、verdict、acceptance 三轴独立显示；same-family PASS 最多 provisional，cross-family/Human 符合策略后才可 accepted。停用指定 provider 或制造 timeout/畸形输出时必须 ERROR/BLOCKED，不能静默换 provider、沿用旧 PASS 或创建 accepted event。修改任一 input hash 后旧 Audit 立即 stale，历史保留，Release Gate 不被自动批准。
2. `MANUAL-METH-PROTOCOL-RUNNER`：在真实本机 Docker、远端 SSH 与 NVIDIA GPU target 上分别提交 exploratory、formal、confirmatory Job。无 Protocol、跨项目 Protocol、非 frozen、intent/hash/Contract/Code/Data/Environment mismatch 必须在创建 Job 前拒绝，jobs/runs/events 全零；exact pin 才可排队。confirmatory valid negative 只记录负科学结果而不把执行标失败；OOM、SSH disconnect、GPU 不可用只记录 infrastructure failure，不能生成 NegativeFinding 或 contradicted Claim。
3. `MANUAL-METH-SYNTHESIS-DIRECTION`：用真实 Evidence/Claim/Run 触发一次 Synthesis，确认输入 refs 与 revision 可追溯；输入变化后旧结果明确 stale。让 reviewer panel 提出 continue/refine/pivot/broaden/stop，确认页面只显示 proposal；pivot/broaden 必须由 Human 在专用 Direction Gate 中 adoption，拒绝、取消、并发 revision 竞争或部分 reviewer 失败均不直接修改 Project/Scope/Contract。当前纯 Research Graph、GET/typed Client、Topology counts，以及 durable Decision→专用 Direction Gate→strict proposal/synthesis/direction payload→Human PI/operator verified receipt 已有自动证据；人工仍须核对 UI 展示与确认动作、explicit/inferred、跨项目 404、历史 adoption 和节点/边计数。未实际完成该 Human workflow 与浏览器核验前不得记 PASS。
4. `MANUAL-METH-REGISTRY-ACTIVATION`：由 Operator 登记一个经过许可审核的本地 immutable fixture，核对完整 commit/hash/license/schema/capability；由 PI 对指定 project/session/phase/NextAction revision 显式激活，确认实际注入模式和 capability 等于 resolver 交集，Topology/Audit 不显示第三方正文或 secret。分别测试 explicit=false、license 非 `VENDOR_CLEAR`、equivocation、revoke、hash/phase/revision mismatch 与 remote URL/branch/tag，全部零 activation 写。未获得单独 vendor 授权前不得使用三个调研仓库的正文、模板、代码或品牌资产完成本项。
5. `MANUAL-METH-WRITING-TEX`：在真实 TeX Workspace 保存 document revision/hash，生成 ReverseOutline 与 Claim–Evidence ReviewFinding；切换 zh/en，确认 chrome/status/ARIA 等价，论文正文、引用和原始诊断不翻译。编辑文档后旧结果立即 stale，焦点、选区和滚动不丢；缺 accepted Evidence 的 Claim 只给弱化/补实验建议，不能虚构数字或引用。compile 成功但 review blocking 时 PDF 仍可预览、submission assurance 保持 blocked；任何 patch 必须用户确认且绑定当前 revision/hash。
6. `MANUAL-METH-UPGRADE-0028`：从包含 active/archived Project、Artifact/CAS、Workspace、TeX、Gate、Job/Run 的 schema 24 canonical backup 启动当前版本；保存 pre-upgrade inventory/hash，执行 backup-first 0028，创建 Audit、Protocol、Synthesis、Direction、Package/Evaluation/Activation、Outline/Finding，完整关闭并重启。经 standalone 与 DSH 两入口读取相同旧业务对象和新事件/revision；重复升级幂等，失败可恢复，downgrade loud fail，源库与备份不删除。
7. `MANUAL-METH-COMPACT-UI`：live Kernel HTTP/AuthZ、typed Client、standalone compact projection 与 DSH Host 原生 exact-session methodology summary 已存在，但本项仍为 `NOT_RUN_MANUAL_PENDING`。分别以 researcher、PI、Operator 和无 membership 用户打开 standalone Overview/Manuscript/Topology 的 main/right/bottom Dock；默认只显示当前阶段、唯一 NextAction 和 blocking，详情按需展开，不渲染完整外部 Pack 正文。修改 Audit input、TeX revision/hash 与 Synthesis snapshot 后，确认摘要从 live endpoint 复算 stale/ready，不保留旧值；注意 Synthesis 当前只复核 live Project/NextAction revision，不得声称重算其内容 hash。再在 DSH 切换两个 session/project，确认 panel 只显示各自 Protocol/Synthesis/Assurance/Writing/Knowledge/下一建议，迟到响应不串 session；Graph counts 当前只要求 standalone Topology 展示，完整 Graph visualization 与 DSH counts 不是已实现能力。覆盖 1280/720/640 px、键盘、屏幕阅读器、zh/en、light/dark、刷新与 delayed response；跨项目一律不可见。
8. `MANUAL-METH-CONFIG-DEFERRED-ABSENCE`：确认 Settings、`/v1/config/schema`、defaults/effective config、file/HTTP/UI 输入均不宣传八个已删除的 `methodology.*` / `knowledge_registry.*` 候选键；逐一写入必须以 unknown key fail closed，旧 effective config 与 config pin 不被伪造。确认 remote Pack 仍由 local-only Package Schema、resolver 与许可政策拒绝，而不是依赖一个不存在的 `remote_sources=disabled` 配置。未来若增加真实 consumer，本项必须先被新的 parity/restart/Settings 人工场景替代；当前不存在可供人工“调参”的方法论设置。
9. `MANUAL-METH-DSH-EXACT-SESSION`：在真实 DSH Host 创建两个 session 并分别绑定不同项目，核对 catalog 为 42；root/unknown role 只能调用 `dsh_scholar` 与七个 exact-session methodology tools，普通 research write 仍 deny。分别记录 Protocol、agent Synthesis、ReverseOutline/ReviewFinding，确认 strict body、stream CAS、author/project/session mismatch 在 HTTP 写前失败；`research_knowledge_activate` 必须只提交 package identity/CAS并出现 Host confirmation，取消保持零写，确认后由 Kernel 派生 PI/license/hash/evaluation/revocation/phase/NextAction/capability。`research_assurance_run` 的 semantic provider/family/independence 必须来自真实 durable reviewer child identity，模型字段不能改变结果。重启 DSH/Scholar 后 session link、records 与 compact summary 不丢；`research-core` 的自然语言引导不能制造 hash、revision、Human actor、Gate Decision 或 reviewer execution。
10. `MANUAL-METH-AUTHORITY-BFF`：在真实 standalone 浏览器与 Network 面板确认 browser body 无 session/phase/capability/principal 字段，客户端伪造身份头被 BFF 剥离；BFF 仅从当前登录 session 注入 principal session。未链接 session、切换到另一项目、并发 Project/NextAction 漂移必须零 Activation，当前项目合法 PI 路径才能追加。此项未实测前固定 `NOT_RUN_MANUAL_PENDING`。
11. `MANUAL-METH-AUTHORITY-REVIEWER`：在真实 DSH Host 分别运行同模型、同 family、跨 family reviewer，并核对 durable child 的 provider/model/family/config identity、parent action 与 terminal state；断开 provider、删除 identity 或跨 session 引用必须零 Audit。same-model/same-family 不得显示 accepted，Human acceptance 与 Release Gate 仍需独立操作。此项未实测前固定 `NOT_RUN_MANUAL_PENDING`。

完成报告必须逐项写 PASS/FAIL/BLOCKED，并区分 Module、Store、HTTP/AuthZ、Graph/Gate provenance、Runner/model、DSH Host/tools、Browser/TeX 与 Config/deferred boundary 八层。任何 FAIL 先回写 methodology-knowledge-layer.md、acceptance-tests.md §25、hardening-v0.2-status.md §19，再修代码；未执行的项继续保留 `NOT_RUN_MANUAL_PENDING`。