2e4dcf8980
新增学习资料生成器模块（learner），从权威库生成多维日语学习资料： - 拼音/假名/汉字/熟字训四类索引，带拼音↔假名↔汉字交叉跳转 - 逐字音训分类（KANJIDIC2 精确查表 + 启发式回退 + 排序键） - 音变标注体系：浊化（連濁）、半浊化、促音变（促音便）、连声（れんじょう） 独立配色 + 合并逻辑 + 音变规律说明 - 显式标注表：rendaku_marks（连用形连浊）、renjou_marks（连声） - 每索引独立例词数配置（jlearn.toml + --config） - HTML 单页应用 + 静态 HTML + PDF（playwright） 清洗工具增强： - 拼音校验器（pinyin_checker）集成到 jclean - 多音字拼音校正、ます形サ変動詞转原型 数据： - 权威库补充连声词（反応/天皇/陰陽/観音/因縁/三位/輪廻/安穏） - KANJIDIC2 音训分类表、拼音校正字典 整理 .gitignore：忽略生成产物（output/study_materials）、词典数据库、 任务运行日志、备份文件
项目文档索引
本目录存放所有项目相关文档，按类型分类组织。
📂 目录结构
docs/
├── design/ 设计文档（架构、工作流、配置方案）
├── history/ 历史记录（重构总结、变更日志）
└── analysis/ 分析报告（数据分析、Review 桶统计）
📖 文档清单
design/ — 设计文档
CONFIG_FILE_DESIGN.md
配置文件系统设计文档
- 配置文件格式（TOML）
- 查找优先级（--config > 当前目录 > 项目根 > 用户主目录）
- 路径解析规则（相对路径相对配置文件所在目录）
- 优先级规则（命令行 > 配置文件 > 默认值）
WORKFLOW.md
三层架构工作流设计
- 底层：
TangoAnalyser— 单词分析（无文件概念） - 中层：
TaskProcessor— 文件 I/O、桶管理 - 顶层：
CleanerWorkflow— 状态机、任务推进 - 状态转换图、CLI 命令映射
history/ — 历史记录
REFACTOR_SUMMARY.md
最初的大重构总结（单脚本 → 三层架构）
- 重构前的问题（500+ 行单文件、全局变量、职责混乱）
- 三层架构设计决策
- 文件清单（9 个核心模块）
- 73 个测试覆盖
CONFIG_INTEGRATION_COMPLETE.md
配置文件集成完成总结（v0.3.0）
- 配置文件功能（init-config / show-config）
- 查找优先级、路径解析规则
- 多项目使用场景（单项目、多项目隔离、共享权威库）
- UTF-8 BOM 容错修复
CONFIG_SIMPLIFICATION.md
配置文件简化总结（移除不必要配置项）
- 移除
sources_dir、default_start_line、default_count count: Optional[int] = None语义（None = 处理到文件末尾）- CLI 默认行为变更（--start 默认 1，--count 默认全部）
- 配置文件精简（3 个段 → 2 个段）
CLEANUP_SUMMARY.md
项目目录清理总结
- 根目录脚本分类移动（analysis / legacy）
- 文档归档到 docs/
- 临时报告移到 reports/
analysis/ — 分析报告
REVIEW_ANALYSIS.md
Review 桶数据分析（tasks/legacy_batch1/）
- 341 条待审核数据的分布统计
- review_pinyin: 218 条（多音字）
- review_split: 79 条（假名分割失败）
- review_verb: 37 条（动词形态）
- review_special: 7 条（特殊格式）
- 典型案例分析和修正建议
🗂️ 其他文档位置
根目录
README.md— 项目总览README_cleaner.md— jclean 工具用户文档jclean.toml— jclean 配置文件（示例）
脚本目录
scripts/analysis/README.md— 分析工具说明（待集成）scripts/legacy/README.md— 已废弃脚本说明
临时报告
reports/phonetics_report.txt— 发音规律分析结果reports/validation_report.txt— 数据质量校验结果
📝 文档维护规则
- 设计文档 (
design/) — 重大架构变更时更新 - 历史记录 (
history/) — 每次重构/重大变更后添加总结，只增不改 - 分析报告 (
analysis/) — 数据分析结果，按需生成 - 用户文档 (根目录) — 与代码同步更新
🔗 快速导航
- 新用户：先读 README.md，再读 README_cleaner.md
- 开发者：读 WORKFLOW.md 了解架构
- 了解历史：按时间顺序读
history/目录 - 数据分析：看
analysis/和reports/