← 返回 Skills 市场
279
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install translate-book
功能描述
Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents. Converts input -> Markdown chunks -> translated chunks -> HTML/DOCX/EPUB/PDF.
安全使用建议
This skill appears coherent for translating ebooks, but consider these practical cautions before installing/using it: 1) Dependencies: install Calibre (ebook-convert), Pandoc, and Python3 (plus pypandoc) locally — the scripts call them via subprocess. 2) Data exposure: translation works by sending chunk text to sub-agents/LLM; do not use it on copyrighted, confidential, or sensitive documents you cannot send to an LLM. 3) Filesystem effects: the pipeline writes a {book_name}_temp/ directory in your current working directory and may create many output files—run it in a dedicated workspace and back up important data. 4) Review code if you require higher assurance: the included scripts are plain Python and call local binaries; if you need to confirm no unexpected network/IO behavior, inspect the scripts (convert.py, glossary.py, merge_and_build.py, calibre_html_publish.py) before running. 5) Minor metadata note: the manifest redundantly lists ebook-convert in both bins/anyBins, which is harmless but worth noting. If you are comfortable with these points, the skill is internally consistent with its stated purpose.
功能分析
Type: OpenClaw Skill
Name: translate-book
Version: 1.0.0
The translate-book skill is a legitimate and well-structured tool for translating books (PDF/DOCX/EPUB) using a multi-step pipeline and parallel sub-agents. The orchestration logic in SKILL.md and the supporting Python scripts (such as convert.py, merge_meta.py, and merge_and_build.py) are entirely focused on the stated purpose: converting documents, managing a terminology glossary, and ensuring translation consistency. The skill uses standard tools like Pandoc and Calibre, and its use of subprocess execution follows security best practices (list-based arguments) to prevent shell injection. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
能力评估
Purpose & Capability
Name/description, SKILL.md orchestration, and the included Python scripts (convert.py, glossary.py, merge_and_build.py, calibre_html_publish.py, etc.) all align with a book-translation pipeline. Required binaries (python3, pandoc, ebook-convert/Calibre) are appropriate. Minor redundancy: ebook-convert appears both in required bins and anyBins, but this is a benign metadata/detail issue.
Instruction Scope
SKILL.md instructs the agent to read a user-provided file path, convert it to Markdown chunks, build a glossary, spawn per-chunk sub-agents that receive chunk text and prompts, and write translated chunk outputs and metadata. This stays within the stated purpose. Important user-facing behavior: chunk contents are sent to LLM sub-agents (expected for translation), and the pipeline writes a <book>_temp/ working directory under the current cwd. The instructions do not ask the agent to scan arbitrary system files or exfiltrate data to external endpoints.
Install Mechanism
There is no remote install/download step in the skill manifest (instruction-only), and the repo includes local Python scripts. No URLs or download/extract install steps are present in the manifest. The runtime uses local binaries (Calibre, Pandoc) invoked by subprocesses; the code is local so install-time network fetch risk is low.
Credentials
The skill requests no environment variables or credentials. All operations are local (file I/O, subprocesses, spawning sub-agents). There are no declared secrets or unrelated service tokens.
Persistence & Privilege
always:false and no special persistence is requested. The skill requires allowed-tools (Read/Write/Bash/Agent/etc.), which lets it run local commands and spawn sub-agents — expected for a parallel translation pipeline. This combination increases blast radius if misused, but it is coherent with the skill's purpose and not excessive by itself.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install translate-book - 安装完成后,直接呼叫该 Skill 的名称或使用
/translate-book触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release with major new glossary and per-chunk meta support for consistency and collaboration:
- Added glossary extraction (with chunk sampling and proper noun detection), v2 schema, and frequency counting for consistent term translation; terms are injected per chunk for sub-agents.
- Sub-agents now emit detailed per-chunk `.meta.json` files (entities, alias hypotheses, conflicts, etc.) to support collaborative glossary growth and later human QA.
- Glossary CLI supports term-table assembly (only injects relevant terms), v1-to-v2 upgrade, and enforces unique surface forms.
- Added comprehensive tests for conversion, glossary, meta, and merger logic; improved script modularity.
- Documentation expanded with detailed glossary, agent, and pipeline behavior; skill metadata updated with homepage link.
- Legacy translation script removed; new modular scripts + tests added.
v0.2.0
- Added full skill documentation detailing book translation workflow from file input to output in multiple formats.
- Introduced parallel sub-agent architecture: each book chunk is translated independently to prevent context accumulation.
- Included rigorous translation prompt for sub-agents, with rules on markdown formatting, header levels, images, and custom instructions.
- Implemented batching with concurrency limit (default: 8) and automatic retry for translation failures.
- Process now translates the book title with proper language formatting before merging and exporting.
- Output includes status report with file locations, count of translated chunks, translated title, and generation summary.
元数据
常见问题
Translate Book 是什么?
Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents. Converts input -> Markdown chunks -> translated chunks -> HTML/DOCX/EPUB/PDF. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 279 次。
如何安装 Translate Book?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install translate-book」即可一键安装,无需额外配置。
Translate Book 是免费的吗?
是的,Translate Book 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Translate Book 支持哪些平台?
Translate Book 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Translate Book?
由 Rainman(@deusyu)开发并维护,当前版本 v1.0.0。
推荐 Skills