贡献功能开发

项目开发规范（AI协作）.md

@@ -109,6 +109,28 @@
 6. 是否挂在正确的职责域中
 7. 文档
 
+### 3.4 新增运行态模式
+
+如果新增的是“运行态 UI 模式”而不是持久配置或新来源，必须先把边界说清楚，再落代码。
+
+当前约定示例：
+
+- `contributionMode` 是 sidepanel 的运行态 UI 模式，不是新的 `panelMode`
+- `panelMode` 仍然只允许 `cpa | sub2api`
+- 运行态模式不能混进 `PERSISTED_SETTING_DEFAULTS`
+- 运行态模式不能混进配置导入/导出
+- 如果运行态模式会临时覆盖某些持久配置的显示值，必须同时处理好“退出模式后恢复”和“自动保存不能误覆盖原配置”这两个问题
+- 如果运行态模式要隐藏某一行 UI，必须先检查这行里是否绑定了不该一起隐藏的其他设置；必要时先拆行，再做显隐
+
+当前贡献模式补充约定：
+
+- 贡献模式属于 `CPA` 来源下的特殊业务模式，不是新的 provider
+- 贡献模式允许扩展内承接公开 OAuth 交互，但只能调用公开接口，不能触碰 `/v0/management/*`
+- 如果产品要求“开始贡献”和主自动流走同一条链路，则优先把贡献服务接入步骤 7 / 10，而不是额外分出一套平行 mini-flow
+- 贡献流程的后台公开 OAuth 状态机应优先收敛到独立模块，例如 `background/contribution-oauth.js`
+- 贡献模式的侧栏按钮、状态展示和轮询调度应优先收敛到独立 manager，例如 `sidepanel/contribution-mode.js`
+- 如果服务端当前返回“无需手动提交 callback”，扩展端必须把它当兼容成功态处理，不能简单按 HTTP 非 200 直接视为失败
+
 ## 4. 测试规范
 
 ### 4.1 原则