DOCUMENTATION

从配置到验收

有解把 API 模型与本机 CLI Agent 组织成可暂停、可恢复、可检查的多角色工作流。最终是否接受和应用结果，始终由用户决定。

快速开始

安装并激活有解 Realize，选择本地项目目录。
把 Run Workspace 存储位置设到空间充足的非系统盘。
普通模式配置项目默认 Provider Profile 与模型；进阶模式可再配置 CLI Agent。
创建角色和流程，为每个角色选择继承默认或单独配置。
启动前核对角色、Provider、模型和备用策略摘要，再开始 Run。
查看交接、命令和复验结果；满意后再应用到真实项目。

普通 API 与进阶 CLI

普通 API 模式

适合首次使用。项目使用一个默认 HTTP Provider 与模型，角色继承同一配置。用户自行提供 API 凭据和模型额度。

进阶 CLI Agent

适合已经使用 Codex CLI 或 Claude Code CLI 的技术用户。CLI 可真实搜索、读取、修改文件和执行命令，完整脱敏过程可在平台展开。

两种模式可以混合，例如策划使用 API、开发使用 Codex CLI、审查使用 Claude Code CLI。CLI 不保证更省 Token，平台只展示各 Provider 实际返回的用量。

Provider Profile 与角色模型

Provider Profile 是一组可复用的连接配置名称，不是 API Key 本身。项目保留一个默认 Provider、模型和协议；角色可继承默认，也可单独指定主 Profile、主模型以及明确开启的备用 Profile 和模型。

Run 启动后配置会冻结。之后修改项目或角色设置只影响下一轮；恢复同一 Run 时仍使用冻结配置。Provider 故障默认暂停，只有用户事先明确开启备用模型时才允许切换。

Run Workspace

每轮运行先在隔离工作区操作，不直接改写真实项目。存储根目录由用户自定义，建议选择非系统盘。平台记录文件版本、变更、命令结果和恢复点。

第一版使用文件系统隔离，不要求项目启用 Git。运行结束后可以查看变化、处理冲突、应用或回滚；不要在活动 Run 期间手工移动工作区。

启动、执行与交接

启动前摘要显示每个角色实际使用的 backend、Provider 和模型。执行中主日志显示“正在搜索项目”“正在修改文件”“正在重新验证”等简明状态；展开 CLI 过程可查看带时间的脱敏事件。

上游角色完成后通过正式交接包把已确认事实、产物和未决问题交给下游。HTTP 与 CLI 角色读取同一条 Workspace Version 链，避免各自在不同副本上工作。

暂停、恢复与重试

限流、登录失效、Provider 失败、工作区离线或需要用户判断时，Run 会暂停并给出恢复建议。恢复同一 Run 会继续使用原配置快照和检查点，不重复已经完成的阶段。

重试前先解决页面显示的原因。不要通过删除数据库、凭据或许可证状态强行绕过门禁。

验收、应用与回滚

“AI 已完成”不等于任务通过。平台会保存独立复验结果、文件差异和命令退出码，用户据此决定接受、要求返工或放弃。

应用前平台重核源项目是否变化。无冲突时事务化写入并验证；冲突或无法证明安全恢复时停止自动写入，保留 Run 供人工处理。

项目经验

项目经验把已采纳的方法转成下一轮可匹配的策略。新经验先以候选形式出现，由用户选择采纳、仅记录、稍后处理或不适用，不会自动把模型输出升级成规则。

经验差分会比较 backend、Provider、模型、角色路由和 Workspace baseline。换模型或换 CLI/API 后没有可比较基线时显示“等待可比较基线”，不会把环境变化误判成经验改善。

隐私与团队包

API Key、Token、密码、私有地址、绝对路径、CLI 参数、原始会话和隐藏推理留在本机。团队包只允许导出脱敏后的角色职责、流程、Profile 显示名、模型能力偏好和安全工作区模式。

官网不保存邀请码明文或原始 IP；下载系统只保存服务端 HMAC 指纹、结果、时间和版本等最少审计信息。

阅读完整隐私说明

验证安装包

只从固定官网渠道下载，并将下载页显示的 SHA-256 与本地文件完整比对：

Get-FileHash "安装包路径" -Algorithm SHA256

SHA-256 验证文件内容是否一致，不等同于代码签名。签名状态以下载页实时信息为准。