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、示例或日志中提交真实凭据。