README
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 票以上 approve → 承認;2 票以上 reject → 拒否;其余(含 1:1:1 或 2 票有条件)→ 有条件承認 |
critical(敏感 / 重要) |
三票必须一致 | 全票 approve 才 承認;全票 conditional → 有条件承認;任何混合或反对 → 否決 |
判决有四种:承認 / 有条件承認 / 拒否 / 否決。单元投 approve、conditional 或 reject;
conditional 表示「条件满足时同意」,必须写明条件,它不是弃权,也不是把判断推回人类。
所以不存在「保留 / 交还人类」这类悬置结果。档位由调用方显式传入;未传时按敏感词表自动升级
(删除、不可逆、密钥、隐私、资金、外发、上线、生产环境、医疗……),并在结果里写明命中了哪些词。
单元调用失败按保守默认记为拒否并注明;三台全失败则整次表决报错,不伪造判决。
每份意见还带 probability(0–1)与 probability_label(如「成功」「胜利」「正确」「支持」):
汇总结果取三台概率的算术平均,名词取三台里出现次数最多的一个(平票取第一台)。
端末模式在右上角判决框下方显示 成功 概率:xx.xx%。
用法
工具(agent 调用)
magi_vote(question, context?, criticality?, label?) 发起表决
magi_history(limit?, key?) 历史记录
magi_personas(action?, force?) 查看 / 导出人格
magi_vote 返回三份原始意见(stance / condition / probability / probability_label / 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.runScript/composeText/desireMap可以分别关闭对应单元的子功能, 关闭后该单元的提示词段落与执行入口同时停用;旧版的abilities.enabled: false仍作为总闸兼容。 - ⚠️ 这不是安全沙箱:脚本以当前用户权限运行。只让它做分析计算,不要在里面放密钥; 不需要时请关闭对应单元的子功能。
历史记录(账本)
每次表决都会立即落盘,不依赖界面是否还开着:
文件(<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递增。
配置
优先用插件管理页:侧栏 插件 → MAGI 三贤人 → magi 行 → 配置。
- 可直接改
personasDir(人格文件目录),并分别开关三台单元的子功能; - CRT 扫描线默认开启,不再提供开关;
- 保存由宿主校验并写回当前 profile,
personasDir与三个子功能开关都是 volatile,保存后立即生效,不需要重启; - 插件半声明了 Schemastery
Config,所以这些字段有校验和默认值,不需要手写 YAML。
也可以直接改 cordis.patch.yml 里那一行的 config:
更多「命令列與終端機」外掛
deepseek-harness-docker
作者 runzhliu
社群 Docker 與 Kubernetes 打包,含加固映象、Compose、Helm、Web UI 與無頭 CLI。
deepseek-harness-android
作者 dphmoblie
dsh安卓版:整合 DeepSeek Harness、Ubuntu 執行環境、外掛與檔案管理,以及使用者授權的 Shizuku 和無障礙自動化。
dsh-subagent-codex
作者 mjylfz
讓 DeepSeek Harness 以 Codex CLI 作為子代理的外掛,在對話中複用 Codex 的編碼與推理能力。
mnemon
作者 mnemon-dev
LLM 監督的持久記憶系統,基於圖結構召回、跨會話知識共享,單個二進位制檔案,相容 DeepSeek Harness 等執行時。
