dsh-feedback

dsh-feedback 是 omp-feedback（Oh My Pi 的 ~/.omp/agent/extensions/feedback 扩展）在 dsh（DeepSeek Harness）插件体系上的移植：一个轻量跨上下文问题记录机制——模型在工作过程中发现的问题（skill/文档/MCP/工具与实际需要矛盾、用户纠正、约束违反）随时记录，后续任何会话都能列出并处理，不随上下文窗口丢失。

除了模型工具，本插件还带一个 Web 前端面板：打开会话时，若当前工作区有反馈，右上角会话头部会出现一个带数量的「反馈」按钮，点击展开浮动窗口——逐条展示、一键复制、就地修改、确认删除（数据与模型工具共用同一份 work/feedback.json）。

OMP → dsh 差距映射

OMP（`~/.omp/agent/extensions/feedback`）	dsh 实现（本插件）	说明
工具 `feedback_add` / `feedback_list` / `feedback_delete`	同名三工具（`ctx.tools.register` + `defineTool`）	行为、参数、返回语义逐一对应；dsh 侧用结构化 JSON 规范值 + 纯 `render` 呈现
存储 `{cwd}/work/feedback.json`	同一路径，cwd = 调用会话的工作区（`exec.agent.session.header.cwd`）	与 dsh 内置 fs 工具（read/write）的 cwd 解析一致；不同 cwd 相互独立
通过宿主注入的 `ExtensionAPI` 直接 `readFile`/`writeFile`	通过 `ctx.fs`（provider seam）读/写	自动走沙箱策略（`sandboxPolicy.resolve({ session })`）、原子写、UTF-8/二进制拒绝；父目录由 provider 创建
最后一条删除后 `unlink` 文件 + `rmdir` 空 `work/`	同语义：`ctx.fs.processPath` → node:fs `unlink`/`rmdir`（fs seam 无删除原语）；provider 无宿主路径时退化为写 `[]`	空 `work/` 仍只在目录为空时移除；该文件是过程 scratch 文件而非持久数据
配套提示词 `skills/feedback/SKILL.md` 随扩展提供	同名 SKILL.md 随包发布，apply 时解析 frontmatter 并 `ctx.skills.register` 为 runtime skill	模型经 `skill` 工具加载；不依赖全局 AGENTS.md；无 skill 注册表的 profile 下工具仍可用（仅少提示词）
JSON 解析失败静默当作空列表	解析失败显式报错（不静默清空，防止下一次写入覆盖损坏数据）	有意收紧：坏文件应被看见并人工处理
`{ id, summary, detail?, createdAt }` 自描述模型	完全一致（不设 category/status/severity）	—
无并发控制	工具未声明 `isConcurrencySafe`（默认 exclusive），避免 RMW 竞态	—

文件布局

feedback-plugin/
├── package.json            # ESM 插件包（peerDeps: cordis ^4.0.1, dsh-tools ^0.1.0-rc.6, dsh-host-webserver）+ dsh.client 声明
├── lib/
│   ├── index.js            # 插件入口：name / inject / apply，注册 4 个工具 + runtime skill
│   ├── store.js            # 存储层：会话 cwd/策略解析、load/save、scratch 清理
│   ├── http.js             # 宿主端 HTTP API（/dsh-feedback：list / update / delete），供前端调用
│   └── client.js           # 浏览器 bundle：右上角会话头部按钮 + 浮动窗口（手写 __ModuleLoader__ 格式，无需构建）
├── skills/feedback/SKILL.md # 机制说明（frontmatter 单行 name/description/whenToUse 供插件解析）
└── test/smoke.mjs          # 存储逻辑 + 工具/路由注册冒烟测试（node test/smoke.mjs）

安装到 web profile

# 1) 插件目录先装依赖（link: 安装的本地插件必须有本地 node_modules，否则
#    ESM realpath 后找不到 @deepseek-ai/dsh-tools）
cd <path/to/feedback-plugin>
npm install

# 2) 装进 profile（dsh plugin = 在 profile 目录里转发 pnpm；workspace 根要 -w）
dsh plugin --profile web add -w <path/to/feedback-plugin>

# 3) 在 ~\.dsh\profiles\web\cordis.patch.yml 追加：
# - insert:
#     - id: dsh-feedback
#       name: 'dsh-feedback'

验证：

# 离线查看组合树里有没有这个插件（不会启动服务）
dsh --profile web --dump-config
# 存储层冒烟测试
node test/smoke.mjs

注意：新装的 npm 依赖需要重启 web 服务后才会被 Loader 解析；只改 patch 会热重载。

工具一览

工具	参数	行为
`feedback_add`	`summary`（必填，自包含一句话）、`detail?`	追加一条反馈到 `{cwd}/work/feedback.json`，返回 `{ id, summary, total, path }`
`feedback_list`	—	列出全部滞留反馈，返回 `{ count, path, items }`（含 createdAt / updatedAt? / detail）
`feedback_update`	`id`、`summary?`、`detail?`	按 id 就地修改（至少一个字段）；detail 传空串清空该字段，写入 `updatedAt`，返回 `{ id, summary, detail?, updatedAt, total }`
`feedback_delete`	`id`	按 id 硬删除；全部删完时清理 scratch 文件与空的 `work/`，返回 `{ id, remaining, fileRemoved }`

前端面板（Web client half）

打开任一会话时，若该会话工作区（cwd）存在 work/feedback.json 且有内容，右上角会话头部（conversation.session.header.actions 槽）直接浮着一个常驻面板（默认展开，无需点击）：

面板逐条展示：id、创建/更新时间、概要、详情；
每条反馈可复制（summary + detail 全文进剪贴板）、修改（弹窗编辑概要/详情并保存）、删除（确认后硬删除，最后一条删除后自动清理 scratch 文件）；
支持手动刷新；面板可折叠（收起为一条标题栏，再点展开）、可关闭（关闭后头部留一个小触发器用于重新展开），切换会话或刷新页面后自动重新出现；
无反馈或未加载完成时不渲染任何控件。

前端与模型工具共用同一存储：前端通过宿主端 HTTP 路由操作（lib/http.js，前缀 /dsh-feedback， GET /list?cwd=…、POST /update、POST /delete），读写仍走 ctx.fs provider seam，与工具行为一致。

生效条件：client bundle 在 web 服务启动时扫描进 window.__DSH_BOOT__；运行中的服务对 bundle 与宿主端插件改动均热重载（dsh 的 client-modules HMR 会重算 rev 并推送新 bundle，宿主端插件热重载），改完刷新页面即可，无需重启。验证：

# 检查 boot manifest 是否含 dsh-feedback 条目（rev 会随 bundle 更新）
Invoke-WebRequest http://127.0.0.1:3080/ | Select-String '__DSH_BOOT__'
# bundle 可访问
Invoke-WebRequest http://127.0.0.1:3080/plugins/dsh-feedback/client.js

使用规则（与 omp 一致）

发现即记录、轻量：记录时不展开处理；调用失败须重试，不得静默丢弃。
自包含：summary 指明哪个 skill/文档/MCP/工具、什么问题。
跨上下文回收：任何新会话开始处理前先 feedback_list。
处理完即删除；每条反馈要么纳入本单元处理，要么显式推迟，不得无声悬置。
多个同类反馈积累 = 演化信号（配合 dsh-skillzip 的 skillzip_compress 等）。
详细规则见 skills/feedback/SKILL.md（运行时已注册为 feedback skill）。

dsh-feedback

项目标签

README

dsh-feedback

OMP → dsh 差距映射

文件布局

安装到 web profile

工具一览

前端面板（Web client half）

使用规则（与 omp 一致）

分类依据

dsh-feedback

项目标签

README

dsh-feedback

OMP → dsh 差距映射

文件布局

安装到 web profile

工具一览

前端面板（Web client half）

使用规则（与 omp 一致）

分类依据

同类项目

deepseek-harness

dsh-desktop

awesome-dsh-plugin