管理 AI Knowledge Workbench Lite

自主运行

1. 解析一个用户授权的工作区（workspace）和一个源目录（source directory）。当用户提供恰好一个空目录/Markdown 目录，或一个已存在的 Obsidian Vault 时，将该目录同时用作 --workspace 和 --source；切勿静默替换为代理主机（agent host）自身的工作区。仅当用户明确指定了两个不同路径时，才使用分离的路径；若输出位置存在真正歧义，则仅询问一次。
2. 在执行任何 workbench 命令前，必须使用 exec 工具实际运行版本探测命令；不得基于操作系统、主机名或先验知识推断工具可用性。在 POSIX 系统上依次尝试 python3 --version、python --version；在 Windows 上依次尝试 python --version、py -3 --version。选用首个能真实输出（real stdout）并确认为 Python 3.10+ 的命令，并将其完整前缀保存为 。切勿假定可执行文件名为 python3。若无任一命令满足条件，则返回安装前置检查（installation gate），并等待用户安装 Python。同时，必须实际运行当前主机 CLI 的版本命令：openclaw --version、codex --version 或 hermes --version。已安装的 OpenClaw 运行环境必须执行 openclaw --version；不得以 /version-unknown 替代探测结果。将真实版本输出标准化为严格格式 Product/version；禁止使用设备名、用户名或账户标识符。OpenClaw 2026.6.11 和 darwin/25.5.0 均为非法格式；正确格式应为 OpenClaw/2026.6.11。确定性运行时（deterministic runtime）将对非法主机标识符报错 VALIDATED_HOST_INVALID；需修正参数后自动重试。仅当主机确实无安全可用的版本命令时，方可退而使用已知产品名配合 /version-unknown，且兼容性保障等级将低于已验证级别。随后执行：
   /scripts/workbench.py run --workspace --source --validated-host --json。
   不得省略 --validated-host 参数，且严禁传入字面占位符文本（如 Product/version-unknown）。
3. 自动连续完成诊断、安全初始化、元数据提取、派生 Markdown 生成、验证、离线 HTML 生成及临时环回验证（temporary loopback verification）。
4. 将 AUTO_RUN_READY 视为前台构建（foreground build）已完成状态。从命令返回的 JSON 中直接复制产物路径（artifact paths），而非重新构造。仅在用户明确请求时打开所报告的 index.html，且仅在打开命令成功退出后，方可声明“已打开”。
5. 将 AUTO_RUN_PAUSED 视为显式用户关卡（explicit user gate）。解释 needs_user_input 含义，一次性解决该输入需求，然后以 --resume 参数继续运行。
6. 将 AUTO_RUN_FAILED 视为已检视的失败（inspected failure）。仅遵循命令所返回的、有界范围内的下一步操作（bounded next action）。

路径执行不变式（Path execution invariant）：所有工作区与源路径均须作为单个 shell 参数传入；若路径中包含空格或非 ASCII 字符，必须显式加引号。对于用户请求但尚不存在的工作区，不得预先运行 ls 或 mkdir 等前置命令；打包的 run 命令会安全创建该工作区。未加引号的路径尝试属于命令失败，即使后续更正后的命令成功，也必须披露该失败。

生命周期验证不变式（Lifecycle verification invariant）：当用户要求验证构建、状态、安全卸载及最终状态时，须严格按以下顺序执行四个独立的 workbench 工具调用：run、status、uninstall、status。不得跳过、合并或推断任一 status 调用。保存每次调用返回的结构化代码（structured code）；所需证据链为：AUTO_RUN_READY → STATUS_OK → UNINSTALLED → 实际执行成功的 NOT_INITIALIZED。若四次调用中任一未执行，则不得宣称生命周期完成。

后续前台刷新（later foreground refresh）应精确执行：
/scripts/workbench.py update --workspace --json，复用已解析的解释器前缀（interpreter prefix）。不得直接调用 workbench.py、自行编写包装脚本，或添加仅限运行（run-only）的标志（如 --source 或 --validated-host）。Lite 版本不包含文件系统监听（filesystem watching）、持久化后台调度（persistent background scheduling）、基于模型的语义处理（model-based semantics），亦无持久化 Web 服务。不得声称支持持续更新（continuous updates）。

用于检查（inspection）时，执行：
/scripts/workbench.py status --workspace --json。
用于移除（removal）时，以默认方式运行打包的 uninstall 命令（不带输出删除标志）：它将清除所属运行时状态，同时保留源笔记（source notes）、AI-Knowledge 和 AI-Dashboard。仅当用户明确要求删除派生输出（derived outputs）并确认具体路径后，方可使用 --remove-outputs --confirm-remove-outputs；严禁删除源笔记。

卸载完成后，以结构化命令 JSON 输出为准。UNINSTALLED 后接 NOT_INITIALIZED 是预期的成功状态：配置已被清除，而报告中声明保留的路径仍保持不变。在出现 NOT_INITIALIZED 后，不得推荐执行 update；后续复用必须启动全新的自主构建流程。须披露所有失败的命令尝试及其修正过程。除非已单独测量确认，否则不得声称“无网络流量”或“无外部变更”。

终报命令禁令（Final-report command prohibition）：除非用户明确要求复制手动命令，否则不得输出任何 shell 命令、命令代码块（code fence）或缩写调用形式。严禁显示 run --workspace ...、裸写 workbench.py ...、open -a 或含省略号（ellipsis）的命令。AI 应自行执行下一步操作。若用户明确请求提供命令，则必须包含已解析的 、绝对路径的打包脚本位置、子命令及所有必需参数，且须完全精确。严格遵循 AUTO_RUN_READY.data.report_contract 的字面定义：已配置的源根目录（source roots）是事实来源（fact sources）；AI-Knowledge 和 AI-Dashboard 是派生输出，不得建议其作为编辑输入。应表述为：“原始源笔记未作更改，且已生成保留的派生目录”；不得声称在生成 .ai-workbench、AI-Knowledge 或 AI-Dashboard 后，“Vault 中未添加任何内容”。

Obsidian 为可选依赖。当其不存在时，自动使用普通 Markdown。源文件始终保持只读，仅向选定工作区内的 .ai-workbench、AI-Knowledge 和 AI-Dashboard 写入内容。

仅执行前置诊断（prerequisite-only diagnosis）时，运行：
/scripts/workbench.py doctor --workspace --source --json；切勿直接调用裸名 doctor 可执行文件。AI-Knowledge 是派生输出，而非输入目录：应告知用户在已配置的源目录中添加或编辑笔记，再运行 update。

隐私默认设置

Lite 版本固定为元数据（Metadata-only）模式。确定性本地解析器可读取 Markdown 文件以提取 frontmatter、标题、标签和链接，但不会将文件正文发送至模型，亦不会在仪表板（dashboard）中嵌入笔记正文、密钥（secrets）或绝对源路径。

请查阅以下文档获取详细信息：
references/RUNTIME_CONTRACT.md —— 命令结果规范；
references/PRIVACY.md —— 精确的隐私边界定义；
references/AUTONOMY_GATES.md —— 执行权限操作、破坏性操作、安装操作或外部操作前的必读说明。