发布或打包

08-03 发布或打包

课程定位

这一课讲项目如何变成可分享成果。不同项目有不同交付方式：静态网页可以发布成公开链接，脚本项目可以整理成文件夹，表格工具可以保留使用说明和样例数据。

第一项目的交付目标很朴素：别人或未来的自己能打开、能运行、能看懂。

这一课的成果是一份「发布或打包记录」。

本课目标

• 能判断项目适合发布还是打包。
• 能完成发布前检查。
• 能保存公开链接或打包文件夹。
• 能打开发布结果或打包结果验收。
• 能记录交付方式和注意事项。

录制建议

• 建议时长：30 到 40 分钟。
• 静态网页项目演示发布，脚本项目演示打包思路。
• 先做发布前检查，再执行交付。
• 强调隐私清理和 README 完整。
• 收尾打开交付结果验收。

课前准备

• 已保存版本的项目。
• README。
• 发布前检查单。
• 平台账号或本地打包目录。
• 浏览器。

讲稿正文

可以这样开场：

“项目完成第一版以后，要决定它怎么交付。网页适合给一个公开链接，脚本适合整理成一个能运行的文件夹。”

先判断交付方式。

静态网页：

适合发布到 GitHub Pages、Cloudflare Pages 或其他静态站点平台。交付物是一个 https:// 开头的链接。

脚本项目：

适合整理成项目文件夹。交付物包括脚本、README、样例输入、样例输出和运行说明。

表格辅助项目：

适合保留原始样例、处理后结果、操作说明和注意事项。

发布或打包前先检查：

• 项目能本地运行。
• README 可照着执行。
• 真实隐私数据已清理。
• 示例数据已脱敏。
• Git 已保存版本。
• 暂缓需求已写进后续计划。

这里要特别强调隐私清理：

“交付前一定要看 inputs、outputs、logs 这些文件夹。里面可能有真实姓名、手机号、客户信息、内部路径、报错截图。公开前要清掉或脱敏。”

发布后要打开链接验收。打包后要从整理好的文件夹重新按 README 跑一遍。

可以让 AI 帮忙生成检查单：

请根据我的项目类型和文件结构，生成发布或打包前检查单。
重点检查 README、示例数据、隐私材料、运行方式和交付后验收。

最后收束：

“交付的目标，是让另一个人，或者未来的自己，可以顺利接住这个项目。”

屏幕演示流程

1. 打开项目 README。
2. 打开发布前检查单。
3. 确认项目能运行。
4. 检查 inputs、outputs、logs。
5. 清理真实隐私材料。
6. 选择发布或打包方式。
7. 静态网页走发布平台；脚本项目整理交付文件夹。
8. 打开公开链接或打包文件夹。
9. 按 README 验收。
10. 保存发布或打包记录。

给 AI 的协作卡

我的项目准备交付。
请根据项目类型、README、文件结构和验收记录，帮我判断适合发布还是打包。

请输出：
1. 推荐交付方式
2. 发布或打包前检查单
3. 需要清理的隐私或临时文件
4. 交付后验收方式
5. 发布或打包记录应该写什么

发布或打包记录

• 项目名称：
• 交付方式：发布 / 打包
• 发布链接或打包位置：
• 发布前检查结论：
• 隐私材料是否清理：
• README 是否可用：
• 交付后验收结果：
• 注意事项：

课堂练习

让学员为自己的项目选择交付方式。

要求：

• 完成发布前检查。
• 清理或脱敏真实材料。
• 保存链接或打包位置。
• 打开交付结果验收。

常见卡点

• 学员没清理真实数据：交付前必须检查 inputs、outputs、logs。
• README 不完整：先补运行步骤。
• 发布后页面和本地不同：检查路径、文件是否齐、平台处理状态。
• 打包文件夹缺样例：保留脱敏输入和示例输出。
• 只保存压缩包没记录：写清打包位置和验收结果。

课后作业

完成主项目发布或打包记录。

提交内容：

• 发布链接或打包文件夹截图。
• 发布或打包记录。
• 交付后验收截图。
• 隐私清理确认。

课件页建议

• 第 1 页：项目要能被别人接住
• 第 2 页：网页发布，脚本打包
• 第 3 页：交付前检查
• 第 4 页：隐私清理
• 第 5 页：交付后验收
• 第 6 页：发布或打包记录