- commit
- 3c85eaf
- parent
- 39766c4
- author
- im_wower
- date
- 2026-03-28 16:35:59 +0800 CST
docs: archive legacy plugin delivery plan
1 files changed,
+0,
-81
1@@ -1,81 +0,0 @@
2-# BAA 插件侧 Delivery 加固需求
3-
4-## 状态
5-
6-- `已完成（T-S035，2026-03-28）`
7-- `当前只保留为 DOM fallback 历史方案；代理式主链已在 ./archive/BAA_BROWSER_PROXY_DELIVERY_REQUIREMENTS.md 完成`
8-- 优先级：`high`
9-- 记录时间：`2026-03-27`
10-
11-## 关联文档
12-
13-- [archive/BAA_DELIVERY_BRIDGE_REQUIREMENTS.md](./archive/BAA_DELIVERY_BRIDGE_REQUIREMENTS.md)
14-- [archive/BAA_ARTIFACT_CENTER_REQUIREMENTS.md](./archive/BAA_ARTIFACT_CENTER_REQUIREMENTS.md)
15-- [../docs/firefox/README.md](../docs/firefox/README.md)
16-
17-## 背景
18-
19-当前 live delivery 已经收口到：
20-
21-- `browser.inject_message`
22-- `browser.send_message`
23-
24-但当前插件侧交付仍保留 3 个直接风险：
25-
26-- inject / send 仍主要依赖 DOM heuristic
27-- 首版只对 `Claude` / `ChatGPT` 做了选择器与流程
28-- 失败恢复、页面 readiness 和平台差异当前还不够收口
29-
30-这意味着当前链路虽然可用，但平台页面稍有结构变化，就可能把交付稳定性重新打回“脆弱自动化”。
31-
32-## 核心结论
33-
34-- 插件仍保持 thin-plugin 方向，不在插件里做 artifact 打包、parser 或复杂编排
35-- 下一步应把 delivery 逻辑显式收口为平台 adapter，而不是继续散落在通用 DOM heuristic 里
36-- 首批只加固：
37- - `Claude`
38- - `ChatGPT`
39-- 加固重点是：
40- - readiness 探测
41- - 平台选择器集中管理
42- - 失败重试 / fail-closed
43- - 结构化状态与错误回写
44-
45-## 范围
46-
47-- `Claude` / `ChatGPT` 平台 delivery adapter 收口
48-- text-only `inject / send` readiness 探测与超时
49-- 结构化失败原因、平台状态和调试字段
50-- browser smoke 与文档回写
51-
52-## 当前明确不要求
53-
54-- 不要求在本需求里扩到 `Gemini`
55-- 不要求在本需求里恢复 upload / download / binary delivery
56-- 不要求在本需求里扩到多客户端、多轮 delivery
57-- 不要求在本需求里改 task/run 编排或跨节点分发
58-
59-## 验收条件
60-
61-- `Claude` / `ChatGPT` 的 text-only `inject / send` 逻辑有明确 adapter 边界，不再散落为隐式 heuristic
62-- 页面未 ready、选择器失效、发送失败时会返回明确错误，不会静默成功
63-- browser smoke 能覆盖至少一条成功路径和一条 fail-closed 路径
64-- 文档已同步到 `plans/`、`tasks/`、`docs/firefox/` 和必要的 `docs/api/`
65-
66-## 当前预期残余边界
67-
68-- 插件侧最终仍会依赖 DOM / 页面结构，只是把风险收口成可维护的 adapter 层
69-- 首版仍只覆盖 `Claude` / `ChatGPT`
70-- 当前仍只服务于单客户端、单轮 delivery
71-
72-## 完成回写（2026-03-27）
73-
74-- 已完成：
75- - Firefox 插件 content script 已新增独立 `delivery-adapters.js`，把 `Claude` / `ChatGPT` 的 text-only `inject / send` 统一收口到 adapter 边界
76- - adapter 已补 page readiness、selector 解析、发送确认和有限重试；失败时返回稳定 `delivery.<code>` 错误并 fail-closed
77- - 插件侧不再接受 `upload_artifact` 命令
78- - browser smoke 已覆盖 adapter 成功路径、page-not-ready 和 send-not-confirmed 失败路径
79-- 当前残余边界：
80- - 仍然依赖 DOM / 页面结构，只是风险已集中在 adapter 模块
81- - 仍未扩到 `Gemini`
82- - 当前仍只服务于单客户端、单轮 delivery