20 lines
1.7 KiB
Markdown
20 lines
1.7 KiB
Markdown
# 原图排版的本地创作数据
|
|
|
|
本目录是发布客户端的输入，不在 Wiki 应用的 public、pages 或内容注册表中，不提供网页或静态子 URL。
|
|
|
|
- `assets/`：原图、裁片、分类标注、构件 PNG、遮罩及新 Router 封面。
|
|
- `manifest.json`：27 张的源坐标、类型、文字与图形位置，使用 `asset:` 本地逻辑引用。
|
|
- `post-ids.json`：保留的 28 个普通 post 稳定 ID。
|
|
- `annotations.json` / `ocr-evidence.json` / `group-text.ts`：识别、人工复核与同词合并的源资料。
|
|
- `renderer.tsx`：作为 Markdown 代码示例上传的创作端组件，不由 Wiki 编译或运行。
|
|
|
|
本地重建封面：`node scripts/layout-reference-cover.mjs`。
|
|
|
|
发布预检：`node scripts/publish-layout-reference.mjs --dry-run`。
|
|
|
|
实际发布设置 `WIKI_BASE` 为指定 Wiki、`WIKI_PUBLISH_STATE` 为独立的本地检查点路径后运行发布脚本。客户端只调用 `/api/upload`、`/api/posts`、`/api/notes/{id}`、`/api/tags`。先单独上传 PNG，再将媒体 UUID、构件 JSON、源码文本组合为普通 post。所有图片链接都会转换为 `/api/media/{id}`；不上传 HTML 页面、JSON 文件端点或 ZIP 页面。
|
|
|
|
检查点记录站点、素材摘要到 UUID 的映射及已发布 post，支持中断后继续。更新已存在的同 slug post 使用 revision、媒体关联与封面字段；遇到占用 ID 则停止，避免覆盖其他内容。请为不同站点使用不同检查点。
|
|
|
|
对外是 27 张设计 post + 1 篇 Router。Wiki 不需要为这些内容增加路由、组件或代码注册；客户端生成的正文可通过 `?agent_mode=True` 读取。原图低清，未知微字保留独立字形，不猜写。
|