🏰 dsh-Kingdom

在 DeepSeek Harness 里，装一个插件，拥有一个自己的 Agent 王国。

---

这是什么？

dsh-Kingdom 是一个 DeepSeek Harness（DSH）插件：安装后，你不需要部署任何服务、数据库或 GUI，直接在 DSH 会话里用自然语言就能创建并运行一个属于自己的最小王国——

你：初始化王国
DSH：已创建王国「My Kingdom」，你成为 Owner

你：给当前项目建一个 RAG 研发领
DSH：已创建领地「RAG 研发领」

你：让 Chancellor 把"检查测试情况"规划成任务，Supervisor 派给 Worker 执行，然后验收
DSH：任务 CREATED → ASSIGNED → RUNNING → REVIEW → DONE ✅

王国是真实的：角色、领地、任务、验收记录全部持久化在本地，重启 DSH 也不会消失。

---

✨ 核心特性

特性	说明
🚀 零门槛安装	一个 tgz + 一条命令，无需 bash / tsc / 外部服务 / GUI
🏛 完整角色体系	Owner / Chancellor / Supervisor / Worker，角色与 Session / 模型解耦
📋 真实治理闭环	规划 → 分配 → 独立执行 → 验收，任务状态全程留痕
⚖️ Claim ≠ Fact	Worker 说自己完成了 ≠ 任务完成——完成权只在 Supervisor，代码强制，不是口头约定
👷 Worker 独立执行	每次执行在独立 DSH 会话（one-shot subagent）进行，结果结构化返回
🔁 返工留痕	REWORK 后同一 Worker 新会话重做，每次尝试（attempt）都有记录
💾 重启恢复	全部状态存本地 SQLite，关掉 DSH 再开，王国原样还在
🔄 换届与会话归属（v0.4）	kingdom_unbind_role 解绑 / kingdom_bind_session 把角色绑到独立会话；session-bound 模式下只有被绑定会话能行使职权
🪪 会话身份预留字段（v0.4）	角色可携带 model_name / agent_name / session_meta（JSON 扩展槽）——现在不必填，未来完整会话逐步填满
🎭 GUI 就绪（可选）	结构化快照 + 本地数据网关（默认关闭），前端页面由 GUI 部署方提供
👑 Persistent Governed Worker（v0.8）	Worker 拥有长期 DSH Session（REWORK 唤醒同一 Worker）；Session ↔ Territory Affinity 不可改绑；每次执行经 Capability Gate（仅 GRANTED+ENFORCED 才 dispatch，Runtime 无法 enforce → DENIED + zero execution）；Execution Lease 互斥 + Dispatch Intent（crash 可 reconcile，不盲发）；terminal 证据来自事件链，Runtime 跑完 ≠ Task DONE（Claim → Supervisor 裁定链不变）
🛡️ Fail-closed 能力治理（v0.8）	无自授 / 超 Ceiling / scope 外 / 部分 policy 一律拒绝；approval=never 禁扩权；workspace 外写真实拒绝；RECOVERING 状态如实显示，禁止显示成 Done
🧩 Legacy 兼容（v0.8）	旧 one-shot 路径继续 LEGACY_COMPAT 工作，回归全绿

---

🚀 快速开始

1. 前置要求

• DeepSeek Harness（dsh） ≥ 0.1.0-rc.5
• Node.js ≥ 22.19（内置 SQLite，插件零原生依赖）
• 一个可用的模型 API key（Worker 执行需要）

2. 安装

方式 A：npm（推荐）

dsh plugin --profile web add dsh-kingdom

方式 B：从 GitHub Releases 下载 tgz

从 Releases 下载 dsh-kingdom-0.7.0.tgz，然后：

dsh plugin --profile web add ./dsh-kingdom-0.7.0.tgz

安装时会打印 5 条 peer dependency warning——这是预期的（这些包由 DSH 运行时提供），不是失败。 判断安装成功：重启 DSH 后 /kingdom status 能返回真实状态。

重启 DSH，插件自动加载。开始使用：

/kingdom init      # 初始化或接入本地王国（幂等）
/kingdom status    # 查看王国真实状态

3. 30 秒体验一个王国

你：初始化王国
你：给当前项目创建一个 RAG 研发领
你：任命一个 Chancellor 和 Supervisor，绑定一个 Worker
你：让 Chancellor 规划"检查测试情况"为任务，Supervisor 派给 Worker
你：开始执行任务
你：验收任务（ACCEPT / REWORK / FAIL）
你：王国现在什么情况？

每一步都用自然语言，模型自动调用对应的 kingdom_* 工具完成真实写入。

---

🛠 工具一览

阶段	工具
王国基础	kingdom_init · kingdom_status
领地	kingdom_create_territory · kingdom_list_territories · kingdom_delete_territory
角色	kingdom_bind_role · kingdom_unbind_role · kingdom_bind_session · kingdom_list_bindings
任务治理	kingdom_plan_task · kingdom_assign_task · kingdom_start_task · kingdom_review_task · kingdom_list_tasks
执行控制	kingdom_execution_control
GUI（可选）	kingdom_snapshot · kingdom_task_detail

领地删除（v0.5.1）：kingdom_delete_territory（网关 territory.delete、GUI 操作台删除按钮）遵循治理语义—— 领地下存在任务（任意状态）时默认拒绝；传 force=true 才级联删除：未终态任务统一标记 FAILED、 活跃执行终止，TERRITORY_DELETED / TASK_FAILED 事件留痕；DONE/FAILED 终态任务不篡改。

---

🧠 它如何保证"治理是真的"？

这是 dsh-Kingdom 与其他 Agent 编排工具最根本的区别：

…