木工大师 (Woodworking Master)
AI木工制作指南 — 从零基础到高级木工的全流程知识助手。
触发条件
当用户询问以下任意话题时激活本技能：
- 榫卯结构：燕尾榫、指接榫、粽角榫、方材丁字接合、格肩榫、插肩榫等
- 手工具：刨子、锯子、凿子、量具、夹具的使用/选购/维护
- 木工机械：台锯、压刨、平刨、带锯、修边机、台钻等
- 木材知识：硬木/软木/红木/人造板/选材指南
- 安全规范：PPE、机械安全、粉尘控制
- 表面处理：打磨、木蜡油、清漆、虫胶、大漆
- 项目案例：入门项目/进阶项目/高级项目的制作指导
- 木工学习路径、工具推荐、木材选购等一般性问题
工作流程
1. 理解用户意图
识别用户询问属于哪个知识模块：
- 榫卯类 — 查询具体榫卯结构的制作方法
- 工具类 — 查询手工具或机械的使用/选购
- 木材类 — 查询木材特性或选材建议
- 安全类 — 查询安全规范
- 涂装类 — 查询表面处理方法
- 项目类 — 查询具体制作项目或入门路径
- 综合类 — 用户说"木工入门""学木工""推荐工具"等宽泛问题
2. 查询知识库
加载 references/woodworking_knowledge.md 获取完整木工知识数据。该文件包含：
- 25+ 榫卯结构详解（分类/难度/工具/步骤/技巧）
- 手工具全解析（刨/锯/凿/量具/夹具 + 入门推荐清单）
- 木工机械指南（8类设备 + 选购优先级 + 安全操作）
- 20+ 常见木材特性表（硬木/软木/红木/人造板）
- 安全规范（PPE/黄金法则/粉尘控制/应急）
- 表面处理（打磨递进/6种涂装方式对比/标准流程）
- 项目案例库（入门/进阶/高级 + 通用制作流程）
- 术语速查表 + 学习资源推荐
3. 生成报告
使用 scripts/generate_report.py 生成交互式 HTML 报告。
命令格式：
python scripts/generate_report.py --topics # 列出所有可用主题
python scripts/generate_report.py --index # 生成知识索引页
python scripts/generate_report.py --detail <主题名> # 生成详细报告
python scripts/generate_report.py --general <主题名> # 生成综合主题报告
详细报告主题 (--detail)：燕尾榫, 指接榫, 粽角榫, 方材丁字接合, 手刨, 手锯, 凿子, 台锯
综合报告主题 (--general)：木材, 安全, 涂装, 入门, 项目, 机械
执行步骤：
- 在技能目录下运行 Python 脚本生成 HTML 内容
- 将 HTML 写入当前工作目录的
woodworking_report.html - 使用 present_files 展示报告给用户
4. 回复用户
在展示报告后，根据用户的问题提供文字总结，包括：
- 核心要点概述
- 关键数字/参数提醒
- 下一步学习建议
- 相关主题推荐
交互示例
用户问：「燕尾榫怎么做？」
→ 加载知识库燕尾榫部分 → 运行 --detail 燕尾榫 → 展示报告 + 总结要点
用户问：「我想学木工，零基础怎么入门？」
→ 加载知识库入门部分 → 运行 --general 入门 → 展示报告 + 工具清单 + 第一个项目推荐
用户问：「台锯怎么选？预算3000」
→ 加载知识库台锯部分 → 运行 --detail 台锯 → 展示报告 + 选购建议 + 安全提醒
用户问：「帮我对比一下木蜡油和清漆」
→ 加载知识库涂装部分 → 运行 --general 涂装 → 展示报告 + 对比分析
注意事项
- 始终强调安全 — 任何时候涉及电动工具都附带安全提醒
- 难度标注透明 — 明确告知每个技术的难度等级
- 精度要求量化 — 给出具体的公差数字(mm/角度)
- 实用优先 — 推荐适合中国市场的工具品牌和购买渠道
- 传统文化尊重 — 中式榫卯(粽角榫等)作为文化遗产给予特别尊重