Cambium_AI

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png"> <img src="assets/logo.png" alt="Cambium AI 研究机构" width="320"> </picture> <h1>Cambium</h1> <p><b>一个您可以以一句話運行的研究機構</b> — 從資助申請到驗證的、符合資助者要求的結果，<br>每個關卡都有人工介入。</p> <p> <a href="https://github.com/IFC-UIDAHO/Cambium_AI/actions/workflows/validate.yml"><img alt="持续集成" src="https://img.shields.io/github/actions/workflow/status/IFC-UIDAHO/Cambium_AI/validate.yml?style=flat-square&label=CI&color=16C079"></a> <a href="CHANGELOG.md"><img alt="版本" src="https://img.shields.io/badge/version-1.00.0-16C079?style=flat-square"></a> <a href="INSTITUTE.md"><img alt="代理人" src="https://img.shields.io/badge/agents-46-16C079?style=flat-square"></a> <a href="#-the-lifecycle--8-gates"><img alt="人工关卡" src="https://img.shields.io/badge/human_gates-8-0E8E5B?style=flat-square"></a> <a href="MCP_INTEGRATION.md"><img alt="MCP" src="https://img.shields.io/badge/MCP-ready-0E8E5B?style=flat-square"></a> <a href="LICENSE"><img alt="许可证：MIT" src="https://img.shields.io/badge/License-MIT-yellow?style=flat-square"></a> </p> <p><b>46 个专业代理人 · 11 个委员会 · 8 个人工关卡 · 21 个技能 · 21 个工具 · 一个 CI 强制执行的证据合约</b></p> <p> <a href="#-why-it-stands-out">为什么它脱颖而出</a> · <a href="#-see-it-work">查看其工作</a> · <a href="#-60-second-quickstart">快速入门</a> · <a href="#-how-to-use-it--what-to-say">如何使用它</a> · <a href="#-the-architecture">架构</a> · <a href="#-full-capability-catalog">功能目录</a> · <a href="#-governance--honesty-by-construction">治理</a> · <a href="#-how-it-compares">比较</a> · <a href="INSTALL.md">文档</a> </p> <img src="assets/demo.gif" alt="Cambium 在行动 — 从 RFP 到验证结果，一次一句话" width="820"> </div> --- ## ✦ 10 秒了解 Cambium 现代 AI 可以起草提案、运行实验或撰写论文。但它**无法**直接运行整个研究组织——从资助申请到结题——同时让人员保持指挥并确保每个声明的真实性。 > [!IMPORTANT] > **Cambium 将 Claude Code / Cowork 转变为一个可移植的、受控的研究机构。** 您是**主任（PI）**。一个**46 代理人组织**分为**11 个委员会**来完成工作——阅读资助申请、集思广益、撰写提案、运行和**重新运行**实验、审计结果并撰写报告——并在 **8 个人工关卡**处停止，由您决定。一个工具套件**如果诚信度下降，则构建失败。** 它是一个 Claude **插件**，一个 **GitHub 模板**，也是一个 **MCP 服务器**，并且它是**领域无关的**。 > *Cambium 是树皮下的薄活层，新生长在那里形成。这个 Cambium 是您的研究生长的层。* --- ## ✦ 为什么它脱颖而出 每个已发布的“AI 科学家”都拥有部分工作。Cambium 的赌注是**整个组织都在一个证据合约下**——这些是使其与众不同的支柱（每个都是真实的并且在这个仓库中；没有炒作）： | 支柱 | 含义 | |---|---| | 🔄 **一个生命周期，从资助申请到结题** | 我们不知道另一个开放系统能够将*寻找和获得资金*与*进行和报告工作*在同一个证据合约下连接起来。从 RFP 意向到提案、开发、验证和报告，共有 8 个关卡。 | | 🔬 **验证代码并重新运行** | 审计委员会不只是阅读和发表意见——他们**执行脚本并重现结果**，从而发现数据泄露、不公平的基准和错误陈述。“代码验证”意味着脚本实际运行了。 | | 🛡️ **治理作为强制代码交付** | 一个 4 级声明合约 + `validate.py` 在未经证据的声明或开放阻止器上**失败 CI** - 以及一个**每个资助者的规则 corpus**（NIH/NSF AI 政策 → 关卡）带有新鲜度检查。不是政策 PDF；是运行代码。 | | 🧑‍🏫 **领域无关的教师** | 领域专业知识是一个参数化的`faculty-expert`——统计学、机器学习、经济学、流行病学、水文学、您的领域——按需启用。Cambium 不局限于机器学习论文。 | | 👁️ **您可以查看机构的工作** | 一个实时运行板显示计划、**真实的命名代理人**正在工作，每个发现和您做出决定的关卡——从来都不是不透明的“使用了 6 种工具”。 | | 🔌 **开放、可自行托管、MCP 暴露** | MIT 许可；在您自己的 Claude 账户中运行；也是其他 AI 应用可以调用的 MCP 服务器。没有数据会发送到第三方云您无法选择的。 | > [!NOTE] > **Cambium **不**声称的内容。** 硬执行优于软提示的假设**尚未**得到证明** - Cambium 提供了一个预先注册的 A/B 测试框架来测试它（[`evals/enforcement_study/`](evals/enforcement_study/)），结果**公开**直到实际运行完成。关卡通过记录的账本和 CI 而不是硬运行时锁强制执行。这种克制**是证据合约**应用于 Cambium 本身。 --- ## ✦ 查看其工作 输入 `/cambium <task>`，运行的结果绝不是通用的“使用了 6 种工具”。您会看到一个**实时运行板**：前面的计划、**真实的命名代理人**正在工作（`Scouts · Landscape`、`Verification · Rigor`等）、每个代理人的单行发现、排行榜以及您做出决定的**人工关卡**——`APPROVE / REVISE / REJECT`。 <div align="center"> <img src="assets/run_board.gif" alt="Cambium 的方式 - 实时运行板：计划、命名代理人工作、关卡" width="860"> <details><summary>_{静态预览（如果 GIF 未加载）}</summary><img src="assets/run_board.png" alt="Cambium 实时运行板 - 静态预览" width="860"></details> </div> 每次运行都遵循**四个阶段** - 由合约强制执行（[PRESENTATION.md](PRESENTATION.md)），而不是惯例： | 阶段 | 您看到的内容 | 状态图标 | |---|---|---| | **I · 开启** | 即将动员的整个机构 - 计划 + 名册 + 关卡 - *在任何工作开始之前* | 计划板 | | **II · 实时阶段** | 协调器调度**真实**子代理人（`cambium-institute:<name>`，标记为`委员会 · 角色`）并在每个阶段重新发出板块 | `✓ 已完成 · ▶ 现在 · ○ 等待中` | | **III · 关卡** | 字面上一页决策卡；没有任何内容在您的`APPROVE`之前完成 | `⛩ 人工关卡` | | **IV · 结案** | 支持委员会自动记录更改日志、刷新文档、验证数字、清理 | 全部`✓`最终板块 | 板块从一个源（`tools/run_trace.py`）以四种方式渲染，以确保词汇不会漂移：**纯文本**（任何客户端）、**Mermaid**（GitHub/Claude Code）、**SVG**图片和**实时 HTML 仪表盘**（Cowork 工件，实时更新每个阶段）。 --- ## ⚡ 60 秒快速入门 > [!TIP] > 新手 Cambium？从 **[`USE_CAMBIUM.md`](USE_CAMBIUM.md)** 开始 - 一个用平易近人的语言指南，带您一步步完成您的第一个运行。 **1 · 直接从此仓库安装**（完整步骤 + 易错点在 **[`INSTALL.md`](INSTALL.md)** 中）： - **Claude Desktop / Cowork** *(无需终端 - 最简单)*：键入 **`/create-cowork-plugin`**，粘贴 `https://github.com/IFC-UIDAHO/Cambium_AI`，选择**完整工作包**，按**安装**。 - **Claude Code** *(终端)* - 在单独的行中运行（完整的 HTTPS URL；选择**用户范围**），然后 `/reload-plugins`： ``` /plugin marketplace add https://github.com/IFC-UIDAHO/Cambium_AI.git /plugin install cambium-institute ``` - **模板：** 在 GitHub 上点击 **“使用此模板”**，或 `git clone` 并将文件夹连接到您的项目。 > [!WARNING] > 如果插件市场 **"+"** 只显示 Anthropic 的目录，请先运行一次 `/create-cowork-plugin` 步骤 - 见 **[`INSTALL.md`](INSTALL.md)**。 **2 · 设置您自己**（一次）：说 `set up Cambium`；它搭建 `config.yml` 并仅询问您的姓名和项目。Cambium 不会在未知 PI 上开始工作（这是关卡 **G0**）。 **3 · 说出您需要的内容** - 一次一句话。机构动员，显示板块，并在关卡处停止： ``` read rfp ./call-for-proposals.pdf ``` 就是这样。从这里开始， **[如何使用它](#-how-to-use-it--what-to-say)** 部分显示完整的词汇。 --- ## 🧭 如何使用它 - 说什么 您可以用自然语言驱动 Cambium，一次一句话。这里有一个完整的项目，以故事的形式讲述： > 您说 **`read rfp <file>`** - 预审委员会提取要求和适合度；您在 **G1（是否继续？）** 处批准。您说 **`brainstorm`** 然后 **`run tournament`** - 产生想法并进行头对头的排名；您选择获胜者 **G2**。 **`draft proposal`** → PI 和 Proposal-Writer 根据资助者的标准编写； **`referee`** 像评审小组一样评分；您在 **G3** 处提交。资助吗？ **`project approved`** → **`run lab`** 运行开发 → 验收委员会 **重新运行您的代码**，捕获数据泄露的错误（一个 **P0**），并在修复和独立复制之前阻止发布 - 您在 **G4** 处接受结果。 **`progress report`** 编写资助者更新；您在 **G5/G6** 处发布。每一步，研究诚信官可以说 GO / CONDITIONS / STOP。 **您可以说的内容** - 按目标分组的自然语言触发器： | 目标 | 说… | 关卡 | |---|---|---| | **寻找和评估资金** | `watch rfps` · `read rfp <file/link>` · `rfp in <file>` | **G1** 是否继续？ | | **生成和选择想法** | `add idea` · `brainstorm` · `run tournament` · `convene faculty <disciplines>` | **G2** 哪个想法？ | | **构建提案** | `find collaborators` · `convene team` · `build budget` · `compliance check` · `draft proposal` · `referee` | **G3a / G3** 提交？ | | **开展工作（资助后）** | `project approved` · `run lab` · `iterate experiment` · `run verification` | **G4** 接受结果？ | | **报告和交付** | `progress report` · `make deck` | **G5 / G6** 发布？ | | **治理和路由** | `conduct check <gate>` · `route feedback` | - | | **运行快速检查** | `check Cambium's health` · `self-grade` | - | | **保存/恢复长时间运行** | `/cambium:pause` · `/cambium:resume` | - | > [!TIP] > **Solo 与 Cambium 方式。** 微不足道、低风险或探索性？使用 **`/solo`** - 普通、快速，无委员会或关卡。任何将被**提交、发布、引用或信任**的内容？使用 **`/cambium`** - 完整的机构与人工关卡。Cambium 的 `cambium-mode` 技能为您选择此选项并在会话中记住它。 > [!NOTE] > **长时间运行永远不会丢失状态。** 接近上下文限制（状态行在 ~85% 处警告），说 **`/cambium:pause`** - Cambium 编写一个带有每个发现和开放关卡的持久 `HANDOFF.md`，因此您可以清除窗口并在新的窗口中 **`/cambium:resume`** 而不会丢失任何内容或跳过批准。 --- ## 🔄 生命周期和 8 个关卡 Cambium 通过一个生命周期运行您的项目，带有 **8 个命名的人工关卡** - 没有任何内容被集思广益、提交、发送或发布而没有负责人批准。预审和资助后在同一个证据合约下连接。 <div align="center"> <img src="assets/lifecycle.svg" alt="Cambium 生命周期 - 从 G0 到 G6 的 8 个人工关卡" width="860"> </div> | 关卡 | 决定 | 批准人 | |---|---|---| | **G0** | PI 配置文件准备就绪 - *Cambium 不会在未知的 PI 上启动* | 主任 | | **G1** | 是否继续这个 RFP？ | 主任 | | **G2** | 哪个想法继续？ | 主任 + 联合首席研究员 | | **G3a** | 我们联系谁？（外联列表） | 主任 | | **G3** | 最终确定并提交提案 | 主任 **+ 第二个人** | | **G4** | 接受结果 / 应用审计的修复 | 联合首席研究员 / 领域负责人（该目标） | | **G5** | 发布进度 / 中期报告 | 主任或授权的联合首席研究员 | | **G6** | 发布 / 外部交付成果 | 主任 **+ 所有共同作者签署 AI 使用声明** | > [!IMPORTANT] > **职责分离不可协商。** 交付成果的作者永远不是其唯一的批准人 - G3 和 G6 需要第二个人。 [`governance/GATES.md`](governance/GATES.md) 中的“批准人”为空白表示 **未批准**，`validate.py` 将其作为发布阻止器强制执行。 --- ## 🏛️ 架构 在关卡背后是一个 **46 代理人组织，分为 11 个委员会**（3 个模型层）。协调器路由任务，正确的委员会并行执行，验证委员会重现数字，您会得到每个关卡的一页决策摘要。 <div align="center"> <img src="assets/org-chart.svg" alt="Cambium 组织结构 - 46 个代理人，分为 11 个委员会" width="860"> </div> | 委员会 | # | 它做什么 | |---|:--:|---| | **协调** | 2 | 路由任务，运行关卡，为交付成果编写单一作者 | | **预审** | 8 | RFP 雷达/分析、构思、创意锦标赛、PI 目标、提案、预算、合规性 | | **合作伙伴** | 4 | 合作者来源、联络、计划和多机构管理 | | **教师** | 1 | 参数化的专家 - *任何学科*，按需启用 | | **侦察** | 3 | 先前艺术、方法和景观侦察 | | **实验室** | 4 | 理论、方法、领域含义和统计 backbone | | **验证** | 5 | 严谨性、方法论、证据、领域 + 场地裁判 - *重运行代码* | | **执行** | 4 | 实验、消融、调谐循环、研究工程 | | **报告** | 2 | 进度/中期/最终报告 + 幻灯片 | | **支持** | 12 | 记录保存、图书管理员、数据管理员、完整性、图表、外联、工具制造商等 | | **治理** | 1 | 负责研究行为，在每个关卡进行检查 | <details> <summary><b>完整的 46 代理人花名册（点击展开）</b></summary> <br> **协调** - `orchestrator`、`document-office` **预审** - `rfp-radar`、`rfp-analyst`、`ideation-facilitator`、`idea-tournament`、`principal-investigator`、`proposal-writer`、`budget-officer`、`grants-compliance` **合作伙伴** - `collaborator-scout`、`partnership-liaison`、`program-manager`、`convener` **教师** - `faculty-expert` *(按学科参数化)* **侦察** - `scout-prior-art`、`scout-methods`、`scout-landscape` **实验室** - `lab-theory`、`lab-methods`、`lab-domain`、`lab-statistics` **验证** - `verify-rigor`、`verify-methodology`、`verify-evidence`, `verify-domain`, `referee` **执行** - `exec-experiments`、`exec-ablation`、`exec-iteration`、`research-engineer` **报告** - `reporting-officer`、`deck-builder` **支持** - `record-keeper`、`librarian`、`janitor`、`teaching-assistant`、`research-assistant`、`office-manager`、`data-steward`、`integrity-officer`、`figures`、`outreach`、`feedback-router`、`toolsmith` **治理** - `research-conduct-officer` 完整章程：[`INSTITUTE.md`](INSTITUTE.md) **完整的花名册： [.claude/agents/](.claude/agents) · 交互式图表： [`dashboard.html`](dashboard.html) 。 ## 🧰 功能目录 Cambium 提供 **21 项技能、21 种工具、6 种 MCP 工具、13 个模板和 5 个实例**，而非虚构的概念。以下是所有内容的扫描清单。 <details> <summary><b>🧪 21 项技能</b> — 代理商的领域专业知识</summary> <br> | 技能 | 功能 | |---|---| | `数学` | 精确的符号和数值数学（SymPy/SciPy/Z3/Pint）— 计算，而非估算 | | `统计` | 严格的推断：测试、置信区间、效应大小、功效、广义线性模型、混合模型、多重性、自助法、贝叶斯 | | `机器学习` | 无泄漏的预测建模：管道、交叉验证、校准、SHAP、模型卡 | | `优化` | 线性/混合整数/凸/非线性规划（scipy, cvxpy, PuLP, OR-Tools）— 报告最优性状态 | | `可重复性` | 固定的环境、种子、Makefile/CI、重新运行和验证关键数字 | | `验证` | 对结果进行对抗性审计；重现每个数字；证据分级裁决 | | `科学写作` | IMRaD 结构、单一贡献规则、主张与证据等级绑定 | | `报告` | 以资助者准备的格式生成进度/中期/最终报告 | | `RFP 接收` | 阅读招标公告 → 需求 + 适合度；停止在 G1 | | `提案` | 从目标到提交的完整提案工作流程 | | `资助写作` | NSF/NIH/USDA-AFRI 结构和标准对齐；绝不捏造引用 | | `预算` | 合规预算编制，附有理由说明 | | `数据管理` | 清单、模式/单位、来源、质量、PII/隐私、CARE 原则 | | `引用` | DOI/Crossref 验证、BibTeX、去重；绝不捏造参考文献 | | `项目管理` | 工作分解结构、里程碑、可交付成果登记、RACI、风险日志 | | `研究伦理` | IRB/IACUC、COI、FERPA/主权、双重用途 → GO / CONDITIONS / STOP | | `Cambium 模式` | 智能默认：从简单到复杂，记住选择 | | `运行实验室` | 拨款后循环：准备 → 构建 → 运行 → 验证 → G4 | | `设置` | `config.yml` 的首次运行脚手架；绝不会覆盖现有文件 | | `健康` | 通过 MCP 等级/医生工具在聊天中（无需终端）进行存储库自检 | | `技能提供者` | 检测所需领域，提供相关技能，并编写可重用的技能 — 而不是预先存储数千种技能 | </details> <details> <summary><b>🛠️ 21 种工具</b> — 机械设备（从终端或通过 MCP 服务器运行）</summary> <br> | 工具 | 功能 | |---|---| | `run_trace.py` | 单一面板渲染器 — 文本 / Mermaid / SVG / live HTML，自动读取运行状态 | | `run_state.py` | 维护实时运行状态；`sync` 提升发现；`reset` 防止陈旧发现泄漏 | | `handoff.py` | 在上下文窗口之间暂停/恢复 — 无损 `HANDOFF.md` 快照 | | `statusline.py` | 上下文窗口热度计；在 ~85% 时警告暂停 | | `cambium_run.py` | 无头运行器：干运行计划（无密钥）或 `--live` 并发调用；在每个关口停止 | | `task_router.py` | 确定性任务 → 分阶段委员会计划；每个面板和 MCP 计划背后的引擎 | | `doctor.py` | 跨 9 个维度的存储库健康检查；`--grade` A–F + 安全扫描；`--fix` 生成派生文件 | | `consistency_check.py` | 如果任何声明的计数偏离规范的 46/11/8，则 CI 失败 | | `check_agents.py` | 验证所有 46 个代理商的前置条件（字段、唯一名称、层级） | | `agent_eval.py` | 完成运行的 CI 校验：关口纪律、引用完整性、层级诚实、忠实度 | | `validate.py` *(治理/)* | 证据关口 — 如果主张未经证据支持或层级过度，则构建失败；如果引用未解决或 P0 打开，则失败 | | `funder_freshness.py` | 如果资助者规则条目过时或不完整，则 CI 硬故障 | | `url_health.py` | 咨询性引用 URL 生存检查；离线安全；标记可能虚构的链接 | | `model_router.py` | 将每个代理商的层级映射到活动提供者的具体模型 | | `toolsmith.py` | 在从头构建之前，建议现有的软件包/技能/MCP | | `new_project.py` | 为 `projects/<slug>/` 搭建完整的 v3 生命周期文件夹 | | `whoami.py` | 显示任何人的桌面代理商 + 关口权限 | | `gen_agent_cards.py` · `gen_org_chart.py` · `gen_board_image.py` · `gen_demo_gif.py` | 从实时名册中重新生成名册清单和 README 的视觉资产 | | `sync_plugin_agents.py` | 镜像 `.claude/agents/` → `agents/` 以防止插件名册漂移 | </details> <details> <summary><b>🔌 6 种 MCP 工具</b> — 从任何 MCP 客户端调用 Cambium</summary> <br> `mcp_server/` 提供 MCP 服务器（官方 `mcp` SDK / FastMCP, stdio）— 注册 `{ "mcpServers": { "cambium": { "command": "uvx", "args": ["cambium-mcp"] } } }`: | 工具 | 功能 | |---|---| | `cambium_plan(task)` | 任何任务的委员会/代理商 + 关口计划 | | `cambium_provision(task)` | 重用工具清单，附带安装命令 | | `cambium_agents()` | 具有层级的实时 46 个代理商名册 | | `cambium_doctor()` | 存储库健康检查 | | `cambium_grade()` | 自我评分 A–F + 风险扫描 | | `cambium_validate(ledger_csv)` | 证据账本检查（阻止虚假主张） | 详情：[`MCP_INTEGRATION.md`](MCP_INTEGRATION.md) · [`mcp_server/README.md`](mcp_server/README.md)。 </details> <details> <summary><b>📋 13 个模板 &nbsp;·&nbsp; 📂 5 个实例</b></summary> <br> **模板** ([`templates/`](templates))：`GATE_SUMMARY` （逐字逐句的关口一页纸） · `REPRODUCIBILITY_CHECKLIST` · `INTERPRETATION_FALLACY_CHECKLIST` （13 个谬误） · `CLAIM_LINEAGE` · `USER_PROFILE` （G0） · `IDEA_INBOX` · `POST_AWARD_PLAN` · `DATA_MANAGEMENT_PLAN` · `COLLAB_WORKSPACE` · `DECISION_RECORD` · 工作状态文件（`leaderboard`, `master_plan`） · 以及每个项目的脚手架。 **实例** ([`examples/`](examples)) — `full-lifecycle` 是一个完整的 RFP → 报告链，附有发现账本；`demo-from-scratch` 和 `demo-mid-project` 显示入口点；`demo-humanities` 和 `demo-public-health` 是 **预授奖切片** （RFP → 想法清单），展示领域无关性。 </details> --- ## 🛡️ 通过建设实现治理和诚实 区别在于 **诚实是机械的，而非可选的**。每个代理商提出的主张都带有证据层级，如果层级过度，CI 将导致构建失败。 | 层级 | 含义 | |---|---| | **已证明** | 正式或数学上建立 | | **代码验证** | 通过 *运行代码* 复制（必须引用命令 + 输出） | | **断言** | 模型生成，尚未验证 | | **开放** | 未解决 / 未知 | *在冲突时，**代码验证优于断言** — 运行代码的代理商获胜。* 严重性运行 **P0** （发布阻止器） · **P1** （削弱） · **P2** （润色）。 什么是强制执行： - **证据验证器** — [`governance/validate.py`](governance/validate.py) 如果主张无证据支持、引用未解决或 P0 打开，则构建失败，并发出每运行一次的 `provenance.json`。 - **自我评分** — `python3 tools/doctor.py --grade` 在名册、治理、工具、测试和决策方面为机构评分 **A–F** ，并进行安全扫描。目前 **A** （2026-06-26 评分；自行复制）。  - **测试 + CI** — pytest 套件（**113 passed / 1 skipped**，2026-06-26）+ `consistency_check.py`，每次推送都由 GitHub Action 运行。 - **已发布的政策** — [`AI_GOVERNANCE.md`](AI_GOVERNANCE.md)（作者、IRB、FERPA、数据主权、双重用途）+ [`RESEARCH_CONDUCT.md`](RESEARCH_CONDUCT.md)（12 点每关口检查清单）+ 记录的人类批准账本和决策记录。 #### 证明主张，而不仅仅是断言 Cambium 提供基础设施来 **衡量其核心主张** 而不仅仅是断言： - **强制执行 A/B 测试** — [`evals/enforcement_study/`](evals/enforcement_study)：预注册协议（强制执行关口 vs 软提示）、种子缺陷任务集、锁定真值、盲裁判和指标管道。 > [!NOTE] > 测试套件已发布并在 CI 中运行；比较 **结果是开放的** — 在完成实际运行之前，没有做出“强制执行优于提示”的主张。 - **每个资助者的治理语料库** — [`governance/funders/`](governance/funders)：NIH + NSF AI 使用规则映射到特定关口，每个条目都有日期、所有者和硬故障新鲜度检查 (`tools/funder_freshness.py`)。它是 **指导方针，而不是合规认证** — 指定的 PI 仍然负责。NIH NOT-OD-25-132（6-app/PI/yr 限制 + “实质上由 AI 开发” 拒绝）和 NSF 审查员 gen-AI 禁令已源验证。 --- ## 🧠 模型路由和效率 每个代理商都声明一个 **层级**；路由器将其映射到您活动的提供者的具体模型。运行 `python3 tools/model_router.py` 以打印完整表格。 | 层级 | 代理商 | 默认模型 | 作业类 | |---|:--:|---|---| | `强` | **12** | `claude-opus-4-8` | 关键路径：理论、统计、审计委员会、裁判、行为、最终写作 | | `中` | **32** | `claude-sonnet-4-6` | 广度：侦察员、实验室、执行、预授奖、报告、支持 | | `轻` | **2** | `claude-haiku-4-5-20251001` | 批量：清理、格式化、摘要 | **提供者无关**：Claude 开箱即用；添加 Google 或任何 OpenAI 兼容/免费模型只需配置即可（无需代码更改），并且您可以拆分层级 — 例如，Claude 在 `strong` 上，更便宜的模型在 `mid`/`light` 上。效率护栏（[`EFFICIENCY.md`](EFFICIENCY.md)）：两模式侦察循环（快速扫描 vs 深入研究）、提示缓存规则 **绝不缓存易变事实** 、每个阶段的成本遥测和有界 ≤40s 代理商运行。关闭自动循环 ([`AUTORUN.md`](AUTORUN.md)) 可以让阶段迭代到其验收测试，在硬 `max_iterations`/预算上限内 — 它可以 **武装** 关口但绝不 **清除** 关口。 --- ## 👥 构建用于团队和多个账户 在 `config.yml` 中配置您的名册（主任、共同 PI、学生、研究助理、工程师、独立完整性管理员），并附有每个关口的审批人映射（[`ROLES.md`](ROLES.md)）。角色带有 **委托关口权限** 和职责分离 — 完整性管理员可以 *阻止* 发布（开放的 P0 停止所有操作）但绝不能批准。 由于所有内容都存在于文件中 — 账本、关口、决策记录 — **多个人员，每个 Claude 账户，可以继续一个项目** 而不会失去连贯性；每个合作机构都作为一个独立的区域主管工作流，由项目经理合并。`python3 tools/whoami.py <name>` 显示任何人的桌面和关口权限。 --- ## 🆚 比较 | | 原始 Claude 代码 | 裸代理商测试 | 自主“AI 科学家” | **Cambium** | |---|:---:|:---:|:---:|:---:| | 多代理商研究组织 | 自己构建 | 仅限底层 | 是（偏 ML） | **46 个代理商 · 11 个委员会，已就绪** | | 强制人类关口 | — | 可选 | 通常没有 | **8 个命名关口（G0–G6 + G3a）** | | 证据层级 + CI 强制执行 | — | — | — | **已证明 / 代码验证 / 断言 / 开放，构建失败** | | 验证重新运行代码 | — | 仅当您连接时 | 有时 | **是 — 审计委员会重现数字** | | 已发布、强制执行的治理 | — | — | — | **AI 使用 + 研究行为 + 每个资助者的规则** | | 预授奖 **和** 授奖后 | — | — | 仅限授奖后 | **两者，在一个合同下** | | 领域无关 | n/a | n/a | 通常否 | **是 — 参数化教师** | | 开放/可自行托管 | 是 | 是 | 取决于 | **是 — MIT，在您的账户中运行** | 现有系统没有一个将预授奖和授奖后结合在一个证据合同下，并带有强制性人类关口和已发布的、可强制执行的治理政策。这是关于 **集成和类别** 的主张；每个基本功能都存在于其他已发布的系统中； **组合** 是不存在的。与 Sakana、Google AI Co-Scientist、Agent Laboratory、Stanford Virtual Lab 和 AutoGen/CrewAI 的比较：[`COMPARISON.md`](COMPARISON.md)**。 > [!TIP] > **何时选择其他选项**（Cambium 也会告诉您）：纯粹的无监督 ML 论文生成 → Sakana；大规模文献综合 → Elicit / Deep Research；资助办公室的资助者数据库和授奖后财务 → Instrumentl；空白-slate 自定义代理商应用 → Claude Agent SDK / AutoGen。 --- ## 🗺️ 路线图 近期：发布一个完整的实例作为完整的工件链；一个机器可检查的溯源清单，将每个 **代码验证** 主张与其重新运行 + 哈希链接；更多领域示例配置。中期：社区“教师包”（可共享的学科配置）、更丰富的协作者来源（ORCID/NSF）、公共数据来源的连接器技能、多 PI 关口模型。长期：完成强制执行 A/B 研究、超出 NIH/NSF 的实时资助者语料库和离线/空气隔离模型路径。它 **不会** 成为一个完全自主的引擎（关口是关键）或期刊同行评审的替代品。完整细节和明确的范围：[`ROADMAP.md`](ROADMAP.md)。 --- ## 🤝 贡献 · 📓 引用 **贡献** — 欢迎提出问题和拉取请求。CI 在每次推送时运行证据验证器、一致性检查器和 **113 测试** 套件 — 保持 **A** 等级。从 [`GETTING_STARTED.md`](GETTING_STARTED.md) 和 [`CONTRIBUTING.md`](CONTRIBUTING.md) 开始，然后是 [`INSTITUTE.md`](INSTITUTE.md) 和 [`DECISIONS.md`](DECISIONS.md) 以了解原因。 **引用** — Cambium 构建用于学术工作； [`CITATION.cff`](CITATION.cff) 已包含，因此 GitHub 的“引用此仓库”按钮直接生效。 <div align="center" <br> _{<b>Cambium</b> · v1.00.0 · MIT 许可 · 由 <a href="https://www.uidaho.edu/">爱达荷大学</a> · 州际林业合作社构建<br> <i>从资助申请到验证结果 — Cambium 之道 ⬢</i>} </div>