GitHub

BriefLoop.ai / 运作原理

AI 起草，控制面记账，人类放行

首页的保管链演示回答“这句话从哪来”。这一页回答其余的问题：为什么要这样分权、发现问题以后会怎样、失败如何变成下一版的改进，以及开发者如何与 Agent 协作。

Governance · 治理模型

给 AI 装一套「公司治理制度」

AI 负责起草与提议，BriefLoop 确定性控制层负责审计与记账。各司其职，才有可信。

传统 AI 写作（黑箱）

  • 数据真实性存疑：大模型逻辑不稳定，改了几稿后，数据真实来源往往无从复查。
  • 错误以讹传讹：草稿中的一个微小误读，在反复润色后被包装成高可信度的错误结论。
  • 反馈凭空蒸发：人工提出的偏好与规则留在脑子里，AI 在下一次运行中极易遗忘重犯。
  • 复核成本高昂：因为不了解修改和证据链路径，复核团队只能靠人力反复重核原始文档。

BriefLoop 保管链（白盒可审计）

  • 事实账本登记：每一个写进交付物的核心断言和数据，必须在事实账本 (Claim Ledger) 有坐标。
  • 确定性质量门禁：由 Python 逻辑执行时效、来源完整性门禁，防止模型自画自签。
  • 改进账本固化：人工批准的写作偏好沉淀为持久记忆，并提供防污染的回滚记录。
  • 交付真值单一记录：交付状态只认 ControlStore 中的交付真值与完成投影，reader-clean 未通过就不会晋升交付件——文件存在不等于交付。
过程模拟 · 不调用真实运行时

问题不会被润色掉，而会进入修复回路

首页的保管链回答“这句话从哪来”；这里回答“发现问题以后会怎样”。门禁只负责阻断，Agent 或人完成修订后，由控制面重新检查。

AI 编辑草稿 (Analyst Draft) REVISION 1
冻结对照记录 (Control Record) 已冻结
claim_idCL-0045
statement组件现货均价环比下降 1.5%
sourceSRC-009 (2026-06-05)
frozen_hashsha256_8f0a2e…
质量门禁 (Quality Gate)
⏳ 等待质量检查运行…
门禁会检查并阻断问题，但不会替 Agent 或人类修改草稿。

模拟说明：修复示例代表 Agent 或人提交一个新 revision；门禁只记录、阻断和复检，旧版本与 finding 继续留痕。

Quality Panel · 质量面板

Gate 之后，每次运行留下一张确定性投影

v0.14.0 可从 Store/LAJ 数据导出一份自包含的三页只读 HTML：质量状态、LAJ advisory 与改进状态。它不是运行权威、质量评分或交付裁决，也不能触发工作流动作；LAJ 效用 NOT MEASURED，改进页如实显示 Improvement Ledger unavailable。

首页有合成数据预览；网站演示全部只读，没有处置、写入、自动学习或“接受建议后改善下次运行”的能力。

Evolution Loop · 演进环

0.14 的工程变更由 Codex 实现和测试，由人批准合并与发布

这是一条软件工程责任链，不是运行中的自动学习。失败可以成为代码候选与回归测试，但不会进入当前或下一次简报运行；0.14 没有可用的 Store-native Improvement Ledger。

RUN-152 · GATE BLOCKED

失败先变成可查询的控制记录

缺失引用映射不会被藏进正文说明，而会成为 finding、blocker 和 event，保留发生阶段、影响范围与修复责任。

权威写者
Python control plane
留下什么
finding + event
立即效果
阻断当前交付
不是自治“自我改进” Codex 在受限分支中实现并测试 0.14 工程变更；人类授权合并与发布。产品运行不会吸收建议、改写 prompt、gate 或 policy，Quality Panel 也不会让下一次运行自动变好。 阅读 Lilian Weng 英文原文《Harness Engineering for Self-Improvement》→
Governance Boundary · 治理边界

人类责任边界声明

任何自动化 AI 系统都不应当、也不能代替人类承担决策与把关的责任。BriefLoop 并不代替人类进行最终的批准决策，而是为人类提供一个降低遗漏风险的证据链条——可追溯性，而非语义证明。

"一旦数据存在冲突或缺失，系统将暴露痕迹并支持快速回溯定位。"
Responsibilities · 责任分层
Report Packs · 交付入口

支持三大交付入口

针对投研、合规、企业披露的不同任务，系统预置了高标准的拓扑与审计合同。

Developers · 开发者

现代开发者与 Agent 协作

BriefLoop 把写作与控制分开：外部 Agent 负责研究和起草，Python CLI 负责建档、校验、状态事务、门禁与交付记录。CLI 不会单独调用模型生成简报。

确定性 CLI 交互

新运行只支持 Experimental Codex SQLite 路径。briefloop status 与 briefloop runtime next 提供 Store 派生的只读视图和下一动作；finalize、批准与交付由 Codex runtime host 提交 typed Store action。SQLite ControlStore 是唯一运行权威，legacy JSON 控制面已删除；legacy JSON 控制文件与报告、status、Quality Panel、Markdown/JSON/JSONL/HTML 导出是非权威投影。strict action、envelope 与 human-request JSON 必须重新对照 ControlStore 校验，自身不构成权威。

Codex 配合

安装 Codex runtime kit 后（briefloop runtime install --workspace <workspace> --runtime codex），在 Codex 中打开并信任该 workspace。Codex 只执行 runtime next 返回的精确动作及 Receipt-backed role invocation；不会回退到其他 runtime。

bash — briefloop
$ git clone https://github.com/Stahl-G/briefloop.git && cd briefloop
$ bash scripts/setup.sh
$ briefloop onboard
$ briefloop init ./my-weekly --from-onboarding onboarding.json
$ briefloop runtime install --workspace ./my-weekly --runtime codex
$ briefloop run --workspace ./my-weekly --runtime codex
[created] workspace → ./my-weekly · briefloop.db (SQLite ControlStore)
$ briefloop runtime next --workspace ./my-weekly
# 唯一顺序权威：Store 返回的 CoreRunNextAction

当前支持的启动路径是源码安装：终端里执行上面的 git clone + scripts/setup.sh；Codex 路径随后在 workspace 里运行 briefloop runtime install --runtime codex，并在 Codex 中打开并信任该目录。Windows 请按 PowerShell 安装路径 执行，不要把这组 Bash 命令改写到 Git Bash。软件包入口（pipx install briefloop）在发布说明明确完成全新环境冒烟前暂不作为启动路径。