common-memory-core 0.2.0

package/docs/session-integration.md

@@ -0,0 +1,134 @@
+# 会话接入：当前实现与验收边界
+
+2026-09-09。此文替代历史记录中的 Pi 六条触发、每轮自动读、Codex 只读 Hook
+及退出只排队的描述。Canonical Markdown、Core 写权限和 MCP stdio 固定 capability
+没有改变；没有新增检索、索引、长期记忆 revision、监听同步或一致性协议。
+
+## 持久状态与处理链
+
+`src/v2/session.ts` 提供 SessionIngress：open、capture、settle、seal、end、status。
+身份是 client（pi/codex/chatgpt-work）＋processInstance＋真实 session ID 的摘要；真实结束后再启动附加独立 activation 标识，cwd 只用于范围选择。
+SQLite 增加 sessions、session_turns、session_messages、session_batches；旧 observations、
+leases、jobs、receipts、associations 继续承担队列与恢复职责。迁移幂等且事务化。
+用户正文存在 observations 一处，session_messages 只存其引用；assistant/tool 正文
+只作为上下文缓存。每条消息有稳定身份、角色、来源、顺序和摘要；重放相同消息是
+no-op，冲突拒绝。一个交互必须含实际已交付用户表达；候选输入不算轮。
+
+满十次 settled（含终止后的 interrupted）即原子封逻辑批次。未满十轮保持 buffered，
+不受 legacy 六条/字节/idle/flush 触发；退出将 open 标为 incomplete 并封尾。
+关闭屏障由 sessions.closing 与该 session 全部观察的持久状态共同构成。
+complete 要求 closing、全部处理成功且不存在 incomplete 回合；dead/quarantined
+或未完成尾轮保留 incomplete。空尾不制造证据。status 命令列出各 session 汇总，
+不打印正文；显式 retry 后状态可重新计算，不存容易失真的成功标志。
+
+Writer 的 `conversation_turns` 保留整轮消息关系。当前用户表达仍各自获得 ev 引用；
+assistant、工具、前轮上下文都是 context_only，不能单独作为 retain/forget 证据。
+跨批尾上下文通过旧 turn/observation 引用读取，无永久正文副本。forget、人工改文档
+导致来源失效、processed prune 都通过 SQLite trigger 同步清空同轮 assistant/tool
+正文；重放同身份不会复活正文。敏感上下文记录不可用；用户正文仍由既有 Writer
+安全扫描保护。引用、建议不会被预处理提升为用户确认。
+
+`conversation_context` 是单独披露权限，旧配置不会自动获得。未授权时会话请求包含
+不可用原因，legacy 前轮上下文也不再发送，不用 user_explicit 绕过。contextTailTurns 默认 2，最多读取同 session、
+同 scope 的已处理回合。Writer 先舍弃可选历史上下文，再按整轮拆请求；单轮连同
+用户确认与相关上下文仍超限则整轮隔离并保留正文。session、legacy relay 和两类
+import 不混批，模型输出仍是 memory_maintenance_v2。
+
+可选 sessionCache 默认 maxSessionBytes=8 MiB、maxTotalBytes=64 MiB、contextTailTurns=2。
+数字是保守工程默认，没有容量实证或远距离指代充分性保证。正文容量包含候选输入、
+交付缓存、session 正文、待交接 Codex/Work inbox 和唯一 host_snapshots 正文。超限事务回滚，保留已有数据及位置，
+终止信封无需新增正文空间。摘要、状态、receipt 等元数据不计入正文容量。
+
+## 宿主适配
+
+Pi 0.84.4：`src/pi-extension/` 保留来源候选匹配、变换/混合来源隔离、稳定 Entry
+绑定。最终 agent_settled 封口；tool loop、retry、compact 不计数。真实 quit 才 end，
+reload/new/resume/fork 的 extension shutdown 只关闭本地资源。进程随机身份与附加
+记忆块通过 globalThis 保留跨 reload 状态；数据Root＋session 冻结附加块，每轮与
+当时的宿主 systemPrompt 组合。startup 读一次，后续生命周期不补读；原生 memory_read
+及 promptSnippet/promptGuidelines 按当前授权主动读取。Pi 直接写公共 ingress。
+
+Codex 0.153.4：`src/cli/codex/transcript-0.153.4.ts` 独立解析 rollout。只认该版本
+session_meta 与已知顶层记录。user_message 与 item_completed/UserMessage 是交付来源；world_state、token_usage_record 为非证据记录；response_item 中环境、hook
+和 compact 重放的 user 消息不成为证据。task_started 分组，task_complete 或
+turn_aborted 确认终态；Stop/Interrupt 只登记核对，不假定其时 transcript 已写终态。
+UserPromptSubmit 候选按 session/turn/digest 独立保存并冻结输入时的 scope，user_message 必须精确匹配；
+匹配成功在同一事务清空候选正文并转存交付，保留摘要用于重试。候选不当作已交付证据，
+也不作为自动记忆返回正文。无法匹配时保留 inbox，明确报告未确认交付。
+
+`src/cli/host-session.ts` 是 Codex/Work 共享 adapter（codex-session 保留兼容导出），将尾部 JSONL 正文和信封放进同一 runtime.sqlite 的 durable
+inbox，SQLite WAL＋synchronous=FULL 提供原子、fsync 持久性。Hook 使用 150ms SQLite
+busy timeout，生成器给三秒宿主期限；不在 hook 内运行模型。首次合格 startup/resume 读取有界快照；普通轮次不重复追加。compact/clear/reload 只重挂缓存。显式刷新由 PostToolUse 或下一 UserPromptSubmit 交付。进程身份取 Linux/WSL boot ID＋Codex 祖先进程 PID＋
+启动时间；PID 复用和不同工作目录不会错误共享 session。未知版本、路径替换、未确认交付、
+尾部不完整或容量不足均显式失败，不前移消费位置。SessionEnd 快照不依赖退出后文件存在。
+
+`src/cli/session-drain.ts` 使用 detached＋独立 stdio＋unref 启动真正的 configured Writer。
+它先事务性将 inbox 正文转为 session 状态，同事务删除副本；Stop 核对会继续读取后续
+终态记录，不等待下一输入。单次核对最多 60 秒，失败保留 durable watch。消费者使用
+`src/v2/session-drain.ts` 等待正常租约、退避，直到已封工作处理或 dead/quarantined。
+消费者崩溃后可由下一次写端事件或 `common-memory session-drain` 恢复；不会清空数据。
+父宿主与 MCP 退出不会撤销独立消费者。kill、重启、磁盘失败不承诺正常结束保证。
+
+两端共用 `src/v2/read-guidance.ts`。缺少用户背景/偏好/兴趣/目标/工作方式/项目约束时
+主动读，例如个性化最优化课程推荐、按研究方向比较项目；普通梯度下降解释或已具备
+充分个人上下文不机械读。contextId 只选授权范围，空结果不是负面个人事实，缺项未知。
+
+## 验收证据与限制
+
+- `tests/v2/session.test.ts`：A/B 各九轮隔离，第十轮 settled 即可领取；21 轮形成
+  10＋10＋1；steering、重复交付/封口、容量回滚、incomplete 尾轮、混合来源隔离、
+  独立上下文权限、forget 清理后重放不复活、完整回合拆请求和真实退避等待。
+- `tests/cli/codex-hook.test.ts`：一次启动读取、新进程恢复、compact 不补读；Stop 重复
+  且终态延迟写入；排除 response_item 用户环境文本；删除 transcript 后仍交接尾批；
+  未知格式保留 inbox、版本拒绝、部分行拒绝、输入/快照上限、五种事件配置。
+- `tests/v2/pi-integration.test.ts`：保留交付认证、队列来源、图片隔离；冻结附加块与
+  宿主新 systemPrompt 组合、reload 保留快照。
+- `tests/cli/session-drain.test.ts`：实际 Node 宿主退出与 MCP EOF 后才释放本地假提供者，
+  独立消费者仍提交 canonical Markdown、receipt 与完成状态；强杀消费者后显式重启恢复。
+  这不是只验证 Node 子进程能存活，而是执行实际 configured Writer 与 Core 提交。
+
+## Work、activation 与刷新
+
+host_activations 在同一 Runtime 保存 client、原生宿主实例、真实 thread、cwd 和 active
+状态；host_snapshots 只有每个 activation 的唯一正文 slot 与 pending 标志。真实
+SessionEnd 入队时关闭 activation 并删除 snapshot，不提前关闭待消费 session 或删除
+尾批。再次合格 startup/resume 创建独立 session key。unsubscribe 不映射 SessionEnd。
+刷新依赖宿主祖先进程身份及 CODEX_THREAD_ID，无法唯一定位就失败；读取和替换在同一
+事务中，容量失败也回滚。普通 memory_read 不接触该 slot，read MCP 不打开 Runtime。
+同进程 resume 不重读；compact/clear/reload 重挂已有块；新进程首次 resume 自动读取。
+
+`work-config --mode posix|windows-wsl --output <absolute-directory>` 生成可检查配置、
+显式 memory-refresh Skill 和必要的 PowerShell bridge。无法从环境确定 agent 模式时
+要求选择，不用终端类型或 WSL_DISTRO_NAME 代替。`codex-config` 同样支持 bundle 参数，
+无参数继续打印 profile。共用 host-launch 固定 Node、CLI、home 与 WSL distro/user。
+Work 的 read 和 init 分进程；init 保留 chatgpt-desktop identity，Codex profile 禁用 init。
+所有 Hook 均保留宿主信任机制，不写信任 store、不生成绕过选项。
+
+Windows bridge 从原生祖先进程读取 PID/CreationDate，转换 cwd/transcript 路径，使用
+UTF-8 STDIO 并保留退出码；生成 ps1 含 UTF-8 BOM，兼容 Windows PowerShell 5.1。
+启动器宜安装到 Windows 本地路径：UNC 脚本可能被本机签名策略拒绝，生成器不改策略。
+macOS 直接使用绝对 POSIX 启动参数，身份取 ps 的 PID/启动时间。WSL 内的 agent 使用
+直接 POSIX 模式。Linux 检查不代表 Desktop 在 Linux 上的产品支持。
+
+新增 `tests/cli/work-session.test.ts` 验证 A→B 刷新后 canonical C 不渗入、空 prompt
+显式 Skill 路径、重复刷新、失败/容量回滚、客户端/线程/进程/重新启动隔离、十轮
+item_completed 交付及旧格式去重、未确认内容保留 inbox、配置与 Skill invocation policy。
+`node scripts/smoke-work-bridge.mjs` 是构建后的 Windows→WSL 合成宿主实测入口，使用
+本地假提供者执行 configured Writer/Core；无真实模型调用或个人资料。
+
+协议依据：[官方 Hooks](https://learn.chatgpt.com/docs/hooks)、
+[官方 MCP](https://learn.chatgpt.com/docs/extend/mcp)、
+[Windows agent 环境](https://learn.chatgpt.com/docs/windows/windows-app)。
+rollout 不是稳定公共接口，未来版本需要新适配与新验收。
+
+真实 Desktop UI 的 Hook 信任、真实模型主动读取与完整真实客户端事件组合尚未验证。
+macOS 本轮只有逻辑与配置生成验证，真机验收留给后续测试者；Linux 测试不证明 Windows CI。
+
+最终验证（Node 24.20.0）：`node scripts/verify.mjs` 通过 typecheck、58 源文件边界
+检查、32 测试文件 / 387 项测试和 build；构建后 `npm run test:consumer` 通过真实
+tarball typed consumer、prompt asset、Writer、Pi load 与 CLI startup。生成的 Work
+和 Codex Skill 均通过 skill-creator quick_validate，invocation policy 另由测试断言。
+Windows PowerShell 5.1 → Ubuntu WSL 的合成宿主测试验证 Unicode STDIO、原生实例
+身份、路径转换、A→B 刷新不被 C 覆盖、退出码，以及父宿主退出后 configured Writer/Core
+提交 canonical Markdown；同脚本还独立验证直接 WSL 祖先进程身份及启动读取。
+此项是合成宿主的真实跨边界执行，不等同于 Desktop UI 验收。

package/docs/tui-workbench.md

@@ -0,0 +1,173 @@
+# Common Memory 交互工作台
+
+## 设计判断与调研依据
+
+统一的是用户的操作旅程，不是协议、宿主生命周期或授权来源。默认运行
+`common-memory` 打开一个持续运行、可以返回的任务工作台；自动化命令和协议
+入口继续存在。采用已有 Clack 的菜单、表单、分页查看，不引入全屏渲染框架、
+第二份业务实现或新的后台服务。
+
+本次调研核对了以下官方／项目一手文档，设计借鉴不等于性能实测：
+
+- [Command Line Interface Guidelines](https://clig.dev)：人类优先但保留组合能力；
+  仅在 TTY 提示；明确确认危险操作；取消不能伪装成功。
+- [Lazygit 导航](https://lazygit.dev/docs)及[项目快捷键](https://github.com/jesseduffield/lazygit/blob/master/docs/keybindings/Keybindings_en.md)：
+  以当前对象和任务组织操作，导航／上下文动作可发现。借鉴分区和逐层进入，
+  **不**照搬 Git 面板、快捷键数量或 Undo 能力。
+- [Clack Prompts](https://bomb.sh/docs/clack/packages/prompts)：沿用 select、
+  multiselect、text、password、confirm 和 cancel。API 与取消键同时核对了本地
+  已安装的 `@clack/prompts` 类型声明和 `@clack/core` 实现。
+- [Codex Hooks](https://learn.chatgpt.com/docs/hooks)：非托管 Hook 必须通过宿主
+  `/hooks` 检查和信任；多个来源的 Hook 可以同时运行，生成文件不等于启用。
+- [MCP stdio](https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/stdio)：
+  stdout 只能传协议消息，不能混入 TUI 提示。
+- Pi 官方安装包中的完整 `README.md`、`docs/packages.md`：本地 package 使用
+  `pi install <path>`／`pi remove <path>`；`pi list` 检查注册，`pi config` 管理资源。
+  工作台交给 Pi 自己执行这些命令，不实现另一套 Pi settings/trust 编辑器。
+
+阅读本仓库 `AGENTS.md`、README、[架构](03-target-architecture.md)、
+[会话接入](session-integration.md)和 CLI/MCP/Pi/宿主适配代码后，确认以下边界：
+Markdown 是事实来源；Runtime SQLite 是持久队列，不是可重建索引；TUI 不增加
+写权限、检索、跨项目读取、导入的用户证据地位或 MCP capabilities。
+
+## 原入口清单与归属
+
+| 原入口 | 性质 | 工作台位置／保留理由 |
+| --- | --- | --- |
+| 无参数 TUI：Status/API/Network | 人类入口 | 改为完整 Home 和六个任务分区 |
+| `config`、`config --network` | 人类表单快捷入口 | Settings；保留直接表单快捷方式，非 TTY 明确失败 |
+| `status`、`show` | 人类＋自动化 | Overview、Memory；保留脚本输出，查看走同一业务函数 |
+| `import` | 人类＋自动化 | Memory 导入向导；仍调用同一 Writer 入队／处理路径 |
+| `project register/list/remove` | 人类＋自动化 | Projects & permissions；CLI 参数和注册语义保留 |
+| `retry`、`flush` | 运维＋自动化 | Maintenance；保留脚本退出码、正常退避和租约行为 |
+| `network-test` | 显式诊断＋自动化 | Settings；用户确认后才发合成请求 |
+| `mcp-config` | 配置生成＋自动化 | Integrations 预览／导出；继续提供 stdout TOML |
+| `codex-config`、`work-config` | 配置生成＋自动化 | Integrations 预览／导出 bundle，CLI 继续支持无人值守生成 |
+| `mcp` | **机器协议** | 保留独立 stdio，固定 relay/init/read；不得显示 TUI |
+| `codex-hook`、`work-hook` | **宿主 Hook 协议** | 保留 JSON stdin/stdout、持久 inbox 和宿主身份 |
+| `session-drain` | **机器消费者**＋显式恢复 | 保留 detached 使用；工作台可前台启动同一入口并等待结果 |
+| `session-refresh` | **宿主身份相关操作** | 保留显式 Skill 命令；不能由 TUI 用 cwd 猜测活动会话 |
+| Pi Extension、`memory_read`、`/memory-flush`、`/memory-refresh` | **宿主生命周期／会话内交互** | 保留原生入口；外部工作台不能替换它们的会话上下文 |
+| Codex/Work 的 `/hooks`、宿主 MCP 设置 | **宿主所有的信任和启停** | 工作台提供安装／停用说明，不修改 trust store |
+| 本地 `config.json`、private `.env`、Canonical Markdown | 用户所有的文件 | 不隐藏、不迁移、不删除；设置表单复用配置验证和私有文件写入 |
+
+没有删除已有命令；CLI 和 TUI 是同一产品的两种操作方式。
+
+## 最终信息架构
+
+```text
+common-memory
+  Home（当前 model/API、dataRoot、导航提示；未配置时只提供配置和退出）
+  ├─ Overview
+  │   ├─ 配置／真实存储路径／密钥是否存在／网络选择（不是连通性结果）
+  │   └─ 队列摘要、刷新、转入维护
+  ├─ Memory
+  │   ├─ 选择 global／已注册项目 → 文档 → 分页查看
+  │   └─ Markdown 导入：文件、范围、作者、标签、处理方式 → 确认 → 结果
+  ├─ Projects & permissions
+  │   ├─ 注册、项目详情、只移除注册
+  │   └─ 独立选择 disclosure scopes、writable scopes、provenance
+  ├─ Integrations
+  │   ├─ 本地就绪条件（宿主状态明确标为未验证）
+  │   ├─ Pi：确认后交给 pi list/install/config/remove
+  │   ├─ Codex：会话 Hook + read MCP + 显式 refresh Skill bundle
+  │   ├─ ChatGPT Work：会话 Hook + 独立 read/init MCP + refresh Skill bundle
+  │   └─ MCP-only：独立 init/read 配置块预览／导出
+  ├─ Maintenance
+  │   ├─ 队列／job 诊断／dead job retry／无正文 session 摘要
+  │   ├─ flush：处理队列，不封未结束的会话尾批
+  │   └─ session-drain：恢复持久 handoff，等待正常租约／退避
+  └─ Settings
+      ├─ model、显式 API 模式、可选密钥更新
+      ├─ network、proxy、CA；单独确认的合成连通测试
+      ├─ 授权（复用同一表单）
+      └─ advanced：输出／thinking 参数、调度／cache／字节限制、切换 dataRoot
+```
+
+高级参数在工作台内编辑受验证的 JSON 对象，不引入另一份参数 schema；切换
+API 会说明并清除不兼容的 thinking 参数，其他设置保留。切换 dataRoot 是
+**选择另一个 store**，不是迁移，需要先停止客户端；原 Markdown/SQLite 不动。
+
+上下键、Enter 和多选 Space 沿用 Clack；每个分区有 Back。表单 Esc/Ctrl+C
+返回当前分区，分区菜单取消返回 Home，Home 取消退出。操作失败留在分区内显示，
+不污染下一次操作的退出码。只在 stdin 和 stdout 都是 TTY 时打开界面；无参数
+非 TTY 输出入口说明并退出，直接配置表单非 TTY 报错，不等待输入。
+
+文档查看是同一次授权读取的分页快照，重新打开 Browse 获取新内容；没有检索、
+排名、跨项目汇总或直接编辑 Canonical 的新接口。终端控制字符可见转义，只影响
+TUI 呈现，原 Markdown 和消费者／CLI 原文不变。状态只显示计数、ID 和受控诊断，
+不打印用户、assistant/tool、inbox 正文。现有 Runtime 存在时状态路径仍通过
+RuntimeStore 打开，可能执行其已有幂等 schema 初始化；不是全新的数据库只读模式。
+Runtime 不存在时不创建它。MCP read-only 进程的“从不开 Runtime”边界不变。
+
+## Integration management 的界限
+
+生成前必须自行选择宿主运行环境（同一 POSIX 或 Windows→WSL），不能仅根据
+`WSL_DISTRO_NAME` 推测桌面进程在哪里。可选项目来自本地 registry，未授权项目有
+明确提示，生成过程不自动添加授权。配置、Skill 和可选 PowerShell bridge 均可
+分页预览；确认后才写文件，不携带 API key 或代理秘密。
+
+工作台 bundle 选择新目录；自动化生成器仍兼容已有目录，但先检查所有目标文件
+是否冲突、bundle 内目录是否为 symlink，再开始写文件，使用独占创建，不覆盖
+旧文件。检查到后面的 Skill 文件冲突也不会先写前面的 TOML。磁盘中途失败可能
+留下部分新 bundle，需要检查错误并使用新目录重试，不假装全部成功。
+
+Codex/Work/MCP 的宿主配置合并、Hook 信任、MCP 启停仍由宿主所有者完成。
+工作台提供步骤和移除说明，没有通用宿主配置自动编辑器，也不写信任 store。
+Pi 可以从工作台确认后调用 PATH 上的官方 `pi` 管理命令，使用 argument array、
+继承终端并固定当前 COMMON_MEMORY_HOME，不拼 shell 命令。成功退出只证明该
+Pi 命令结束，不证明扩展正在捕获或真实模型已读到记忆。
+
+session-refresh 必须来自实际宿主实例＋thread，继续在会话内执行。
+session-drain 的工作台动作前台启动原机器入口；Ctrl+C 停止该 consumer，持久
+未完成工作留待恢复。flush/import/network-test 在进程内复用既有操作，取消信号
+传给对应模型请求。保存配置不执行网络测试、不热更新／热撤销现存客户端。
+
+## 关键解耦
+
+- `src/cli/operations.ts`：共享状态快照、授权读取、项目注册／移除、retry；
+  `main.ts` 和 TUI 都调用这些函数，没有各自一份 SQL／权限选择／锁实现。
+- `tui-settings.ts`：配置表单、状态格式；保留可选 sessionCache、旧 proxy 字段缺省、
+  未修改的密钥和 CA。保存前检查配置是否被外部编辑，防止长时间表单覆盖已观察到
+  的新版本；这不是多个配置文件的原子事务或完整的并发锁协议。
+- `tui-prompts.ts`：TTY、返回／取消、错误隔离、终端文本和分页呈现。
+- `tui-integrations.ts`：宿主工作流和就绪说明；生成内容仍来自原 generator。
+- `work-config.ts`：准备／渲染与写 bundle 分开，CLI 和 TUI 共用，预览没有文件写入。
+- `interactive-process.ts`：有界的原生宿主／消费者命令交接，不调用 shell。
+- import/flush 使用原函数；network-test 加可注入日志和取消信号，仍不打开 SQLite。
+
+没有修改 Core、Writer 决策协议、scope/provenance 映射、MCP 或 Pi capture 代码。
+配置保存仍由现有 validator 和 private file writer 完成。secret 和 JSON 是两个
+独立私有文件，不承诺它们跨文件提交的原子性。
+
+## 验证与剩余限制
+
+测试入口：
+
+- `tests/cli/tui.test.ts`：真实业务配置／文件＋脚本化 prompt 驱动导航，覆盖取消、
+  错误、授权分离、导入/flush/probe/recovery 路由、配置保留、终端转义和 Pi 交接。
+- `tests/cli/workbench-entries.test.ts`：真实子进程非 TTY/CLI、机器错误通道、
+  scope 隔离、无正文 job/session 状态、bundle 冲突／symlink 和共享生成结果。
+- `tests/cli/network-test.test.ts`：合成 probe 输出、取消信号和连接／监听器清理。
+- 既有 import、MCP、Pi、Codex/Work、session-drain 测试继续覆盖下层真实路径。
+
+完整 gate 使用 Node 24.x：`node scripts/verify.mjs`；构建后追加
+`npm run test:consumer`。无需个人记忆、真实模型或生产集成设置。
+
+本次结果（Node 24.20.0）：
+
+- 完整 gate 通过：typecheck、63 个源文件边界检查、35 个测试文件／425 项测试、build。
+- tarball consumer 通过：typed consumer、维护 prompt asset、Writer、Pi load、CLI startup。
+- 构建产物的真实 Linux PTY 冒烟通过：Home→Overview→Memory、授权文档分页、
+  终端 resize、逐层 Esc 返回和正常退出；确认未创建 SQLite、未改变 Markdown。
+- `git diff --check` 通过。没有调用真实模型，也没有安装／修改用户生产宿主配置。
+- 首次全量 gate 暴露了预览测试的分页断言错误，已修正；另一个既有网络测试依赖
+  `.invalid` 必然 DNS 失败，但此环境实测解析成 `198.18.0.87`。测试改为受控
+  `dns.lookup` 返回 ENOTFOUND，仍经过真实 NetworkClient 的错误处理；生产网络
+  代码未因该测试改变。复验全部通过。现有 TLS-IP 弃用和 SOCKS5 实验性警告仍存在。
+
+尚未覆盖：真实 Desktop UI 的信任、宿主配置合并后的端到端启用；本次 Linux
+终端检查不证明 Windows/macOS 真机体验或 CI。宿主安装和存活状态不做猜测，
+必须在宿主核验。不存在统一的一键暂停所有消费者／撤销已披露记忆的能力。
+已损坏或不支持版本的配置仍 fail closed，需要先在文件中修复；没有静默重置或
+迁移。高级参数仍是受校验 JSON 表单，不是每个参数独立控件。