ja-zh-max
workflow
Uyari
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Gecti
- Code scan — Scanned 4 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
jp-zh-max: 日译汉翻译 Skill — Japanese→Chinese translation built on 20 methods distilled from Gao Ning's textbook; tiered workflow + wasei-kango checker
README.md
jp-zh-max — 日译汉翻译 Skill
日文→中文翻译与润色,输出日中对照译文。方法论基于高宁《日汉翻译教程》,按工作量分三档,附机检脚本(含和製漢語同形词检测)。
📊 工作流图
这是什么
jp-zh-max 是一个翻译 skill,Claude Code、DeepSeek Harness 等支持 Agent Skills 的工具都能用。它把日文译成地道中文,产出日中对照译文。
- 方法论来自高宁《日汉翻译教程》(上海外语教育出版社,2008)。
- 书中 20 个方法经 book2skill 蒸馏,压缩成速查表
references/methods.md。
日译汉有三处根本差异,本 skill 的设计围绕它们展开:
- 汉字同形,带来虚假的安全感:「検討」不是「检讨」,「手紙」不是「手纸」。
- 语序不同:日语是 SOV,中文是 SVO。
- 暧昧被语法化:日语用语法表达不确定,逐个直译就会满纸「似乎」「或许」。
v4 的变化
| v3 | v4 | |
|---|---|---|
| 动笔前必读 | 14 个文件,约 2 万汉字 | 小档不读;中档、大档读一页速查表和翻译腔清单 |
| 每段改写 | v1 → v2 → v3,逐段打版本标记 | 初译 → 由大到小修订一轮 |
| 校验链 | 4 个 skill 全量过,不可跳过 | 大档每章过一次 humanizer,其余可选 |
| 标点脚本 | normalize-punctuation-ja.py 有三个 bug |
统一改用 check.py |
| 机检 | 只查标点 | 新增翻译腔信号;对照原文报出照搬的和製漢語;检测日语读点「、」残留 |
| 自包含 | 依赖仓库外的 jp-zh-ultra 目录(未随仓库发布) | 速查表随仓库提供,不再依赖外部目录 |
旧标点脚本的三个 bug:
- 『 被替换成乱码并插入换行。旧版 SKILL.md 里提醒要检查的
'』':乱码,就是这个 bug 造成的。 - 「」被换成英文直引号。
- 列举用的顿号「、」被一律改成逗号。
工作流
| 档 | 场景 | 流程 |
|---|---|---|
| 小 | 聊天里几句、一段 | 定性 → 理解 → 初译 → 自查(含和製漢語表),在回复里给对照 |
| 中 | 一篇文档 | 定性 → 理解 → 初译 → 修订 → 机检 → 交付 |
| 大 | 整本书 | 项目初始化,然后逐章走中档流程,每章加一次 humanizer 终审;全书合订后派生 HTML、EPUB、MOBI |
- 定性:判断软硬、自由度、文体三层(语体、风格、体裁)、大众语境还是个人语境,以及语域脏度。
- 修订:按篇章 → 句子 → 词汇 → 修辞四层推进;软文本再用「达意 → 得体 → 传神」自评。
- 详见 SKILL.md。
安装
cd ~/.claude/skills/ # 或你的 agent 的 skills 目录
git clone https://github.com/3060226349kk-cmd/ja-zh-max.git jp-zh-max
依赖:
- Python 3.8+,运行
scripts/。 - 可选:
playwright(PDF)、ebooklib(EPUB)、Calibreebook-convert、Pandoc。 - 可选 skill:humanizer,大档终审时用。
使用
日译中:
(日文原文)
项目结构
jp-zh-max/
├── SKILL.md # 运行时指令:三档工作量、流程、格式、文件路由
├── references/ # 20 法速查 methods.md、工作流图 workflow.md、和製漢語陷阱表、翻译腔症状、技巧库、文本分析、修改方法、语域词表、提取与输出
└── scripts/
├── check.py # 机检:标点残留 + 翻译腔信号 + --pairs 同形词检测(--fix 修标点)
├── normalize-punctuation-ja.py # 兼容入口,调用 check.py 修标点
├── strip-version-markers.py # 交付清理 + 译者署名 + 项目地址
└── bilingual-to-pdf.py # 日中对照 MD → HTML + PDF
致谢
- 项目作者:Lilipuut。
- 框架来源:en-zh-translation-polish。
- 蒸馏工具:cangjie-skill 的 book2skill 管线。
- 高宁教授:《日汉翻译教程》为全套方法论提供了理论基石。
许可
MIT License,详见 LICENSE。
English
jp-zh-max is a Japanese→Chinese translation skill for agents that support Agent Skills (Claude Code, DeepSeek Harness and others). It produces paragraph-aligned bilingual Markdown, with the Japanese source in blockquotes and the Chinese translation below.
- Method: Gao Ning's A Course in Japanese-Chinese Translation (2008). Twenty methods are distilled into
references/methods.md. - Tiers: work is sized in three tiers (snippet, document, book).
- Revision runs once, top-down: discourse → sentence → word → rhetoric.
scripts/check.py zh --fix --pairs references/wasei-kango-traps.mdfixes punctuation. It also flags translationese and wasei-kango false friends that were carried over literally from the source.- Book: one
humanizerpass per chapter.
MIT licensed.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi