.brain --便携式决策日志
你的人工智能工具都会读取便携式决策日志。一台MCP服务器。任何AI工具。普通文件。
](https://badge.fury.io/py/nucleus-mcp)   ](https://www.npmjs.com/package/nucleus-mcp) 
每个AI编码会话都从重新解释上一个会话已经知道的上下文开始。 .brain 是存储库中的一个文件夹，Claude Code、Cursor和Codex都通过一个MCP服务器读取。决策、政策、计划——写一次，每次会议和每种工具都要记住。
麻省理工学院许可。基于文件（纯JSON+markdown）。没有嵌入。没有供应商锁定。
______________________________________________________________________
三个边界
随着时间的推移，使AI可靠性复合的核心循环是：
GROUND ALIGN COMPOUND
────── ───── ────────
Machine verifies Human corrects System learns
AI writes code → You fix a mistake → Delta recorded
GROUND checks → Verdict stored → DPO pair created
Receipt logged → Event emitted → Training data grows
│ │ │
└───────────────────┴────────────────────┘
Reliability improves地面 --5层执行验证。语法、导入、测试、运行时。在正式系统之外检查人工智能的工作。
对齐 --一个电话更正。 nucleus_align(action="correct", params={context, correction})每次校正都会自动记录一个判断，创建一个训练对，并发出一个事件。
复合物 --三角洲测量意图和现实之间的差距。反复出现的模式成为策略。负增量成为训练信号。
每个工具响应都显示了前沿健康状况：
[frontiers: GROUND 42 | ALIGN 12 | COMPOUND 28]______________________________________________________________________
快速开始
pip install nucleus-mcp
nucleus init --recipe founder两个命令。Nucleus正在运行。AI输出现已验证。
______________________________________________________________________
它做什么
114 MCP工具 横跨13个立面：
- 地面 --执行验证（5层：差异、语法、导入、测试、运行时）
- 对齐 --人工更正（一次通话中的判决+增量+DPO+事件）
- 记忆 --会话中持续存在的接合。写一次，永远回忆。
- 会话 --保存上下文，稍后继续。会话弧显示您最近的3个会话。
- 任务 --具有升级、HITL门和心跳监控的优先级队列。
- 治理 --终止开关、合规配置（欧盟DORA、MAS TRM、SOC2）、审计跟踪。
- 编排 --代理插槽、多脑同步、任务调度。
- 档案 --训练管道（SFT+DPO）、增量跟踪、前沿健康仪表板。
基准： 决策保留评估 --你的AI代理还记得为什么代码是这样的吗？
______________________________________________________________________
Nucleus Pro
上面的一切都是免费的（麻省理工学院）。Nucleus Pro增加了可验证的治理：
nucleus trial # 14-day free trial
nucleus compliance-check # Score your AI governance
nucleus audit-report --signed -o report.html # Cryptographically signed report19美元/月 或 149美元/年 — nucleusos.dev/pricing
| 免费 | 专业版 | |
|---|---|---|
| 13个工具、10个资源、3个提示 | 是 | 是 |
| 持久内存 | 是 | 是 |
| 治理和HITL | 是 | 是 |
| 审计跟踪（DSoR） | 是 | 是 |
| 已签署的审计报告 | -第25519版 | |
| 合规性导出 | 仅分数 | 完整PDF/HTML |
| 优先级问题 | -是的 |
______________________________________________________________________
安装
一键
| IDE | 安装 |
|---|---|
| 光标 | 添加到光标 |
| 克劳德代码 | npx -y nucleus-mcp |
| 任何IDE | pip install nucleus-mcp |
pip/npx
pip install nucleus-mcp或者使用npx（不需要Python设置）：
npx -y nucleus-mcp配置您的MCP客户端
克劳德桌面/光标/风帆
添加到MCP配置(claude_desktop_config.json 或同等）：
{
"mcpServers": {
"nucleus": {
"command": "npx",
"args": ["-y", "nucleus-mcp"]
}
}
}Alternative: use pip install directly
{
"mcpServers": {
"nucleus": {
"command": "python3",
"args": ["-m", "mcp_server_nucleus"],
"env": {
"NUCLEUS_BRAIN_PATH": "/path/to/your/project/.brain"
}
}
}
}克劳德代码
添加 .mcp.json 在项目根目录中：
{
"mcpServers": {
"nucleus": {
"command": "npx",
"args": ["-y", "nucleus-mcp"]
}
}
}路径发现
Nucleus找到您的 .brain 自动：
NUCLEUS_BRAIN_PATH环境变量（显式）- 从CWD向上走，寻找
.brain/目录 - 退回到
$HOME/.nucleus/brain
______________________________________________________________________
命令行界面
Nucleus除了MCP工具外，还有一个完整的CLI。自动检测TTY（表输出）与管道（JSON）。
# Memory
nucleus engram write my_key "insight here" --context Decision --intensity 7
nucleus engram search "compliance"
nucleus engram query --context Strategy --limit 10
# Tasks
nucleus task list --status READY
nucleus task add "Ship the feature" --priority 1
# Sessions
nucleus session save "Working on auth refactor"
nucleus session resume
# Health
nucleus status --health
nucleus sovereign
# Compliance
nucleus comply --jurisdiction eu-dora
nucleus audit-report --format html -o report.html
# Chat (multi-provider: Gemini, Anthropic, Groq)
nucleus chat管道友好型：
nucleus engram search "test" | jq '.key'
nucleus task list --format tsv | cut -f1,3______________________________________________________________________
合规
监管框架的一种命令配置：
nucleus comply --jurisdiction eu-dora # EU DORA
nucleus comply --jurisdiction sg-mas-trm # Singapore MAS TRM
nucleus comply --jurisdiction us-soc2 # US SOC2| 管辖权 | 保留 | HITL操作 | 终止开关 |
|---|---|---|---|
eu-dora | 7年 | 5种类型 | 必填 |
sg-mas-trm | 5年 | 5种类型 | 必填 |
us-soc2 | 1年 | 3种类型 | 可选 |
global-default | 90天 | 2种类型 | 可选 |
______________________________________________________________________
遥测
Nucleus收集匿名的聚合使用统计信息（命令名、持续时间、错误类型、版本、操作系统）。没有雕刻内容，没有文件路径，没有提示，没有API密钥，没有PII-永远。
nucleus config --no-telemetry
# or: NUCLEUS_ANON_TELEMETRY=false看 遥测.md 了解详情。
______________________________________________________________________
贡献
- 程序错误 打开一个 问题
- 特色创意？ 开始a 讨论
- 密码？ 看 贡献.md
- 聊天？ Discord 的中文翻译是“不和谐”或“纷争”。
许可证
麻省理工学院©2026| hello@nucleusos.dev
