Consilium Principis

English · Русский

Consilium Principis

多种视角。一个决定。引文与原文逐字核对。

面向 Claude Code 和 MCP 主机的 AI 顾问委员会。遇到难以抉择的事时，向它提问：顾问们从不同角度审视问题，彼此质疑，并为你给出下一步行动。标记为 🔵 的内容由代码与原文逐字核对。如果原文中没有这句话，顾问就不会把它作为引文呈现。

示例：“马可·奥勒留会怎么看这件事？”Consilium 可以将模型的解读标记为 🟡，展示经原文核对的段落 🔵，或者在语料库不支持时拒绝引用。观看实时拒绝与核验 →

在 Claude Code 中快速开始

/plugin marketplace add ilyautov/consilium-principis
/plugin install consilium-principis@consilium-marketplace

然后提问：“帮我决定该专注于什么。” 关于 Claude Desktop、其他 MCP 主机和本地设置，请参阅安装。该插件使用你现有的 Agent；如有模型或提供商费用，则按你的主机设置收取。

探索：查看一场讨论 · 引文核验的工作原理 · 安装 · 限制

这是怎样的项目

**Consilium Principis 是面向 AI Agent 的技能和 MCP 服务。**将它连接到你的 Agent，提出一个需要你做决定的问题，它就会召集一群顾问：孙子、马可·奥勒留、马基雅维利、爱比克泰德，以及你添加的其他人。每位顾问都会用自己的视角审视问题，依据自己的文本展开论证——与你交流，也与其他顾问辩论。最后，你会得到一份综合意见和一个下一步行动。如果问题可以量化（“X 和 Y 哪个更划算”），委员会不会凭感觉判断，而是把决策拆解为数字，并用蒙特卡洛方法进行计算。

这个项目不会让 AI 扮演圣贤——我们尝试构建的是工具，而不是角色扮演游戏或格言生成器。接下来，我们会说明为什么你可以相信它引用的内容。

关于与会者，有一点需要坦诚：他们并非思想家本人，而是他们的 AI 版本——透过他们公开文本语料呈现其观点的棱镜。没有人会“从冥界发言”。顾问采用作者的视角，并依据其言论展开分析，但本质上仍然是一个模型——我们会明确说明这一点。

Consilium 无需单独的 API 密钥。它运行在你已有的 Agent 上，该 Agent 使用的模型或提供商可能会收取费用。核验引文无需联网；要完全离线使用，则需要本地模型。

与其他议事团的区别

“多个 AI 一起审议”这种机制已经很常见。Consilium 的独特之处不在于发言者的数量，而在于观点可以重新核验；无法核验时，议事团会诚实地保持沉默：

	“扮演一位智者”（一个 AI）	LLM-Council 式议事团	带引文核验的角色议事团（例如 roast-room）	Consilium
不同视角，将意见分歧作为一种优势	±	✅	✅	✅
逐字核对引文，确认其与所归属顾问的语料一致	✗	✗	± 使用汇总语料，在会话结束后核验	✅ 按顾问分别核验，在输出前完成
语料范围之外诚实地保持沉默（默认拒绝）	✗	✗	✗	✅
由代码计算结论，并为破产风险和不可逆押注设定上限	✗	✗	✅	✅
可量化的问题 → 蒙特卡洛模拟（📐）	✗	✗	✗	✅
使用不同模型担任席位，且可通过你已有的订阅使用	✗	± API 密钥	✗	✅ Claude Code / Codex / Kimi
项目无需单独的密钥	±	±	✅	✅

_{“私人董事会”是一种主流做法（源自 HBR 的概念）；对事实依据和引文透明度的重视，已得到市场（Delphi，获红杉资本投资 1,600 万美元）和学术界（多角色辩论、ALCE 基准）的验证。我们的着眼点是严谨：可核验的引文和诚实的拒绝。}

效果展示

你用日常语言提问：

“我同时在权衡四个方向。应该把重点放在哪里？”

你得到的不是一个圆滑、面面俱到的回答，而是一场会话：每位顾问都从自己的视角出发，而且他们会有不同意见：

Sun Tzu（“战略家”视角）🟡 “处处强大，便处处不强。四条战线中，选出你占有优势的一条，集中力量；其余的则维持在最低限度。”

Machiavelli 🟡 “力量分散，就会在每条战线上都显得薄弱，也会处处受制。问题不是‘要发展什么’，而是‘你愿意放弃什么’。这才是关键决定。”

Marcus Aurelius 🔵 “作为一名罗马人和一个人，你应当始终诚挚而不懈地致力于完成眼前的一切。” (《沉思录》，Long 译)。全心做好眼前之事；同时做四件事只会分散精力。 ↳ 要是问他文本中没有的事，他会诚实地保持沉默，而不是编造引文。

接下来是综合结论（他们真正达成共识之处）和一个具体的下一步。意见分歧在这里是一种优势：你能从不同角度看待决策，发现独自思考时可能忽略的方面。如果问题可以量化（“X 和 Y 哪个更值得？”），议事团会建议不凭直觉争论，而是进行计算（见下方 📐）。

_{此示例仅作说明；顾问是根据文本构建的 AI 形象，并非作者本人。🟡 = 符合作者思想的观点（模型通过作者的视角进行推理），🔵 = 带有语料来源的逐字引文。所有示例人物均为公版人物（Sun Tzu、Aurelius、Machiavelli、Epictetus）；由谁加入你的议事团，由你决定。你的真实会话会保存在本地的 council/ 目录中，绝不会提交到 git（参见技术设计）。}

你可以问什么

无需学习命令。只要说 "what can you do?"，看板就会显示菜单。例如：

• "What could go wrong with my launch?" 事前检讨：找出可能出问题的地方，以及需要提前加固之处
• "What would Aurelius say about burnout?" 一位顾问，严格依据他的著作作答
• "Have Sun Tzu and Machiavelli argue about X" 让两种观点针锋相对
• "Which is more worthwhile, going back to a salaried job or sticking with my own thing?" 📐 决策图：拆解成数字并进行计算（而不是凭直觉争论）
• "Help me win this argument" 像国际象棋引擎一样拆解立场：你的走法、反击，以及公正的判断
• "Am I contradicting myself?" 一面镜子：你说的话与你实际做出的选择

为什么你可以信任它

这不是「一个扮作智者的聊天机器人」。每句话都带有保护性标记。

真正的证据不在语气，而在于可验证性：逐字引文（🔵）会通过代码与作者的真实语料逐字核对，并附上来源。如果找不到完全匹配的原文，顾问就会如实保持沉默（故障时关闭），而不是编造。这就是决策工具与「扮演智者」的区别：每项主张都可以重新核查。

标记	含义
🔵	来自作者真实语料的逐字引文，已逐字核验，并附有来源
🟢	逐字引文，但出自评论／诠释（不是作者本人的口吻），并注明评论者
🟡	符合作者的思想精神，但并非作者原话，并已如实标明
📐	计算：用 Monte Carlo 对你自己的数字进行运算；它不是事实，也不是引文，只是将你自己的模型运行 N 次
弃答	问题超出语料范围 → 顾问会保持沉默，而不是编造内容

此外，采用不同视角，而非合唱：每位顾问都有自己的角度，彼此意见不一致是协作的一部分，不是缺陷。你可以从不同侧面看待决策，避免把它们混为一谈。

诚实标记本身由代码实现，而非模型：它可以在任何机器上将每条引文与其来源核对，无需密钥，也不产生费用。没有语义判断时，只会降低搜索精度，绝不会影响诚实性。候选内容的相关性通过两阶段门槛评分：模型负责判断，代码负责应用阈值，因此主题相近但实际没有回答问题的内容，不会混入 🔵。默认由主机进行评分——它是有利益关系的一方，doctor 会对此如实标明；如果想要独立评判，可以连接本地（ollama）或 API 后端，这是一个明确的选择。API 后端使用 OpenRouter（openrouter.ai），需要你自己的 OPENROUTER_API_KEY：查询和候选段落会发送到那里进行评分。除非你主动启用，否则任何内容都不会离开你的机器。逐字引文的 🔵 门槛从不依赖评判模型：它由代码把关。

计算，而不只是讨论：📐 决策图

讨论板有两种模式。第一种是会话（讨论、质疑、综合）。第二种模式用于可量化的决策问题（“哪个更值得”“值不值得”“X 还是 Y”）：讨论板不再给出凭直觉的答案，而是将选择拆解成一张决策图，包含选项、数量（采用你自己的数字，并通过三点式“最差／典型／最好”估算来征询，以避免锚定效应）和公式。接下来是确定性蒙特卡洛（由代码计算，不使用大模型参与计算，相同种子会得到相同结果）：最佳选项的概率、龙卷风敏感性图，以及真正左右结果的因素。必须包含“什么都不做”这一选项。讨论板也会通过事前验尸（“一年过去了，事情失败了，为什么？”）和针对关键不确定因素的 2×2 矩阵来拆解问题。所有内容都归在 📐 标签下，与 🔵/🟢/🟡 并列，但绝不混为一谈：这不是智慧，而是你自己的模型，并以数值运行。如果你记录了决策，讨论板之后还会对照预测与实际结果（结果闭环：校准你的模型，而不是判断“猜对了还是猜错了”）。

默认情况下，保持清晰易懂：讨论板会使用你的语言回答，并给出简洁明确的结论，不附加多余数字。🔵 引文会保留原文（以便核实），并附上译文。需要完整拆解（概率、立场的稳健性、逐个来源的标注）时，只要说“向我展示详细信息”。

安装

通过 Claude Code 插件（推荐）

在 Claude Code 中：

/plugin marketplace add ilyautov/consilium-principis /plugin install consilium-principis@consilium-marketplace

Claude Code 会启动 MCP 服务并注册技能。然后说 “我该从哪里开始”，礼宾助手会检查准备情况并搭建一个入门讨论板（Marcus Aurelius 和 Epictetus，公有领域作品）。

通过 skills.sh（CLI）

从 skills.sh 注册表中，运行一条命令即可安装精简的入门引导：

npx skills add ilyautov/consilium-principis/skills/consilium-connect

此操作只会安装 consilium-connect 引导技能：它会说明需要本地 MCP 服务，并引导你完成连接（请参阅上面的路径或 CONNECT-MCP.md）。讨论会和所有工具都在服务中，而非这份 Markdown 文件里——这是一个发现渠道，不是可实际使用的安装方式。

或直接安装

**最简单的方法：让 Claude 为你安装。**打开 Claude Code 并提供链接：

“为我安装这个技能：https://github.com/ilyautov/consilium-principis”

Claude 会克隆仓库、运行 python3 install.py（副本会安装到 ~/.claude/skills/，并包含自检），然后向你报告结果。不需要密钥，也不需要终端。然后说 “我该从哪里开始”，它会在几分钟内搭建一个入门讨论板（Marcus Aurelius 和 Epictetus，公有领域作品）。

第一次没成功？把下面这段原样发给 Claude：

git clone https://github.com/ilyautov/consilium-principis ~/consilium-principis
cd ~/consilium-principis && python3 install.py

更喜欢按钮或终端？请参阅 QUICKSTART.en.md：里面有点击安装方式（install.command / .bat）和手动安装流程。

或使用 Claude Desktop 安装包

发行版提供单文件 .mcpb 安装包——一个 Claude Desktop 扩展。下载后，在 Claude Desktop 中打开 Settings → Extensions → install from file。Claude Code 用户无需安装；使用上面的路径即可。其他 MCP 宿主的接入详情请见 CONNECT-MCP.en.md。

要更新，重新运行安装（会合并文件并保留你的 advisors/ 理事会）。要卸载： 如果你是作为插件安装的，请在 Claude Code 中运行 /plugin uninstall consilium-principis；如果你是通过脚本安装的，请删除 ~/.claude/skills/consilium-principis。

**Claude Desktop 或其他 MCP 宿主：**服务会将其工作流程（构建、会话、小组件）作为工具公开。宿主兼容性各不相同；请查看 docs/CONNECT-HOSTS.en.md 中的测试状态表，然后从检出目录生成可移植配置： python3 scripts/board.py mcp-config --json。

**你只需要：**Python 3.10+。如需智能跨语言搜索，可选用 ollama 和 bge-m3（理事会会引导你完成设置）。无需它也能运行轮廓。

Windows

Windows 尚未完成端到端测试，因此暂不作为受支持的平台。install.bat 和 mcpb 安装包中包含 Windows 启动路径，但请将其视为实验性功能，并通过 支持报告结果。以下两点是 Windows 用户需要了解的事项：

• 在终端中使用 py install.py（而不是 python3 install.py）。python.org 安装程序会安装 py.exe 和 python.exe，但不会安装 python3.exe；你可能在 Microsoft Store 下看到的 python3.exe 是 App Execution Alias 存根，只会打开 Store，而不会运行程序。
• **插件找不到 Python？**启动 Claude Code 前，请在环境中设置 CONSILIUM_PYTHON=py。插件的服务命令默认使用 python3，并支持此覆盖设置。（Claude Desktop 路径无需设置任何内容——board.py mcp-config 会为你写入确切的解释器路径。）
• **MCP 配置：**运行 py -3 scripts/board.py mcp-config --json（或运行 py -3 scripts/board.py mcp-install 以用于 Claude Desktop）。如果没有 py，请先确认 python 是 Python 3.10+，然后再使用；请勿使用 Store 的 python3 别名。确切的备用方案请见 CONNECT-MCP.en.md。

Codex CLI 和 Kimi Code CLI（实验性）

python3 install.py --host codex     # or: kimi, all; add --dry-run to see the plan first

安装程序会将技能放到各 CLI 查找的位置，并注册 MCP 服务（Codex 使用 codex mcp add，Kimi 则会备份并合并到 ~/.kimi-code/mcp.json）。如果 Codex 中有指向不存在路径的过时条目，安装程序会将其替换，同时保留每项工具的审批设置。详情： docs/CONNECT-HOSTS.en.md。

不同模型组成的理事会，使用你的订阅

一个模型身兼数职会犯相关性错误。如果你已安装并登录 Claude Code、Codex 或 Kimi Code，理事会就能让不同模型分别入席，无需任何 API 密钥：请 Agent“基于我的订阅运行理事会”，或在终端中运行：

python3 scripts/federation/sub_worker.py --open --session s1 \
  --question "Should I quit my job to start a business?" \
  --advisors advisors/marcus-aurelius,advisors/machiavelli --backends claude,codex

每个订阅都会为每位顾问提供支持；引用仍会经过语料库检查，且只有服务能够将其标记为 🔵。你的问题会发送给这些服务提供商，并使用你账户下的配额（隐私、限制 §7–8）。

你的议事桌，由你做主

开箱时议事桌是空的，这很正常。 邀请谁入席由你决定；议事桌只属于你。用一句话即可汇集公有领域的智者（斯多葛学派、孙子）。现代思想家的材料则由你自行提供。

⚖️ 边界。 Consilium 是一个忠实度引擎，而非内容分发器：它提供运作机制，来源由你提供。该技能不会下载受版权保护的书籍。公有领域的资料可自由使用；受版权保护的资料只能使用你自己的合法副本，并且这些副本会留在你的设备上。我们预先组装好的智者都是已故多年的公有领域人物；现代人物则由你自行创建。你的议事桌（advisors/）和个人资料属于个人数据；它们绝不会进入代码仓库。

构建方式

搜索分为两个支持层级：SIMPLE 是基于标准库的词汇搜索基础层；FULL 增加了使用 bge-m3 的 Ollama，以支持跨语言语义搜索。Hybrid 检索是可选功能，不属于第三个支持层级。保护机制独立运行：无论选择哪个层级，它都会对照来源检查每条引文。详情见 SKILL.md（俄语）和生成的 docs/MANUAL.md（俄语）。

技术设计

完整技术手册（项目介绍、架构、工具和规则参考、扩展方法）位于 docs/MANUAL.md。该手册由代码生成（scripts/gen_selfdoc.py → scripts/build_manual.py）；运行时也可通过 MCP 工具 explain_self 获取相同信息。

常见问题

什么是 Consilium Principis？ Consilium Principis 是一个开源 AI 顾问团——既是 Claude Code 技能，也是 MCP 服务——它召集由真实思想家构成的 AI 人格小组（孙子、马可·奥勒留、马基雅维利、爱比克泰德，以及你添加的任何人物），共同推演决策。它的独特之处在于忠实度保护机制：每条逐字引文都会对照作者的原文核实，否则顾问就会 abstain。

它如何核实引文？ 每条 🔵 引文都会通过代码与作者的公有领域语料逐字核对。如果原文中找不到某项说法，顾问就不会将其作为引文呈现，而是保持沉默（默认拒绝），不会凭空捏造。你可以自行再次核实，而非盲目相信。

这和让 AI 扮演一位智者有什么不同？ 角色扮演聊天机器人很可能会编造听起来可信的引文。Consilium 要么用真实文本证实引文，要么拒绝将其归于该作者。顾问之间意见不一是特色，不是缺陷：每位顾问都会从不同视角发言。

需要 API 密钥或额外付费吗？ Consilium 本身不需要单独的密钥或订阅。它使用你现有的 Agent，而其模型或服务提供商可能会产生自己的费用。引文核实不需要联网；要完全离线运行，则需要本地模型。

包含哪些思想家？我可以添加自己的人选吗？ 公有领域人物（斯多葛学派、孙子、马基雅维利）只需一句话，即可根据他们自己的著作完成组装。你也可以使用公有领域资料或自己的合法材料自行添加顾问；这些材料会留在你的设备上——代码仓库只提供运作机制，绝不包含受版权保护的来源。

它免费且开源吗？ 是的。它采用 MIT 许可证并开源。使用 /plugin marketplace add ilyautov/consilium-principis 安装。

贡献与安全

欢迎提交 PR，但有两条规则绝不妥协：仅限公有领域文本（不得包含受版权保护的材料，哪怕是摘录），并且绝不削弱故障关闭边界（🔵 仅通过代码验证）。如何设置、运行离线套件并提交 PR，请参阅 CONTRIBUTING.en.md。 发现绕过保真边界的方法或数据泄漏？这是一级漏洞，请通过 SECURITY.en.md 私下报告。支持与项目治理信息见 SUPPORT.md 和 GOVERNANCE.md；变更历史见 CHANGELOG.md。

---

---

构建者

Ilya Utov，来自 AI Frontier 实验室。我会在 Telegram 和 LinkedIn 分享这些工具的内部工作原理。

相关项目：

• humanizer-ru：去除俄语文本中的 AI 痕迹
• marketplaces-mcp-ru：让 Agent 直接使用 Wildberries、Ozon、Yandex Market 和 Avito
• small-business-ru：为俄罗斯小企业提供 34 项技能，数字通过代码计算
• hefest：为工业工厂提供化学品安全保障，并将其保留在工厂自身的网络中
• cordon：位于不可信内容与 Agent 操作之间的确定性层

按功能分类的完整列表：ilyautov.github.io。源码：github.com/ilyautov。觉得有用？点个 Star，其他人才能发现它。