阿里云 OSS 文件夹归档 Workflow

边界

OSS 文件、附件、图片、Excel、压缩包和源数据都留在阿里云 OSS bucket/prefix，或本机被忽略的 oss/ 缓存中。Git 只保留说明、清单、流程和必要的小型派生信息。

执行步骤

1. 先运行 bash scripts/sync_workflow.sh pull。
2. 确认阿里云 OSS 的 bucket、prefix、region、endpoint 和本机 profile。
3. 用 aliyun ossutil ls 查看远端，用 find oss、du、stat、shasum -a 256 扫描本地元数据。
4. 把归档结论写入 docs/runs/YYYYMMDD-oss-folder-archive.html。
5. 把稳定做法沉淀到 skills/oss-folder-archive/SKILL.md 和本 workflow。
6. 用带路径的 upload 只提交控制面文件。

推荐命令

bash scripts/aliyun_oss_project_assets.sh check
bash scripts/aliyun_oss_project_assets.sh list
bash scripts/aliyun_oss_project_assets.sh pull
bash scripts/aliyun_oss_project_assets.sh list-spreadsheets
bash scripts/aliyun_oss_project_assets.sh pull-spreadsheets
bash scripts/aliyun_oss_project_assets.sh push-spreadsheets --dry-run

项目默认配置

• 配置文件：config/aliyun-oss.env，只保存非密钥配置。
• 私有 bucket：bucket-food-safety。
• 项目前缀：bid-analysis-methodology。
• 表格前缀：bid-analysis-methodology/spreadsheets。
• 默认 profile：st_huicheng_oauth。别人 Mac 需要创建同名 profile，或用 config/aliyun-oss.local.env 覆盖。
• HTML 公开前缀：oss://kxunpt/public/bid-analysis-methodology/。
• HTML 外网基址：https://kxunpt.oss-cn-beijing.aliyuncs.com/public/bid-analysis-methodology。

同步与挂载

• aliyun ossutil sync 是同步方式，适合把阿里云 OSS 对象下载到本地 oss/，或把本地 oss/ 上传到指定 prefix。
• ossfs 是文件系统挂载方式，适合把 bucket 显示成一个本地目录，但每台 Mac 都需要自己的 OSS 凭据和权限。
• 本项目默认采用同步目录模型。只有在明确需要实时挂载时，才把 oss/ 当作 mount point。
• 谨慎使用 --delete，避免把本地或远端多余文件误删。

归档字段

• 阿里云 OSS bucket、prefix、region、endpoint 和本机 profile 名称。
• 相对路径、类型、大小、修改时间。
• 普通文件的 SHA256，文件太大时可只记录大小和待算哈希。
• Git 忽略状态和处理结论。
• 是否需要从 OSS 拉取、上传到 OSS、生成派生报告、请用户补权限或保留本地。

Git 与 OSS 分流

详细标准见 docs/oss-assets/git-vs-oss-storage-standard.html。简化规则：问答、脚本、skill、workflow、OSS 非密钥配置放 Git；说明类 HTML 同时放 Git 和公开 OSS；Excel、CSV、PDF、Word、ZIP 和原始数据放阿里云 OSS 或本地 ignored 目录。

协作者边界

• 别人 Git clone 或 Codeup 拉取仓库，只会得到 oss/.gitignore 和流程说明，不会得到阿里云 OSS 文件。
• 别人本地 Mac 没有阿里云 OSS 登录配置时，不能自动访问 bucket，也不能同步或挂载远端内容。
• 如果用 Finder、zip、移动硬盘或 rsync 复制 Jack 本机整个项目，并且 oss/ 已有缓存文件，那些文件可能被一起复制。这是文件系统复制，不是 Git 行为。