Open Source Research Agent v0.3.0

Open Source Research Agent v0.3.0

这一版本新增一个有明确安全边界的 GitHub 公共只读研究适配器，并强化证据完整性与取消语义。

主要更新

• 新增可选 GitHub 公共 REST 适配器；默认本地 fixture 演示仍可离线运行。
• 只允许固定的公开只读 GET 目标，不使用 Token，不执行写操作，并拒绝重定向。
• 加入超时、调用方取消、响应大小、响应结构、仓库身份与许可证字段校验。
• 每次异步操作后都重新检查取消状态，避免取消后仍输出完成结果。
• 规范化 owner/repo 与 GitHub URL 身份，拒绝大小写或 URL 别名造成的重复任务。
• 对 Evidence ID 做全局唯一性校验，防止证据引用歧义。
• 明确 searchProjects 是校验用户给定目标，而不是开放式全网项目搜索。

验证结果

• 29 项自动化测试全部通过。
• 本地 fixture 演示通过。
• 对本仓库执行真实 GitHub 公共只读冒烟测试：任务完成，生成 4 条证据，调用 2 次，无重规划。
• 依赖安全审计：0 个高危漏洞。

使用边界

该项目不读取私有仓库、私有 README 或内部源码，不包含凭据，也不是生产级 GitHub 客户端。所有外部事实必须由证据 ID 回链到已验证的公开响应。

v0.2.0 — 显式规划与重规划

Open Source Research Agent v0.2.0

• 新增可插拔 ResearchPlanner 和可检查的计划版本
• 搜索结果现在真正决定后续执行步骤
• 区分瞬时与永久工具失败，并在重试时改变步骤策略
• 公开口径收敛为引用完整性，不夸大为来源真实性
• 自动测试 6/6、离线演示通过、依赖漏洞 0

附件是完全离线 fixture 生成的示例报告。

v0.1.0 — Evidence-grounded Research Agent

首个招聘展示版本。

• Research Task Contract 与结构化工具调用
• Evidence ID、来源绑定和引用审查
• 瞬时故障后的有界重规划
• COMPLETED / PARTIAL / BLOCKED 终态
• 4 项自动测试、架构图、演示 GIF 和中文面试讲解材料

当前版本使用确定性本地 fixture，未宣称开放网络或真实 LLM 性能。