本文记录 fivsevn-devlog 的翻译与发布流程。实际执行规则以用户自行保存的 translate and post.md 为准。
本文件属于 blogops/docs 操作说明,不属于 fivsevn-spec。
它说明的是实际操作流程、工具组合和提示词使用方式。
相关规范:
https://github.com/fivsevn-agy/fivsevn-spec/blob/main/content/spec-content-translation-001.md
本流程用于把外部网页、PDF、截图或其他材料整理成可发布的 Markdown 中文翻译稿。
默认由具备相应能力的 AI 完成翻译、校验、入库、提交与线上核验;用户指定仅生成文件或发布受阻时,交付完整 Markdown 文件并说明实际停点。
流程重点不是绑定某一个工具,而是把以下模块组合起来:
材料输入
→ 正文抓取
→ 提示词组装
→ AI 翻译整理
→ 生成 Markdown 文件
→ 校验、自动提交与发布
→ 核对 Actions 和实际页面
当前使用的 iOS Shortcuts 只是其中一种实现方式。
后续也可以替换为其他自动化工具、网页服务、脚本或人工复制流程。
本文件说明:
metadata 字段语义与类型遵循共用 frontmatter 规范和 schema。页面开头统一使用“◇ 概括性中文标题 → SOURCE → NOTE”,目录由现有脚本生成。具体执行方式以用户保存的提示词为准。
推荐流程如下:
1. 获取原始材料
2. 抓取或整理正文文本
3. 将原文 URL 和正文文本填入提示词
4. 把提示词发送给 AI
5. AI 生成可发布 Markdown 文件
6. AI 检查 frontmatter、正文、来源、链接和实际发布条件
7. 按现行仓库规则保存、提交、推送,并核验部署与实际页面
8. 未完成发布时交付完整译稿和准确停点
当前快捷指令流程为:
Share Sheet 输入 URL
→ 生成 r.jina.ai 读取地址
→ Get Contents of URL 获取网页 Markdown
→ 拼接固定提示词
→ 生成日期命名的 .md prompt 文件
→ 打开分享菜单
→ 手动发送给 ChatGPT 或其他 AI
→ AI 按用户保存的提示词完成处理与自动发布,受阻时交付文件
输入材料可以来自多种来源。
常见输入包括:
优先使用 URL 输入。
如果 URL 抓取失败,再使用 PDF、截图、复制文本或人工整理结果。
正文抓取的目标不是保留网页完整外壳,而是获得可翻译的正文内容。
可使用以下方式。
当前快捷指令使用:
https://r.jina.ai/<原文 URL>
例如:
https://r.jina.ai/https://example.com/article
作用:
在 iOS Shortcuts 中,对应结构为:
Receive URLs from Share Sheet
Text
https://r.jina.ai/[Shortcut Input]
Get Contents of URL
输入:上一步 Text
其中:
Shortcut Input
= 原始网页 URL
Contents of URL
= 抓取到的网页 Markdown 内容
如果自动抓取失败,可以直接从网页中复制正文。
适用场景:
手动复制时,应尽量保留:
如果原文是 PDF,或网页无法稳定抓取,可使用 PDF 作为输入材料。
处理方式:
PDF 场景下,应额外注意:
如果网页、PDF 或应用内容无法复制,可以使用截图。
适用场景:
截图处理要求:
在抓取结果不可靠时,可以先人工整理一版输入文本。
最低要求是保留:
原文标题
原文 URL 或来源说明
正文内容
重要链接
图片位置或图片 URL
作者 / 发布方 / 发布时间
只要能提供完整可读的原文正文,就可以进入后续 AI 翻译步骤。
当前 iOS Shortcuts 的核心模块如下。
Receive URLs from Share Sheet
作用:
Text
https://r.jina.ai/[Shortcut Input]
作用:
Get Contents of URL
输入:上一步 Text
作用:
Text
固定提示词 + Shortcut Input + Contents of URL
作用:
Set Name of Text to Current Date.md
建议日期格式:
yyyy-MM-dd
作用:
Open Renamed Item
Show Open In Menu: On
作用:
快捷指令使用的 translate and post.md 由用户自行保管,不收录在本仓库或网站中。快捷指令的 Text 动作使用用户保存的版本,并接入下一节所列变量。
在 iOS Shortcuts 中,提示词末尾使用两个变量。
原文 URL:
[Shortcut Input]
网页 Markdown 内容:
[Contents of URL]
变量含义:
| 变量 | 含义 |
|---|---|
Shortcut Input |
从分享菜单传入的原始 URL |
Contents of URL |
通过 r.jina.ai 或其他抓取方式得到的正文 Markdown |
如果输入材料不是 URL,而是 PDF、截图或人工整理文本,可以把:
网页 Markdown 内容:
改成:
材料正文内容:
并放入对应的 OCR、复制文本或人工整理结果。
提示词可以发送给不同 AI 工具。
可选方式包括:
当前做法是:
Open Renamed Item
Show Open In Menu: On
然后在分享菜单中手动选择 AI。
这样做的好处是:
AI 在保存与发布前检查以下内容;用户也可据此复核:
id;Posts 正式发布时保存为对应发布包的 index.md;type 是否为 translation;status、visibility 是否符合公开发布状态;original_url 是否为原文链接;◇ 概括性中文标题,且无重复主标题;SOURCE 和 NOTE,SOURCE 是否统一列出原文标题链接及作者、来源、发布日期;符合实际提示词发布条件的译稿保存到 fivsevn-devlog 对应模块目录;待审核稿按提示词保存在本地或已确认权限的私人位置。
模块由 frontmatter 中的:
module:
submodule:
topic:
决定。
常见情况:
netcom/
natsci/
posts/
Posts 正式发布保存为 posts/YYYY/MM/文章编号/index.md;配图和附件放在同一发布包的 assets/。生成的下载文件可先使用 id.md,整理进发布包时改为 index.md,保留原 id。
natsci、netcom 仍按各自主题目录保存。具体目录结构以当前内容仓库实际结构为准。
本文件记录的是实际操作流程,可以随工具变化调整。
如果后续更换抓取工具、AI 工具或 Shortcuts 结构,只需要更新本文对应模块,不需要修改 fivsevn-spec 中的翻译规范。
本文只维护快捷指令接线方式和仓库操作说明。translate and post.md 由用户自行更新和存档,不在仓库内同步提示词正文。