docs: GOVERNANCE §6 Git 远端协作治理 + DECISIONS 2026-08-01

This commit is contained in:
agent committed 2026-08-02 13:31:19 +00:00
1 parent 4ba51e8770
commit 3ce4fc0f0a
2 files changed
+10

No files matched your search

+9
View File
@@ -63,3 +63,12 @@ qianbian/
- 分析环境:Python 3.12(venv 于 `.venv/`)、jadx、capstone、bleak。
- 依赖锁定:`requirements.txt` 固定版本;新增依赖需记录于 DECISIONS.md。
- 外部工具一律装在本机,不修改系统关键组件。
## 6. Git 与远端协作(2026-08 增补,DECISIONS 2026-08-01)
1. **远端**:Gitea 实例,chenwei 账户下同名仓库 `qianbian`(remote 名 `origin`)。URL 见 DECISIONS.md 2026-08-01 条目。
2. **分支策略**:`main` 为唯一主干,直接提交;实验性大改动用 `<topic>` 短分支,回合并即删。不使用 force push 改写 main 历史。
3. **提交身份**:agent 工作用 `agent <agent@local>`,人工工作用本人身份——不混用、不改写历史身份,保证溯源诚实。
4. **推送前检查**:工作树干净、`pytest` 全绿、无新增 secret(token/私钥/真实密码)。测试用口令(如 `pw123456`)允许但必须在测试/文档语境。
5. **大文件**:`app/` 原始输入(APK 9.3MB、固件 72KB)随库分发(项目自包含要求);其余 >1MB 产物须为文档/证据类文本,二进制中间产物一律 gitignore + 再生方法入库(analysis/README.md)。
6. **同步纪律**:每个工作会话开始先 `git pull --ff-only`;结束前提交并 `git push`。冲突时以远端为准 rebase 本地未提交改动,禁止 `--force`。