v0.2.0-alpha.1

v0.2.0-alpha.1 Alpha 发布说明

状态：发布材料已准备，等待 CI 全绿和正式发布操作。

我在这轮 Alpha 中把项目从可安装 CLI 和只读检查，推进到可以在本地仓库上运行的完整 Agent harness。当前包版本是 0.2.0a1，最终公开 tag 将使用 v0.2.0-alpha.1。

这次新增

1. 完整运行链路：我接入了 CLI、Pico runtime、有界 Agent loop、prompt/context 管理、工具解析和停止条件。
2. 四类 Provider：我保留 DeepSeek、OpenAI 兼容、Anthropic 兼容和 Ollama 的配置与 client 适配，真实调用仍由用户显式启用。
3. 工作区工具：我提供 list、read、search、write、patch、shell 和受限 delegate，并用路径边界、工具白名单与 approval policy 约束变更。
4. 会话与恢复：我加入 session、task state、run store、trace、report、checkpoint、resume、working memory 和 durable memory。
5. 离线评测证据：我加入固定 benchmark、fixture、FakeModelClient、上下文/记忆/恢复对照实验、复现脚本和脱敏结果。

安全与兼容性

• 我不会把真实凭据、.env、.pico/、缓存、虚拟环境或私有资料提交到仓库。
• 默认测试和 CI 不读取真实凭据，也不联网调用 Provider。
• 工作区边界和 approval policy 属于应用层保护，不替代操作系统级沙箱、容器、虚拟机、网络隔离或人工代码审查。
• Provider 配置、CLI 参数、本地存储格式和 Alpha API 仍可能在后续版本中调整。

已知限制

• benchmark 结果来自固定 fixture 和 FakeModelClient，只能说明当前 runtime 合同及模块行为，不能外推真实模型质量、成本、延迟或线上成功率。
• Ollama 需要本地服务和已准备好的模型；HTTP Provider 需要用户自行配置可用的 endpoint 与凭据。
• 本次只准备发布材料，不改写已经发布的 v0.1.0 tag 与 Release。

验证命令

python scripts/check_quality.py
python -m pico --help
python -m pico.public_evaluation --check --output docs/evaluation/readonly-workspace-v1.json

安全问题请遵循 SECURITY.md 的私密反馈方式，不要在 Issue、示例或日志中提交真实凭据。

v0.1.0

Coding Agent v0.1.0

这是一个可安装的 Alpha 快照，聚焦当前公开、可验证的本地模块。

已验证范围

• pico 命令行帮助、Provider 配置选择与只读工作区检查。
• 工作区文件列表、读取、搜索及常见越界/二进制拒绝规则。
• 受控变更、本地状态、checkpoint、分层记忆和有界控制流的独立模块。
• 面向只读工作区 API 的合成、离线、可逐字节复现的回归证据。
• Python 3.10、3.11、3.12 的安装、测试、Ruff、评测复现与 CLI help 已通过 CI。

重要限制

• 未包含集成式 Agent runtime、真实 Provider API 调用或真实模型任务执行。
• approval policy 和路径/命令拦截是应用层策略，不提供 OS 级沙箱。
• 评测不代表真实模型质量、Provider 兼容性、性能、成本、延迟或端到端 Agent 表现。
• 公共接口和本地存储格式仍可能在后续 Alpha 版本中调整。

完整变更、安全反馈方式和候选发布记录见仓库中的 CHANGELOG.md、SECURITY.md 与 docs/releases/v0.1.0.md。