ljg-classic

1# ljg-classic：古文笺
2 
3原文是主干，注解贴着字词生长，章节解读把整章重新接成一个能运行的判断。最终交付一张标明书名与章节的 PNG 长图到 `$HOME/Downloads/`；生成与复验过程留在独占 `/tmp` 工作区。
4 
5## Workflow Notification
6 
7执行工作流时，只输出文字通知：
8 
9```text
10Running the **AnnotateAndRender** workflow in the **ljg-classic** skill to annotate and render the chapter...
11```
12 
13不发送开始、阶段或进度语音；完成语音由系统统一处理。
14 
15## Workflow Routing
16 
17| Workflow | Trigger | File |
18|---|---|---|
19| **AnnotateAndRender** | 逐字注解、彩色夹注、章节解读、生成古文 PNG | `Workflows/AnnotateAndRender.md` |
20 
21## 快速合同
22 
23- 输入必须能确定原文、书名、章节；版本不明时保留异文边界。
24- 所有非标点原文片段都有对应注解，不能只挑“重点词”。
25- 青色解释字词与语法，朱色解释整句动作，赭色只标异文与不确定处；章节解读使用暖纸深墨，不用蓝色长正文。
26- 解读借用 `ljg-explain` 的直白中文与理解标准和 `ljg-writes` 的「条件—机制—结果、迁移、边界」，产物仍遵守本工作流，不额外附加自测或写作脚手架。
27- 默认调用内置 `image_gen` 生成一幅无字、低干扰的章节意旨图，放在章节标题与原文之间；图像不可用时继续生成无图版本并说明。
28- 每次运行先建立独占 `/tmp/ljg-classic-*` 工作区；JSON、HTML、manifest、意旨图、候选 PNG 与重叠 QA 切片都只放在该工作区。
29- 候选 PNG 完成硬验收后，才复制到 `$HOME/Downloads/` 作为最终卡片；用户显式指定另一最终路径时以本次指令为准。未经明确要求不覆盖同名文件。
30 
31## Gotchas
32 
33- “逐字”指原文覆盖率 100%，不等于把固定词拆成失去意义的单字；成词、虚词功能和通假关系按最小有意义单位注。
34- 注解不能改写原文。底本疑似错字、通假或版本差异用 `variant` 标出，不能静默替换。
35- 字词注与句义注若都写成长句，原文会被淹没。字词注只解决局部读法，句义注只补当前动作或因果。
36- 章节解读不是逐句译文的重复，也不是金句合集。它只运行一个主关系，并说明一个可迁移场景或失效边界。
37- 边界要自然写进文章，不另起「解读边界」「应用边界」「迁移测试」之类的方法标题；这些词会让读者从内容中跳回写作后台。
38- 顶部配图负责压缩母题，不负责复述情节。禁止图中文字、书法、印章、水印与高饱和宗教奇观；画面细节太满会抢走原文的第一阅读权。
39- PNG 文件存在不算完成。必须核对真实尺寸、标题章节、注解覆盖、页面底部、整图与长图切片。
40- 不直接渲染到 Downloads。先在 `/tmp` 验收候选 PNG，再复制最终卡片，并读回候选与交付文件的 SHA-256 一致性。
41- 图像宽度固定不代表字号固定。文字量增加时先增高页面和调整断行，不能把正文字号压到难读。
42- 标点不能作为可独立换行的单元。句末标点与闭引号跟住前一原文 token；段首引号跟住后一 token，避免孤行。
43 
44## Examples
45…