dsh-plugins

dsh-plugins

English | 中文

两个面向 DeepSeek Harness Web 界面的插件，在该仓库之外开发，以 @sumomok 作用域发布到 npm。

Harness 把一切都当作插件，它的仓外扩展路径是一等公民：$DSH_HOME/profiles/<name> 下的 profile 在自己的 package.json 里列出 bundle 层，任何声明了 dsh.bundle.patch 的 npm 包都可以是其中一层。这里的东西不需要 fork 上游检出，也不需要给它打补丁。

包

@sumomok/dsh-quote-message 让你在写提示词时引用当前会话里较早的内容：在任意聊天消息中选中一段文字，一个原生引用 chip 就把这段文字带进你的提示词，发送时展开成一段 markdown 引用块。发出去之后，引文不会以一串 > 留在气泡里，而是渲染成消息上方一张独立的引用卡片——插件遮挡宿主的用户气泡渲染器，气泡本身仍交回给它渲染。它只有浏览器半边——宿主半边是空操作，只为让加载器看到一个真正的 cordis 插件而存在。完整文档：English · 中文。

@sumomok/dsh-balance 在侧边栏底部的设置旁放一个 chip，显示当前会话所选模型所属服务商的账户里还剩多少；悬停打开的浮层拆解该余额，并带一个服务商下拉（覆盖本部署能查到余额的那些）、一个打开该服务商自己收款页的「充值」按钮，以及这套安装今天、本月和累计花了多少；输入框下方还有一行显示当前会话花了多少。余额是服务商自己给的数字；花费是 Harness 自己记录的 token 用量，乘以一张本部署自己拥有、可从 cordis.yml 改的价格表。完整文档：English · 中文。

录制中的账户余额已做遮挡；消费数字是真实值。

安装

每个包都是普通的 npm 包，声明了 dsh.bundle.patch，所以用 Harness 自己的 plugin 命令装进某个 profile：

dsh plugin --profile <name> add @sumomok/dsh-quote-message
dsh plugin --profile <name> add @sumomok/dsh-balance

安装会把这个包追加到 profile 的 dsh.profile.bundles，由它的 patch 层挂载插件；不需要往 profile 自己的 cordis.patch.yml 里加任何东西。两个插件都贡献浏览器侧 UI，因此 profile 需要一个组合了 Web 界面的 bundle（@deepseek-ai/dsh-web-app）——在 headless profile 里没有任何可看的东西。

每个发布的 tarball 都带着预构建的 lib/，因此安装现场从不执行构建。

兼容性

针对 @deepseek-ai/* 0.1.1-rc.2 构建——该代次的宿主，桌面应用或源码检出均可。Node ^22.19 || >=24。

peer 范围写成 >=0.1.0-rc.1 <0.2.0-0 而不是 ^0.1.0-rc.7，因为按 semver 规则，跨越预发布版本的 caret 范围匹配不到更后面的预发布版本：^0.1.0-rc.7 不满足 0.1.1-rc.2。每个 @deepseek-ai/* peer 都是可选的，所以只组合了其中一部分的宿主同样能装。

安全摘要

每个包自己的 README 有完整说明，这里是简版。

• quote-message——不联网、不碰文件系统、不做任何存储、不写自定义会话事件、不注册宿主路由或服务。被引用的文字只通过你发送的提示词到达模型，宿主把它记录为普通的 user/message。
• balance——出站网络只到配置的服务商 origin，别处一概不去；推导后会离开该 origin 的 base URL 会被拒绝而不是发出请求。API key 每次读取时经宿主凭据缝解析一次，以 Authorization 头发送，从不记录、缓存、落盘，也不回传给浏览器。它暴露的三个 RPC 方法都是只读的。唯一的磁盘写入是它自己在 $DSH_HOME/dsh-balance 下的花费账本。「充值」按钮只在用户自己点击时，用新的浏览器窗口打开一个硬编码的服务商控制台地址；插件自身从不请求它。

两个插件都不写自定义会话事件类型，所以卸载其中任何一个都不会留下宿主拒绝加载的会话。

开发

pnpm install
pnpm run build       # 各包自己的构建：先 tsc，再各自的打包器
pnpm run test        # 对每个包跑 vitest
pnpm run typecheck
pnpm run lint

pnpm run test 在全新检出上就能跑：quote-message 的构建冒烟测试会先跑自己的打包器。balance 的构建冒烟测试在 lib/ 不存在时跳过，因此想让每条断言都执行，就先 pnpm run build 再 pnpm run test。

每个包都拥有自己的整套构建，因为每个都要产出 Web 外壳模块加载器所要求的闭包工厂形式的浏览器包，共享的 node 平台配置产不出这种东西。pnpm --filter @sumomok/dsh-<name> run build 可以单独构建其中一个。

package.json          工作区根：共享工具链，无运行时依赖
pnpm-workspace.yaml   packages/*
tsconfig.base.json    每个包继承的编译器面
tsconfig.json         solution 文件；每个包一条 reference
eslint.config.js
packages/<name>/
  package.json        @sumomok/dsh-<name>
  tsconfig.json       继承 ../../tsconfig.base.json
  cordis.patch.yml    这个包贡献的 bundle 层
  src/                源码；本地相对导入带 .ts 扩展名
  tests/              vitest 用例
  lib/                构建产物（git 忽略；随 npm tarball 发布）

lib/ 在这里被 git 忽略，同时列在每个 manifest 的 files 里，因此仓库只带源码，而每个发布的 tarball 都带着预构建产物。

许可

MIT。