前言¶
DeepSeek Harness (DSH) 在本地运行模型时，模型容易忽略上下文或重复犯已知错误。dsh-lessons 插件通过记录这些“犯蠢”时刻，将其沉淀为教训清单，并在后续对话中自动注入系统提示词，从而让模型不再重复犯同样的错。
它是什么¶
这是一个为 DeepSeek Harness (DSH) 设计的插件。它的核心逻辑是：记录犯过的错 → 沉淀成清单 → 下次开口前先看一眼。插件开源，许可证为 MIT。
核心功能¶
插件具备以下能力：
- 自动识别：对 AI 表达不满（如“你又搞错了”、“不对”、“答非所问”），自动识别并记录。
- 手动补录：通过输入指令直接录入教训。
- 工具报错留档：可选功能，记录工具执行失败的场景（默认关闭以减少噪声）。
- 动态注入：通过
systemPrompt.section()注册实时求值的提示词，记录后立即生效，无需重启 DSH。 - 会话级开关：每个对话可独立决定是否启用教训注入，或在对话内使用指令开启/关闭。
- 可视化面板：DSH 右侧栏的“AI 教训”标签页，用于查看、管理、补录及预览注入内容。
安装¶
克隆仓库并运行安装脚本：
git clone https://github.com/dusktin71-lang/dsh-lessons.git
cd dsh-lessons
node install.mjs
安装完成后，建议运行校验命令确认状态：
node verify-install.mjs
使用方法¶
自动识别¶
当用户对 AI 发出短促的负面反馈（120 字以内且命中明确负面词语）时，插件会自动入库。误判的记录可在面板中删除。
手动记录与开关¶
- 手动补录：输入
记一下：<内容>、记住：<内容>或/lesson <内容>。 - 开启/关闭注入：在对话中输入
/lessons on或/lessons off。
面板使用¶
DSH 右侧栏 →「AI 教训」：
* 顶部开关：控制总开关、自动识别、工具报错记录以及当前对话是否生效。
* 教训列表：支持补录、逐条停用或删除。
* 注入预览：查看模型实际会读到的文本内容。
* 更多设置：调整注入条数上限、单条字符上限、新对话默认设置等。
配置与数据¶
- 数据存储：
~/.dsh/ai-lessons/state.json。 - 自检日志：
~/.dsh/ai-lessons/boot.log（每次启动追加一行，用于排查加载问题）。 - 浏览器端依赖：要显示右侧栏面板，必须在
package.json的dsh.client.inject中声明@deepseek-ai/dsh-client-ui-sidebar-right。若声明缺失，插件不会报错，但面板将不出现。
排查¶
若右侧栏未出现「AI 教训」标签页，请检查以下几点：
- 依赖检查：确认
dsh.client.inject数组中包含@deepseek-ai/dsh-client-ui-sidebar-right。缺少此依赖会导致服务缺失，回调永不执行。 - 手动展开：注册成功不代表面板自动展开。需在会话标题栏最右端（折叠图标镜像）手动点击展开右侧栏。
- 查看日志：检查
~/.dsh/ai-lessons/boot.log，重点关注client-report事件中的event字段，确认client/apply和client/tab-registered是否出现。
结语¶
dsh-lessons 适合需要在本地环境中通过持续反馈来提升模型表现的开发者。它将零散的纠正转化为结构化的约束，是构建健壮本地智能体的实用工具。
