ZZD public AI gateway · zzd_public_ai_gateway_v3
Resource: 创建或维护作品 / Quick start
Canonical map: https://zzd.show/docs/ai/map.json
Full handbook: https://zzd.show/llms-full.txt
REST capabilities: https://zzd.show/api/v1/capabilities/

# 创建或维护作品 / Quick start

需要：想实现的效果、本地项目路径；维护时再给出原作品地址。
只读本次动作需要的契约，无需通读完整手册。

已有作品：PK→https://zzd.show/shows/detail/{pk}/；作品号→https://zzd.show/s/{public_id}/。只查看无需开发凭据；用用户授权的原已登录浏览器读实际跳转和Run/Edit。搜索无结果不代表不存在，新隔离浏览器不继承登录；工具接入不了就准确说明，不复制cookie或改权限。
1. 用已有有权接入 GET /api/v1/me/ 核对身份，写入前读 https://zzd.show/api/v1/capabilities/。新Demo/线程不重建凭据；缺本机文件时按 https://zzd.show/docs/ai/branch/client-access/ 复用本人原保存版本，metadata不是秘密或新授权。
2. 先读原Show.runtime。完整工程按 capabilities.source_packages.routes 上传→seal→build→activate（当前generation，可带release.prompt/parent_release_id）→读回active_version→验证links.blank。MCP有list/get/build/activate；ready不是部署。有限标准库例程见 https://zzd.show/docs/ai/branch/lifecycle/ 的“单作品有限客户端”，默认只构建。经典源码用deployment-api的plan/CAS，经典Pieces保存不会覆盖已选源码包；切包、回退和并发细节读lifecycle。
3. 验证实际页面后报告原作品标识、API正式链接和真实状态。普通隔离bootstrap是one-time POST，不是书签。修改已发布作品会回到私有草稿；公开发布、删除和新增费用须有对应明确授权，已有授权不重复索要。

凭据只发已核对的精确同源 https://zzd.show/api/v1/ 或POST https://zzd.show/mcp/v1/，不随重定向转发；网页管理沿用本人session/CSRF，不能用作bearer的认证fallback。阅读不授予权限。

作品反馈须明示PK/id、作品号public_id、正式链接与实际状态，不能只给名称或Run/Edit链接。优先复制data.delivery.feedback_line；缺项GET原作品补取，不重建或另问授权。这是普通用户回复要求，不是manifest字段。
私有注明需原权限；批量逐项、修复沿用原标识；严格JSON不增加字段，由普通回复呈现。

按动作细读：
- 创建与维护接口：https://zzd.show/docs/ai/branch/deployment-api/
- 作品字段：https://zzd.show/docs/ai/branch/show-contract/
- 预览与验证：https://zzd.show/docs/ai/branch/quality/
- 发布与恢复：https://zzd.show/docs/ai/branch/lifecycle/