Files

原图排版的本地创作数据

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