SuperAPI AI 工具集

soia-pkm-translate

通用与其它

查看项目

更新于 10-16 08:38

技能介绍

用途:把 soia-pkm-clip-x / soia-pkm-clip-web 等归档的外文文章翻译成目标语言,落地为独立文件,不改动原文。也可直接翻译任意 Markdown/纯文本或粘贴文本。

三种模式:quick 直接翻译,适合想先看懂大意;normal(默认)先分析文体/术语/受众再翻译,适合一般文章;refined 在分析、翻译后增加审校(只诊断)与润色(应用修正),适合发布级内容。quick 不分块、不做术语一致性处理。normal 完成后回复“继续润色”可从审校步骤升级为 refined。

长文处理:超过 chunk_threshold(默认 4000 词)时运行 scripts/chunk_markdown.py 机械分块,按标题层级和段落边界切块,单块上限 5000 词,代码块整体保留。命令: python3 scripts/chunk_markdown.py --file <path.md> --json python3 scripts/chunk_markdown.py --file <path.md> --threshold 4000 --max-words 5000 --json python3 scripts/chunk_markdown.py --selftest 术语表(config 的 glossary)与会话术语贯穿所有块保持一致。

使用方式:提供文件路径或文本,说明目标语言/模式/受众;默认 zh-CN / normal / general。首次翻译某文件前 Agent 须报告“将翻译 <文件> 到 <目标语言>,模式 <模式>”并等待确认,除非客户明确要求跳过。产出 <原文件名>-<目标语言>版.md 落原目录,frontmatter 继承原文并追加 translated_from、translated_language、translated_at;同名译文存在时需先确认是否覆盖。

配置:~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-translate/config.yml,可用 SOIA_PKM_TRANSLATE_CONFIG_FILE 指定。优先级为 CLI 参数 > 环境变量 > 私有 config > 内置默认值。

安装:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-translate -y 依赖 Python 3(强依赖),PyYAML 为可选增强。

限制:不调用外部翻译 API 或网络服务,翻译在 Agent 上下文完成;不处理凭据;图片内文字不翻译,仅提醒可能需本地化的图片;术语一致性只保证同一次任务,不跨文件累积。clip 归档模板先只截取 ## 原文 小节再喂脚本,以免词数虚胖与边界横跨语义区。