save_lesson
Records a resolved Houdini issue as a draft lesson with symptom, fix, category, severity, and affected versions, so repeated occurrences strengthen the lesson and support future diagnosis.
Instructions
把解决一个 Houdini 问题的经验沉淀为 lesson（写入个人库 draft 状态）。
触发时机：agent 在解决一个 Houdini 问题后主动沉淀经验。写入个人库
draft 状态，不立即进入检索索引；同 symptom 再次出现会自动累积
strength（只累积不覆盖）。团队 root 默认只读，写入返回
root_not_writable。沉淀的是 advisory 经验，不替代 verify_hou_api /
get_houdini_help / get_best_practices 与目标 Houdini 版本 live
verification。
主动沉淀工作流（advisory 行为注解，非强制协议）：用户完成 HDA / 节点流
/ VEX 工作流后说"沉淀这些知识"时，agent SHALL 依次：get_selection 定位
→ capture_workflow_snapshot 取快照 → 组织为 recipe（用法文档，走
save_recipe）或 lesson（经验，走本工具）→ 写入后向用户汇报写入的
id / root / 状态。
加深与研究方法论（advisory 引导，非强制）：用户要求"加深 / 改造 / 优化"
既有沉淀时，agent SHALL 先 search_lessons 定位既有 id，再用
capture_workflow_snapshot（自制 HDA 带 include_hda_internals=True）
重新研究，最后 save_recipe(recipe_id=...) 原地更新（recipe 通道），
**不得新增重复知识**。沉淀目标是原理 / 设计意图 / 为什么（方法论优先），
参数按需收录（用户显式要求除外）；正文索引用资产级标识（type_full /
hda 资产全名 + 版本），实例名仅辅助，**禁止本机路径入正文**。
参数说明：
- problem / symptom / fix / category / affected_versions: 必填。
- severity: 必填，取值 low / medium / high / critical。
- verified_versions: 可选；缺省 "unknown"。
- root: 可选 root 名；缺省 personal（唯一可写 root）。
返回：新 lesson → {status:success, lesson_id, lesson_status:"draft",
strength:1, root}；同 fingerprint 已存在 → strength 递增且内容保留。
错误为 status=error + error={code,message,details}（非法 severity →
ls_write_error 并列出合法值；只读团队 root → root_not_writable）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fix | Yes | ||
| root | No | ||
| problem | Yes | ||
| symptom | Yes | ||
| category | Yes | ||
| severity | Yes | ||
| affected_versions | Yes | ||
| verified_versions | No |