从日常请求开始
完成配置与信任后，已连接的 Agent 可在处理日常请求时遵循同一文件工作流程。纯问答和规划不会创建工作区。
0.4.0rc2预览版本
macOS本地文件系统
3.11+Python 要求
MIT开源许可
01 / 基础功能
将任务所需的信息放在一起。
一项任务不只是最新生成的文件。Retulo 为已连接的 Agent 整理原始资料、历史版本、决策与检查记录。
继续同一个任务
稳定的任务 ID 与工作区将不同会话中的工作连接起来。继续时，请提供任务 ID、工作区路径或实际产物引用。
管理原始资料与历史版本
预留输出位置、登记已保存的文件，并保留受管理的历史输出。现有代码仓库保持原有位置。
了解任务进展
精炼的当前指引中包含决策、剩余工作、检查与审批记录。文件已保存、内容已检查与用户已批准分别记录。
运行文件任务续接示例
.venv/bin/python scripts/demo_continuity.py --output-dir /tmp/retulo-continuity-demo请使用新的空输出目录。独立 CLI 进程创建指南，再检查同一任务，保存第二版本，并保留原始资料与第一版本。这用于检查任务续接，并不验证新 Codex 会话的集成行为。
02 / 工作原理
Agent 运行工具。
Retulo 整理任务。
描述工作
当前 Agent 理解请求，并明确目标与完成标准。
连接任务
生成文件前，Agent 创建工作区或识别已有工作区。
保存与检查
Retulo 记录版本并检查文件完整性。Agent 或用户评估内容，并记录结果。
带着当前状态继续
先阅读简短的当前指引，需要时再获取详细记录。
核心在本地运行，不启动模型或 Agent，不执行模板中的命令，不监视文件夹，也不发布结果。
03 / 快速开始
从源代码目录开始。
解压源代码包，并在项目目录中打开终端。当前预览版采用源代码安装。
安装 CLI 与 MCP 核心
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.lock
.venv/bin/python -m pip install --no-deps -e .
.venv/bin/retulo --help最后一条命令应显示 Retulo 的可用命令。
预览 Codex 集成变更
.venv/bin/python scripts/install_codex.py
.venv/bin/python scripts/install_codex.py --apply第一条命令只预览变更。准备好后再应用，并在 Codex 中查看、信任具体的钩子定义。请保留该源代码目录。现有 MCP 连接不会自动重启。
然后提出日常工作请求
请制作一份 Markdown 访客指南，并保留原始资料。
在新会话中，请同时提供现有工作区或文件引用
在同一工作区继续这份指南，添加联系方式，并保留上一版本。
04 / 更新与复用
输入发生变动，
有效成果依然保留。
对于已声明的工作流，Retulo 连接输入、生成步骤与具体输出。输入变化后，Agent 可以判断哪些步骤需要重新处理。
重建受影响的步骤
宿主 Agent 重新运行所需工具，保留此前的最终文件。未声明的依赖关系不会被自动发现。
复用工作流模板
用带版本的输入与参数创建新任务。新任务重新检查，不继承已有审批或检查结论。
运行完整的本地示例
.venv/bin/python scripts/demo_incremental.py --output-dir /tmp/retulo-report-demo请选择一个新的空输出目录。示例根据当前代码目录的文件清单生成 HTML 报告、更新受影响步骤、保留旧报告、保存模板，再根据另一份清单创建新报告。它不调用模型，也不更改全局安装设置。
05 / 文档
从第一个任务，
了解完整的工作约定。
- README概览、源代码安装与日常使用。
- 工作流与模板声明步骤、输入输出与新任务复用。
- 集成说明宿主 Agent、上下文钩子与任务协调。
- 验证范围已测试环境、实际方法与当前限制。
- 恢复安装安装快照与带检查的恢复流程。
- 常见问题配置、跨会话继续与验证问题。
先了解这几个区别。
Retulo 会记住所有对话吗？
Retulo 记录受管理的任务、文件与进度。跨会话继续时，请指定同一任务或工作区。核心不会重建未接收的对话。
Retulo 会编写或评估内容吗？
当前 Agent 理解请求并运行工具。Retulo 管理工作区，记录文件完整性、检查与审批。检查记录本身不保证内容质量。
目前支持哪些环境？
验证目标为 macOS、本地文件系统与 Python 3.11 或更高版本。其他操作系统、网络存储、多主机与其他客户端需要单独验证。
需要安装和连接哪些内容？
安装 Python 3.11+ 与软件包依赖，并配置本地工作区和源文件根目录。通过 CLI 使用，或将 MCP 服务连接到现有 Agent。Codex 指引与钩子由单独的安装程序配置；Retulo 不添加 AI 运行时或后台服务。
06 / 帮助与贡献
让下一项工作更顺利。
先查看指南；报告问题时提供最小复现；提出功能建议时说明希望完成的具体工作。
当前为预览版。请按 GitHub 源码中的说明安装，并查看验证记录，了解已测试环境与当前限制。