# Prompt 效果馆 · 如何新增案例

本模块是静态站「效果馆」（`prompt-arcade.html`），与「Prompt库」（`prompts.html`）分离：

| | Prompt库 | 效果馆 |
|---|---|---|
| 焦点 | 实操案例里作者公开的提示词原文/框架 | 先看 AI 做出的游戏/网页/UI/动画效果，再带走 prompt |
| 数据 | `practice-*-prompts` → `prompts-library.json` | `data/prompt-arcade-showcases.json` |
| 生成 | `_practice_build.py` | `_prompt_arcade_build.py` |

## 新增一条作品

1. 复制 `data/prompt-arcade-import-template.json` 中的一条，填入真实可核字段。
2. 追加到 `data/prompt-arcade-showcases.json` 的 `items`（或合并后整体替换）。
3. `promptStatus` 只能是：`original_full` | `original_partial` | `reconstructed` | `unavailable`。
4. **禁止**编造作者、模型、收藏数、复现成功率。未知写「未注明」；未跑过复现用 `reproductionStatus: "untested"`。
5. 外部长 prompt：确认可公开引用后再放 `originalPrompt`；否则草稿（`publicationStatus: "draft"`，前端只渲染 `published`）。
6. `contentOrigin: "site_created"` 的案例必须在文案中标明「本站原创演示」。
7. 在站根执行：`python3 _build.py`，再按需 `npx wrangler pages deploy . --project-name ai-gonglue`。

## 新增资源站点

编辑 `data/prompt-arcade-sources.json`。未核实的能力标「待核实」，不要写成已验证。

## 收藏

收藏存在浏览器 `localStorage`（键 `ai-gonglue-prompt-arcade-favorites`），可在效果馆「收藏」页导入/导出 JSON。不跨设备同步。

## 模型家族 / 版本筛选

效果馆按 `sourceModel` 启发式归类为 **模型家族**（GPT / OpenAI、Claude、Fable、DeepSeek、GLM、Qwen、Grok、Gemini、Ox、MiMo、Muse Spark、Kimi、多模型、未注明、其他）与 **模型版本**（清洗后的原文字符串）。构建时 `_prompt_arcade_build.classify_model` 写入前端字段 `modelFamily` / `modelVersion`；发现页支持 `?family=` / `?version=` URL 同步。Fable 优先于 Claude 匹配。

## 与完整 Next.js 规格的差距

本站为 Cloudflare Pages 静态实现：无服务端管理后台、无 SQLite、无登录审核队列。收录靠改 JSON + 重建；不要把管理密钥放进前端。

## 收录政策（公开原文）

效果馆**只上架**带公开提示词原文的案例：

- 允许：`promptStatus` 为 `original_full` 或 `original_partial`，且 `originalPrompt`（或迭代摘要）有可展示正文
- 不上架：`unavailable`（仅有 Demo、无公开原文）——可留在 JSON 作草稿，前端不展示
- `reconstructed` 默认不上架，除非另有明确标注

搜集时优先找：OpenGame 可 inspect prompt、MiaAI / 仓库内 `.txt` 全文、作者博文附完整 prompt、官方 showcase 附原文。