dsh-plugin · DSH 个人插件合集

Name: Suxeca/dsh-plugin
Author: Suxeca

面向 DeepSeek Harness（DSH）Web GUI 的个人插件合集：仓库内维护的插件（packages/）+ 常用插件收录（third-party/ submodule）+ 推理模式路由预设（presets/）。

安装形态：所有插件以 bundle 形态装进 profile，无需修改或重建 DSH 本身。通用命令 dsh plugin --profile web add <包名> → 重启生效（见安装与使用）。

插件总览

组件	类型	功能	安装	状态
会话切换面板	仓库内	Ctrl+K 调色板切对话、键盘循环、布局快捷键	npm	✅ rc.5
插件管理器	仓库内	`/plugin` 命令 + 设置页管理插件	npm	✅ rc.4
科研台 Lab Cockpit	仓库内	侧边栏「研究台」扫描展示研究项目	本地 link	✅ 在用
Better Sidebar 工作台	收录	文件/预览/终端/Git/浏览器/任务面板	npm / GitHub	✅ v0.12.x
浏览器兼容补丁	私人	polyfill `crypto.randomUUID` / `AbortSignal.*`	私人 link	✅ 在用
视觉工具箱	收录	识图、OCR、像素级定位、UI 还原	npm	✅ 在用
记忆系统	收录	跨会话记忆：自动沉淀 + 检索注入	GitHub 源	✅ 在用
对话分享	收录	对话片段导出品牌化 PNG 长图	GitHub 源	✅ v0.1.1
超级模组注入器	收录	运行时注入插件包，免重启、热重载、自愈	GitHub 源	✅ v0.3.1
推理模式路由	预设	任务感知路由：spec/react/weak + 首轮工具裁剪	复制安装	✅ v2

仓库内插件（`packages/`）

1. dsh-client-ui-session-switcher · 会话快速切换面板

功能	说明
调色板	`Ctrl+K` / `Alt+K`：↑↓ 选择、`N` 新建、`A` 归档、`T` 归档视图、`U` 取消归档、`R` 重命名、`S` 搜索、皮肤切换
对话循环	`Ctrl+[` / `Ctrl+]` 按左侧栏可见顺序切换
布局快捷键	VSCode 风格（Mac 自动 ⌘ 化；面板 → ⚙ 可改键）
IME 防护	中文输入法组合键不误触发

布局快捷键	默认键位	联动
折叠/展开左侧栏	`Ctrl+B`	DSH `ctx.layout`
折叠/展开右侧栏	`Ctrl+Shift+B`	better-sidebar `ctx.betterSidebar`
折叠/展开底栏	`Ctrl+J`	better-sidebar `ctx.betterSidebar`
左侧栏全屏/还原	`Alt+Shift+L`	DSH `ctx.layout`
右侧栏全屏/还原	`Alt+Shift+R`	better-sidebar `ctx.betterSidebar`
退出全屏（固定）	`Esc`	两者同时退出

安装

cd ~/Workspace/deepseek-harness
pnpm dsh plugin --profile web add @suxeca/dsh-client-ui-session-switcher

参考

项	值
npm	`@suxeca/dsh-client-ui-session-switcher@0.1.0-rc.5`（`git tag dsh-v*` 触发 CI 发布）
回归脚本	`scripts/verify-shortcuts.mjs`（无头 Chrome E2E，13 项断言）

2. dsh-plugin-manager · 插件管理器

功能	说明
命令	`/plugin`：`list` / `install` / `uninstall` / `status`
设置页	列表 / 卸载 / 安装 / 刷新
服务	`/plugin-manager/*` JSON 路由 + `ctx.pluginManager`；host 半原生 Node 读写 `~/.dsh/profiles/web/package.json`

设计原则	说明
不注册模型工具	激活/重载不击穿 turn 内前缀缓存
安装/卸载	改 profile 后重启生效

安装

pnpm dsh plugin --profile web add @suxeca/dsh-plugin-manager

参考：npm @suxeca/dsh-plugin-manager@0.1.0-rc.4。

3. dsh-lab-kit · 科研台 Lab Cockpit

项	说明
定位	侧边栏「研究台」：扫描工作区（识别 `.git` / `.summary.md`），按最近修改排序展示项目
数据流	host 经 `/lab-kit/projects` 路由提供 JSON

安装

pnpm dsh plugin --profile web add link:<repo>/packages/dsh-lab-kit

参考：本地 link 安装（private，未发布 npm）。

4. 浏览器兼容补丁（🔒 私人使用，源码不入库）

纯 Client 私人插件；本仓库只记录原理，不收录源码、包名、安装路径或部署信息。缺失 API 会导致目录选择器、附件草稿与 RPC 调用崩溃。

缺失 API	场景
`crypto.randomUUID`	secure-context-only（仅 HTTPS / loopback 存在）
`AbortSignal.timeout` / `AbortSignal.any`	旧引擎 / 嵌入式 WebView 缺失

实现原理	说明（幂等：原生存在时跳过）
`randomUUID`	`crypto.getRandomValues` 构造 RFC 4122 UUID v4
`timeout(ms)`	一次性定时器 + `AbortController`，reason 为 `TimeoutError`
`any(signals)`	`AbortController` 组合，reason 取首个 abort 输入

参考：上游讨论 #514 / #1050；上游原生兼容后可移除。

收录插件（`third-party/`）

5. dsh-vision-toolkit · 视觉工具箱

项	说明
定位	把 agent-vision-toolkit 带入 DSH 的原生 Profile Bundle
能力	意图感知识图问答、OCR、像素定位、UI 还原、像素验证、Artifact 管理、Web 设置（10 个独立工具，渐进暴露）
上游	https://github.com/Anionex/dsh-vision-toolkit（v0.1.6，MIT，162 测试）
安装	`dsh plugin --profile web add @anionex/dsh-vision-toolkit`

6. sage-mem · DSH 记忆系统

项	说明
定位	跨会话记忆：事件流自动沉淀 → LLM 压缩为结构化记忆 → 新会话自动检索注入
中文优先	worker 用 trigram 分词 + 短词 LIKE 兜底（FTS5 默认分词器对中文 0 命中）
上游	https://github.com/gezi-wen/sage-mem（fork 自 claude-mem，Apache-2.0 + 中文修复）
架构	DSH 插件 → HTTP → Bun 常驻 worker → SQLite（FTS5 trigram）
安装	`dsh plugin --profile web add github:gezi-wen/sage-mem`（另需按上游说明常驻 worker）

7. dsh-conversation-share · 对话分享

项	说明
定位	会话流中选取一段对话范围（可拖拽、磁吸对齐），导出品牌化 PNG 长图（适合飞书/微信/汇报）
上游	https://github.com/bill9109/dsh-conversation-share（v0.1.1，未发布 npm）
安装	`dsh plugin --profile web add github:bill9109/dsh-conversation-share`

8. dsh-better-sidebar · 文件预览与右侧工作台

项	说明
定位	VSCode 风格右侧栏 + 底部面板
能力	文件树、文本/Markdown/图片/PDF 预览与编辑、真实终端、Git、内嵌浏览器、后台任务、第三方 Tab 扩展接口
上游	https://github.com/omdsh-dev/DSH-better-sidebar（本机 v0.12.x）
安装	`dsh plugin --profile web add dsh-better-sidebar`
⚠️ 高权限边界	Host 侧具备文件读写、PTY shell、Git、浏览器能力，非只读预览器——仅装受信任实例

本机目录含行为修订快照（gitignored）；README 只记录官方上游。

9. dsh-super-injector · 超级模组注入器

项	说明
定位	DSH 生态 BepInEx 式模组注入入口：运行时注入本地插件包，不碰 patch / package.json / bundles、不重启；注入即完整生效（host 工具 + client UI）
能力	热重载、自重载（失败自动 rollback）、卸载即净、一键自检（`dev_self_test` 8 项）、开发侧挂区（staging）转正
上游	https://github.com/yjh051108/dsh-super-injector（v0.3.1，按 docs/SPEC.md 源码契约重构）
安装	`dsh plugin --profile web add github:yjh051108/dsh-super-injector`（引导一次，之后万物皆可运行时注入）
⚠️ 高权限边界	以进程内代码执行能力运行任意插件包——仅装受信任实例

推理模式路由预设（`presets/`）

DSH 的 dsh-agent-presets 扫描 ~/.dsh/.agent-presets/<id>/agent.cordis.yml 发现本地 preset。本仓库收录本机在用的两个路由预设。

机制	说明
路由	会话首条真实用户消息 → 任务分类 → 注入对应 persona + 首轮核心工具集
解锁	首个工具调用后暴露完整工具目录；模式从持久会话事件推导，resume 不丢
agent 可见	`dev_router_status`（模式/路由）、`dev_router_mode`（调整 band/数值）、`dev_mode_subagent`（隔离模式子任务）

维度	router-standard	router-opencode-go
定位	通用任务感知路由	opencode-go / deepseek-v4-flash 适配变体
来源	派生自 yjh051108/dsh-router-standard（MIT，含论文 P1–P30）	上述 router-standard 的派生适配
模式	四模式 · 三稳定带（spec / 过渡 / react）	Flash 恒 weak + 深度思考锚（对照实验数据见测量文档）
本地补丁	`sessionModeUser` 只分类真实用户消息（防 sage-mem 注入污染）	同左 + 移除失效近场引导 + provider 路由记录（不硬门控）
适用	deepseek-official 日常	opencode-go flash（手动选模型，默认模型不动）

安装

mkdir -p ~/.dsh/.agent-presets
cp -r presets/router-standard ~/.dsh/.agent-presets/
cp -r presets/router-opencode-go ~/.dsh/.agent-presets/
# 重启 DSH 后新建会话，选择 Router Standard / Router Opencode-Go

⚠️ 安装副本须保持唯一模块文件名（loader 按 URL 缓存 ESM 模块，原地覆盖拿到旧缓存）；升级先删旧目录再复制。

运维（router-opencode-go）：presets/router-opencode-go/OPERATIONS.md

运维项	说明
安装链	注入器自重载确认 → `dev_self_test` 8/8 → 装预设 → discovery → 冒烟
健康检查	`bash presets/router-opencode-go/scripts/verify.sh`（注入器活性 + discovery + 文件完整性 + 环境体检）
更新规则	ESM 缓存陷阱（改文件必换名）；故障诊断矩阵；已知环境坑见文档

注入器（dsh-super-injector）是运维层"手术台"：预设运行时不依赖它（走官方 agent-presets 通道），但安装链与故障归因按作者指导先注入器后预设。

同类项目对比：与 SheberDavid/v4-flash-godmode-opencode-go（V4 Flash 神模式）及官方套装的差异见 docs/compare-v4-godmode.md；实测数据见 docs/measurements-router-opencode-go.md。

目录结构

packages/                  # 仓库内维护插件（monorepo，tsdown 构建 + vitest）
  dsh-client-ui-session-switcher/
  dsh-plugin-manager/
  dsh-lab-kit/
third-party/               # 收录的在用插件（公开上游 submodule；本地修订快照忽略）
  dsh-vision-toolkit/
  sage-mem/
  dsh-conversation-share/
  dsh-super-injector/
  dsh-better-sidebar/      # 本机修订快照（gitignored；官方上游见插件说明）
presets/                   # 推理模式路由预设（复制到 ~/.dsh/.agent-presets/ 安装）
  router-standard/         #   通用路由（上游派生 + v2 补丁；含 MIT LICENSE）
  router-opencode-go/      #   opencode-go 适配变体（派生适配）
docs/                      # 文档
  DEVELOPMENT.md           #   插件开发指南
  compare-v4-godmode.md    #   与 v4godmode 差异对比
  measurements-router-opencode-go.md  # 三组对照实验真实测量数据
scripts/                   # 工具脚本
  verify-shortcuts.mjs     #   会话切换快捷键回归（无头 Chrome E2E）
dsh-architecture-map.html  # DSH 架构地图（zoom-out 交互可视化）
dsh-venn.html              # Profile · Bundle · Patch 维恩图

安装与使用

本机 dsh 位于 npx 缓存，标准调用在 harness 仓库下执行：

cd ~/Workspace/deepseek-harness
pnpm dsh plugin --profile web add <包名或 link: 路径>
# 重启 dsh web 后生效

注意事项	说明
重复来源	同一插件不能同时以 link 版 + npm 版留在 bundles（`duplicate loader entry id` 功能消失）——换源先卸载旧条目
各插件命令	见对应章节；preset 走复制安装（见推理模式路由预设）

开发

pnpm install
pnpm -r typecheck   # 全仓类型检查
pnpm -r test        # 全仓单测
pnpm build          # 构建全部插件

发版步骤	操作
1. 版本	改版本号
2. 标签	`git tag dsh-vX.Y.Z && git push origin dsh-vX.Y.Z`
3. 发布	GitHub Actions 自动发布 npm（`@suxeca` scope）并提升 `latest`

文档	内容
`docs/DEVELOPMENT.md`	插件开发指南（新建包、构建、安装、扩展点速查）
`docs/compare-v4-godmode.md`	与 v4-flash-godmode-opencode-go 差异对比
`docs/measurements-router-opencode-go.md`	三组对照实验真实测量数据
`dsh-architecture-map.html` / `dsh-venn.html`	DSH 架构可视化
deepseek-harness `docs/`	上游参考（cordis 教程、extension-cookbook、capability-seams）

Suxeca/dsh-plugin

dsh-plugin · DSH 个人插件合集

目录

插件总览

仓库内插件（`packages/`）

1. dsh-client-ui-session-switcher · 会话快速切换面板

2. dsh-plugin-manager · 插件管理器

3. dsh-lab-kit · 科研台 Lab Cockpit

4. 浏览器兼容补丁（🔒 私人使用，源码不入库）

收录插件（`third-party/`）

5. dsh-vision-toolkit · 视觉工具箱

6. sage-mem · DSH 记忆系统

7. dsh-conversation-share · 对话分享

8. dsh-better-sidebar · 文件预览与右侧工作台

9. dsh-super-injector · 超级模组注入器

推理模式路由预设（`presets/`）

目录结构

安装与使用

开发

相关文档

보안 및 설치 증거

Suxeca/dsh-plugin

dsh-plugin · DSH 个人插件合集

目录

插件总览

仓库内插件（packages/）

1. dsh-client-ui-session-switcher · 会话快速切换面板

2. dsh-plugin-manager · 插件管理器

3. dsh-lab-kit · 科研台 Lab Cockpit

4. 浏览器兼容补丁（🔒 私人使用，源码不入库）

收录插件（third-party/）

5. dsh-vision-toolkit · 视觉工具箱

6. sage-mem · DSH 记忆系统

7. dsh-conversation-share · 对话分享

8. dsh-better-sidebar · 文件预览与右侧工作台

9. dsh-super-injector · 超级模组注入器

推理模式路由预设（presets/）

目录结构

安装与使用

开发

相关文档

보안 및 설치 증거

관련 플러그인

cocofhu/anime-find

omdsh-dev/dsh-data-agent

bradeGithub/DSH-Plugins-Marketplace

eri64/dsh-claude-ux

仓库内插件（`packages/`）

收录插件（`third-party/`）

推理模式路由预设（`presets/`）