Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 49 additions & 30 deletions .ai-team/TASK.md
Original file line number Diff line number Diff line change
@@ -1,61 +1,80 @@
# Current Task

- ID: `AR-003`
- Title: `Simplify the assignment plan to module level`
- Status: `done`
- Owner: `zzg`
- ID: `AR-006`
- Title: `Build the AutoResearch evidence-aware research workbench`
- Status: `handoff`
- Owner: `Codex`
- Next owner: `user/team`

## Goal

根据用户反馈,把任务拆解入口从 122 个子任务收敛为模块级分配。保留此前详细版作为附录,但当前团队先按模块认领负责人、边界、主要产出、依赖和验收目标。
交付一个可运行、响应式的 AutoResearch 前端工作台,把 idea 交流、论文搜集、论文阅读、论文写作与实时修改组织成一条可见的证据链。前端必须复用现有 FastAPI/Application Service 合同,明确区分真实 API 数据、浏览器本地草稿和界面预览数据,不得把 UI 状态冒充科研结论、Gate 通过或生产集成。

## Acceptance scenarios

- [x] `docs/AutoResearch_任务拆解书.md` 只作为模块级分配入口,覆盖 M00–M17。
- [x] 每个模块说明目标、边界、主要交付物、前置模块、负责人建议和当前状态。
- [x] 文档提供模块负责人验收模板和第一批模块分配建议。
- [x] 原 122 子任务版本保留为 `docs/AutoResearch_任务拆解书_详细版.md`,不丢失后续拆解素材。
- [x] README、Project-to-Act 和 VibeCollab 任务状态保持一致,不改变五业务 Agent 和证据门禁边界。
- [x] Next.js 使用已修复 CVE-2025-55182 的版本,独立安装、开发和生产构建命令可运行。
- [x] 桌面端提供项目栏、五阶段证据脊柱、主工作区和证据检查器;移动端无横向溢出且关键操作可触达。
- [x] Idea 工作台可记录交流、创建项目并通过现有 `/projects`、`/runs` 合同启动研究;失败和 blocked 结果有明确状态。
- [x] 论文搜集界面支持检索过滤、题录队列和 seed paper 编辑;启动 run 时通过既有合同提交,不伪造外部检索成功。
- [x] 论文阅读界面支持文献切换、摘要/定位信息、阅读笔记和证据限定问答;未连接 API 时返回可行动的未发送状态。
- [x] 写作界面支持章节导航、实时编辑、字数统计、浏览器本地自动保存、版本快照和受控修订请求;本地保存不显示为服务端同步。
- [x] 审核界面展示 Gate、证据覆盖、缺口、审计事件和定向修订入口,不允许 UI 绕过人工批准或确定性 Gate。
- [x] 前端至少覆盖 loading、empty、error、success/blocked 状态,并通过 lint、typecheck、单元测试和生产构建。
- [x] 使用真实本地浏览器验证宽屏与移动视口的布局、关键交互和无水平溢出,并保留截图证据。
- [x] Python 回归、doctor、Project-to-Act validate 与 `node .ai-team/check.mjs --base main` 通过,协作账本与代码同一提交。

## Invariants

- 当前入口不要求团队一次性拆到函数、接口或工单;模块负责人后续再自行细化。
- 详细版是参考材料,不代表所有子任务都已实现或已验收。
- 真实论文试点、生产数据库、Web UI、灾备和性能仍保持原有“外部阻塞/待开发”状态。
- 不提交 token、密钥、私有来源、完整论文、原始提示或虚构外部结果。
- 保持恰好五个业务 Agent;前端阶段、证据检查器、自动保存和 API 适配层都不是新 Agent。
- UI 只调用受支持的 HTTP/Application Service 边界,不自行实现 Gate、状态转换或人工批准。
- `synthetic_fixture`、界面预览和浏览器 localStorage 只证明交互路径,不能展示为真实论文、真实 MD 结果或服务端已同步。
- 证据不足、API 不可达、unknown、blocked、denied 与成功必须视觉和语义上分开。
- 不提交密钥、`.env.local`、原始模型响应、许可不明全文或外部论文副本。
- 原工作树中的未提交 LLM/阅读/写作改动属于用户;AR-006 在独立 worktree 中实现,不覆盖或携带这些变更。

## Decisions

- 使用 M00–M17 作为稳定模块 ID,先按模块分配负责人。
- 保留详细拆解版,避免未来重新整理时丢失依赖和验收素材。
- `.project-to-act` 继续作为长期项目事实源;`.ai-team/TASK.md` 只记录本次短周期交付。
- 从 AR-005 已提交快照 `ca00cbb` 创建独立分支 `codex/ar-006-research-workbench`,避免污染原工作树的未提交后端修改。
- 使用 Next.js 16.3.2 + React 19 + TypeScript;该 Next.js 版本高于 CVE-2025-55182 的 16.0.7 修复线。
- 视觉方向为“研究台账 × 编辑工作台”,以五阶段“证据脊柱”作为签名交互;采用石墨/纸张色和单一青色操作强调。
- 参考 AI-Scientist、STORM、PaperQA、GPT Researcher 与 Open Deep Research 的阶段/证据/阅读模式,只吸收信息架构,不复制代码或视觉。
- 初版通过同源 `/backend/*` 代理连接默认 `http://127.0.0.1:8010`;连接失败时保留明确的离线预览和浏览器草稿状态。

## Completed

- 将原 `docs/AutoResearch_任务拆解书.md` 移为 `docs/AutoResearch_任务拆解书_详细版.md`。
- 新建模块级 `docs/AutoResearch_任务拆解书.md`,包含 18 个模块、执行阶段、负责人模板和首批分配建议。
- 保留 README 任务书入口,并将 AR-003 的状态、范围和下一步写入协作账本。
- 已读取 AGENTS、PROJECT、TASK、repo-task-sync 与 Project-to-Act 账本,确认 M13 Web UI 是待开发范围。
- 已完成 GitHub 定向参考调研并确定前端信息架构与视觉方向。
- 已隔离原工作树的用户修改并建立 AR-006 独立工作树。
- 已交付 Next.js 16.3.2 五阶段工作台、证据脊柱、三栏研究台、移动端底部阶段栏和证据抽屉。
- 已接通 `/health`、`/projects`、`/runs`、论文问答、稿件读取与 revision;E0 题录不提交,blocked/unknown/错误状态分开。
- 已实现章节实时编辑、浏览器 localStorage 自动保存、版本快照、字数/引用/缺口统计和受控修订入口。
- 已完成 3 个前端交互测试、Next 生产构建、26 个 Python 回归、doctor、Project-to-Act 校验和真实隔离 HTTP 客户旅程。
- 已在 1440×1000 与 390×844 浏览器视口确认 0 px 横向溢出,并保存生产模式截图。

## Pending

- 用户/团队需要为模块负责人模板填写实际 owner、分支、目标日期和 evidence ID。
- 模块负责人确认后,再选择需要展开的模块,不默认展开全部模块。
- 真实论文试点仍等待 idea、领域、目标 venue、授权全文和实验资源边界。
- AR-006 本地单用户前端无剩余实现项。
- 平台级后续仍需受控论文/稿件/审核列表 API、流式 run 事件、认证、协作和生产托管;真实 corpus/MD Gate 保持未通过。

## Next step

先认领 M01–M04、M05–M07、M08、M09–M10、M11–M12、M13–M15/M17、M16 这 7 个模块包;完成模块边界确认后,再只对当前瓶颈模块做子任务拆解。
由用户/团队审阅研究工作台;下一前端任务应先补后端列表/流式事件与认证合同,再扩展跨项目和多人协作界面。

## Verification

- [x] Project-to-Act `--check` — managed 配置有效,唯一账本保持不变。
- [x] 模块文档结构检查 — M00–M17 全部存在,详细版文件可访问。
- [x] `node .ai-team/check.mjs --base main` — AR-003 acceptance 5/5,任务范围和变更同步有效。
- [x] Project-to-Act `--validate` — managed 配置 valid,issues 为空。
- [x] `npm.cmd run lint`
- [x] `npm.cmd run typecheck`
- [x] `npm.cmd run test`
- [x] `npm.cmd run build`
- [x] `.venv\\Scripts\\python.exe -m ruff check src tests`
- [x] `.venv\\Scripts\\python.exe -m pytest -W error -q`
- [x] `.venv\\Scripts\\autoresearch.exe doctor`
- [x] Root Project-to-Act `--validate`
- [x] Browser wide/mobile validation and screenshots
- [x] `node .ai-team/check.mjs --base main`

## Handoff note

- From: `zzg`
- From: `Codex`
- To: `user/team`
- Summary: 当前分配入口已经降为模块级;详细拆解保留在附录。先分模块负责人,后续只对真正需要的模块继续细化。
- Summary: AR-006 五阶段本地研究工作台已收口;真实 API、blocked Gate、本地草稿、宽屏/移动端和全仓回归均有证据。认证/协作/生产部署与真实论文结论未虚报完成。
22 changes: 17 additions & 5 deletions .project-to-act/PROJECT_ACCEPTANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,10 @@

## 当前验收结论

- 结论:0.1.0 Foundation Preview 基础验收通过;生产级 P1–P6 与真实论文项目仍未验收
- 验收范围:严格五 Agent 本地架构、基础纵向工作流、CLI/API、证据门禁、项目文件夹投影和隔离客户旅程
- 最后检查:2026-08-22(foundation 收口检查)
- 遗留问题:真实论文 idea/gold corpus/实验、生产数据库、重启幂等、备份恢复、Web/认证和真实投稿均未验收
- 结论:0.1.0 Foundation、AR-005 M08 软件纵切与 AR-006 本地研究工作台验收通过;生产级 P1–P6 与真实论文/MD 项目仍未验收
- 验收范围:严格五 Agent 本地架构、M08 RunManifest/执行 lineage、领域化完整论文框架、CLI/API/Web、证据门禁、实例化项目和隔离客户旅程
- 最后检查:2026-08-23(AR-005 稿件框架检查)
- 遗留问题:许可全文/gold corpus/真实 MD/独立复验、生产数据库、备份恢复、Web 认证/协作/托管和真实投稿均未验收

## 验收标准

Expand Down Expand Up @@ -43,6 +43,8 @@
| A-FND-012 | CLI/API 可运行且配置摘要不泄露秘密 | 已通过 | doctor、ASGI、真实 listener、受管 LLM 最小调用 | E-RUN-001、E-JOURNEY-001、E-LIVE-001 |
| A-FND-013 | 自进化没有自动改源码/策略的执行路径 | 已通过 | proposal-only 状态测试与接口审查 | E-RUN-001 |
| A-FND-014 | 文档覆盖架构、功能、接口、运维、安全、开发和测试 | 已通过 | 文件清单与链接检查 | E-RUN-001 |
| A-FND-015 | 金属韧性损伤 Writer 在缺真实结果时仍生成完整论述框架,且不伪造数值 | 已通过 | 领域工作流回归、全稿结构和占位检查 | E-WRITE-001 |
| A-FND-016 | 本地 Web 工作台覆盖五阶段并准确区分 E0、本地草稿、blocked 与 API 成功 | 已通过 | 前端 lint/typecheck/test/build、真实隔离 HTTP journey、宽屏/移动端浏览器检查 | E-WEBUI-001 |

### 产品运行时验收标准

Expand All @@ -57,7 +59,7 @@
| A-RUN-007 | 论文搜索多源、去重、版本、撤稿/更正和检索日志完整 | 待检查 | gold queries + 手工标注集 | 无 |
| A-RUN-008 | 论文读取支持全文 locator、总结、陪读、claim map 和创新候选 | 待检查 | 固定论文集人工盲审 | 无 |
| A-RUN-009 | 创新候选完成最近似工作和反向检索,不把 UNKNOWN 写成创新 | 待检查 | 已知重复 idea 和反例回归 | 无 |
| A-RUN-010 | 工作包与 RunManifest 可复核,未执行计划不能变成结果 | 待检查 | fake-run/adversarial + 实际运行测试 | 无 |
| A-RUN-010 | 工作包与 RunManifest 可复核,未执行计划不能变成结果 | 已通过 | fake-run/adversarial + 实际确定性运行测试 | E-M08-001、E-M08-LIVE-001 |
| A-RUN-011 | 写作只消费已放行 claim,关键事实/数字/结果证据绑定 100% | 待检查 | manuscript claim-citation audit | 无 |
| A-RUN-012 | 审核可定向打回并在修订后复验,无自批或改证据放行 | 待检查 | reviewer/gate 权限测试 | 无 |
| A-RUN-013 | paper/experience/knowledge/user/project/evidence 分区与 ACL 生效 | 待检查 | 跨分区污染和权限负例 | 无 |
Expand All @@ -82,17 +84,27 @@
| E-LIVE-001 | 2026-08-22 | OpenAlex/Crossref/S2 limit=1;受管 DeepSeek JSON connectivity | 部分外部源受限 | OpenAlex/Crossref 成功;S2 HTTPStatusError;LLM call 成功 | 只证明当时边界;不证明检索/生成质量 | `evidence/FOUNDATION_EVIDENCE.md` | 7 天或外部配置变化前 |
| E-PROJECT-001 | 2026-08-22 | 项目实例化/防覆盖/终态投影测试 | 0 | 同 E-RUN-001 | 子项目 manifest、RUN_INDEX、进度 runtime 区块与稿件路径一致 | `evidence/FOUNDATION_EVIDENCE.md` | 模板或投影代码变化前 |
| E-COLLAB-001 | 2026-08-22 | VibeCollab check;根/模板 Project-to-Act validate | 0 | AR-001 9/9;两账本 zero issues | 当前 Git 任务、代码、验收和长期账本一致;private sessions disabled | `.ai-team/TASK.md`、`evidence/FOUNDATION_EVIDENCE.md` | TASK 或账本变化前 |
| E-M08-001 | 2026-08-22 | Ruff;25 tests warnings-as-errors;84% coverage;doctor;CLI register/execute/status;双账本/YAML 校验 | 0 | `0.2.0.dev0`;收口提交后以 Git commit 固化 | 金属韧性损伤 Profile、RunManifest、幂等、hash、失败不产证据、E1/E2 和 workflow Gate 通过 | `evidence/AR005_M08_EVIDENCE.md`、`tests/test_execution_service.py` | 代码/fixture 变化前 |
| E-M08-LIVE-001 | 2026-08-22 | 受管 GLM/DeepSeek;127.0.0.1:8137;AAWO HTTP journeys | GLM/provider timeout 和 AAWO 15s timeout 如实保留;6 pass | run `run_c3357978832d4b77`、`run_b33c1d0b69564e6f`;报告 hash 见证据文件 | DeepSeek scope 成功;synthetic 执行 completed 但稿件 blocked | `evidence/journeys/ar005-*`、`evidence/AR005_M08_EVIDENCE.md` | 7 天或模型/HTTP 合同变化前 |
| E-WRITE-001 | 2026-08-23 | Ruff;26 tests warnings-as-errors;doctor;根/论文 Project-to-Act validate;repo-task-sync;全稿章节/占位/diff 检查 | 0 | implementation commit `4bacb90` | Writer 生成领域化完整框架;手工稿约 9800 字符、35 个标题、0 个待填写/TODO;synthetic 结果仍阻断 | `src/autoresearch/writing_service.py`、`tests/test_execution_service.py`、论文 `05_writing/` | Writer、稿件或研究边界变化前 |
| E-WEBUI-001 | 2026-08-23 | Next lint/typecheck/3 tests/build;隔离 FastAPI `/health`+`/projects`+`/runs`;1440×1000/390×844 浏览器布局、交互与溢出检查 | 0 | AR-006 收口提交后以 Git commit 固化 | 五阶段本地 Web 可运行;真实 run blocked/waiting_evidence;宽/移动 0 px 横向溢出;localStorage 不冒充服务端同步 | `evidence/AR006_WEB_EVIDENCE.md`、`evidence/ui/`、`web/` | 前端、HTTP 合同或响应式 CSS 变化前 |

## Gate 记录

| Gate ID | 日期 | Gate | 对象 | 结果 | 证据 ID | 豁免与确认人 |
|---|---|---|---|---|---|---|
| G-P0-001 | 2026-08-21 | P0 规划交付 | 计划书、功能表、根账本、论文项目模板 | PASS | E-PLAN-001、E-TPL-001 | 无豁免 |
| G-FND-001 | 2026-08-22 | Foundation Preview 本地交付 | 源码、文档、测试、CLI/API、本地客户旅程 | PASS | E-RUN-001、E-JOURNEY-001、E-LIVE-001、E-PROJECT-001 | 无豁免;真实论文与生产 Gate 保持未通过 |
| G-M08-SW-001 | 2026-08-22 | M08 软件纵切 | 领域 Profile、RunManifest、deterministic execution、artifact lineage、synthetic Gate | PASS | E-M08-001、E-M08-LIVE-001 | 无豁免;真实 MD/论文/生产 Gate 保持未通过 |
| G-M13-UI-001 | 2026-08-23 | M13 本地 Web 纵切 | 五阶段工作台、API 边界、本地实时编辑、证据检查器、响应式布局 | PASS | E-WEBUI-001 | 无豁免;认证/协作/生产托管与真实论文 Gate 保持未通过 |

## 验收记录

按时间倒序追加:日期、检查范围、证据 ID、结果、遗留问题和结论。失败、跳过与过期证据也必须如实记录。

- 2026-08-23|AR-006 本地研究工作台:Next.js 16.3.2 lint/typecheck/3 tests/build 通过;隔离 FastAPI 健康连接和 blocked run 通过;宽屏/移动端均无横向溢出,E0 与本地草稿边界可见|E-WEBUI-001|G-M13-UI-001 PASS|遗留:认证、列表/流式事件、协作、生产托管和真实 corpus|结论:A-FND-016 通过;Web 生产与真实论文验收仍未通过。
- 2026-08-23|AR-005 稿件框架:Writer 领域化框架回归、26 tests、Ruff、doctor、双账本和协作校验通过;完整论述稿无待填写/TODO,synthetic 未写成材料结果|E-WRITE-001|论文框架 PASS|遗留:无许可全文/真实 MD/独立复验/图表|结论:A-FND-015 通过;A-RUN-018 真实论文试点仍未通过。
- 2026-08-22|AR-005 M08 软件纵切:25 tests、84% coverage、doctor、CLI、双账本、真实 DeepSeek scope、AAWO 6 pass/1 timeout inconclusive、真实 OpenAlex 题录+synthetic 完整 run 和稿件缺口|E-M08-001、E-M08-LIVE-001|G-M08-SW-001 PASS|遗留:无许可全文/真实 MD/独立复验/生产 executor|结论:A-RUN-010 软件合同通过;A-RUN-018 真实论文试点仍未通过。

- 2026-08-22|0.1.0 foundation 收口:18 tests、84% coverage、warnings-as-errors、doctor、四个真实 HTTP 客户旅程、OpenAlex/Crossref 最小 live、S2 受限诊断、受管 LLM 最小 connectivity、子项目运行投影与完整文档|E-RUN-001、E-JOURNEY-001、E-LIVE-001、E-PROJECT-001|G-FND-001 PASS|遗留:严格产品 A-RUN-002–020 多数仍需生产级/真实论文证据|结论:基础架构和功能纵向切片可运行,不可声明真实论文或生产交付完成。
- 2026-08-21|P0 收口:计划书、86 项功能表、根/模板 Project-to-Act、模板结构、相对链接、字段、密钥样式和现有底座核验|E-BASE-001、E-WEB-001、E-PLAN-001、E-TPL-001|P0 PASS|遗留:产品运行时全部阶段尚未实现;真实论文试点未开始|结论:规划交付完成,项目产品不可声明完成。
Loading