dsh-feedback-combined — DSH 反馈整合插件(单包双端)
一个包补齐 DSH(DeepSeek 桌面端)反馈闭环: 客户端侧一键 👍/👎 即时评分 UI + 宿主侧评分采集 → JSONL 落盘 → 请求前注入摘要 → 查询工具。 配套 feedback-adapter Skill 约束模型收到负反馈后的反思与调整行为。
DSH 官方反馈体系设计为「评分仅写日志、不进模型上下文」,用户点 👎 后模型在下一轮完全不知道被否决过。本插件补上这一环,且把 UI 与数据层整合为单包:用户只需安装一个插件。
仓库结构
- 仓库根即主插件
dsh-feedback-combined(单包双端,推荐安装),可用pnpm add github:zhuran305-web/dsh-feedback-combined直接安装; legacy/保留整合前的两个单端插件(dsh-feedback-bridge仅宿主侧、dsh-simple-feedback-ui仅客户端侧),仅供维护参考,无需安装;- 两个单端插件功能已完全并入主插件(详见各自 README)。
单包双端结构
本插件同时声明 DSH 的两套正交配置,一个包同时携带宿主半边与客户端半边:
| 半边 | 加载机制 | 功能 |
|---|---|---|
| 宿主侧(Node) | dsh.bundle.patch(cordis.patch.yml) |
采集评分事件 → JSONL 落盘 → agent/pre-step 注入摘要 → 注册查询工具 |
| 客户端侧(web) | dsh.client.inject(platform: web) |
slot shadow 遮蔽官方按钮,单击即时提交、长按官方弹窗、Deepy 联动 |
两半边无直接调用:客户端经官方 messageFeedback.put 提交评分,宿主侧经官方 session/event 事件通道采集,slot/事件空间正交。
宿主入口为
lib/index.js(exports"."),客户端产物为lib/client.js(exports"./client")。 客户端 bundle 内嵌的__ModuleLoader__.load注册 id 必须等于包名,否则激活审计报loaded without registering。
安装与启用
前置:DSH 已安装;profile 目录可写;profile 的 pnpm-workspace.yaml 含 nodeLinker: hoisted。
# 1. 安装插件包进 profile(路径含空格,必须加引号)
cd "C:/Users/chichen/.dsh/profiles/desktop"
pnpm add "file:D:/GongJu12345/airuanjian/zcode/dsh judge/dsh-feedback-combined"
# 2. 部署 feedback-adapter Skill
mkdir -p "C:/Users/chichen/.dsh/skills/feedback-adapter"
cp "D:/GongJu12345/airuanjian/zcode/dsh judge/dsh-feedback-combined/SKILL.md" \
"C:/Users/chichen/.dsh/skills/feedback-adapter/SKILL.md"
然后在 profile package.json 的 dsh.profile.bundles 数组追加 "dsh-feedback-combined":
{
"dsh": {
"profile": {
"bundles": ["...已有插件...", "dsh-feedback-combined"]
}
}
}
若此前安装过旧插件 dsh-feedback-bridge / dsh-simple-feedback-ui,必须先移除,否则双份挂载(重复采集 + 重复 slot 注册):
cd "C:/Users/chichen/.dsh/profiles/desktop"
pnpm remove dsh-feedback-bridge dsh-simple-feedback-ui
最后完全退出 DSH(含托盘)再启动。
源码更新后刷新(file: 依赖会被复制成普通目录、不是软链,改源码不会自动生效):
cd "C:/Users/chichen/.dsh/profiles/desktop" && pnpm install
或直接覆盖部署副本后核对哈希(本项目踩过"以为同步了其实没有"的坑):
$src="D:/GongJu12345/airuanjian/zcode/dsh judge/dsh-feedback-combined"
$dst="C:/Users/chichen/.dsh/profiles/desktop/node_modules/dsh-feedback-combined"
foreach($f in @("lib/index.js","lib/store.js","lib/client.js","SKILL.md")){
if((Get-FileHash "$src/$f").Hash -ne (Get-FileHash "$dst/$f").Hash){"DIFF $f"}
}
改完 必须重启 DSH 进程;客户端 half 是 boot 插件,刷新页面不会重拉 bundle。
改 SKILL.md 后还要单独重新复制到 Skill 安装点(~/.dsh/skills/feedback-adapter/SKILL.md),
两处不一致会让模型对着旧插件名推理。
启用确认
重启后通过以下方式确认加载成功:
- 宿主侧:日志出现
feedback-combined: activated, data file: ...; - 数据目录已建立(首次评分后):
~/.dsh/data/dsh-feedback-combined/feedback.jsonl; - 客户端侧:点击 👍/👎 即时提交且 toast 出现;UI 无
Failed to load plugins报错; - 历史数据自动迁移:旧
~/.dsh/data/dsh-feedback-bridge/feedback.jsonl存在且新文件不存在时,启动时自动复制(幂等)。
配置项
宿主侧(通过 DSH 设置界面或 cordis.patch.yml)
注意:不要给这些字段加
.volatile()。schemastery 3.18.5 的.volatile()会把 校验结果变成{ get(): T }引用对象,而 cordis 的resolveConfig不会拆包, 插件拿到的就不是数字/布尔值——曾因此让budget变成NaN,注入出无意义的"[用户反馈] · …"。需要热更新语义时应显式调用config.x.get()。
| 配置项 | 默认 | 说明 |
|---|---|---|
injectEnabled |
true |
关闭后完全不注入(采集与工具照常) |
maxItems |
3 |
注入摘要最多聚合几条负反馈(1–10) |
maxCharsPerItem |
200 |
单条摘要字符上限(40–400) |
maxTotalChars |
600 |
注入总字符上限(含固定前后缀,100–2000) |
reconcileEnabled |
true |
对账兜底开关(messageFeedback.list() 不可用时可关) |
客户端侧(内置默认值,不走 DSH 配置)
客户端 half 由 dsh-client-modules 作为 boot 插件加载,其 manifest 只读取
package.json 的 dsh.client(inject / external / immediately / platform),
不会把宿主侧 Config 的值传给浏览器,因此下列选项目前是内置默认值。
如需覆盖,在页面加载前设置全局对象(只覆盖同名键,其余保持默认):
window.__DSH_FEEDBACK_COMBINED_CONFIG__ = {
toastEnabled: false,
duplicateClickStrategy: "cancel", // "open-dialog" | "cancel"
};
| 配置项 | 类型 | 默认 | 说明 |
|---|---|---|---|
toastEnabled |
boolean | true |
关闭后仅图标状态变化作为确认 |
toastDurationMs |
number | 2000 |
toast 显示时长(1500–3000ms) |
toastPositiveText |
string | "赞已记录" |
正向 toast 文案 |
toastNegativeText |
string | "反馈已记录,AI 将改进" |
负向 toast 文案 |
longPressDialogEnabled |
boolean | true |
关闭后长按无效,仅响应单击 |
duplicateClickStrategy |
enum | "open-dialog" |
重复点击策略:open-dialog 或 cancel |
deepyLink |
boolean | true |
是否联动 dsh-claude-style 的小鲸鱼 |
交互说明(客户端侧)
| 操作 | 效果 |
|---|---|
| 单击 👍 | 即时提交 positive 评分,图标高亮,toast 显示正向文案 |
| 单击 👎 | 即时提交 negative 评分,图标高亮,toast 显示负向文案 |
| 长按 👍/👎 | 唤起官方完整反馈弹窗(7 分类 + 备注 textarea) |
| 再次点击相同评分 | 按策略:唤起弹窗(默认)或取消评分 |
Deepy 联动:向 dsh-claude-style 的像素小鲸鱼合成 pointer 事件(happy → 连按 4 次挠痒笑;panic → 拖动慌乱循环)。鲸鱼不在场时静默跳过。
slot 契约记录
| 字段 | 值 |
|---|---|
| slot name | conversation.chat.assistant-actions |
| slot id | feedback |
| priority | -1(官方为 0,lowest renders) |
| order | 10(与官方一致) |
| 遮蔽范围 | 仅按钮区域,不遮蔽弹窗 |
数据格式
数据文件:~/.dsh/data/dsh-feedback-combined/feedback.jsonl(append-only JSONL,永不改写已写入的行)。
文件首行为 # 注释,说明格式。每行一个 JSON 对象,四种行类型:
| 行类型 | 字段 | 说明 |
|---|---|---|
rating |
ts, kind, sessionId, messageId, rating, category?, note?, version, source, scope |
一次评分事件(👍/👎) |
consumed |
ts, kind, sessionId, messageId, rating, version? |
该反馈已注入一次(消费标记) |
deleted |
ts, kind, sessionId, messageId |
官方 delete 事件的 tombstone(撤回) |
recorded |
ts, kind, sessionId, note, rating?, scope |
record_feedback 工具写入的观察 |
字段说明:
rating:"positive"(👍)或"negative"(👎)version:随机 UUID,每次实质 put 更新;去重键 =sessionId + messageId + versionsource:事件来源(session/event/feedback/committed/reconcile)scope:采集时归属作用域
三种作用域:
| 作用域 | 含义 | 查询聚合范围 |
|---|---|---|
session |
该记录的 sessionId 本身 | 仅当前会话 |
task |
该 sessionId 沿 parentSession 上溯到的根会话 |
根会话及其全部子会话 |
global |
全部记录 | 跨所有会话 |
消费语义: 带 version 的 consumed 只挡同版本评分(用户对同一消息再次 👎 会产生新 version,可再次注入);不带 version 的 consumed 永久挡住该 messageId(兼容旧语义)。
提供的工具(宿主侧,agent 作用域)
record_feedback
补记一条反馈观察到本地日志。当用户口头给出评价但没有点 👍/👎,或需记录复盘结论时调用。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
note |
string | 是 | 要补记的内容(≤500 字符) |
rating |
string | 否 | positive 或 negative,仅观察时可省略 |
scope |
string | 否 | session(默认)或 global |
get_recent_feedback
查询历史评分与反馈记录,按时间倒序返回。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
scope |
string | 否 | session(默认)/ task / global |
limit |
integer | 否 | 返回条数,默认 5,上限 20 |
rating |
string | 否 | 按评分过滤:positive 或 negative |
includeNotes |
boolean | 否 | 是否含备注原文,默认 false |
联调验证
| # | 验证项 | 操作 | 预期 |
|---|---|---|---|
| V1 | 双端挂载 | 重启后检查 | 宿主日志 feedback-combined: activated;UI 一键评分即时提交 |
| V2 | 负反馈闭环(核心) | AI 回答 → 点 👎 → 下一轮 | (a) 注入 [用户反馈] ... 👎;(b) 加载 feedback-adapter;(c) 针对性调整非空洞道歉;(d) 同一 messageId 未重复注入 |
| V3 | 正反馈记录 | 点 👍 | JSONL 有记录、get_recent_feedback 可查到、下一轮未注入正文 |
| V4 | 作用域 | session/task/global 调用工具 | 三种作用域读写过滤正确 |
| V5 | 长度与污染 | 连续 3 轮普通对话 | 无负反馈轮次零注入;有注入时 ≤600 总 / ≤200 单条 |
| V6 | 鲁棒性 | 反馈服务不可用 / JSONL 写失败 | 对话正常进行、日志有 warn 但无阻断 |
| V7 | 长按弹窗 | 长按 👍/👎 | 官方完整弹窗(7 分类 + 备注) |
| V8 | 数据迁移 | 有旧 feedback.jsonl 时首次启动 | 数据自动复制到新目录,历史可查 |
故障排查
| 症状 | 排查方向 |
|---|---|
UI 报 Failed to load plugins / loaded without registering |
client.js 内嵌注册 id 是否等于包名(激活审计要求两者一致)→ 重新打包统一 id |
| 插件加载失败 | profile package.json 是否被写坏 → 恢复备份;dsh.profile.bundles 是否含 "dsh-feedback-combined" |
| 注入未出现 | ① session/event 是否捕获到 feedback/message-put;② JSONL 是否写入成功(查日志 warn);③ consumed 是否误判;④ agent/pre-step 是否挂载(根 agent 判定) |
| 重复注入 | consumed 行是否落盘(注入后立即写 consumed,若写失败会重复注入——查日志) |
| 写入失败 | withFileLock 冲突视为暂时失败,下次事件重试;所有写操作 try/catch 静默降级,不阻断对话 |
| Skill 未触发 | 确认 ~/.dsh/skills/feedback-adapter/SKILL.md 已部署且 frontmatter name: feedback-adapter |
| 依赖解析失败 | profile pnpm-workspace.yaml 是否含 nodeLinker: hoisted(peer 依赖由运行时宿主树提供) |
已知限制
- R4 consumed 时序窗口:pre-step 注入成功后立即落 consumed,若该 step 随后被 abort,注入内容丢失但已标消费。
- R7 子 agent 不注入:注入只挂根 agent,子会话(subagent)回合不注入反馈摘要。
- 长按唤起弹窗依赖访问 slot 内部记录,若 DSH 版本变更 slot 内部结构可能失效,失效时长按降级为无操作,一键评分不受影响。
- 客户端 bundle 是预打包产物,修改 UI 逻辑需重新打包并保证内嵌 id 与包名一致。
feedback-adapter Skill
配套 Skill 位于 SKILL.md,定义模型收到负反馈后的反思与调整规范。安装时复制到 ~/.dsh/skills/feedback-adapter/SKILL.md。详见 SKILL.md。
No comments yet. Be the first to write one.