ReasonFirst¶

推理优先的编程编排

强推理负责判断，coding agent 负责执行，证据回到推理层审查。¶

ReasonFirst 把 ChatGPT（或用户明确选择的其他强推理界面）放在架构、诊断、范围、验收标准和最终审查的位置；可替换的 coding agent 在受控 workspace 中完成实现。

安装 ReasonFirst 十分钟上手查看日常工作流 English

ReasonFirst 如何工作¶

1 · 推理ChatGPT读取仓库/MR/CI 证据，做诊断、范围控制和验收标准。

2 · 契约TaskSpec持久保存已批准目标、非目标、验收标准和固定 workspace identity。

3 · 执行Coding workerCodex CLI、Copilot CLI 或 Codex Desktop 在边界内实现任务。

4 · 证据EvidencePack + CI返回有界 diff、validation、reviewability 与 CI 新鲜度/完整性证据。

5 · 决策ChatGPT + 人审查证据，决定继续、调整或合并。

只有一条主闭环

ActualCoder 也可以被终端、CI、IDE 或其他客户端直接调用，适合测试、恢复和自动化；但这是次要运维能力，不是另一种并列产品模式。

v0.5.1 引导配置与安装¶

0.5.1 源码整合了五个 setup 切片：统一 reasonfirst setup 向导、先验证后授权的项目配置、worker 选择、打包只读 MCP、可选打包全聊天 Bridge、受管 tunnel runtime，以及基于记录状态的修复/恢复。打包安装和源码安装都是正式支持的路径，共用配置与状态；详细/手工指南继续保留。

功能整合基线已通过十个 CI job，包括 Ubuntu、macOS 和 Windows 上真实的打包/源码安装 E2E。发布准备提交仍需重新验证；安装测试不等于 provider 登录或浏览器侧 ChatGPT 授权。只有维护者发布 v0.5.1、Release assets 工作流成功附加 wheel 后，才应使用发布包。源码版本号本身不代表发布包已可下载。

阅读 v0.5.1 发布说明选择安装路径

v0.5.0 已验证基线¶

v0.5.0 把上面的架构组合为一套经过测试的系统：三个 worker backend（codex-cli、copilot-cli、codex-desktop）、两个刻意分开的 MCP 面（只读 GitLab 证据面与可选 Bridge Preview 编排面）、持久 TaskSpec/attempt、跨进程 workspace 变更锁、有界 EvidencePack、共享 finish/review gates，以及 matching-HEAD CI 反馈。

预发布审计基线 7d16061061f6337604bd3135c9e4a693ad1fd68a 的七个 release-critical CI job 与文档部署全部通过；主验证 job 共运行 445 个测试。package job 构建 wheel + sdist、检查 archive path、在干净环境安装 wheel、验证版本/CLI 入口，并重新执行源码/完整历史 secret scan。冻结发布由已发布的 v0.5.0 tag 标识，而不是这里更早的审计基线；这个历史测试数量不代表当前测试集规模。

阅读 v0.5.0 发布说明查看架构说明

Bridge Preview 可用性

只读 GitLab MCP 是通用证据连接；Bridge Preview 需要所连接客户端/workspace 允许其权限更高的 custom-MCP action。该面不可用时使用终端 ActualCoder；TaskSpec、workspace identity、validation 与 review gates 保持相同。

我应该从哪里开始？¶

第一次使用

先看安装与更新，选择打包快速路径或继续正式支持的源码/开发者路径；两条路径都进入 reasonfirst setup。然后用十分钟上手走最短闭环。
ChatGPT 已经能读取 GitLab

按工作流程走：ChatGPT 推理 → 有界任务交接 → worker 执行 → 证据回到 ChatGPT 审查。
需要配置 coding worker

看快速上手。它是执行引擎/运维参考。
遇到问题

看故障排查，不要把 API、Git、Tunnel、worker 登录、workspace 和 CI 问题混在一起。

核心概念¶

概念	含义
推理层	ChatGPT 读取证据、诊断、决定架构、限制范围并审查结果。
TaskSpec	持久保存目标、验收标准、非目标以及 workspace/base identity。
Worker	可替换执行者：Codex CLI、Copilot CLI 或 Codex Desktop/App Server。
WorkerPolicy	用户拥有的 model/effort/sandbox/approval/network/tool 约束。
EvidencePack	有界、递归脱敏、只读的实现证据，用于返回推理层。
Finish gates	发布前的 validation、reviewability、protected path、secret/history 和 candidate identity 检查。

ReasonFirst 不是什么¶

ReasonFirst 不是模型代理、额度转移服务、通用安全沙箱或自动合并机器人。它不直接发起模型推理 API 调用；coding backend 使用各自的认证和使用权益。

更完整的边界见架构说明和安全边界。