版式保留 PDF 翻译 reliable-ly0411/babeldoc-pdf-translate

BabelDOC PDF Translate — 通用智能体技能

保留版式的 PDF 翻译技能，面向 Codex 和 DeepSeek Harness，由单独安装的 BabelDOC 运行时驱动。支持双语输出、页面选择、自定义术语表和上下文术语审校。本地解析与排版；翻译使用你配置的服务商。无遥测，不捆绑云端账号。

Codex 插件安装

codex plugin marketplace add reliable-ly0411/babeldoc-pdf-translate

在支持仓库市场的 Codex 客户端选择 BabelDOC PDF Translate 安装。该仓库市场独立于 OpenAI 官方公共目录，不代表官方收录。插件只封装技能；Python/BabelDOC 按部署文档另行安装。

DeepSeek Harness 技能安装

DSH 原生发现项目 .dsh/skills/<name>/SKILL.md。在目标项目根目录运行：

git clone --branch v1.1.0 --depth 1 https://github.com/reliable-ly0411/babeldoc-pdf-translate.git .dsh/skills/babeldoc-pdf-translate

这是文件系统技能，无需安装 Cordis 插件或运行 npm 安装脚本。也可从本仓库复制 skills/babeldoc-pdf-translate 到 .dsh/skills/ 或配置的用户技能目录。需要 DSH 的文件/命令工具和独立 BabelDOC 运行时；未声称验证所有 DSH 版本。

See DSH's filesystem skill discovery. Root SKILL.md remains available for direct skill installers; the nested skills/ copy is the Codex plugin payload. Maintainers edit the root skill resources, run python scripts/sync_plugin_skill.py, and check with --check.

License / 许可

本仓库原创技能和适配脚本采用 MIT。BabelDOC、PyMuPDF 及其他运行时依赖分别适用各自上游许可；它们不包含在本仓库或 MIT 授权范围内。

入口：SKILL.md。这是可分发的技能与脚本包，不是包含所有模型和依赖的独立翻译软件。

适用于支持文件访问和命令执行的智能体平台；核心不依赖 Codex 工具。agents/openai.yaml 是可选界面元数据，其他平台可忽略。

快速使用

1. 将整个 babeldoc-pdf-translate 目录复制到目标平台支持的技能目录；若没有技能机制，让智能体读取 SKILL.md。
2. 按 部署说明 配置 BabelDOC 运行时。
3. 告诉智能体 PDF 路径、目标语言和偏好；服务未配置时也可先准备术语和作业草案。

示例请求：

使用这个技能把论文第 2–4 个物理页翻译为中文，输出交替页中英对照，只保留选中页。phase margin 固定翻译为相位裕度，其余术语结合控制领域上下文自动匹配。保留公式、图片和单位。云端接口稍后配置，先准备作业和术语表。

翻译整份 PDF，输出中文单语及左右对照两个版本。航空专有名词采用英文（中文），使用我提供的 CSV；先试译有公式和表格的两页。

包结构

SKILL.md agent 入口与工作流程 scripts/ 参数校验、引擎探测、PDF 检查与执行 references/ 参数、术语、质量、部署和来源 assets/ 作业、术语表、提示词模板 agents/ 可选的平台界面元数据 requirements.txt 已测运行时版本基线

支持单双语、双语页顺序、页码、术语表、自动术语提取、风格提示、字体、扫描处理、并发和云端兼容接口。专业领域判断由智能体结合上下文完成；本包不自带各行业权威词库，不保证复杂 PDF 完全免返工。

运行与测试边界见 VALIDATION.md。不要在分发包中加入个人密钥、PDF、缓存或虚拟环境。