三贤人决策 MengYuanzhuo/dsh-plugin-magi

dsh-plugin-magi — MAGI（三贤人）

把《新世纪福音战士》里的 MAGI 决策系统做成 DeepSeek Harness 插件：输入一件待决事项，三台独立且互不可见的决策单元各自给出「同意 / 不同意」与理由 —— 必须选边，没有弃权、没有保留 —— 再按规则计票。

| 单元 | 人格属性 | 判断视角 |
| MELCHIOR-1 | 科学家 | 事实、数据、可验证性、技术可行性、风险概率 |
| BALTHASAR-2 | 母亲 | 安全、保护、长期后果、伦理、不可逆损害 |
| CASPER-3 | 女人 | 直觉、情感、欲望、自我实现、关系动力学 |

magi_vote(question="要不要删除生产库里的旧表", criticality="critical")
→ VETO（否決） 1:2 MELCHIOR-1 reject 「缺少可验证的数据支撑：没有量化收益、没有失败概率、也没有回滚方案」 BALTHASAR-2 reject 「一旦出错，受损的一方没有能力拒绝，也拿不回选择权」 CASPER-3 approve「我想要它，而且我看不出自己会后悔」

端末模式：提訴读数与三盾三角盘面

端末模式：提訴 读数（CODE / FILE / EXTENTION / EX_MODE / PRIORITY）+ 三盾三角盘面，只给颜色与判决 —— 蓝＝承認、红＝拒否、琥珀＝待決。

安装

要求 DSH 0.2.0-rc.2（清单里以 peerDependencies 声明，版本不符会被宿主拒绝安装）。

dsh plugin --profile <名> add github:MengYuanzhuo/dsh-plugin-magi # 从 GitHub
dsh plugin --profile <名> add dsh-plugin-magi # 从 npm

应用内也可以走插件管理工具：plugin_manager { action: "install_bundle", target: "<规格或包目录>" }。
不要手写 profile 的 package.json / cordis.patch.yml —— 交给上面的命令。

卸载：dsh plugin --profile <名> remove dsh-plugin-magi；账本 ~/.dsh/profiles/<名>/.magi/ 需手动删。

计票规则

| 档位 | 规则 | 结果 |
| normal（默认） | 多数决 | 2:1 → 多数方胜 |
| critical（敏感 / 重要） | 三票必须一致 | 3:0 才 承認；任一反对即 否決 |

判决只有三种：承認 / 拒否 / 否決。单元只能投 approve 或 reject，所以不存在平票，也没有「保留 / 交还人类」这类悬置结果。档位由调用方显式传入；未传时按敏感词表自动升级（删除、不可逆、密钥、隐私、资金、外发、上线、生产环境、医疗……），并在结果里写明命中了哪些词。
单元调用失败按保守默认记为拒否并注明；三台全失败则整次表决报错，不伪造判决。

用法

工具（agent 调用）

magi_vote(question, context?, criticality?, label?) 发起表决
magi_history(limit?, key?) 历史记录
magi_personas(action?, force?) 查看 / 导出人格

magi_vote 返回三份原始意见（stance / confidence / reason / key_factors / risks / caveats）、计票、判决、耗时，以及每台生效人格的来源与 sha256。

界面

- 侧栏「面板」列表里的 MAGI 三贤人（三竖条图标）—— 主入口；进入后占满主视图，用「← 返回会话」回来。
- 对话内卡片 —— 每次 magi_vote 后出现在对话流里：三台结论 + 票数 + 判决。
- 输入区按钮 —— 输入框附近的黑绿「MAGI」按钮，快捷切到面板。

面板有两种显示模式，随时切换（会记住）：

| | 詳細（默认） | 端末 |
| 盘面 | 三列单元竖栏，逐字打印理由 | 三盾三角盘面：蓝＝承認、红＝拒否、琥珀＝待決 |
| 输出 | 理由全文 + key_factors / risks / caveats | 只有颜色与判决词 |

詳細模式：三台逐字理由

詳細模式：三列单元竖栏，逐字打印理由，附关键因素、风险与保留意见；底部是 VOTE / UNANIMOUS / CONF AVG / ELAPSED 计票行。

端末模式下按「执行」后，三块盾形会在浅绿 ↔ 黑之间高频闪烁表示思考（三台的周期与相位各自随机），某台出结果即定格成结果色；詳細模式保持 ANALYZING 状态灯，不加闪烁。

界面文案以中文为主，只保留少数原作写法：承認 / 拒否 / 否決、MAGI SYSTEM、VOTE / CONF / ELAPSED / UNANIMOUS、STANDBY / ANALYZING，以及单元名。

人格文件（点盾形查看 / 编辑）

端末模式的三块盾形可点击（键盘 Tab 聚焦后 Enter / 空格同样可用）：弹出该单元当前生效的 md 人格文件。
弹层用粗绿边框 + 黑底绿字，正文比詳細模式再大一号；查看态只有「关闭」「修改」两个选项。

- 「修改」进入同色系的等宽 textarea；编辑完可以「保存」或「不保存」。
- 保存写回 <personasDir>/<melchior|balthasar|casper>.md，下一次表决立即生效，不需要重启。
- 「不保存」丢弃草稿、恢复原文；编辑态按 Esc 不会关闭弹层，避免误丢修改。
- 未配置 personasDir 时只能查看内置默认，「修改」按钮禁用。

三台独立的子功能

每台单元在给出最终意见之前，都可以调用只属于自己的子功能。调用写进 JSON 契约：单元先输出 {"action":"tool","tool":"…","args":{…}}，编排层执行后把结果回注，再让它输出最终意见。
每家默认最多 2 次；子功能调用会记进结果的 tool_calls 与账本，詳細模式可展开查看输出。

| 单元 | 子功能 | 用途 | 实现 |
| MELCHIOR-1 科学家 | run_script | 跑分析脚本：核对数量级、模拟、检查环境 | Python / JavaScript / PowerShell / Bash / Batch / VBS / .NET |
| BALTHASAR-2 母亲 | compose_text | 起草通知、信件、声明、清单、备忘、摘要 | 模板化 Markdown / 纯文本，落盘到 <ledgerDir>/drafts/ |
| CASPER-3 女人 | desire_map | 欲望读数：想要什么、想要背后的想要、价格、底线、所有权、十年回看 | 结构化一致性检查；只在两个选项真正打平时允许 tieBreak 抽签当镜子 |

- 尽量免安装：Python / JavaScript 优先用 DSH 自带运行时；PowerShell / Batch / VBS 用 Windows 自带； .NET 是把 C# 源码交给 PowerShell Add-Type 编译执行；Bash 需要 Git Bash 或 Unix bash。
当前机器上哪些引擎可用，会实时写进该单元的系统提示词。
- 脚本隔离：每次执行落在 <ledgerDir>/lab/run-…/ 独立目录，cwd 固定在那里；单次默认 15 秒超时并杀进程树； stdout+stderr 截断到 8000 字，超过 4 倍上限直接终止；环境变量走白名单，不把 DSH/API 凭据传给脚本。
- 总开关：abilities.enabled: false 会同时关闭提示词里的子功能段与执行入口，回到纯三票表决。
- ⚠️ 这不是安全沙箱：脚本以当前用户权限运行。只让它做分析计算，不要在里面放密钥；不需要时请关闭 abilities。

历史记录（账本）

每次表决都会立即落盘，不依赖界面是否还开着：

| 文件（<workspace>/.magi/，可用 ledgerDir 改） | 内容 |
| ledger.jsonl | 一条表决一行完整 JSON：议题、背景、三份原始意见、计票、判决、耗时、人格哈希 |
| ledger.index.json | 最近 500 条的摘要索引：key / id / seq / 判决 / 档位 / 票数 / 时间 / 议题前 120 字 |
| counter.json | 决策编号计数器（MAGI-DECISION No.000N） |

读取方式有三种：工具 magi_history(limit?, key?)、HTTP GET /magi/api/history（摘要 + 完整记录）与 GET /magi/api/result?id=<key>（单条），以及端末模式的「历史」抽屉：

- 按钮在端末模式顶部中间；抽屉按条列出最近的记录（编号 / 判决 / 票数 / 档位 / 时间 / 议题缩略）。
- 点任一条 → 载入该次决议并切到詳細模式看三份意见全文；Esc 或「关闭」关闭。
- 「清空历史」需要连点两次确认（5 秒内），或直接 DELETE /magi/api/history。
清空只删除 ledger.jsonl 与 ledger.index.json 的内容；counter.json 保留，已发出的决策编号不回收，清空后下一条继续按 No.000N+1 递增。

配置

改 cordis.patch.yml 里那一行的 config：

| 字段 | 默认 | 说明 |
| provider / model | '' | 留空 = 沿用会话默认模型（推荐） |
| personasDir | '' | 人格外部文件目录，空 = 只用内置 |
| criticalKeywords | 内置词表 | 命中即升级为 critical |
| llmMode / ledgerDir / historyLimit | live / .magi / 50 | 桩模型离线自检 / 账本目录 / 历史条数 |
| abilities | 开启，2 次 / 15s / 8000 字 | 子功能总开关与限制：enabled、maxToolCallsPerUnit、scriptTimeoutMs、maxOutputChars、labDir、draftsDir |
| ui.crtEffects / ui.bootSequence | true / false | 界面动效开关（bootSequence 目前还没有对应实现） |

其余字段（timeoutMs、maxTokens、passTemperature、useWeights、stubDelayMs…）见 lib/config.js。

⚠️ 覆盖配置时要重述整份 config：Loader 的 patch 是整值替换、不做按键深合并，只写要改的那一项会让其余项回落默认。

人格可以随时改

人格默认内置；导出成外部文件后每次表决现读，改完下一次表决即生效，不需要重启：

magi_personas(action="export") # 导出 melchior.md / balthasar.md / casper.md / contract.md
magi_personas(action="show") # 看当前生效的是内置还是文件，以及哈希与字数

contract.md 是公共输出契约（JSON 结构、反 AI 腔规则、判定口径），改它等于同时改三台的说话方式。
文件缺失时静默使用内置；读取失败或内容为空则回退内置并显式告警。
每票都记录人格与契约的 sha256，人格变更会在结果 notes 里写明。

除了直接改文件，也可以在端末模式点盾形 →「修改」在界面里编辑并保存（见上一节）。

开发

本仓库就是插件包（仓库根即 package.json 所在目录）。DSH 桌面版不把 node 放进 PATH，用自带运行时：

NODE="C:\Users\<你>\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe"

& $NODE test\magi.test.mjs # 46 项：计票 / 加权 / 敏感词 / 配置 / 账本（含清空） / 子功能回合 / 桩模型端到端 / 失败降级 & $NODE test\api.test.mjs # 14 项：路由（含清空、人格保存与跨站拒绝） & $NODE test\personas.test.mjs # 9 项：人格外部文件层（含手动保存与缓存失效） & $NODE test\abilities.test.mjs # 13 项：欲望读数 / 文本起草 / 脚本运行 / 能力注册表 & $NODE tools\magi-dev-server.mjs --port 8790 # 离线开发服务器（桩模型，不联网）+ 预览页 & $NODE tools\sse-smoke.mjs --port 8790 --question "…" # 协议冒烟

面板与卡片走 /magi/api/*（vote / events / history / history DELETE / result / config / personas / persona POST / debug），实现见 lib/api.js。
预览页要用的 React（preview\vendor\）不随仓库分发，克隆后先跑 node tools\extract-host-react.cjs 从本机 DSH 的 app.asar 现场生成。

打包：node tools\pack-plugin.mjs [--publish] —— 校验官方 bundle 清单，产出可安装目录与 .tgz； --publish 另出 npm 格式包，并联网核对名字 / 版本占用。

合规与许可

MAGI / NERV / 三贤人 的名称与人设属致敬性引用；本插件不含任何官方图像、字体、音频或模型素材，界面全部用 CSS / SVG 自绘，不含任何音频。MIT。