dsh-plugin-dev-kb 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-plugin-dev-kb contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# dsh-plugin-dev-kb
+
+DeepSeek Harness（dsh）**插件开发知识库**：把官方文档站点
+<https://deepseek-harness.github.io/deepseek-harness/> 的全部内容整理为 dsh 原生可用的形态。
+
+## 这是什么
+
+- **站点完整镜像**：官方文档（VitePress）由仓库 `deepseek-ai/deepseek-harness` 的 `docs/` 原始 Markdown
+  投影生成（链接已按站点路由重写，与线上逐字一致）。中英双语共 168 页。
+- **补充文档**：仓库 `docs/` 中未发布到站点的 50 篇开发参考（术语表、防御模式、模块图、测试策略、事故复盘、i18n 规范等）。
+- **agent 友好**：`skills/dsh-plugin-dev-kb.md` 技能让 dsh 在插件开发任务中自动加载，获知知识库位置、
+  主题导航与检索策略；`kb/meta/topics.md` 按任务场景映射要读的文件；`kb/meta/search-index.json` 提供全量检索。
+
+## 安装 / 挂载
+
+插件目录放在 `D:\dsh\plugins\dsh-plugin-dev-kb\`（与本机其他 dsh 插件同级）。
+`cordis.patch.yml` 声明 `- insert: { id: dsh-plugin-dev-kb, name: dsh-plugin-dev-kb }`，
+挂载为 profile 根层插件行；其 `skills/` 技能进入全局层。
+
+> 重新启动 / 新建 dsh 会话后，`dsh-plugin-dev-kb` 技能才会出现在可用技能列表中（技能清单在会话启动时快照）。
+
+## 目录结构
+
+```
+dsh-plugin-dev-kb/
+├── cordis.patch.yml   挂载声明
+├── package.json       插件元数据
+├── skills/
+│   └── dsh-plugin-dev-kb.md   ★ 知识库使用指南（agent 加载此技能）
+├── kb/
+│   ├── site/          站点镜像：guide/ develop/ reference/（+ en/ 英文站）
+│   ├── extra/         仓库补充文档：glossary、defensive-patterns、module-graph、postmortem/、i18n/ …
+│   ├── meta/
+│   │   ├── topics.md         ★ 主题导航：任务场景 → 文件
+│   │   ├── search-index.json 全量索引（220 文件）
+│   │   ├── source.json       来源 commit / 时间 / 统计
+│   │   └── site-pages.txt    线上页面清单
+│   ├── INDEX.md        站点 URL ↔ 本地文件 对照
+│   └── README.md       知识库总览与更新方法
+└── LICENSE
+```
+
+## 使用
+
+- **agent 侧**：写插件 / Tool / 配置 / 服务 / 事件 / 打包 / LLM 适配器时，加载
+  `dsh-plugin-dev-kb` 技能 → 读 `kb/meta/topics.md` 定位 → 按需 read/grep。
+- **人侧**：直接浏览 `kb/` 目录，或打开 `kb/INDEX.md` 按 URL 对照查阅。
+
+## 更新知识库
+
+见 `kb/README.md`：重新克隆 `deepseek-ai/deepseek-harness`，安装投影依赖后运行
+`scripts/project-doc-site.ts` 生成 `website/.generated/`，覆盖 `kb/site/`，再重新生成索引。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-plugin-dev-kb bundle patch：DeepSeek Harness 官方文档知识库
+#
+# 挂载为 profile 根层的一个插件行（与 dsh-base / dsh-web-app 同一平面）。
+# 插件无 JS 代码（纯文档数据），skills/ 下的 dsh-plugin-dev-kb 技能进入全局层，
+# 每个会话的 agent 在插件开发 / 查询 dsh 能力 / 写 Tool / 配置 cordis.yml 类任务时，
+# 会根据技能 description 自动加载本技能，从而获知知识库位置与阅读路径。
+#
+# 知识库数据在插件内 kb/ 目录（site/ 站点镜像 + extra/ 补充文档 + meta/ 主题导航与索引）。
+# 更新知识库：见 kb/README.md（重新克隆 deepseek-ai/deepseek-harness 并运行站点投影器）。
+- insert:
+    - id: dsh-plugin-dev-kb
+      name: dsh-plugin-dev-kb

package/kb/INDEX.md

@@ -0,0 +1,210 @@
+# DeepSeek Harness 文档索引
+
+> 由 `scripts/rebuild-index.mjs` 自动生成。共 168 个站点页面（中英双语），另有 53 个补充文档在 `extra/`。
+
+## 中文站点（根路径）
+
+### 首页
+
+| 页面 | 站点 URL | 本地文件 |
+| --- | --- | --- |
+| site/index.md | [https://deepseek-harness.github.io/deepseek-harness](https://deepseek-harness.github.io/deepseek-harness) | `site/index.md` |
+
+### 入门（/guide/）
+
+| 页面 | 站点 URL | 本地文件 |
+| --- | --- | --- |
+| 配置模型 | [https://deepseek-harness.github.io/deepseek-harness/guide/providers](https://deepseek-harness.github.io/deepseek-harness/guide/providers) | `site/guide/providers.md` |
+| Python SDK 快速上手 | [https://deepseek-harness.github.io/deepseek-harness/guide/python-sdk](https://deepseek-harness.github.io/deepseek-harness/guide/python-sdk) | `site/guide/python-sdk.md` |
+| 使用 Web UI | [https://deepseek-harness.github.io/deepseek-harness/guide/quickstart](https://deepseek-harness.github.io/deepseek-harness/guide/quickstart) | `site/guide/quickstart.md` |
+
+### 开发（/develop/）
+
+| 页面 | 站点 URL | 本地文件 |
+| --- | --- | --- |
+| 插件配置 | [https://deepseek-harness.github.io/deepseek-harness/develop/basic/config](https://deepseek-harness.github.io/deepseek-harness/develop/basic/config) | `site/develop/basic/config.md` |
+| 第一个插件 | [https://deepseek-harness.github.io/deepseek-harness/develop/basic](https://deepseek-harness.github.io/deepseek-harness/develop/basic) | `site/develop/basic/index.md` |
+| 打包与安装插件 | [https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish](https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish) | `site/develop/basic/publish.md` |
+| 开发一个工具 | [https://deepseek-harness.github.io/deepseek-harness/develop/basic/tool](https://deepseek-harness.github.io/deepseek-harness/develop/basic/tool) | `site/develop/basic/tool.md` |
+| 1. 编写第一个插件 | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/01-first-plugin](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/01-first-plugin) | `site/develop/cordis-tutorial/01-first-plugin.md` |
+| 2. 生命周期与 effect | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/02-lifecycle-and-effects](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/02-lifecycle-and-effects) | `site/develop/cordis-tutorial/02-lifecycle-and-effects.md` |
+| 3. 服务 | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/03-services](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/03-services) | `site/develop/cordis-tutorial/03-services.md` |
+| 4. 事件 | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/04-events](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/04-events) | `site/develop/cordis-tutorial/04-events.md` |
+| 5. 配置 | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/05-config](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/05-config) | `site/develop/cordis-tutorial/05-config.md` |
+| 6. 组合与 HMR（热模块替换） | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/06-composition-and-hmr](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/06-composition-and-hmr) | `site/develop/cordis-tutorial/06-composition-and-hmr.md` |
+| 7. 进入 harness | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/07-into-the-harness](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/07-into-the-harness) | `site/develop/cordis-tutorial/07-into-the-harness.md` |
+| Cordis 教程 | [https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial](https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial) | `site/develop/cordis-tutorial/index.md` |
+| 事件系统 | [https://deepseek-harness.github.io/deepseek-harness/develop/framework/events](https://deepseek-harness.github.io/deepseek-harness/develop/framework/events) | `site/develop/framework/events.md` |
+| 插件与生命周期 | [https://deepseek-harness.github.io/deepseek-harness/develop/framework](https://deepseek-harness.github.io/deepseek-harness/develop/framework) | `site/develop/framework/index.md` |
+| 服务与依赖 | [https://deepseek-harness.github.io/deepseek-harness/develop/framework/service](https://deepseek-harness.github.io/deepseek-harness/develop/framework/service) | `site/develop/framework/service.md` |
+| 能力的三种角色设计 | [https://deepseek-harness.github.io/deepseek-harness/develop/practice](https://deepseek-harness.github.io/deepseek-harness/develop/practice) | `site/develop/practice/index.md` |
+| LLM 适配器 | [https://deepseek-harness.github.io/deepseek-harness/develop/practice/llm-adapter](https://deepseek-harness.github.io/deepseek-harness/develop/practice/llm-adapter) | `site/develop/practice/llm-adapter.md` |
+
+### 参考（/reference/）
+
+| 页面 | 站点 URL | 本地文件 |
+| --- | --- | --- |
+| Agent 轮次与步骤生命周期 | [https://deepseek-harness.github.io/deepseek-harness/reference/agent-lifecycle](https://deepseek-harness.github.io/deepseek-harness/reference/agent-lifecycle) | `site/reference/agent-lifecycle.md` |
+| 能力 Seams 与核心服务 | [https://deepseek-harness.github.io/deepseek-harness/reference/capability-seams](https://deepseek-harness.github.io/deepseek-harness/reference/capability-seams) | `site/reference/capability-seams.md` |
+| 插件配置目录 | [https://deepseek-harness.github.io/deepseek-harness/reference/config-catalog](https://deepseek-harness.github.io/deepseek-harness/reference/config-catalog) | `site/reference/config-catalog.md` |
+| 添加 Web Client Conversation Node | [https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-conversation-node](https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-conversation-node) | `site/reference/cookbook/adding-a-conversation-node.md` |
+| 实操手册：添加 workspace 包 | [https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-package](https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-package) | `site/reference/cookbook/adding-a-package.md` |
+| Cookbook: 新增设置卡片 | [https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-settings-card](https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-settings-card) | `site/reference/cookbook/adding-a-settings-card.md` |
+| 工具编写参考 | [https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-tool](https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-a-tool) | `site/reference/cookbook/adding-a-tool.md` |
+| 实操手册：添加 LLM（大语言模型）适配器 | [https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-an-llm-adapter](https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/adding-an-llm-adapter) | `site/reference/cookbook/adding-an-llm-adapter.md` |
+| 实操手册：扩展插件形态 | [https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/extension-cookbook](https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/extension-cookbook) | `site/reference/cookbook/extension-cookbook.md` |
+| 上下文 | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/context](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/context) | `site/reference/cordis-api/context.md` |
+| 事件 | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/events](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/events) | `site/reference/cordis-api/events.md` |
+| Fiber | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/fiber](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/fiber) | `site/reference/cordis-api/fiber.md` |
+| Inherited Cordis API | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/inherited](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/inherited) | `site/reference/cordis-api/inherited.md` |
+| 注册表 | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/registry](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/registry) | `site/reference/cordis-api/registry.md` |
+| Service | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/service](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/service) | `site/reference/cordis-api/service.md` |
+| Cordis 入门 | [https://deepseek-harness.github.io/deepseek-harness/reference/cordis-primer](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-primer) | `site/reference/cordis-primer.md` |
+| DeepSeek Harness 架构 | [https://deepseek-harness.github.io/deepseek-harness/reference](https://deepseek-harness.github.io/deepseek-harness/reference) | `site/reference/index.md` |
+| 会话持久化事件目录 | [https://deepseek-harness.github.io/deepseek-harness/reference/persistence-catalog](https://deepseek-harness.github.io/deepseek-harness/reference/persistence-catalog) | `site/reference/persistence-catalog.md` |
+| 用户审批 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/approval](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/approval) | `site/reference/subsystems/approval.md` |
+| Client 模块 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/client-modules](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/client-modules) | `site/reference/subsystems/client-modules.md` |
+| 代码运行时 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/code-runtime](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/code-runtime) | `site/reference/subsystems/code-runtime.md` |
+| 用户命令 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/commands](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/commands) | `site/reference/subsystems/commands.md` |
+| 压缩（compaction） | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/compaction](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/compaction) | `site/reference/subsystems/compaction.md` |
+| 核心 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/core](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/core) | `site/reference/subsystems/core.md` |
+| 用户凭据 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/credentials](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/credentials) | `site/reference/subsystems/credentials.md` |
+| 文件系统 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/filesystem](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/filesystem) | `site/reference/subsystems/filesystem.md` |
+| 同会话目标 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/goal](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/goal) | `site/reference/subsystems/goal.md` |
+| 子系统 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems) | `site/reference/subsystems/index.md` |
+| 运行时不变式 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/invariants](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/invariants) | `site/reference/subsystems/invariants.md` |
+| 后台任务运行时 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/jobs](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/jobs) | `site/reference/subsystems/jobs.md` |
+| LLM（大语言模型）流式输出 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/llm-streaming](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/llm-streaming) | `site/reference/subsystems/llm-streaming.md` |
+| LSP 导航 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/lsp](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/lsp) | `site/reference/subsystems/lsp.md` |
+| 权限预设 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/permission-presets](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/permission-presets) | `site/reference/subsystems/permission-presets.md` |
+| 会话持久化 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/persistence](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/persistence) | `site/reference/subsystems/persistence.md` |
+| 计划模式 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/plan](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/plan) | `site/reference/subsystems/plan.md` |
+| 进程沙箱 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/sandbox](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/sandbox) | `site/reference/subsystems/sandbox.md` |
+| 仅限 Session 内的 Schedule | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/schedule](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/schedule) | `site/reference/subsystems/schedule.md` |
+| 作用域注册 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/scope](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/scope) | `site/reference/subsystems/scope.md` |
+| 会话投影 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-projection](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-projection) | `site/reference/subsystems/session-projection.md` |
+| 会话查询 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-query](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-query) | `site/reference/subsystems/session-query.md` |
+| 会话引用 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-reference](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-reference) | `site/reference/subsystems/session-reference.md` |
+| 遥测（telemetry） | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-telemetry](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-telemetry) | `site/reference/subsystems/session-telemetry.md` |
+| 会话标题 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-title](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-title) | `site/reference/subsystems/session-title.md` |
+| 会话 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session) | `site/reference/subsystems/session.md` |
+| 用户设置 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/settings](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/settings) | `site/reference/subsystems/settings.md` |
+| Bash 执行器 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/shell](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/shell) | `site/reference/subsystems/shell.md` |
+| Skills | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/skills](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/skills) | `site/reference/subsystems/skills.md` |
+| spill 存储 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/spill](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/spill) | `site/reference/subsystems/spill.md` |
+| 存储 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/storage](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/storage) | `site/reference/subsystems/storage.md` |
+| Subagent | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/subagent](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/subagent) | `site/reference/subsystems/subagent.md` |
+| 子进程 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/subprocess](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/subprocess) | `site/reference/subsystems/subprocess.md` |
+| 系统提示词组装 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/system-prompt](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/system-prompt) | `site/reference/subsystems/system-prompt.md` |
+| 持久 PTY 会话 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/terminal](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/terminal) | `site/reference/subsystems/terminal.md` |
+| Token 计量 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/token-meter](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/token-meter) | `site/reference/subsystems/token-meter.md` |
+| 工具 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/tools](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/tools) | `site/reference/subsystems/tools.md` |
+| Typert 远程调用 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/typert](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/typert) | `site/reference/subsystems/typert.md` |
+| 用户交互 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/user-questions](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/user-questions) | `site/reference/subsystems/user-questions.md` |
+| HTTP 服务器 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/web-server](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/web-server) | `site/reference/subsystems/web-server.md` |
+| Web 访问 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/web](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/web) | `site/reference/subsystems/web.md` |
+| 工作流 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/workflow](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/workflow) | `site/reference/subsystems/workflow.md` |
+| 工作区 | [https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/workspace](https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/workspace) | `site/reference/subsystems/workspace.md` |
+| 工具 Schema 目录 | [https://deepseek-harness.github.io/deepseek-harness/reference/tool-catalog](https://deepseek-harness.github.io/deepseek-harness/reference/tool-catalog) | `site/reference/tool-catalog.md` |
+| 工具执行流水线 | [https://deepseek-harness.github.io/deepseek-harness/reference/tool-execution-pipeline](https://deepseek-harness.github.io/deepseek-harness/reference/tool-execution-pipeline) | `site/reference/tool-execution-pipeline.md` |
+
+## 英文站点（/en/）
+
+### 首页
+
+| 页面 | 站点 URL | 本地文件 |
+| --- | --- | --- |
+| site/en/index.md | [https://deepseek-harness.github.io/deepseek-harness/en](https://deepseek-harness.github.io/deepseek-harness/en) | `site/en/index.md` |
+
+### 全部英文页面（/en/...）
+
+| 页面 | 站点 URL | 本地文件 |
+| --- | --- | --- |
+| Plugin configuration | [https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/config](https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/config) | `site/en/develop/basic/config.md` |
+| Your first plugin | [https://deepseek-harness.github.io/deepseek-harness/en/develop/basic](https://deepseek-harness.github.io/deepseek-harness/en/develop/basic) | `site/en/develop/basic/index.md` |
+| Package and install a plugin | [https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/publish](https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/publish) | `site/en/develop/basic/publish.md` |
+| Build a tool | [https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/tool](https://deepseek-harness.github.io/deepseek-harness/en/develop/basic/tool) | `site/en/develop/basic/tool.md` |
+| 1. Your first plugin | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/01-first-plugin](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/01-first-plugin) | `site/en/develop/cordis-tutorial/01-first-plugin.md` |
+| 2. Lifecycle and effects | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/02-lifecycle-and-effects](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/02-lifecycle-and-effects) | `site/en/develop/cordis-tutorial/02-lifecycle-and-effects.md` |
+| 3. Services | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/03-services](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/03-services) | `site/en/develop/cordis-tutorial/03-services.md` |
+| 4. Events | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/04-events](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/04-events) | `site/en/develop/cordis-tutorial/04-events.md` |
+| 5. Configuration | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/05-config](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/05-config) | `site/en/develop/cordis-tutorial/05-config.md` |
+| 6. Composition and HMR | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/06-composition-and-hmr](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/06-composition-and-hmr) | `site/en/develop/cordis-tutorial/06-composition-and-hmr.md` |
+| 7. Into the harness | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/07-into-the-harness](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial/07-into-the-harness) | `site/en/develop/cordis-tutorial/07-into-the-harness.md` |
+| Cordis tutorial | [https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial](https://deepseek-harness.github.io/deepseek-harness/en/develop/cordis-tutorial) | `site/en/develop/cordis-tutorial/index.md` |
+| Event system | [https://deepseek-harness.github.io/deepseek-harness/en/develop/framework/events](https://deepseek-harness.github.io/deepseek-harness/en/develop/framework/events) | `site/en/develop/framework/events.md` |
+| Plugins and lifecycle | [https://deepseek-harness.github.io/deepseek-harness/en/develop/framework](https://deepseek-harness.github.io/deepseek-harness/en/develop/framework) | `site/en/develop/framework/index.md` |
+| Services and dependencies | [https://deepseek-harness.github.io/deepseek-harness/en/develop/framework/service](https://deepseek-harness.github.io/deepseek-harness/en/develop/framework/service) | `site/en/develop/framework/service.md` |
+| Three-role capability design | [https://deepseek-harness.github.io/deepseek-harness/en/develop/practice](https://deepseek-harness.github.io/deepseek-harness/en/develop/practice) | `site/en/develop/practice/index.md` |
+| LLM adapters | [https://deepseek-harness.github.io/deepseek-harness/en/develop/practice/llm-adapter](https://deepseek-harness.github.io/deepseek-harness/en/develop/practice/llm-adapter) | `site/en/develop/practice/llm-adapter.md` |
+| Configure models | [https://deepseek-harness.github.io/deepseek-harness/en/guide/providers](https://deepseek-harness.github.io/deepseek-harness/en/guide/providers) | `site/en/guide/providers.md` |
+| Get started with the Python SDK | [https://deepseek-harness.github.io/deepseek-harness/en/guide/python-sdk](https://deepseek-harness.github.io/deepseek-harness/en/guide/python-sdk) | `site/en/guide/python-sdk.md` |
+| Use the Web UI | [https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart](https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart) | `site/en/guide/quickstart.md` |
+| Agent Turn And Step Lifecycle | [https://deepseek-harness.github.io/deepseek-harness/en/reference/agent-lifecycle](https://deepseek-harness.github.io/deepseek-harness/en/reference/agent-lifecycle) | `site/en/reference/agent-lifecycle.md` |
+| Capability Seams And Core Services | [https://deepseek-harness.github.io/deepseek-harness/en/reference/capability-seams](https://deepseek-harness.github.io/deepseek-harness/en/reference/capability-seams) | `site/en/reference/capability-seams.md` |
+| Plugin Config Catalog | [https://deepseek-harness.github.io/deepseek-harness/en/reference/config-catalog](https://deepseek-harness.github.io/deepseek-harness/en/reference/config-catalog) | `site/en/reference/config-catalog.md` |
+| Add a Web Client conversation node | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-conversation-node](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-conversation-node) | `site/en/reference/cookbook/adding-a-conversation-node.md` |
+| Cookbook: adding a workspace package | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-package](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-package) | `site/en/reference/cookbook/adding-a-package.md` |
+| Cookbook: adding a settings card | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-settings-card](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-settings-card) | `site/en/reference/cookbook/adding-a-settings-card.md` |
+| Tool authoring reference | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-tool](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-tool) | `site/en/reference/cookbook/adding-a-tool.md` |
+| Cookbook: adding an LLM adapter | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-an-llm-adapter](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-an-llm-adapter) | `site/en/reference/cookbook/adding-an-llm-adapter.md` |
+| Cookbook: extension plugin shapes | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/extension-cookbook](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/extension-cookbook) | `site/en/reference/cookbook/extension-cookbook.md` |
+| Context | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/context](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/context) | `site/en/reference/cordis-api/context.md` |
+| Events | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/events](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/events) | `site/en/reference/cordis-api/events.md` |
+| Fiber | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/fiber](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/fiber) | `site/en/reference/cordis-api/fiber.md` |
+| Inherited Cordis API | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/inherited](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/inherited) | `site/en/reference/cordis-api/inherited.md` |
+| Registry | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/registry](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/registry) | `site/en/reference/cordis-api/registry.md` |
+| Service | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/service](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-api/service) | `site/en/reference/cordis-api/service.md` |
+| Cordis Primer | [https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-primer](https://deepseek-harness.github.io/deepseek-harness/en/reference/cordis-primer) | `site/en/reference/cordis-primer.md` |
+| DeepSeek Harness Architecture | [https://deepseek-harness.github.io/deepseek-harness/en/reference](https://deepseek-harness.github.io/deepseek-harness/en/reference) | `site/en/reference/index.md` |
+| Session Persistence Event Catalog | [https://deepseek-harness.github.io/deepseek-harness/en/reference/persistence-catalog](https://deepseek-harness.github.io/deepseek-harness/en/reference/persistence-catalog) | `site/en/reference/persistence-catalog.md` |
+| User Approval | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/approval](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/approval) | `site/en/reference/subsystems/approval.md` |
+| Client Modules | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/client-modules](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/client-modules) | `site/en/reference/subsystems/client-modules.md` |
+| Code Runtime | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/code-runtime](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/code-runtime) | `site/en/reference/subsystems/code-runtime.md` |
+| Human Commands | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/commands](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/commands) | `site/en/reference/subsystems/commands.md` |
+| Compaction | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/compaction](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/compaction) | `site/en/reference/subsystems/compaction.md` |
+| Core | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/core](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/core) | `site/en/reference/subsystems/core.md` |
+| User Credentials | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/credentials](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/credentials) | `site/en/reference/subsystems/credentials.md` |
+| Filesystem | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/filesystem](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/filesystem) | `site/en/reference/subsystems/filesystem.md` |
+| Same-session goals | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/goal](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/goal) | `site/en/reference/subsystems/goal.md` |
+| Subsystems | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems) | `site/en/reference/subsystems/index.md` |
+| Runtime Invariants | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/invariants](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/invariants) | `site/en/reference/subsystems/invariants.md` |
+| Background Task Runtime | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/jobs](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/jobs) | `site/en/reference/subsystems/jobs.md` |
+| LLM Streaming | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/llm-streaming](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/llm-streaming) | `site/en/reference/subsystems/llm-streaming.md` |
+| LSP navigation | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/lsp](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/lsp) | `site/en/reference/subsystems/lsp.md` |
+| Permission Presets | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/permission-presets](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/permission-presets) | `site/en/reference/subsystems/permission-presets.md` |
+| Session Persistence | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/persistence](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/persistence) | `site/en/reference/subsystems/persistence.md` |
+| Plan Mode | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/plan](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/plan) | `site/en/reference/subsystems/plan.md` |
+| Process Sandbox | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/sandbox](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/sandbox) | `site/en/reference/subsystems/sandbox.md` |
+| Session-local Schedule | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/schedule](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/schedule) | `site/en/reference/subsystems/schedule.md` |
+| Scoped Registration | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/scope](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/scope) | `site/en/reference/subsystems/scope.md` |
+| Session Projections | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-projection](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-projection) | `site/en/reference/subsystems/session-projection.md` |
+| Session Query | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-query](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-query) | `site/en/reference/subsystems/session-query.md` |
+| Session References | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-reference](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-reference) | `site/en/reference/subsystems/session-reference.md` |
+| SessionTelemetryBackend | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-telemetry](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-telemetry) | `site/en/reference/subsystems/session-telemetry.md` |
+| Session Titles | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-title](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session-title) | `site/en/reference/subsystems/session-title.md` |
+| Sessions | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/session) | `site/en/reference/subsystems/session.md` |
+| User Settings | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/settings](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/settings) | `site/en/reference/subsystems/settings.md` |
+| Bash Executor | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/shell](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/shell) | `site/en/reference/subsystems/shell.md` |
+| Skills | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/skills](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/skills) | `site/en/reference/subsystems/skills.md` |
+| Spill Storage | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/spill](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/spill) | `site/en/reference/subsystems/spill.md` |
+| Storage | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/storage](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/storage) | `site/en/reference/subsystems/storage.md` |
+| Subagent | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/subagent](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/subagent) | `site/en/reference/subsystems/subagent.md` |
+| Subprocess | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/subprocess](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/subprocess) | `site/en/reference/subsystems/subprocess.md` |
+| System Prompt Assembly | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/system-prompt](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/system-prompt) | `site/en/reference/subsystems/system-prompt.md` |
+| Persistent PTY Sessions | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/terminal](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/terminal) | `site/en/reference/subsystems/terminal.md` |
+| Token Meter | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/token-meter](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/token-meter) | `site/en/reference/subsystems/token-meter.md` |
+| Tools | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/tools](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/tools) | `site/en/reference/subsystems/tools.md` |
+| Typert remote calls | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/typert](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/typert) | `site/en/reference/subsystems/typert.md` |
+| User Interaction | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/user-questions](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/user-questions) | `site/en/reference/subsystems/user-questions.md` |
+| HTTP Server | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/web-server](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/web-server) | `site/en/reference/subsystems/web-server.md` |
+| Web Access | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/web](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/web) | `site/en/reference/subsystems/web.md` |
+| Workflow | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/workflow](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/workflow) | `site/en/reference/subsystems/workflow.md` |
+| Workspaces | [https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/workspace](https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/workspace) | `site/en/reference/subsystems/workspace.md` |
+| Tool Schema Catalog | [https://deepseek-harness.github.io/deepseek-harness/en/reference/tool-catalog](https://deepseek-harness.github.io/deepseek-harness/en/reference/tool-catalog) | `site/en/reference/tool-catalog.md` |
+| Tool Execution Pipeline | [https://deepseek-harness.github.io/deepseek-harness/en/reference/tool-execution-pipeline](https://deepseek-harness.github.io/deepseek-harness/en/reference/tool-execution-pipeline) | `site/en/reference/tool-execution-pipeline.md` |
+
+---
+
+*站点页面：168（中文 84，英文 84）*
+

package/kb/README.md

@@ -0,0 +1,69 @@
+# DeepSeek Harness 文档知识库
+
+本地镜像的 DeepSeek Harness 官方文档知识库，用于辅助 Harness **插件开发**。内容抓取自官方文档站点
+<https://deepseek-harness.github.io/deepseek-harness/>，并以**仓库内原始 Markdown**（`deepseek-ai/deepseek-harness` 的 `docs/` 目录）重建，比抓取渲染后的 HTML 保真度更高、链接与代码块完整。
+
+## 目录结构
+
+```
+knowledge/deepseek-harness/
+├── README.md         本文件：总览与使用指南
+├── INDEX.md          全部页面的 站点 URL ↔ 本地文件 对照索引（自动生成）
+├── site/             线上站点的完整镜像（中英双语，链接已按站点路由重写）
+│   ├── index.md            中文首页（/deepseek-harness/）
+│   ├── guide/              入门：quickstart / providers / python-sdk
+│   ├── develop/            开发：basic(第一个插件/tool/config/publish)、
+│   │                       framework(生命周期/service/事件)、practice、cordis-tutorial(7 章)
+│   ├── reference/          参考：架构、capability-seams、config-catalog、tool-catalog、
+│   │                       cordis-api、cookbook、subsystems(42 个子系统页)…
+│   └── en/                 英文站镜像（/deepseek-harness/en/...），结构同上
+├── extra/            仓库 docs/ 中未发布到站点的补充文档（开发参考）
+│   ├── glossary.md         术语表（capability seam 等核心概念）
+│   ├── defensive-patterns.md / testing.md / development.md / rescope.md …
+│   ├── module-graph.md     模块依赖全景图（125KB）
+│   ├── cookbook/           adding-a-vendored-package 等仓库内 cookbook
+│   ├── subsystems/         attachment / extensions / feedback
+│   ├── postmortem/         事故复盘（4 篇）
+│   └── i18n/               文档双语规范与术语
+└── meta/
+    ├── source.json         来源信息：仓库 commit、抓取时间、统计
+    └── site-pages.txt      线上站点 hashmap.json 的页面清单（168 页）
+```
+
+## 插件开发学习路径（从 `site/` 开始）
+
+1. **第一个插件** — `site/develop/basic/index.md`（插件 = 导出 `apply(ctx)` 的模块，`ctx.effect()` 自动清理）
+2. **开发一个 Tool** — `site/develop/basic/tool.md`（工具定义 DSL）
+3. **插件配置** — `site/develop/basic/config.md`；**打包安装** — `site/develop/basic/publish.md`
+4. **框架能力** — `site/develop/framework/index.md`（生命周期）、`service.md`（服务与依赖注入）、`events.md`（事件系统）
+5. **Cordis 框架教程** — `site/develop/cordis-tutorial/`（7 章：插件/生命周期/服务/事件/配置/组合与热重载/进入 Harness）
+6. **实战** — `site/develop/practice/index.md`（能力三层拆分）、`llm-adapter.md`
+7. **按需查阅** — `site/reference/`：
+   - 架构总览 `reference/index.md`；能力服务 `reference/capability-seams.md`；Agent 生命周期 `reference/agent-lifecycle.md`
+   - 插件配置目录 `reference/config-catalog.md`；Tool Schema 目录 `reference/tool-catalog.md`；持久化事件 `reference/persistence-catalog.md`
+   - Cordis API `reference/cordis-api/`（Context / Events / Fiber / Registry / Service / 继承接口面）
+   - Cookbook `reference/cookbook/`（新增 package / tool / LLM adapter / 设置卡片 / 扩展模式 / Conversation Node）
+   - 子系统 `reference/subsystems/`（core / scope / session / tools / shell / filesystem / subagent / sandbox / approval … 共 42 页）
+
+## 更新方法
+
+知识库与仓库 `master` 分支对齐（见 `meta/source.json` 的 commit）。需要刷新时：
+
+```sh
+# 1. 重新克隆并安装投影依赖
+git clone --depth 1 https://github.com/deepseek-ai/deepseek-harness.git <tmp>
+cd <tmp> && npm install --no-save --no-package-lock mdast-util-from-markdown mdast-util-gfm micromark-extension-gfm
+# 2. 运行站点投影器（需要 Node ≥ 22.19）
+node --experimental-strip-types run-projector.ts   # 输出到 website/.generated/
+# 3. 用 website/.generated/ 覆盖本插件的 kb/site/
+# 4. 在本插件根目录重新生成索引与 INDEX.md
+node scripts/rebuild-index.mjs
+```
+
+站点投影逻辑为仓库内 `website/docs.ts`（发布清单）+ `scripts/project-doc-site.ts`（链接重写/图片复制）。
+
+## 统计
+
+- 站点页面：168 个 Markdown（中文 84 + 英文 84），4 张图片
+- 补充文档：50 个 Markdown（`extra/`）
+- 来源 commit：`99f6f02fecdb7dff40c3fbc9470f5907c29f74ca`（master）

package/kb/extra/AGENTS.md

@@ -0,0 +1,75 @@
+# AGENTS.md — The documentation standard
+
+This file defines document structure, Markdown tiers, writing rules, and `verify-doc-budgets` ceilings. Use [dsh-doc-standards](../.agents/skills/dsh-doc-standards/SKILL.md) for placement and validation, and [dsh-prose-standard](../.agents/skills/dsh-prose-standard/SKILL.md) for required coverage and editorial judgment; the [doc-tiers Agent Note](../.agents/notes/implemented/process/2026-07-04-doc-tiers-and-budgets.md) owns rationale.
+
+## Document structure
+
+These rules apply to human-facing documentation; [Agent Notes](../.agents/notes/README.md) remain outside their scope. A [postmortem](postmortem/README.md) is an incident-scoped reference; chronology records evidence, not a teaching sequence. A document's subject and tree position fix its scope: describe its own subject at appropriate detail and direct children only by purpose, responsibility, and high-level behavior; link to the owning descendant for lower-level detail. Document type does not widen that scope. A reference may be exhaustive only about its own subject. Testing mechanisms, fixtures, and harnesses belong at the lowest owning level; higher documents link there.
+
+Classify every in-scope document as a tutorial or reference. Tutorials follow an ordered path to an outcome and introduce only what each step needs. References define a lookup scope and current behavior without a teaching sequence. Separate substantial tutorial and reference content; label a section when either part is small.
+
+Before writing a tutorial, privately classify the reader's starting knowledge and each concept as beginner, intermediate, or advanced. Establish prerequisites before dependent concepts, increase difficulty gradually, and move unnecessary advanced material to a later tutorial or reference.
+
+Author in this order: locate the document in the tree; set its permitted detail; choose tutorial or reference; for a tutorial, order concepts by prerequisite and difficulty; relocate descendant-owned detail; replace lower-level explanations with links to their owners.
+
+## The tier taxonomy: one home per fact
+
+Each fact has one home: the tier whose job it is; elsewhere, link there.
+
+| Tier | Job | Does NOT belong there |
+|---|---|---|
+| Root `AGENTS.md` | Standing orders: rules an agent needs in context in every session, one to three lines each, linking its home | Stories, worked examples, situational procedures, anything restated from a linked home |
+| Subtree `AGENTS.md` (`packages/`, `examples/`, `docs/`, `.agents/notes/`) | Orders specific to that subtree | Repo-wide rules the root file already carries |
+| [architecture.md](architecture.md) | Ordered map: composition, core packages, loop, seams, extension points; read before changing `packages/` | Type definitions (→ subsystems), per-package detail (→ package READMEs), decision rationale (→ Agent Notes), implementation-status annotations |
+| [subsystems/](subsystems/README.md) | One reference page per subsystem: type definitions, semantics, and the generated Cordis API | Behavior narration (→ architecture.md) |
+| [Agent Notes](../.agents/notes/README.md) | Active decision records: the why, what-was-given-up, and required verification; `implemented/` notes describe shipped reality in present tense | Migration plans, acceptance-task checklists, fixture walkthroughs, and spec-speak ("should…") once the decision has shipped; archived notes are frozen history, never current authority |
+| [postmortem/](postmortem/README.md) | Incident stories — the only tier where war-story narrative belongs | — |
+| [cookbook/](cookbook/adding-a-package.md) | Step-by-step how-tos with numbered verify steps | Design rationale (→ the Agent Note each guide links) |
+| [user/](user/index.md) | Product-facing guides published by the documentation website | Generated reference tables, contributor procedures, decision history |
+| Package README | The per-package contract: config, semantics, limitations, extension points, and [Model Experience](cookbook/adding-a-package.md#4-write-the-package-readme) | JSDoc restatement, generated-catalog restatement (event/tool tables), other packages' concerns |
+| [development.md](development.md) | Contributor setup, daily workflow, and a summary of CI; a bilingual pair under the [i18n contract](i18n/README.md) | Runtime/version rationale (→ Agent Notes), check-by-check lists that drift from `package.json` scripts |
+| Generated reference: the per-page `cordis-surface` regions in [subsystems/](subsystems/README.md), the [Cordis core API + inherited tier](cordis-api/context.md), [tool-catalog](tool-catalog.md), [config-catalog](config-catalog.md), [persistence-catalog](persistence-catalog.md), [module-graph.md](module-graph.md) | Exhaustive English sources regenerated from source and freshness-gated; reviewed Chinese counterparts follow the [pairing workflow](i18n/README.md#scope-and-exclusions) | Hand edits to generated English sources or regions; Chinese counterparts update through pairing only |
+| Skills (`.agents/skills/`) | Reusable workflows and specialized decision standards | Product and runtime contracts (→ docs or source) |
+
+Placement: bugs → postmortems; rationale → Agent Notes; procedures → cookbooks; type definitions → subsystems; package contracts → READMEs; standing orders → root `AGENTS.md` with a rationale link.
+
+## Writing rules
+
+- **Document current state, not change history.** Avoid "previously/now/no longer", PRs, commits, and stack positions in durable prose; name the live mechanism. Put change stories in commits, PRs, Agent Notes, or postmortems; the latter two may cite merged PRs and issues as evidence.
+- **Every non-trivial change includes at least one Agent Note in the same PR.** Update the owning note or add one; only mechanical/local edits are exempt ([scope](../.agents/notes/README.md#when-to-write-one)).
+- **One physical line per paragraph** (`verify-md-wrap`): use editor soft-wrap. Code blocks, tables, and list structure keep their formatting; code comments stay under the linter's column limit.
+- **Fenced `ts` blocks must compile** (`doc-typecheck`); a pasted type declaration and its original JSDoc use ` ```ts type-equiv `, while a body-stripped public class declaration uses ` ```ts public-api `; register either in the manifest so neither can drift ([mechanics](development.md#documenting-types-verbatim-ts-type-equiv)).
+- **The owning [subsystems page](subsystems/README.md) updates in the same change** that reshapes a documented type. `verify-type-equiv` catches drifted pastes, not never-documented new types; a type is documented on its declaring package group's page ([page scoping](../.agents/notes/implemented/process/2026-08-03-package-anchored-subsystem-pages.md)).
+- **Pairs update together**: [Terminology-guided](i18n/terminology.md), single-pass active-agent work repositions first-use annotations, preserves untouched prose, and re-records; `dsh-translate-docs` remains user-invoked ([contract](i18n/README.md)).
+- **Comments and JSDoc state complete contracts, not reasoning transcripts.** Preserve behavior, failure, timing, ownership, modality, exceptions, consequences, and non-obvious orientation; delete narration, test walkthroughs, review analysis, and code restatement. Keep the local contract and link its rationale. Use [dsh-prose-standard](../.agents/skills/dsh-prose-standard/SKILL.md) for details.
+- Write directly: name actors and facts ([decision](../.agents/notes/implemented/process/2026-08-09-concrete-prose-names-actors-and-recorded-facts.md)). Reserve `seam` for the defined capability. Name the exact check, type, API, operation, or behavior instead of metaphorical "gate", "vocabulary", or "surface".
+
+## Wordcount Budgets
+
+[scripts/doc-budgets.manifest.json](../scripts/doc-budgets.manifest.json) sets standing-doc ceilings; `pnpm run verify-doc-budgets` rejects excess or missing files.
+
+When the gate goes red:
+
+1. **Relocate** content that belongs in another tier; leave a one-line link if needed.
+2. **Condense** content that belongs here but can be shorter.
+3. **Raise** the ceiling only when the words need the space; justify the manifest diff in the PR. A too-low ceiling is a budget bug.
+
+Ceilings are guardrails, not reduction targets. At or below target, retain at least 5% headroom; above target, freeze the ceiling until relocation or condensation brings the document under target. Lower a ceiling only when the document still has room, and raise it when content would otherwise be deleted. Targets: root `AGENTS.md` ≤ 1,600 words; `architecture.md` ≤ 1,800; subtree `AGENTS.md` ≤ 600, except `packages/AGENTS.md` ≤ 650 and this file ≤ 1,250; `packages/README.md` ≤ 600. Review governs unbudgeted tiers.
+
+## The slop checklist
+
+Hunt these in any doc; [dsh-doc-standards](../.agents/skills/dsh-doc-standards/SKILL.md) runs this list as an audit:
+
+- The same rule stated in more than one home. Grep a distinctive phrase; keep one home and link the rest.
+- Narrated history or war stories: "previously", "now", "no longer", "used to", "renamed", "was moved", PRs, or commits. State the current fact; link an Agent Note or postmortem when needed.
+- Implementation-status annotations in prose or diagrams ("implemented!", "future: …"). Status rots; the repo layout and package manifests carry it.
+- Hand-restated catalogs, JSDoc, or inventories of tests, packages, and status when source or a generator is authoritative.
+- Reasoning transcripts: step-by-step implementation narration, proof of obvious branches, test walkthroughs, or rejected local alternatives. Keep the resulting contract or durable rationale; delete the path used to derive it.
+- Rationale repeated beside sibling methods instead of once at the owning capability or helper.
+- Paragraph walls: one paragraph carrying several rules and parenthetical asides. Split it or demote the detail to its home.
+- Emphasis inflation: bold, CAPS, or "critically" everywhere means nothing stands out. Reserve emphasis for the clause that changes behavior.
+- Spec-speak in `implemented/` Agent Notes: "should", migration plans, acceptance checklists. An implemented Agent Note describes what is, per the [implemented-note instructions](../.agents/notes/implemented/AGENTS.md).
+
+## Cross-reference with machine-checkable links, never free prose
+
+Link repository references with relative Markdown paths, never bare filenames or Agent Note numbers. `verify-md-links` rejects missing targets and dead `#fragment` anchors ([rationale](../.agents/notes/implemented/process/2026-06-18-markdown-cross-link-lint.md)).