oss/ 已创建,作为 OSS 文件投放或挂载根目录。OSS 文件夹挂载与归档记录
本次把项目根目录下的 oss/ 设为本地专属 OSS 文件夹。仓库只提交问答记录、归档清单、skill 和 workflow,避免提交 OSS 文件本体。
用户目标
给这个项目挂载一个 OSS 专属文件夹,把文件夹里的所有内容归档一下。项目只提交所有问答,以及形成 skill workflow 之类的控制面内容。
处理结果
本地目录
提交边界
.gitignore 和 oss/.gitignore 已阻止未来内容进入 Git。项目 skill
skills/oss-folder-archive/SKILL.md 已记录后续 agent 操作规则。Workflow
workflows/oss-folder-archive-workflow.html 已记录目录归档流程。本次目录归档
扫描时 oss/ 还没有业务文件。当前归档为首版空目录基线,只包含用于保留目录和忽略内容的控制文件。
oss/ └── .gitignore tracked control file external files: 0 business file bodies committed: 0
命令与验证
- 已执行
bash scripts/sync_workflow.sh pull,仓库已是最新。 - 已刷新 Codex 线程归档基线,输出到 notebooklm-mcp 的 thread archive 目录。
- 已读取项目 HTML taste skill,并按文档型页面做轻量样式。
- 待提交前验证:
git check-ignore oss/example-placeholder、git diff --check、git status --ignored --short oss。
可复用模式
oss/ 本地或 OSS 挂载文件本体 docs/runs/ 问答记录和目录归档摘要 workflows/ 可复跑流程 skills/ 后续 Codex 自动采用的项目规则
复制与登录边界
- OSS 文件夹位置:
/Users/jack/code/010-cpt/008-zhct/bid-analysis-methodology/oss。 - 别人通过 Git clone、Codeup 拉取或下载仓库时,只会得到
oss/.gitignore,不会得到 Jack 本机放入oss/的文件。 - 如果别人用 Finder、移动硬盘、rsync 或压缩包复制整个本地工作目录,并且 Jack 本机
oss/里已有文件,那么那些 ignored 文件可能会被一起复制。这是文件系统复制,不是 Git 提交。 - 别人本地 Mac 没有 OSS 登录配置时,仍然能看到空的
oss/目录和 workflow/skill 说明,但不能自动访问真实 OSS bucket 或同步远端 OSS 内容。 - 如需让别人拿到 OSS 内容,应单独给 OSS 权限、导出下载包,或生成可公开访问的 OSS 链接,并把链接或清单写入运行记录。
阿里云 OSS 语义修正
用户澄清这里的 OSS 指阿里云 Object Storage Service。已将 skill 和 workflow 从泛对象存储目录修正为阿里云 OSS bucket/prefix 的本地缓存、同步目录或挂载点。
- 本机已检测到阿里云 CLI:
aliyun 3.2.13。 - 本机已检测到
aliyun ossutil 2.3.0,可用于上传、下载、列举和同步 OSS 对象。 - 本机存在阿里云 CLI 配置,当前 profile 为
st_huicheng_oauth。记录中不保存任何密钥、Token 或 AccessKey 内容。 - 随后已配置项目级非密钥 OSS 设置:
bucket-food-safety、cn-beijing、bid-analysis-methodology前缀。
bash scripts/aliyun_oss_project_assets.sh check bash scripts/aliyun_oss_project_assets.sh list bash scripts/aliyun_oss_project_assets.sh pull
项目级 OSS 配置与 Excel 迁移
- 新增
config/aliyun-oss.env:提交 bucket、region、endpoint、prefix、profile 名称等非密钥配置。 - 新增
scripts/aliyun_oss_project_assets.sh:提供check、list、pull、list-spreadsheets、pull-spreadsheets、push-spreadsheets等入口。 - 新增
docs/oss-assets/git-vs-oss-storage-standard.html:明确 Git 与阿里云 OSS 分流标准。 - 已将 26 个 Excel/CSV 类文件上传到
oss://bucket-food-safety/bid-analysis-methodology/spreadsheets/。 - 新增
docs/oss-assets/spreadsheet-manifest.html与docs/oss-assets/spreadsheet-manifest.json作为表格资产清单。 - 已将 Git 中历史跟踪的 6 个 Excel/CSV 文件移出索引;本地文件保留,后续 clone 不再直接下载这些表格。
HTML 双存储策略
- 用户明确:HTML 说明放到阿里云 OSS 内,因为需要外网地址,同时 Git 仓库也存储一份。
- Git 仓库继续保存 OSS 非密钥配置,例如
config/aliyun-oss.env。 - 已扩展
scripts/aliyun_oss_project_assets.sh,新增push-html-public、list-html-public和html-manifest。 - 说明类 HTML 发布到
oss://kxunpt/public/bid-analysis-methodology/,外网基址为https://kxunpt.oss-cn-beijing.aliyuncs.com/public/bid-analysis-methodology。 - 业务报告 HTML 不默认公开发布,避免把敏感内容放进 public OSS。
下一步
别人 clone 项目后,先配置阿里云 CLI profile,再运行 bash scripts/aliyun_oss_project_assets.sh check 和 pull-spreadsheets 拉取表格资产。默认仍不提交文件本体。