三省六部审核 Caoran1314/dsh-edict

dsh-edict ⚔️

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

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

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

为什么要有这个移植

| | 原版 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，原子写） |
| 多智能体从哪来 | 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），本移植保留其规则语义并注明出处；实现代码为本项目独立编写。