Local Publishing Pipeline

从素材到发布的一站式入口

这里把本地工具、资料规范和发布检查放在同一页,之后编辑时可以按顺序走完整流程。
01

建立项目

先在项目工作流中登记来源、人物、作品、目标文件和当前阶段,之后按步骤推进。

assets/tools/project-workflow-board.html
02

导入素材

把扫描图、采访原文、旧平台 HTML 或网页素材放入本地目录,先保留原始文件。

migration/inbox/
03

分区与预处理

用杂志分区工具处理跨栏、图文块和阅读顺序,再交给 OCR 脚本。

assets/tools/magazine-region-annotator.html
04

区域 OCR / 校对

按分区把裁片送进 Qwen-VL 识别,再由 DeepSeek 校对并给出初译,保留坐标和逐区 JSON。

tools/run-region-vlm-api-ocr.ps1
05

翻译与评注

进入文章翻译编辑器整理原文、译文、注释、图片和链接解析。

assets/tools/article-translation-editor.html
06

旧文迁移

用迁移脚本读取旧平台 HTML / Markdown,下载图片、生成站点展示图,并输出 Jekyll 草稿。

node tools\migrate-article-images.mjs --input migration\inbox\article.html --title "标题"
07

资料卡片

补齐人物、作品、年份、来源、工作流状态,让搜索和关系图谱能自动使用。

tools/check-metadata.js
08

本地预览 / 发布

本地浏览确认排版、主题、移动端和检索结果,再发布到站点。

serve-local.ps1

常用本地动作

启动站点预览.\serve-local.ps1

启动统一编辑工具箱npm run tools

打开项目工作流assets/tools/project-workflow-board.html

迁移旧平台文章npm run migrate:article -- --input migration\inbox\article.html --title "文章标题" --date 2026-07-16 --slug article-slug

查看迁移教程/article-migration-guide/

启用图片压缩npm install --no-save sharp

重建资料网络ruby tools\build-resource-index.rb

检查资料卡片node tools\check-metadata.js

统一工具箱地址http://127.0.0.1:4175/assets/tools/editor-toolbox.html

启动 DeepSeek 检索代理$env:DEEPSEEK_API_KEY="你的 key"; node tools\deepseek-search-proxy.mjs

Markdown 简化方式

网页访谈先用网页访谈收录工具生成草稿,再放入 _posts

扫描访谈先用文章翻译编辑器生成 parallel_items / translation_segments

资料字段人物、作品、来源、引用、工作流由工具预填,VSCode 里只做校对

引用正文只写 {% include citation-ref.html id="source-web" %}

发布前检查