公开示例脱敏检查
本页面向准备公开分享示例或参与 Seed 贡献的人。普通用户只在本地使用 Seed、Lite 或 Studio 时,不需要执行本页流程。
公开示例是可以给外部开发者阅读、复制和运行的资料。它可以是 Prompt Spec 示例、Task Pack、Check Pack、Verification Pack 或 Case Pack。博客搜索很适合做公开示例,但前提是它已经脱敏、可复现、边界清楚,并通过 gate。
Seed 公开仓库地址以官网为准:GitHub https://github.com/mawflow/mawflow-seed,Gitee https://gitee.com/mawflow/mawflow-seed。
本页不是产品上线或生产运维流程;它只说明“准备把示例资料公开给外部用户之前,要检查什么”。
博客搜索可以公开什么
| 内容 | 可以公开吗 | 要求 |
|---|---|---|
| Prompt Spec | 可以 | 使用通用博客案例,不含真实项目名和业务数据。 |
| Task Pack | 可以 | 路径、状态、验证命令都可复现。 |
| Check Pack | 可以 | 检查命令不依赖私有服务。 |
| Verification Pack | 可以 | 只保留脱敏验证结果和收口模板。 |
| Case Pack | 视授权 | 必须确认案例来源允许公开。 |
不适合公开的内容
- 客户名称、项目名称、截图、日志或业务数据。
- 未公开 URL、私有仓库地址或访问方式。
- 真实密钥、token、账号密码和连接串。
- 内部任务记录、未授权讨论和原始材料。
- 只能在私有环境运行的专用流程。
公开前检查流程
- 确认博客搜索示例的公开目的:教学、模板、案例还是检查包。
- 检查授权:是否允许公开,是否需要人工批准。
- 删除或替换敏感内容。
- 使用仓库相对路径和公开仓库地址。
- 把真实项目路径改成占位路径,例如
code/client/**。 - 运行本机边界、脱敏和 open-source readiness 检查。
- 人工复核 README、示例和验证说明。
- 再决定是否发布到公开仓库、公开 release 或公开文档页。
博客搜索 Pack README
md
# Blog Search Task Pack
## 用途
演示如何用 MAWflow Seed 为博客文章列表增加搜索能力,并完成 Prompt、Task Pack、检查和收口。
## 适用对象
适合第一次学习 AI Coding 闭环的个人开发者和小团队。
## 使用方式
复制 Prompt Spec,或按 Task Pack 的 `EXECUTE_PROMPT.md` 执行。
## 输入要求
- 已有文章列表页面。
- 能定位文章标题和摘要字段。
- 有最小验证命令。
## 输出结果
- 搜索输入框。
- 无结果状态。
- 验证和收口说明。
## 验证
- git diff --check
- npm run test:plan
## 公开边界
本 Pack 不包含真实项目名、客户数据、私有仓库地址、账号、密钥或未脱敏日志。发布前命令
bash
git diff --check
bash ops/scripts/check-local-boundary.sh
bash ops/scripts/check-seed-open-source-readiness.sh --strict --format json如果 Pack 要作为 Seed 分发的一部分,再运行:
bash
bash ops/scripts/check-seed-distribution-readiness.sh常见错误
| 错误 | 修正方式 |
|---|---|
| 示例里写了开发仓库地址 | 统一改为公开仓库地址或占位。 |
| 只替换正文,没有检查文件名 | 文件名、截图名、日志名也要脱敏。 |
| 验证命令依赖私有服务 | 改成公开可复现命令或说明需要用户替换。 |
| Pack 没有适用范围 | 在 README 中写清输入、输出和不适用场景。 |
| 把内部收口原文公开 | 改成教学版收口,只保留通用证据。 |
下一步
阅读 脱敏规则 和 Release gates。
