chore: assets - retire canvas workflow and document repo sources

This commit is contained in:
tukuaiai
2026-04-28 19:14:25 +08:00
parent 7dd36d6dd3
commit f7d1828dcd
28 changed files with 77 additions and 1988 deletions
+12
View File
@@ -19,8 +19,20 @@ assets/repos/
- 新增外部依赖(优先 Git submodule,确保可复现)
- 更新 submodule 指针(明确记录上游来源与用途)
- 用相对软链接把 submodule 暴露到其它资产目录,软链接目标必须仍在仓库内
- 为已复制进主仓库的外部源码建立清退计划:上游 URL、保留理由、迁移方式、验证命令
### 禁止 / 不推荐
- 直接复制粘贴大型第三方仓库内容到主仓库(优先 submodule)
- 将 submodule 替换为本地绝对路径软链接(会导致他人环境不可用)
- 提交第三方仓库的构建产物、生成物、运行时二进制或缓存目录
- 在主仓库直接魔改第三方源码快照;需要改造时先 fork,再以 submodule 指向 fork
## 仓库表达决策
1. **完整外部仓库**:使用 `git submodule`,主仓库只记录 commit 指针。
2. **同仓多入口展示**:使用相对软链接,例如 `assets/skills/<name> -> ../repos/<name>`
3. **项目内小工具**:只有在无上游、体量小、与本项目强耦合时才直接追踪源码。
4. **生成输出**:默认不跟踪;若必须保留样例,只提交最小样例和生成说明。
5. **历史备份**`assets/repos/backups/` 按项目资产处理,不套用外部仓库清退规则。