原图排版的本地创作数据
本目录是发布客户端的输入,不在 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 读取。原图低清,未知微字保留独立字形,不猜写。