1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | baoyu-translate-jimliu-baoyu-skills |
| 项目自述名称 | baoyu-translate（收录于 baoyu-skills 合集） |
| 作者/维护者 | JimLiu（公开身份“宝玉”，中文 AI/科技领域知名内容创作者与翻译实践者） |
| 来源链接 | https://github.com/JimLiu/baoyu-skills/tree/main/skills/baoyu-translate |
| 许可证 | MIT（GitHub API 验证） |
| 所属合集仓库 Stars/Forks | 23,768 / 2,670（GitHub API 验证；注：该数字属整个 baoyu-skills 合集共 20 余个技能，不代表本技能自身热度） |
| 该技能自身活跃度 | 19 次独立提交作用于该子目录路径（GitHub API 按路径过滤），最近一次 2026-06-13；CHANGELOG.md 另有十余条专门标注 baoyu-translate: 的迭代记录；第三方技能注册平台 SkillSafe 记录该技能单独下载量 35,338 次（安全扫描状态为“待处理”，未见已发布的风险披露） |
| 最新版本 | 随合集统一发版，当前 v2.5.2（2026-06-18，GitHub Releases API） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
baoyu-translate 是一个面向长文档与专业文章的结构化翻译技能，核心设计：
- 三档翻译模式：quick（直译）、normal（先分析后翻译，默认）、refined（分析→草译→批判性复核→修订→润色的完整出版级流程）
- 风格与受众定制：内置学术、商务、幽默、口语、优雅等 9 种风格预设，可指定目标受众（如 technical）
- 术语一致性机制：支持外部术语表文件（Markdown 表格或 YAML），并可通过
EXTEND.md分项目/用户两级覆盖默认行为 - 长文分块与子代理协作：借助
scripts/main.ts/chunk.ts对长文做 Markdown 感知分块，草稿阶段可委派子代理并行处理 - 图文一致性检查：翻译完成后自动扫描文中图片，提示可能仍是原语言的封面图、图表等，需要用户确认是否需要图片本地化
- URL 直译支持：可直接传入文章链接而非本地文件
亮点：①作为合集中被持续打磨最深的技能之一，仅该子目录路径下即有 19 次独立提交，功能从最初的直译逐步演进为含风格预设、术语表、图文检测的完整工作流；②纯提示词 + 轻量本地脚本实现，不依赖任何第三方翻译 API；③作者身份公开可查，长期在中文技术社区分享翻译与提示词工程实践。
3. 适用场景
固定分类：内容创作与知识管理
适合需要将英文技术文章、产品文档翻译成高质量中文（或反向）的独立开发者与内容创作者，尤其是重视术语一致性、希望按受众与风格定制译文、或需要处理长篇文档分块翻译的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方提供插件市场安装路径 /plugin marketplace add JimLiu/baoyu-skills，为主要目标平台 |
| Codex | 原生支持 | README 专门列出 Codex 项目级安装步骤——将技能目录复制/软链接进 .agents/skills/ |
| OpenClaw | 原生支持 | SKILL.md 显式声明 metadata.openclaw（含 homepage 与 anyBins: [bun, npx] 依赖要求）；仓库同时提供 sync-clawhub.sh 脚本将该技能单独发布到 ClawHub，可用 clawhub install baoyu-translate 安装 |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes Agent 专属适配，未为此单独搜索 |
5. 推荐理由
多数翻译类技能止步于“把文章丢给模型翻一遍”，baoyu-translate 把职业译者的工作流——先理解原文语境与挑战、草译、批判性复核、修订润色——拆解成可执行的分档流程，并配上术语表与风格预设两个直接影响可用性的定制项，还额外处理了纯文本翻译容易忽略的“图片里的文字要不要一起本地化”问题，对经常需要产出中英双语内容的独立开发者与内容创作者有直接的实用价值。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集整体 star 不计入本技能个体评分；以该技能自身证据评估——19 次专门提交持续迭代、第三方注册平台 SkillSafe 记录该技能独立下载量 35,338 次、作者为中文 AI 社区具公开影响力的从业者，三项合计对应约“千级以上独立采用规模”区间 |
| 可用性 | 8 | SKILL.md、scripts/、references/ 结构完整；三档模式与风格预设开箱即用；EXTEND.md 支持项目/用户两级配置覆盖；该技能专属提交最近一次为 2026-06-13，合集整体近期仍有发版，无付费依赖 |
| 安全性 | 8 | 见下方检查清单——代码执行范围明确可审计，无外部网络外发，MIT 开源 |
| 综合评分 | 7.67 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 仅 scripts/main.ts/chunk.ts 通过 bun/npx 在本地做 Markdown 分块，无提权、无系统级操作 |
| ② 运行时联网外发数据 | 翻译工作由调用该技能的 Agent 自身完成，技能脚本本身未见对外发起网络请求 |
| ③ API Key/凭据要求 | 不需要任何第三方 API Key 或凭据 |
| ④ 可疑指令/Prompt Injection 迹象 | SKILL.md 全文与脚本目录均未发现要求执行额外操作、访问文件外范围或凭据的可疑指令 |
| ⑤ 作者/组织信誉 | JimLiu（宝玉）身份公开可查，长期活跃于中文技术社区，合集仓库有 2,670 次 fork 的社区参与度 |
| ⑥ License 是否明确 | MIT，明确 |
| ⑦ 最近维护时间 | 该技能专属提交最近一次为 2026-06-13（距今约 5 周），合集仓库整体最近一次发版为 2026-06-18，均在近 3 个月内 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 与 baoyu-translate 的差异 |
|---|---|---|
| baoyu-translate（本次推荐） | 三档翻译流程 + 术语表 + 9 种风格预设 + 图文一致性检查 | 唯一同时覆盖分档流程、术语一致性与图片语言检测三项能力的翻译技能 |
| translate（feiskyer/claude-code-settings） | 专注英/日译中的技术文章翻译，保留专有名词与术语不译 | 单一方向、单一模式，无术语表机制与风格定制，仓库整体 1,595 星，translate 只是其中一项配置 |
| baoyu-post-to-wechat（同合集） | 将 Markdown 文章转换并发布至微信公众号 | 定位是“发布”而非“翻译”，工作流下游可与 baoyu-translate 衔接，但不解决语言转换问题 |
多数同类项目把翻译视为发布流程中的一个步骤或简单的单向转换，baoyu-translate 是其中把“翻译质量本身”作为独立工作流深耕的少数项目之一。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价原文；第三方技能注册平台 SkillSafe 记录其独立下载量为 35,338 次，可作为客观采用规模的参考，但该平台的安全评级流程尚未完成，不构成用户评价。
9. 其他补充
baoyu-translate 所属的 baoyu-skills 合集还包含 20 余个围绕“内容生产与发布”的关联技能（如封面图生成、markdown 转 HTML、多平台发布等），彼此可组合成完整的中文内容创作流水线，也支持仅安装 baoyu-translate 单个技能而不引入其余部分。仓库提供中英双语 README 与 CHANGELOG。
10. 安装使用方式
方式一：Claude Code 插件市场（安装整个合集）
/plugin marketplace add JimLiu/baoyu-skills
/plugin install baoyu-skills@baoyu-skills方式二：只装这一个技能（通用 CLI）
npx skills add jimliu/baoyu-skills安装时按提示只选择 baoyu-translate 即可，避免整包安装带来的上下文开销。
方式三：Codex 项目级安装
将技能目录复制或软链接为 <project>/.agents/skills/baoyu-translate/SKILL.md（含同目录下 scripts/、references/）。
方式四：OpenClaw / ClawHub
clawhub install baoyu-translate安装后在对话中提出翻译需求（如“帮我把这篇文章翻译成中文”）即可自动触发，或显式调用 /translate article.md --to zh-CN。无需重启终端。
11. 注意事项
- Hermes Agent 的兼容性未在已抓取材料中得到证实，标记为“未验证”
- 该技能依赖
bun或npx运行本地分块脚本，需确认本机已安装 Node.js 环境 - refined 模式包含完整的分析→草译→复核→修订→润色流程，处理长文档时耗时与 token 消耗高于 quick 模式，建议按实际质量需求选择模式
- 版本号随 baoyu-skills 合集统一发布，不是该技能独立的语义化版本