onesvm-browser-server/.dsh/contracts/plan-20260901-02.md
chii 983259836d chore: init workspace with onesvm-dev-md + casa-commander
docs: 联网搜索服务架构方案全套(plan-final/design-arch/选型决策/整合导览/MCP文档/部署预设/联调手册)
bench: 5 方案 + 代理 + 站点矩阵本机实测工程(无密钥)
部署目标:primary mgr1 先行测试(待批准后执行)
2026-09-01 15:19:52 +08:00

35 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Commander Plan: 文档体系 + 部署预设 + 强对抗优化方案(第二轮)
> 状态: done
> 创建: 2026-09-01(Asia/Shanghai)
> plan_id: plan-20260901-02
> run_id: run-20260901-browser-arch(沿用首轮实测数据)
## 目标
交付 5 项:T0 整合架构梳理文档;T1 MCP 使用文档(含能力数据范围);T2 生产部署预设详情(供用户审批,不实际部署);T3 打不过的 9 类站点优化方案研究;T4 Vlepontas 联调使用说明草稿。
## 背景与约束
- 数据基础:run-20260901-browser-arch 全部产物(bench 实测、site-matrix、三 PASS 验收)
- 约束:本轮纯文档/调研,不部署、不改生产;技术栈选型给预设建议并标决策点;文档 ≤600 行/份
## 步骤表
| step_id | goal | worker | model_family | scope (in) | acceptance | depends_on | status |
|---------|------|--------|--------------|------------|------------|------------|--------|
| P1 | T3 强对抗站点优化方案研究:Amazon/Medium/Reddit/X/知乎/微博/百度百科/SO/YouTube 各站的可行获取路径(官方 API/RSSHub/移动端/住宅代理/Camoufox/第三方数据服务),按成本-质量-合规分级 | subagent_cursor(explore) | hard | 写 `.dsh/artifacts/run-20260901-browser-arch/research/06-blocked-sites.md` | 每站给出 ≥1 可行路径 + 成本 + 合规注记 + 来源链接 | — | done |
| P2 | T0 整合架构梳理文档:整合哪些自部署服务/怎么整合(Dock 协议+模版层)/提供什么服务/并发排队机制 | subagent_fork(implement) | hard | 写 `docs/overview-integration-20260901.md` + `docs/README.md` 索引 | 覆盖用户四问,引用既有文档不重复造数 | — | done |
| P3 | T1 MCP 使用文档:工具清单/参数/认证/错误码/合规使用规则/能力数据范围(引擎矩阵+站点矩阵+性能档位) | subagent_fork(implement) | hard | 写 `docs/mcp-usage-20260901.md` | 智能体读完可正确接入;能力范围与实测一致 | — | done |
| P4 | T2 生产部署预设:服务清单(控制层/worker)、技术栈、镜像、资源、节点布局、端口、健康检查、部署流程 | 主会话 | architect | 写 `docs/deploy-prod-preset-20260901.md` | 与档位表/布局一致;标出待用户拍板项 | — | done |
| P5 | T4 Vlepontas 联调使用说明草稿(注册/拿 key/接 MCP/验收用例/反馈回路) | 主会话 | hard | 写 `docs/integration-vlepontas-20260901.md` | 批准部署后可直接发对方 | P4 | done |
| P6 | 四份文档独立验收 | subagent_fork(review) | reviewer | 只读 | review 无 blocker | P1–P5 | done(PASS;F1-F5 已修) |
## 并行策略
P1 ∥ P2 ∥ P3 同时启动;P4/P5 主会话穿插;P6 收尾。
## 风险
- T3 部分站点可能无合规可行路径 → 如实写「无可行路径/需住宅代理成本项」
- 技术栈预设(Go vs Python)用户可能有偏好 → 标决策点