fivsevn-devlog

Auto Translation Shortcut Workflow

自动翻译快捷流程说明

本文记录 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

1. 目的

本流程用于把外部网页、PDF、截图或其他材料整理成可发布的 Markdown 中文翻译稿。

默认由具备相应能力的 AI 完成翻译、校验、入库、提交与线上核验;用户指定仅生成文件或发布受阻时,交付完整 Markdown 文件并说明实际停点。

流程重点不是绑定某一个工具,而是把以下模块组合起来:

材料输入
→ 正文抓取
→ 提示词组装
→ AI 翻译整理
→ 生成 Markdown 文件
→ 校验、自动提交与发布
→ 核对 Actions 和实际页面

当前使用的 iOS Shortcuts 只是其中一种实现方式。
后续也可以替换为其他自动化工具、网页服务、脚本或人工复制流程。


2. 工作流边界

本文件说明:

metadata 字段语义与类型遵循共用 frontmatter 规范和 schema。页面开头统一使用“◇ 概括性中文标题 → SOURCE → NOTE”,目录由现有脚本生成。具体执行方式以用户保存的提示词为准。


3. 总体流程

推荐流程如下:

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 按用户保存的提示词完成处理与自动发布,受阻时交付文件

4. 材料输入方式

输入材料可以来自多种来源。

常见输入包括:

优先使用 URL 输入。
如果 URL 抓取失败,再使用 PDF、截图、复制文本或人工整理结果。


5. 正文抓取方式

正文抓取的目标不是保留网页完整外壳,而是获得可翻译的正文内容。

可使用以下方式。

5.1 自动网页抓取

当前快捷指令使用:

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 内容

5.2 手动复制正文

如果自动抓取失败,可以直接从网页中复制正文。

适用场景:

手动复制时,应尽量保留:

5.3 PDF 输入

如果原文是 PDF,或网页无法稳定抓取,可使用 PDF 作为输入材料。

处理方式:

PDF 场景下,应额外注意:

5.4 截图输入

如果网页、PDF 或应用内容无法复制,可以使用截图。

适用场景:

截图处理要求:

5.5 人工整理输入

在抓取结果不可靠时,可以先人工整理一版输入文本。

最低要求是保留:

原文标题
原文 URL 或来源说明
正文内容
重要链接
图片位置或图片 URL
作者 / 发布方 / 发布时间

只要能提供完整可读的原文正文,就可以进入后续 AI 翻译步骤。


6. 当前快捷指令模块

当前 iOS Shortcuts 的核心模块如下。

6.1 接收 URL

Receive URLs from Share Sheet

作用:

6.2 生成抓取 URL

Text
https://r.jina.ai/[Shortcut Input]

作用:

6.3 获取网页 Markdown

Get Contents of URL
输入:上一步 Text

作用:

6.4 组装提示词

Text
固定提示词 + Shortcut Input + Contents of URL

作用:

6.5 生成 prompt 文件

Set Name of Text to Current Date.md

建议日期格式:

yyyy-MM-dd

作用:

6.6 打开分享菜单

Open Renamed Item
Show Open In Menu: On

作用:


7. 实际发布提示词

快捷指令使用的 translate and post.md 由用户自行保管,不收录在本仓库或网站中。快捷指令的 Text 动作使用用户保存的版本,并接入下一节所列变量。


8. 提示词变量

在 iOS Shortcuts 中,提示词末尾使用两个变量。

原文 URL:

[Shortcut Input]

网页 Markdown 内容:

[Contents of URL]

变量含义:

变量 含义
Shortcut Input 从分享菜单传入的原始 URL
Contents of URL 通过 r.jina.ai 或其他抓取方式得到的正文 Markdown

如果输入材料不是 URL,而是 PDF、截图或人工整理文本,可以把:

网页 Markdown 内容:

改成:

材料正文内容:

并放入对应的 OCR、复制文本或人工整理结果。


9. AI 处理模块

提示词可以发送给不同 AI 工具。

可选方式包括:

当前做法是:

Open Renamed Item
Show Open In Menu: On

然后在分享菜单中手动选择 AI。

这样做的好处是:


10. 生成结果检查

AI 在保存与发布前检查以下内容;用户也可据此复核:


11. 保存位置

符合实际提示词发布条件的译稿保存到 fivsevn-devlog 对应模块目录;待审核稿按提示词保存在本地或已确认权限的私人位置。

模块由 frontmatter 中的:

module:
submodule:
topic:

决定。

常见情况:

netcom/
natsci/
posts/

Posts 正式发布保存为 posts/YYYY/MM/文章编号/index.md;配图和附件放在同一发布包的 assets/。生成的下载文件可先使用 id.md,整理进发布包时改为 index.md,保留原 id。

natsci、netcom 仍按各自主题目录保存。具体目录结构以当前内容仓库实际结构为准。


12. 维护说明

本文件记录的是实际操作流程,可以随工具变化调整。

如果后续更换抓取工具、AI 工具或 Shortcuts 结构,只需要更新本文对应模块,不需要修改 fivsevn-spec 中的翻译规范。

本文只维护快捷指令接线方式和仓库操作说明。translate and post.md 由用户自行更新和存档,不在仓库内同步提示词正文。