dsh-sansheng-liubu/README.md

79 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 「上朝」DSH 多 Agent 模式
面向 DeepSeek Harness Web GUI 的 Agent Preset,mode id 保持 `sansheng-liubu`。
**本插件默认不开启。** 装上它不会往 DSH 的模式选择器里塞「上朝」,也不会成为新会话的默认模式。只有你按下面步骤显式启用、并在新建会话时主动选中「上朝」,这套流程才开始运行。
启用之后,尚未加入 Agent Team 的默认主 Agent 会自动担任丞相(Lead),你可以直接与丞相对话,其余部门由丞相按流程创建。
## 启用方式(选了才生效)
```powershell
node scripts/mode.mjs status # 现在开没开
node scripts/mode.mjs on # 让「上朝」出现在模式选择器里
node scripts/mode.mjs off # 彻底移除这个选项
```
`on` 只是把 [preset.patch.yml](preset.patch.yml) 里那段 insert 写入 `~/.dsh/profiles/desktop/cordis.patch.yml`(带标记,可原样撤回),**不会**替你选中它。执行后彻底重启 DSH,新建会话时在模式选择器里主动选「上朝」,这套流程才启动;不选就一直是普通模式。
`off` 把那段 insert 整段删掉,文件回到原样;已存在的会话仍保留它自己的模式记录,不会被切成别的模式。
包自带的 [cordis.patch.yml](cordis.patch.yml) 是空层(`[]`),这是刻意的——装包本身不产生任何行为。想手工合并也可以,规则同上:顶层保持数组,删掉 `[]` 再接那段 insert。
若重启后模式选择器里看不到「上朝」,把 `dsh-sansheng-liubu-mode` 也加进 `~/.dsh/profiles/desktop/package.json` 的 `dsh.profile.bundles` 再重启——预设按包名解析那支策略插件,个别部署要求它显式列出。这条不影响「默认关闭」:加进 bundles 只是让插件可加载,策略仍只在会话 preset 为 `sansheng-liubu` 时才生效。
## 部门职责
- `lead`(丞相):统筹、决策、组队与管理型工具;调用须留痕。
- `zhongshu`(中书省):调查与规划,只读。
- `menxia`(门下省):准奏、封驳、验收与查账,只读。
- `shangshu`(尚书省):任务依赖和分工调度,只读。
- `libu`(吏部):Agent 与技能维护、成员编制与角色配置;只动技能、角色与配置文档,不开命令行。
- `hubu`(户部):数据、表格与计算;依据真实数据给出可复算的结论,不补造数据。
- `lipu`(礼部):文档、汇报、文案润色与可视化产出。
- `bingbu`(兵部):环境运行、调试与部署,以及工具装配、发放、回收、登记、销账;只发不批。
- `xingbu`(刑部):按风险开展的专项测试与独立验证;只跑不部署,不替代门下审议。
- `gongbu`(工部/图像司):编码与工程实现;识图、OCR、截图与视觉分析;通过 `dsh-image-gen` 执行生图、批量生图和图片编辑。
执行部门常备 `read`、`write`、`edit`、`bash`、`grep`、`glob` 等工具;规划/审议部门保持只读。
## Image-gen 接管
上朝插件不再自行注册图片工具或读取图片 Provider 凭据,而是复用已安装的 `dsh-image-gen`:
- `generate_image`:单张生图;
- `generate_images`:批量生图;
- `edit_image`:参考图与连续编辑。
三项工具只允许工部在已准奏且处于执行中的任务里调用。Provider、模型、API Key、Base URL、订阅登录、计费和结果保存均由 Image-gen 配置管理。`image_generate` 与 `codex_image_generate` 继续被上朝策略拒绝。
请在“插件 → 已安装 → dsh-image-gen”中配置并测试 Provider。修改插件配置或本模式后需彻底重启 DSH。
## 工具审核则例
1. 部门申请工具须写明用途、范围、期限;门下准奏后由兵部发放,限期使用,到期回收销账。
2. 只读工具由门下专决;写入须注明 writeScopes;涉费、删除、全局配置须人工签字。
3. `task_board_*`、`automation_*` 归丞相执掌并留痕;部门调用管理型工具须持门下准奏记录。
4. 门下验收查账;越界者下次从严;工具不得转借。
## 验证
```powershell
node --check index.js
node --test --test-isolation=none test/policy.test.js panel/test/client.test.js
node scripts/check-install.mjs
```
`check-install.mjs` 会确认三件事:包自带 patch 是空层(不注册预设)、`preset.patch.yml` 能复现出同一个 preset id、以及你的 profile 当前到底有没有启用「上朝」(输出里的 `modeEnabled`)。
## 回滚
版本历史统一走 Git,不建备份目录、不留时间戳副本:
```powershell
git log --oneline # 找目标提交
git revert <sha> # 或 git reset --hard <sha>
```
回滚后重启 DSH。mode id 与 preset id 不变。