返回目錄

dsh-plugin-magi

維護狀態: 活躍

mengyuanzhuo/dsh-plugin-magi

為 DeepSeek Harness 提供帶有三個終端介面的 MAGI 風格系統。

前往 GitHub
$ dsh plugin add dsh-plugin-magi

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README 中的設定行加入你的 profile / patch 設定,然後重啟即可。

查看安裝教學

10

星數

2

Fork

JavaScript

語言

NOASSERTION

授權條款

2026-10-14

建立於

2026-11-20

最近推送

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:

在 GitHub 閱讀完整 README →

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。