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、委派深度/循环/权限链、越权矩阵、审计结构、文本清洗。
路线图
许可与署名
MIT。审核流程设计来自 cft0808/edict（MIT），本移植保留其规则语义并注明出处；实现代码为本项目独立编写。
