dsh-edict ⚔️

三省六部制多智能体审核流程，移植为 DeepSeek Harness 插件。

玩法来自 cft0808/edict（MIT，★16k+）：用 1300 年前的三省六部制重新设计多 Agent 协作。 本插件是它审核流程逻辑的忠实移植——状态机、封驳规则、高风险确认、越权矩阵、委派防死锁、审计留痕，逐条对齐。

你(皇上) → 太子(分拣) → 中书省(规划) → 门下省(审议·可封驳) → 尚书省(派发) → 六部(并行执行) → 回奏

---

为什么要有这个移植

	原版 edict	dsh-edict
宿主	OpenClaw（必装）	DeepSeek Harness
语言/依赖	Python 3.9+ / FastAPI / Postgres 可选	纯 Node，零依赖
安装	install.sh / Docker / 注册 agent 到 openclaw.json	dsh plugin add dsh-edict
数据	kanban JSON / Postgres	~/.dsh/edict/（JSON，原子写）
多 Agent 从哪来	OpenClaw 的 11 个 agent 进程	DSH 子代理 / 你自己扮演衙门
审核规则	见下	逐条一致（有测试证明）

---

规则（与 edict 逐条对齐）

12 状态状态机

Pending → Taizi → Zhongshu → Menxia → Assigned → Next/Doing → Review → Done
终态：Done / Cancelled（无出边）

完整合法转换表：

状态	可转到
Pending	Taizi, Cancelled
Taizi	Zhongshu, Cancelled
Zhongshu	Menxia, Cancelled, Blocked
Menxia	Assigned, Zhongshu（封驳打回）, Cancelled
Assigned	Doing, Next, Cancelled, Blocked
Next	Doing, Cancelled, Blocked
Doing	Review, Done, Blocked, Cancelled
Review	Done, Menxia（复审）, Doing, Cancelled, PendingConfirm
PendingConfirm	Done, Review, Cancelled
Blocked	Taizi, Zhongshu, Menxia, Assigned, Next, Doing, Review, Cancelled

非法转换一律拒绝，并写 state_rejected 审计。

高风险操作要确认（拦在 PendingConfirm）

转换	确认方
Review → Done（完结任务）	menxia（门下省）
Doing → Cancelled（执行中取消）	shangshu（尚书省）
Menxia → Cancelled（审核中取消）	zhongshu（中书省）

不直接生效：先落 PendingConfirm，由确认方 approve（落到目标状态）或 reject（退回 Review 复审）。

硬校验

• done 前置：当前状态必须是 Doing/Next，且 todos 全部完成，否则拒绝（"todos 未完成（1/2），禁止直接收口"）
• 单一 in-progress：同一任务同时最多 1 个 in-progress todo
• 委派防死锁：深度 ≤ 3，路径成环直接拒绝
• 委派权限链：太子→中书省；中书省→门下省/尚书省；尚书省→六部；六部→只能回报尚书省
• 标题校验：长度 ≥6 且不能是闲聊词（好/收到/测试…）
• 越权矩阵：六部不能改状态，门下省不能 create……（11 个角色的命令白名单）

审计

每条动作都落 ~/.dsh/edict/audit_log.json（保留最近 5000 条），含 ts / task / agent / action / from / to / reason。拒绝也留痕。

---

安装

从 npm 装（推荐，一行）：

dsh plugin --profile desktop add dsh-edict

从 GitHub 装（想跟最新提交，或 npm 不可用时）：

dsh plugin --profile desktop add github:Caoran1314/dsh-edict

本地开发（改代码即时生效，无需重装）：

dsh plugin --profile desktop add link:D:\path\to\dsh-edict

装完重启 DSH。数据目录 ~/.dsh/edict/。

--profile 填你实际在用的那个：桌面客户端用 desktop，dsh web 用 web。

提供的工具

工具	对应衙门/命令	说明
edict_create	皇上/太子 create	下旨建任务
edict_move	三省 state	状态流转（含合法性与高风险拦截）
edict_flow	各省 flow	部门间流转留痕
edict_progress	六部/各省 progress	实时进展 + ✅/🔄 清单同步 todos
edict_todo	六部 todo	子任务（单一 in-progress）
edict_done	六部 done	回报完成 → Review（前置硬校验）
edict_block	六部 block	标记阻塞
edict_confirm	门下/尚书 confirm	批准 / 驳回高风险操作
edict_delegate	中书/尚书 delegate	委派（深度+循环+权限链校验）
edict_delegate_result	六部 delegate-result	回写子任务结果
edict_memory	全部 memory	衙门记忆（上限 200，pinned 优先）
edict_task_memo	全部 task-memo	任务级决策/警示备忘
edict_shared_memo	尚书 shared-memo	全局共享备忘
edict_status	只读	军机处看板：各状态数量 / 任务详情 / 流转链 / 待确认项
edict_role	—	设置当前衙门身份（越权矩阵据此生效）

命令（无 UI 界面时用）：edict（看板）、edict-audit（审计）、edict-reset-role。

身份如何确定

越权矩阵需要一个"当前是谁"。DSH 的子代理没有独立环境变量（不像 OpenClaw 的 OPENCLAW_AGENT_ID），所以推断链是：

工具参数 agent  →  EDICT_AGENT_ID 环境变量  →  ~/.dsh/edict/current_role  →  默认 taizi

子代理开工前先调 edict_role 设定身份，之后再调 edict_*，越权矩阵才按你的身份生效。

---

用法示例

你：用三省六部流程做「把首页加载时间降到 1 秒以内」

1. edict_create(title:"把首页加载时间降到 1 秒以内")        → Pending
2. edict_role(role:"taizi") + edict_move(state:"Taizi")      → 太子分拣
3. edict_role(role:"zhongshu") + edict_move(state:"Zhongshu")→ 中书省规划
4. edict_todo ×N（拆子任务）+ edict_move(state:"Menxia")     → 交门下省审议
5. edict_role(role:"menxia")
   - 不通过 → edict_move(state:"Zhongshu", now:"封驳：缺少回滚方案")
   - 通过   → edict_move(state:"Assigned")
6. edict_role(role:"shangshu") + edict_move(state:"Doing")
   + edict_delegate(to:"hubu", instruction:"…")              → 派发给六部
7. edict_role(role:"hubu") + edict_progress / edict_todo / edict_done
8. edict_role(role:"shangshu") + edict_move(state:"Done")
   → 落 PendingConfirm，edict_role(role:"menxia") + edict_confirm(action:"approve") → Done

---

与本移植的差异（诚实清单）

规则一致，适配层有三处必然差异，另有两处实现层差异（语言/内部一致性问题，非规则改动）：

项	原版 edict	本移植	性质
身份来源	OPENCLAW_AGENT_ID 等环境变量	同上 + 工具参数 + 角色文件	适配（DSH 无 per-subagent env）
存储	kanban JSON / Postgres 双写	~/.dsh/edict/ JSON 原子写	适配
多 Agent	11 个 OpenClaw agent 进程	DSH 子代理 / 人工扮演	适配
todos 清单解析	Python item[:-1]（按码位）	Array.from 后删末位（按码位）	语言差异：JS 里 slice(0,-1) 会切断 emoji 代理对，故必须按码位处理
progress 替换 todos 后	不重算 ready_to_close（cmd_todo 才置位）	重算，保持标记与 todos 一致	实现增强（上游内部不一致）

另：垃圾词比较刻意保持上游行为——上游 if t in _JUNK_TITLES 是集合精确匹配、不忽略大小写， 因此 'OK'/'Yes' 这类大小写变体不会被拦。本移植没有"顺手修好"它，以对齐上游。

测试

node test/edict.test.mjs

28 项，覆盖：状态机守卫（移植自 edict 的 tests/test_state_machine_consistency.py，期望表逐字抄自上游 task.py）、高风险确认、封驳路径、done 前置、单一 in-progress、委派深度/循环/权限链、越权矩阵、审计结构、文本清洗。

路线图

• 军机处看板 UI（dsh.client 浏览器半侧 + HTTP API），对齐 edict 的 10 个面板
• 奏折阁：已完成旨意自动归档为 Markdown
• 旨库：预设圣旨模板
• 官员总览：Token/耗时排行（progress 已在记 tokens/cost/elapsed）

许可与署名

MIT。审核流程设计来自 cft0808/edict（MIT），本移植保留其规则语义并注明出处；实现代码为本项目独立编写。