SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场baoyu-translate

baoyu-translate

写作与研究

查看项目

更新于 10-15 18:31

技能介绍

用途

baoyu-translate 是一个翻译类 AI 技能，用于将文章或文本翻译成目标语言（默认 zh-CN 简体中文）。适用于用户提出“翻译”“精翻”“translate article”“translate to Chinese”“translate to English”“改成中文”“改成英文”等请求的场景。

主要能力

三种翻译模式

  • Quick（快速）：直接翻译，适合短文本、非正式内容和快速任务，不切块。
  • Normal（普通，默认）：分析 → 翻译，适合文章、博客等一般内容。
  • Refined（精翻）：分析 → 翻译 → 审校 → 润色，适合出版级质量的重要文档。

模式可通过 --mode 标志指定。自动检测：“快翻”“quick”“直接翻译”触发 quick；“精翻”“refined”“publication quality”“proofread”触发 refined；其他情况使用默认模式（normal）。normal 模式完成后会提示可回复“继续润色”或“refine”进入审校与润色步骤。

翻译风格

支持 storytelling（默认）、formal、technical、literal、academic、business、humorous、conversational、elegant，也接受自定义风格描述（如 --style "poetic and lyrical"）。

读者画像

支持 general（默认）、technical、academic、business，也接受自定义描述（如 --audience "AI感兴趣的普通读者"）。

术语表与长文切块

  • 支持内置术语表（如 EN→ZH 的 references/glossary-en-zh.md），并可与 EXTEND.md 内联或外部术语表合并。
  • 内容超过切块阈值（默认 4000 词）时自动切块，单块最大词数默认 5000。
  • 切块基于 markdown 块边界（标题、段落、列表、代码块、表格等），保持结构；单块超限时回退到按行、再按词切分。
  • 切块时先提取术语并建立会话术语表，通过共享的 02-prompt.md 保证一致性。

使用方式

配置优先级

偏好文件 EXTEND.md 按以下优先级查找，第一个找到的生效：

  1. .baoyu-skills/baoyu-translate/EXTEND.md（项目级）
  2. ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-translate/EXTEND.md（XDG）
  3. $HOME/.baoyu-skills/baoyu-translate/EXTEND.md（用户主目录）

未找到 EXTEND.md 时必须先运行首次设置（阻塞操作），引导用户填写目标语言、模式、读者、风格和保存位置，然后生成 EXTEND.md 并确认保存路径。

默认值与 CLI 标志

  • 目标语言：zh-CN / target_language / --to
  • 模式：normal / default_mode / --mode
  • 读者：general / audience / --audience
  • 风格：storytelling / style / --style
  • 切块阈值：4000 / chunk_threshold
  • 单块最大词数：5000 / chunk_max_words

脚本调用

脚本位于 scripts/ 子目录，{baseDir} 为 SKILL.md 所在目录。运行时解析 ${BUN_X}：若已安装 bun 用 bun；若有 npx 用 npx -y bun；否则建议安装 bun。

  • scripts/main.ts：CLI 入口，默认动作是将 markdown 切块，也支持显式 chunk 子命令。
  • scripts/chunk.ts：供 main.ts 使用的切块实现，同时保留直接调用兼容性。

切块命令示例：${BUN_X} {baseDir}/scripts/main.ts <file> [--max-words <chunk_max_words>] [--output-dir <output-dir>]

工作流程

  1. 加载偏好：检查 EXTEND.md，加载内置术语表并合并。
  2. 实体化源文件并创建输出目录：{source-dir}/{source-basename}-{target-lang}/。
  3. 评估内容长度：quick 模式不切块；normal/refined 模式超过阈值触发切块，切块前提取术语、建会话术语表、切分并使用子代理并行翻译后合并。
  4. 翻译与精炼：遵循“重写而非直译”、准确优先、自然流畅、术语一致、保留 markdown 格式、按需加注等原则。
  5. 输出：最终译文始终为输出目录下的 translation.md；翻译完成后进行轻量图片语言检查，若图片可能仍含源语言文本则列出提醒（仅提醒，不自动本地化）。

输出目录文件

  • translation.md：最终译文（所有模式）。
  • 01-analysis.md：内容分析（normal、refined）。
  • 02-prompt.md：组装的翻译提示（normal、refined）。
  • 03-draft.md：审校前初稿（refined）。
  • 04-critique.md：审校发现（refined）。
  • 05-revision.md：修订稿（refined）。
  • chunks/：源切块与译文切块（切块时）。

适用场景

适合需要将文章、博客、文档等翻译为目标语言的个人或团队，尤其是需要一致性术语管理、可配置风格与读者定位、以及出版级审校润色流程的场景。

限制

  • 首次使用且未找到 EXTEND.md 时，必须先完成阻塞式设置才能翻译。
  • quick 模式不做切块，长文在 normal 模式下方能获得更好的术语一致性与质量。
  • 子代理并行翻译依赖 Agent 工具；不可用时按顺序内联翻译。
  • 图片语言本地化仅作提醒，不自动执行。
  • 除资料中列出的默认值、风格、读者画像与流程外，其他功能、收费、价格、平台或效果暂未提供。