这是 SOIA 个人知识管理域（soia-pkm-*）加工环节的翻译技能，用于把 soia-pkm-clip-x / soia-pkm-clip-web 等归档的外文文章译成目标语言，产出独立文件，不改动原文。
用途：提供三种模式——quick 直接翻译，适合短文本或先看大意；normal（默认）先分析文体、术语、受众再翻译；refined 在 normal 基础上加审校（只诊断）与润色（应用修正），面向出版级质量。
主要能力：超过分块阈值（默认 4000 词）的长文会先用 scripts/chunk_markdown.py 机械分块，按标题层级与段落边界切块，代码块整体保留；术语表贯穿所有块以保持一致。产出文件名形如“<原文件名>-<目标语言>版.md”，落在原文件同目录，frontmatter 继承原文并追加 translated_from、translated_language、translated_at 等字段。
使用方式：提供文件路径或直接粘贴文本，可指定目标语言、模式、受众，未指定则用 config 默认或内置默认（zh-CN / normal / general）。首次翻译某文件前需报告并等待确认，除非客户明确说直接翻。配置位于 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-translate-article-zh/config.yml，也可用环境变量 SOIA_PKM_TRANSLATE_ARTICLE_ZH_CONFIG_FILE 指定自定义路径。安装命令：npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-translate-article-zh -y。
限制：不调用任何外部翻译 API 或网络服务，翻译由 Agent 自身上下文完成；分块脚本依赖 Python 3；不处理图片内文字；术语一致性仅限同一次任务内。