Hegelion
“真理是整体。”——黑格尔
Hegelion将辩证推理应用于LLM:迫使模型在得出结论之前与自己争论。这将为问题提供更好的推理,并为实现提供更好的代码。
Hegelion在默认情况下是提示驱动的:它生成结构化提示供编辑器执行,不需要API键。可选的服务器端后端支持直接执行和独立的教练验证。
通过Claude Desktop中的MCP、Cursor、VS Code或任何启用MCP的编辑器使用它,或者通过您自己代理中的Python API使用它。
______________________________________________________________________
两种模式
| 模式 | 模式 | 用例 |
|---|---|---|
| 辩证推理 | 论文→ 对立→ 综合 | 深入分析问题、哲学、战略 |
| 自动编码 | 玩家→ 教练→ 迭代 | 通过独立审查验证代码实现 |
这两种模式都使用相同的原理: 迫使模型自我对立 在结束之前。这抓住了单程接近时错过的盲点。
______________________________________________________________________
自动编码:球员-教练循环
更新于v0.5.0 --基于 阻止AI的g3代理研究.
问题
单代理编码工具通常:
- 过早宣布成功(“我已经成功实现了所有要求!”)
- 在长时间的会话中积累上下文污染
- 错过了边缘案例,因为它们验证了自己的工作
解决方案
两个角色迭代,直到需求得到验证:
REQUIREMENTS (Source of Truth)
│
▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ PLAYER │────▶│ COACH │────▶│ ADVANCE │
│ Implements │ │ Verifies │ │ State │
│ code & tests │ │ independently │ │ │
└───────────────┘ └───────────────┘ └───────┬───────┘
▲ │
│ ┌───────────┐ │
└──────────────│ APPROVED? │◀───────────────┘
└───────────┘
│ │
No Yes
│ │
▼ ▼
Continue Done玩家:实现需求、编写测试、响应反馈。不宣布成功。
教练:独立验证每个要求,忽略玩家的自我评估,输出结构化的检查表。 当Codex MCP可用时,Hegelion可以启动一个单独的Codex会话来担任教练,而当前会话仍然是玩家。
关键洞察
“放弃球员的自我成功报告。让教练进行独立评估。”
教练通过重新阅读要求和实际运行测试来发现问题,而不是相信球员所说的。
快速入门(自动编码)
在Claude Code、Cursor或任何启用MCP的编辑器中:
提示:如果你的编辑器公开了斜线命令,你可以使用 /hegelion 作为包装材料。 底层MCP工具包括 autocode 和 autocode_turn.
You: Call autocode with mode=init and these requirements:
- Add user authentication to src/api.py
- Add tests in tests/test_auth.py
- All tests must pass
[Session initializes]
You: Call autocode_turn with role=player and implement
[Player writes code and tests]
You: Call autocode_turn with role=coach, execute=true, backend=auto, cwd=
[Separate Codex coach verifies the workspace when available]
You: Call autocode_turn with role=advance, coach_feedback, approved=false
[Loop until COACH APPROVED]状态流: 每 autocode_turn 返回更新的 state 对于下一个调用,将其传递给下一个工具调用。所有输出包括 schema_version 为了客户的稳定性。看 MCP集成 用于Codex教练设置。
MCP工具
| 工具 | 目的 |
|---|---|
dialectic | 统一辩证推理(mode: single_shot, workflow, thesis, antithesis, synthesis) |
autocode | 统一自动编码入口点(mode: init, workflow, single_shot) |
autocode_turn | 执行一次自动编码转弯(role: player, coach, advance) |
autocode_session | 保持或恢复会话(action: save, load) |
Codex技能(可选)
此repo包括Codex技能 skills/hegelion/SKILL.md.用你的技能安装它 安装程序(例如, install-skill-from-github.py --repo Hmbown/Hegelion --path skills/hegelion). 它反映了 /hegelion 命令,将当前Codex会话视为玩家,并在可用时将教练转向单独的Codex后端。
为什么它有效
| 问题 | 单人代理 | 教练球员 |
|---|---|---|
| 锚定 | 偏离要求 | 要求锚定每一圈 |
| 验证 | 自我评估(不可靠) | 独立验证 |
| 上下文 | 累积污染 | 每一轮都有新的背景 |
| 完成 | 开放式 | 明确的审批门 |
______________________________________________________________________
辩证推理:论题→ 对立→ 合成
对于需要深入分析的问题,Hegelion强制进行三次单独的LLM调用:
[Call 1] Thesis → LLM commits to a position
[Call 2] Antithesis → LLM attacks that position (separate call, no hedging)
[Call 3] Synthesis → LLM reconciles the opposition为什么单独通话很重要
| 方法 | 调用 | 结果 |
|---|---|---|
| 原始 | 1 | “这取决于定义……” |
| 增强 | 1 | “保持两种观点的紧张状态……” |
| Hegelion | 3 | 具有可测试预测的新颖框架 |
当模型必须致力于一个论文,然后在单独的调用中真正攻击它时,综合会揭示出单个调用接近捷径的见解。
Example: "Is free will compatible with determinism?"
Hegelion合成 (在论文和对立面之后):
当我们认识到自由意志存在于 自我创作谱: 1. 最小自由度:在没有外部胁迫的情况下根据欲望行事 1. 反思自由:二等背书——我想要这个 1. 叙事自由:按照连贯的生活叙事行事 1. 组织自由:通过有意的习惯化进行递归的自我修改 研究计划:使用fMRI对参与者进行以下扫描:(1)快速判断,(2)简短反思,(3)深入思考。假设:条件(3)与自我报告的决策“所有权”的相关性最强
这个四级框架源于实际的自我论证,而不是在一个提示中要求“论文/对立/综合”。
快速入门(辩证法)
pip install hegelion
# MCP setup (auto-detects OS)
hegelion-setup-mcp --host claude-desktop
# MCP setup for Claude Desktop (macOS)
hegelion-setup-mcp --write "$HOME/Library/Application Support/Claude/claude_desktop_config.json"或者使用提示驱动的Python API(使用您选择的LLM运行提示):
from hegelion.core.prompt_dialectic import create_single_shot_dialectic_prompt
prompt = create_single_shot_dialectic_prompt(
"Is AI conscious?",
use_council=True,
response_style="sections",
)
print(prompt)健康检查(列出工具+生成示例提示):
hegelion-server --self-test功能切换
| 选项 | 描述 |
|---|---|
use_council | 三位批评家:逻辑学家、经验主义者、伦理学者 |
use_search | 以网络搜索为论据 |
response_style | sections, json,或 synthesis_only |
______________________________________________________________________
安装
pip install hegelion对于MCP集成(适用于任何启用MCP的编辑器):
# Shortcuts
hegelion-setup-mcp --host claude-desktop
hegelion-setup-mcp --host cursor
hegelion-setup-mcp --host vscode
hegelion-setup-mcp --host windsurf
# Claude Desktop (macOS)
hegelion-setup-mcp --write "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
# Claude Desktop (Windows)
hegelion-setup-mcp --write "%APPDATA%\\Claude\\claude_desktop_config.json"
# Claude Desktop (Linux)
hegelion-setup-mcp --write "$HOME/.config/Claude/claude_desktop_config.json"
# Then restart your MCP host克劳德代码(无需MCP设置):
# Use /hegelion command directly in any Hegelion repo clone
# Or add MCP server for tool access
claude mcp add hegelion python -- -m hegelion.mcp.server手动配置(任何MCP主机):
{
"mcpServers": {
"hegelion": {
"command": "python",
"args": ["-m", "hegelion.mcp.server"]
}
}
}如果从源代码(而不是站点包)运行,请设置 PYTHONPATH 到repo根目录。这 hegelion-setup-mcp 命令会自动写入此内容。 如果您的主机需要完整的命令路径,请使用 python -m hegelion.mcp.server 而不是 hegelion-server.
支持的编辑器: 克劳德桌面,克劳德代码,光标,VS代码+GitHub复制品,Windsurf,谷歌反重力,Gemini CLI
看 MCP集成指南 有关设置说明。
______________________________________________________________________
文档
- MCP集成 --Claude桌面、光标、VS代码+副本、Windsurf、反重力、Gemini CLI的设置
- Python API -提示驱动API参考
- CLI参考 --MCP服务器和设置命令
- 配置 --后端和功能切换
- 技术规范 --输出模式、相位规格
______________________________________________________________________
贡献
欢迎发布问题和PR。对于重大更改,请先展开讨论。
______________________________________________________________________
最近的更改
v0.5.0(2026年3月)
- 执行后端:已添加
prompt,cli,codex_mcp,以及autoMCP执行流的后端选择 - 独立Codex教练:
autocode_turn(role=coach, execute=true)现在可以运行单独的Codex MCP会话并返回coach_feedback - 快速回退:
backend=auto现在,当没有可执行后端可用时,它会干净地降级为仅提示输出 - LangGraph删除:删除了LangGraph包、额外依赖项、测试和文档引用
- MCP工具整合14个工具简化为4个统一工具:
dialectic,autocode,autocode_turn,autocode_session - 状态机简化:
AutocodingStatus远离的;phase现在是唯一的状态指示器 - 架构迁移:
schema_version撞到2具有向后兼容的v1-to-v2加载 - 验证清理:已添加
@validated装饰器+类型化规范,以删除重复的处理程序样板 - 删除死代码:删除了未使用的判断路径、未使用的对话状态和已弃用的响应样式
- Python 3.13支持:添加到CI和分类器中
- 公共API导出:
hegelion现在直接导出关键类(DialecticalPrompt,PromptDrivenDialectic,AutocodingState等等) - PEP 561
py.typed标记:为库使用者启用类型检查器支持 --version旗帜:两者都有hegelion-server和hegelion-setup-mcp现在支持--version
注: v0.4.x以下条目引用v0.5之前的工具名称(例如。dialectical_single_shot).这些被统一的dialecticv0.5.0中的工具。
v0.4.6(2026年2月4日)
- CI修复:修复了CI管道和自动发布工作流
v0.4.5(2026年2月4日)
- 单次调用CLI执行 为了
dialectical_single_shot:execute,timeout_seconds,max_retries hegelion-setup-mcp旗帜:--llm-command-json,--llm-command,--auto-execute
v0.4.4(2026年1月21日)
- 简化技能/命令:精简到最小路由表,MCP优先方法
v0.4.3(2026年1月12日)
- MCP重构:拆分工具、处理程序和验证,使服务器更容易扩展和维护
- 食典技能:已添加
skills/hegelion/SKILL.md为了/hegelion工作流
______________________________________________________________________
许可证: 麻省理工学院
