v0.20.2 harden antigravity research workflow

PLAN.md

@@ -1,7 +1,7 @@
 # Deep Research 系统方案（Python Core + 多平台 Adapter）
 
 > 本文件是整套方案的**单一真实源**，中断后续接时从此文件恢复上下文。
-> 最后更新：2026-05-05
+> 最后更新：2026-05-07
 > 实施阶段：v0.20 — Skill-driven Python core 重构
 
 ---
@@ -35,6 +35,7 @@
 | 交互节奏 | Phase 1 末、Phase 3 末强制确认 |
 | 并发执行 | Python task-card worker pool（平台 subagent 仅作可选表层能力） |
 | 中文字体 | **思源宋体 + 思源黑体 + 霞鹜文楷**，通过 `download-fonts.sh` 自动拉取 |
+| Antigravity 适配 | 使用 `.agents/rules` + `.agents/skills` 指导 Antigravity 原生执行 Deep Research；Gemini Flash 管流程，Opus/Gemini Pro 分 phase 执行，Python core 退为辅助工具 |
 
 ---
 
@@ -59,6 +60,19 @@
 
 **Cache 行为**：Claude 走 `@ai-sdk/anthropic` 会自动打 `cache_control` 断点，zenmux 的 Anthropic 端点完整支持 4 种 cache 模式。Opus 4.7 cache read 价格仅 0.5 USD/M tokens（对比输入价 25 USD/M，节省 98%）。验证方法见 `AGENTS.md` §6.5。
 
+### 2.1 Antigravity 原生模型策略
+
+Antigravity 当前可选 models 包括 Gemini 3.1 Pro (High/Low)、Gemini 3 Flash、Claude Sonnet 4.6 (Thinking)、Claude Opus 4.6 (Thinking) 与 GPT-OSS 120B。Codex 使用经验显示，若 Antigravity 仍默认调用 Python core model workers，研究主流程容易回到 ZenMux，并且 packet/chapter assembly 有碎片化风险。因此 Antigravity 采用 native 模式：用 skill 指导 Antigravity 自身模型按 phase 写产物，Python core 只负责脚手架、确定性校验、引用和出稿。
+
+默认策略：
+
+- Surface manager：Gemini 3 Flash，负责读 skill、维护 task list、推进 phase、跑轻量命令和收集 artifact。
+- Phase 0-1：Claude Opus 4.6 (Thinking)，负责材料解读、研究方法选择、大胆假设、章节架构和成功标准。
+- Phase 2：Gemini 3.1 Pro (Low)，负责证据包、反方证据、chapter brief、初稿，优先追求速度和可控成本。
+- Phase 3：Gemini 3.1 Pro (High)，先做总编审校和证伪；若质量不足，再人工决定是否换模型复核。
+- Phase 4：Claude Opus 4.6 (Thinking)，负责最终中文统稿、Executive Summary、表达质量和交付一致性。
+- Python core 禁止默认接管 `run/research --execute-packets/assemble-chapters`；只有用户明确授权外部模型/API 消耗时才运行。
+
 ---
 
 ## 3. 完整架构
@@ -69,7 +83,7 @@ v0.20 后，核心编排从平台 prompt 迁移到项目自有 Python runtime：
 
 - `scripts/dr.py` 是稳定入口：`init`、`frame`、`run`、`research`、`review`、`finalize`、`skills`、`models`。
 - `scripts/runtime/*` 负责 role/task 模型解析、skill registry、task cards、packet schema、manifest 更新。
-- `.agents/skills` 是 canonical skill registry；`.opencode/skills` 等 adapter 目录由 `dr.py skills sync` 生成。
+- `.agents/skills` 是 canonical skill registry，也是 Antigravity 默认 workspace skill 目录；`.opencode/skills` 等 adapter 目录由 `dr.py skills sync` 生成。
 - OpenCode/Codex/Claude Code 只作为 surface adapter，调用 Python CLI，不再承载默认并发调度。
 - Phase 2 默认生成 `phase2/task_cards.json` 与 `phase2/packets/*.json`，减少长上下文传递。
 - Phase 2 在正式写章前生成 `phase2/chapter_briefs/*.json`，先把并发证据收束为章节主线，降低碎片化。
@@ -78,6 +92,7 @@ v0.20 后，核心编排从平台 prompt 迁移到项目自有 Python runtime：
 - Phase 4 默认中文原生：`final_zh.md -> build_report`，legacy 英译中链路仅由 `--legacy-translate` 显式启用。
 - Phase 1 必须选择 `research_method`，由 `configs/research_methods.yaml` 决定框架方法和 Phase 2 task axes；MECE 不再是唯一默认。
 - 用户提供资料入口已支持 `input_materials` / `phase0/inputs` / `phase0/extracted`；PDF 文本抽取与 FireRed OCR 扫描件识别已先行落地，DOCX/PPTX/表格结构化继续放入 v0.21。
+- Antigravity 入口已落地：`.agents/rules/deep-research-antigravity.md` 约束其优先使用 Antigravity 模型配额，`.agents/skills/antigravity-surface-adapter` 提供 native runbook、模型切换和搜索策略。
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
@@ -715,3 +730,33 @@ OpenCode 的坑：如果只是在主会话里装样子地写"让 X agent 做"，
   - `scripts/runtime/tasks.py` 把 `evidence` 纳入合法 search route，并更新主要 task axes 的默认路由。
   - `scripts/runtime/workers.py` 的 `ProjectSearchProvider` 支持 `evidence` route。
   - `skills/search-gateway`、`skills/search-strategy`、`docs/search-playbook.md`、`README.md`、`AGENTS.md` 同步记录搜索分工，避免后续又回到 Tavily MCP 或中文长句搜索。
+
+- 2026-05-07 v0.20.1 Antigravity native adapter：**用 Antigravity 模型配额执行研究**
+
+  **设计结论**：
+  - Antigravity 官方机制以 `.agents/skills`、`.agents/rules`、Rules/Workflows、Task Groups 和 browser subagent 为核心；本项目在 Antigravity 中采用 skill-driven native research，而不是默认调用 Python core model workers。
+  - `AGENTS.md` 继续作为跨平台总规则；Antigravity 专项约束放到 workspace rule 和 skill，避免引入非官方 SOUL.md 作为项目真源。
+  - Opus 额度有限但大局观强，优先用于 Phase 0-1 和 Phase 4；Gemini 3 Flash 做流程管理，Gemini 3.1 Pro Low/High 分别用于 Phase 2/3。
+  - `paperfoot/search-cli` 可作为 Antigravity 原生检索前台：多 provider、14 modes、JSON/exit code 友好；但不得替代本项目 source tier 与 source-quality 评分。
+
+  **已落地**：
+  - 新增 `.agents/skills/antigravity-surface-adapter/SKILL.md`，定义 Antigravity native runbook、pause points、artifact 汇报、模型切换表和 `search-cli` 使用建议。
+  - 新增 `.agents/rules/deep-research-antigravity.md`，要求 Antigravity 优先使用自身模型配额，Python core 只做脚手架、确定性校验、引用和出稿。
+  - 撤回 `configs/models.yaml` 中 Antigravity 专用 ZenMux profile，避免误导主流程继续走 Python/ZenMux。
+  - `docs/platform-adapters.md`、`README.md`、测试用例同步更新。
+
+- 2026-05-07 v0.20.2 Antigravity/Gemini research integrity hardening：**反幻觉、反假搜索、workflow gates**
+
+  **设计结论**：
+  - Gemini/Gemini CLI/Antigravity 在 deep research 中必须默认视为高幻觉风险模型；项目规则要把"诚实暴露不确定性"写成硬门槛，而不是依赖模型自觉。
+  - `GEMINI.md` 适合放短而硬的项目级行为约束，并通过层级 context 与 imports 承接 `AGENTS.md`。
+  - Antigravity `rules` 适合放 Always-On 约束；`workflows` 适合固化 Phase 0-4 执行顺序、人工暂停点和质量 gates。
+  - Claude/Claude Code 最佳实践可借鉴：根指令要短、具体、可执行，长流程拆到 rules/skills/workflows，避免巨型上下文降低遵从性。
+
+  **已落地**：
+  - `AGENTS.md` 新增 Antigravity native 例外、检索回执、source_id、search_log、unsupported_claims 等反幻觉硬规则。
+  - `GEMINI.md` 重写为短约束：禁止假搜索、禁止无 source_id 事实、要求 search log，并区分 Gemini CLI 与 Antigravity native。
+  - `.agents/rules/deep-research-antigravity.md` 加入 Anti-Hallucination Contract。
+  - `.agents/skills/antigravity-surface-adapter/SKILL.md` 加入 phase artifacts、fact-audit、权限建议和检索日志要求。
+  - 新增 `.agents/workflows/deep-research-native.md`，把四阶段 native research 写成可执行 workflow，并在每阶段设 gate。
+  - `scripts/deploy_adapters.py antigravity` 同步部署 workflows；已有文件继续默认跳过，`--force` 才备份覆盖。