内容
**中文** ·
<div align="center">
<img src="assets/logo-consilium-principis.png" width="300" alt="Consilium Principis" />
# Consilium Principis
**一个由多个AI顾问组成的个人董事会——适用于需要多个可靠答案的决策。**
<img src="assets/demo-refusal-en.gif" width="760" alt="Consilium拒绝虚构的名言，并逐字确认真实的名言" />
<sub>实时演示：一个虚构的“ Aurelius 名言”被拒绝；一个真实的句子被确认 🔵 逐字逐句，与其来源相同。每次运行的判决都是通过代码计算的，而不是脚本。</sub>
每个顾问都通过自己的视角审视问题，与你和其他顾问进行辩论，最终董事会 **达成共识**。但最重要的是：Consilium 不会将似是而非的捏造当作作者的话——**逐字引用 🔵 通过代码与源文本进行验证**；如果语料库中没有确切的句子，顾问就不会引用。
[](https://github.com/ilyautov/consilium-principis/actions/workflows/ci.yml)
[](LICENSE)
</div>
---
## 这是什么
**Consilium Principis 是一个适用于AI代理的技能和MCP服务器。** 你可以将它连接到你的代理，提出一个需要决策的问题，它就会聚集一个董事会：孙子、 Marcus Aurelius、马基雅维利、 Epictetus 以及其他你添加的人物。每个顾问都从自己的角度看待问题，依靠自己的文本，并与其他顾问和你进行辩论。最后，你会得到一个综合意见和一个具体的下一步行动。如果问题是可量化的（“哪个更值得，X还是Y”），董事会不会凭感觉做出决定——它会将决策分解为数字，并通过蒙特卡罗方法进行计算。
这个项目并不要求AI扮演贤者——我们试图构建一个工具，而不是角色扮演游戏或格言生成器。为什么你可以信任它的引用接下来会解释。
董事会成员并不是贤者本身，而是他们的 **AI版本** ——他们观点的棱镜，是从他们的公开文本中提炼出来的。没有人“从坟墓外说话”。顾问坚持作者的立场，依靠作者的话，但仍然是一个模型——我们明确指出。
不需要额外的密钥或付款——Consilium 运行在你已经拥有的代理上。检查引用不需要互联网；一个完整的离线设置只需要本地模型。
## 它与其他的理事会有什么不同
“多个AI商议”的机制已经很常见。 Consilium 与众不同之处不在于数量，而在于主张可以 **重新验证**，而且在无法验证时，理事会会诚实地保持沉默：
| | “扮演贤者”（一个AI） | LLM-Council-style 董事会 | **Consilium** |
|---|:---:|:---:|:---:|
| 不同的视角，分歧作为一个特征 | ± | ✅ | ✅ |
| **逐字引用通过源代码与原文进行验证** | ✗ | ✗ | **✅** |
| **在语料库之外诚实沉默（失败关闭）** | ✗ | ✗ | **✅** |
| 可量化问题 → 蒙特卡罗（📐） | ✗ | ✗ | ✅ |
| 无需额外密钥或付款 | ± | ✗ | ✅ |
<sub> “个人董事会”是一种主流实践（HBR概念）；押注于接地和引用透明度的验证已经被市场（Delphi，1,600万美元来自红杉资本）和学术界（多人辩论，ALCE基准）所验证。我们的角度是严谨：一个可验证的引用和诚实的拒绝。</sub>
## 它是什么样子
<div align="center">
<sub> 拒绝 + 逐字验证在上面的演示中。 更多场景 - 错误归因，蒙特卡罗，跨语言： **[演示图库→](docs/demo/gallery.md)**</sub>
</div>
你用平实的语言提问：
> **“我同时处理四个方向。我应该专注于哪一个？”**
而不是一个顺利的、涵盖一切的答案，你会得到一个 **会话**，每个顾问从自己的角度看待问题，他们会产生分歧：
> **孙子** （“战略家”的视角） 🟡 “谁在每个地方都很强大，谁在任何地方都不强大。在四个方面中，选择你有优势的那一个，将你的力量投入其中；保持其他方面的最小限度。”
>
> **马基雅维利** 🟡 “分散太薄，你在每个方面都很弱，并且在所有方面都容易受到攻击。问题不是‘要发展什么’，而是‘你要放弃什么’。这是决定。”
>
> **Marcus Aurelius** 🔵 “要认真和坚持不懈地做一个罗马人和一个男人，做你正在做的事情” *(沉思，翻译：Long)*。做眼前的事情，完全投入；同时做四件事情是分散的。
> ↳ 如果你问他一个问题，他的文本中没有答案， **他会诚实地保持沉默，而不是编造一个引用**。
接下来是 **综合**（他们实际同意的地方）和 **一个具体的下一步行动**。这里的分歧是一个特点：你可以看到你自己无法看到的决策角度。如果问题是可量化的（“哪个更值得，X还是Y”），董事会将提供 **计算**（见下文的 📐），而不是凭感觉做出决定。
## 你可以问什么
不需要学习命令。说 **“你能做什么？”**，董事会会显示一个菜单。例如：
- **“我的发布可能会有什么问题？”** 预测失败：可能会出现问题，需要加强哪些方面
- **“Aurelius会如何看待倦怠？”** 单个顾问，严格按照他的文本
- **“让孙子和马基雅维利就X进行辩论”** 两个观点相互冲突
- **“哪一个更值得，回到薪水工作还是坚持自己的事情？”** 📐 决策图：将其分解为数字并计算（而不是凭感觉做出决定）
- **“帮助我赢得这场争论”** 像下棋引擎一样进行立场分析：你的行动，对手，诚实的判决
- **“我是否自相矛盾？”** 镜子：你说的话 vs. 你实际选择的话
## 为什么你可以信任它
这不是“一个扮演贤者的聊天机器人”。每个字都带有 **保护轮廓**。
真正的证明不在于语气，而在于可验证性： **逐字引用 🔵 通过代码与作者的原始语料库进行验证**，并附有出处。如果确切的句子在语料库中找不到，顾问会诚实地保持沉默（失败关闭），而不是编造一个。
| 标记 | 含义 |
|:---:|---|
| 🔵 | **逐字引用** 来自作者的真实语料库，逐字验证，并附有出处 |
| 🟢 | **逐字引用，但来自评论/解释** （不在作者自己的声音中），并附有评论者姓名 |
| 🟡 | **符合作者精神**，但不是确切的词语，诚实标记 |
| 📐 | **计算**：您自己的数字，通过蒙特卡罗方法运行；不是真相，不是引用，只是您自己的模型运行N次 |
| *弃权* | 问题在语料库之外 → 顾问 **保持沉默而不是编造** |
此外 **不同的视角，而不是合唱团**：每个顾问都保持自己的角度，他们的分歧是一个工作部分，而不是一个错误。你从不同的角度看待决策。
诚实轮廓本身就是代码，而不是模型：它在任何机器上检查每个引用与它的源代码，无需密钥，无需成本。没有语义，只有搜索精度会减弱，但诚实永远不会。
## 计算，而不仅仅是讨论： 📐 决策图
董事会中有两种模式。第一种是 **会话**（讨论，挑战，综合）。第二种是在 **可量化** 的决策问题上（“哪一个更值得”，“是否值得”，“X或Y”）：与其给出一个估计的答案，董事会会将选择分解为 **决策图**，即选项，数量（您自己的数字，诱导为三点“最坏/典型/最佳”估计，以避免锚定），和公式。然后是 **确定性蒙特卡罗**（代码进行数学运算，零LLM计算，相同的种子给出相同的结果）：P（最佳选项），龙卷风敏感性图表，实际驱动结果。 “不作为”选项是强制性的。将其分解为预测失败（“一年后失败了，为什么？”）和2×2关键不确定性也是董事会的工作。所有内容都位于📐标签下， **旁边** 🔵/🟢/🟡但永远不会混合：在这里，这不是智慧，而是您自己的模型，以数字运行。如果您记录决策，稍后董事会将检查 **预测与实际发生的情况**（结果循环：校准您的模型，而不是“正确或错误的猜测”）。
**默认情况下，简单来说**：董事会用 **您的语言**回答，并给出一个干净的结论，没有多余的数字。 🔵引用保持在原始语言中（以便验证），并附有翻译。需要完整的分解（概率，立场稳健性，按来源标记的源代码），只需说“给我看详细信息”。
## 安装
### 通过Claude Code插件（推荐）
在Claude Code中：
> `/plugin marketplace add ilyautov/consilium-principis`
> `/plugin install consilium-principis@consilium-marketplace`
Claude Code 将启动MCP服务器并注册技能。然后说 **“我在哪里开始”**， concierge将检查准备情况并组装一个启动董事会（公共领域人物， Marcus Aurelius 和 Epictetus）。
### 通过skills.sh（CLI）
从 [skills.sh](https://www.skills.sh) 注册表中，只需一个命令即可安装薄的 onboarding 通道：
> `npx skills add ilyautov/consilium-principis/skills/consilium-connect`
此安装仅 `consilium-connect` 指南技能：它解释了需要本地MCP服务器并引导您连接（参见上面的路径或 [`CONNECT-MCP.md`](CONNECT-MCP.md））。委员会和所有工具都位于服务器中，不在此markdown中 - 一个发现频道，不是工作安装。
### 或普通安装
**最简单的方法，让Claude为您安装。** 打开Claude Code并给它链接：
> “请为我安装此技能：`https://github.com/ilyautov/consilium-principis`”
Claude 将克隆存储库，运行 `python3 install.py`（副本位于 `~/.claude/skills/`，自检已包含），然后报告。 没有密钥，没有终端。 然后说 **“我在哪里开始”**，它将在几分钟内组装一个启动董事会（公共领域人物， Marcus Aurelius 和 Epictetus）。
如果第一次尝试不成功，请给Claude以下内容：
```bash
git clone https://github.com/ilyautov/consilium-principis ~/consilium-principis
cd ~/consilium-principis && python3 install.py
```
更喜欢按钮或终端？查看 [`QUICKSTART.zh.md`](QUICKSTART.zh.md)： 一键安装（[`install.command`](install.command) / `.bat`） 和手动路径。
### 或Claude Desktop捆绑包
[发布](https://github.com/ilyautov/consilium-principis/releases/latest) 提供一个`.mcpb`捆绑包 - 一个Claude Desktop扩展程序。下载它，然后在Claude Desktop中打开 **设置→扩展程序→从文件安装**。Claude Code用户不需要它；上面的路径足够。其他MCP主机所需的线路细节在 [`CONNECT-MCP.zh.md`](CONNECT-MCP.zh.md) 中。
**更新**，请重新运行安装（它合并，保留您的 `advisors/` 董事会）。 **卸载**：如果您作为插件安装，请在Claude Code中运行 `/plugin uninstall consilium-principis`；如果您通过脚本安装，请删除 `~/.claude/skills/consilium-principis`。
**Claude Desktop 或另一个MCP主机：** 服务器通过其周期（构建，会话，小部件）公开其工具。主机兼容性各不相同；请查看 [`docs/CONNECT-HOSTS.zh.md`](docs/CONNECT-HOSTS.zh.md) 中的测试状态表，然后使用 `python3 scripts/board.py mcp-config --json` 从checkout生成可移植配置。
**您需要的所有东西：** Python 3.10+。对于智能跨语言搜索，可选地 [ollama](https://ollama.com) 搭配 `bge-m3`（董事会将引导您设置）。轮廓无需它即可工作。
### Windows
Windows 目前不是一个完全支持的目标。 `install.bat` 和mcpb包包含一个Windows启动路径，但请将其视为实验性并通过 [支持](SUPPORT.md) 报告结果。 两个Windows特定事项值得注意：
- **在终端中，使用 `py install.py`** （而不是 `python3 install.py`）。 python.org安装程序提供 `py.exe` 和 `python.exe`，但没有 `python3.exe`；您可能在Microsoft Store下看到的 `python3.exe` 是一个应用执行别名存根，只是打开商店而不是运行。
- **插件找不到Python？** 在环境中设置 `CONSILIUM_PYTHON=py` 然后启动Claude Code。 插件的服务器命令默认为 `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 3.10+后使用 `python`。 请参阅 [`CONNECT-MCP.zh.md`](CONNECT-MCP.zh.md) 以获取确切的回退。
## 您的董事会，您的选择
**出厂时空的董事会是正常的.** 谁坐在桌子上由您决定；董事会是个人化的。 公共领域贤者（斯多葛派，孙子，马基雅维利）仅用一个短语组装而成。 现代思想家来自您自己带来的材料。
> ⚖️ **边界.** Consilium 是一个 **保真** 引擎， **不是内容分发器**：它提供机制， 您提供来源。 技能不会下载版权书籍。 公共领域免费获取； 版权意味着您自己的合法副本，它们保留在您的机器上。 预装的贤者是我们预装的公共领域人物；任何现代人您自己构建。 您的董事会 (`advisors/`) 和您的个人资料是个人数据；它们永远不会进入存储库。
## 它是如何构建的
搜索有两个支持层： **SIMPLE** 是标准库的词汇底线； **FULL** 添加带有 `bge-m3` 的Ollama进行语义跨语言搜索。 **混合** 检索是可选的，不是第三个支持层。 保护轮廓是单独的：它检查每个引用与其源代码，无论选择哪个层级。 详情见 [`SKILL.md`](SKILL.md) *(俄语)* 和生成的 [`docs/MANUAL.md`](docs/MANUAL.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服务器 - 它汇集了真正的思想家（孙子，Marcus Aurelius，马基雅维利， Epictetus等）的AI角色来讨论决策。其显著特点是 **保真轮廓**：每个引用都通过代码与作者的原始文本进行逐字验证，否则顾问不会将其作为引用提出。
**它如何验证引用？**
每个 🔵引用都通过代码与作者的公共领域语料库进行逐字检查。如果索赔在源文本中找不到，顾问不会将其作为引用提出 - 它会保持沉默（失败关闭）而不是编造一个。
**这与要求AI扮演贤者的角色有什么不同？**
一个扮演贤者的聊天机器人会编造一个听起来很合理的引用。 Consilium要么用真实文本证明引用，要么拒绝将其归因。 顾问之间的分歧是一个特点，而不是一个错误：每个人都通过不同的视角发言。
**它需要API密钥或额外付款吗？**
否。它在您已经拥有的AI代理（Claude Code）上运行。验证轮廓不需要网络；如果您添加本地模型，则完全离线操作。
**包括哪些思想家，我可以添加自己的吗？**
公共领域人物（斯多葛派，孙子，马基雅维利）仅用一个短语就组装好了。您可以从公共领域或您自己的合法材料中添加任何顾问，这些材料保留在您的机器上 - 存储库仅提供机制，从不版权材料。
**它是免费和开源的吗？**
是的。它是MIT许可的开源软件。 使用 `/plugin marketplace add ilyautov/consilium-principis` 进行安装。
## 贡献和安全
PRs是受欢迎的，但有两个不可妥协的规则： **仅限公共领域文本** （无版权材料，甚至不是摘录）和 **绝不削弱 fail-closed 轮廓** （ 🔵 仅通过代码验证）。 如何设置，运行离线套件和打开PR在 [`CONTRIBUTING.zh.md`](CONTRIBUTING.zh.md) 。 发现一种方法来绕过保真轮廓或数据泄漏？ 那是一个一流的漏洞，请通过 [`SECURITY.zh.md`](SECURITY.zh.md) 私下报告。 支持和项目治理在 [`SUPPORT.md`](SUPPORT.md) 和 [`GOVERNANCE.md`](GOVERNANCE.md) 中；变更历史在 [`CHANGELOG.md`](CHANGELOG.md) 中。
<div align="center">
<sub>Consilium Principis · early access (v0.1.3) · <a href="https://github.com/ilyautov/consilium-principis/releases/download/v0.1.3/consilium-principis.mcpb">发布产物</a> · <a href="LICENSE">MIT</a> · <a href="CONTRIBUTING.zh.md">贡献</a> · <a href="SECURITY.zh.md">安全</a></sub>
</div>
