DeepSeek Harness 插件

AlexPeng07/dsh-custom-plugin

Star 数 ★ 9 下载量(近 30 天) 3,129 分类 UI 增强 收录于 2026-08-24 npm @alexpeng/dsh-custom-plugin

DSH Web GUI 便利套件,提供外观控制、时间线导航、项目文件夹、提示词、会话导出、Mermaid 渲染、引用回复,以及 DeepSeek 余额和每日 token 用量。

安装

# npm 包(预构建)

dsh plugin --profile web add @alexpeng/dsh-custom-plugin

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:AlexPeng07/dsh-custom-plugin

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

CI

English | 中文

DeepSeek Harness(DSH)Web GUI 的 Custom 便利套件:个性化外观、天气特效、背景动效、玻璃效果、项目文件夹、增强提示词库、会话导出与会话搜索、Mermaid 渲染、7/30/90 天用量分析、预算与无密钥本地备份,以及 Ctrl/Cmd+K 快捷面板。

插件为双半区架构:宿主半区(src/)持有状态文档、注册 /api/custom-plugin 路由与 custom_plugin_status 智能体工具;浏览器半区(src/client/)通过 7 个官方 slot 的 8 处注入挂载 UI,以同源 fetch 与宿主通信。经官方 profile 机制挂载,不改 DSH 源码。

部分界面展示

天气特效截自深色模式。额度历史、备份导入预览、会话搜索与快捷面板属于同一套动态面板,需在 DSH 内打开对应页查看;仓库未另附固定截图。

功能

外观个性化

  • 背景颜色:20 组低饱和典雅色(每组合配 tab 栏色,默认「天青灰」),另有「无颜色」(跟随 GUI 默认主题)。深浅色模式均可选用;深色模式自动派生同色系的深色变体(保留色相与低饱和,落到深色明度档),色板预览即当前模式的实际效果。
  • 天气特效:画布渲染、不挡交互,一键切换——飘雪、电影感雨滴(三层景深 + 地面溅起)、樱花飘落;关闭时自动清空画布。
  • 玻璃效果:所有 Custom 面板默认毛玻璃;可切换液态玻璃(圆角矩形 SDF 位移贴图让四条边对称折射,配合克制的模糊提饱和、1px 高光边与约 70% 宿主填充,大面积面板文字仍清晰;不支持 SVG 位移滤镜的引擎自动回退毛玻璃)。背景动效开启时,玻璃改用「中心实、边缘透」的径向填充与提高对比度的滤镜链,让动画纹理在玻璃边缘继续可见,同时保持正文可读。「全局浮层玻璃」对弹窗、菜单、提示框、下拉框与系统设置窗统一加玻璃质感,液态模式下浮层同样位移折射。
  • 原生入口:头部「个性化」按钮只打开一个紧凑的外观浮层,锚定在按钮下方、空间不足时自动上翻,不再有可拖拽窗口;项目、提示词、搜索、导出、Mermaid、效率、额度与数据管理全部收进 dsh 设置页的「个性化」分区。浮层、菜单与设置卡片统一使用宿主菜单材质、抬升阴影、圆角与字号阶梯,开合有 150–220ms 的淡入/缩放动效(浮层从锚定方向进入),通知在原位退出,并遵循系统的「减少动态效果」设置。
  • 背景动效:内容层下方的整页动态背景,两套互斥档位——字符档(flow / rain / ocean / starfield / ripple,以及零动画的 static)与光影档(每套风格一张全屏着色器:liquid / grain;页面不支持 WebGL 时回退字符档并提示)。面板里切换档位与预设,可调密度、速度、帧率、字号与浓度(光影档为强度,字号/浓度不适用),「恢复默认参数」只把六项参数恢复为「跟随预设」,不改变动效档位与预设(按钮旁与提示里都写明了这一点);滑块值一律 clamp 到当前预设声明的范围。墨色强度是另一条独立的轴(柔和 / 标准 / 强烈),只改墨色深浅、不动密度、速度与帧率;「避让正文」开关默认打开,让正文读取列更淡、页面四周保持浓淡,关掉则整页均匀。动效开启时页面底色会调成半透明以便透出纹理;开启玻璃后卡片和浮层会变成覆盖在这层纹理上的玻璃——中心保留足够填充保证可读,边缘透出持续运动的动画,对话框保持不透明。ocean、flow、rain、ripple 与 starfield 都能响应鼠标。ocean 铺在会话中栏内部,水面直接出现在消息背后:拖动会留下涟漪,点击溅起水花,鱼群会惊散后重新聚拢。flow 仍是整页背景,但指针现在会搅动雾面:拖动沿途扭曲并加浓噪声,点击推开一圈涟漪。rain 把指针当作风:划过会把雨丝吹斜,点击向两侧拨开雨帘,随后慢慢合拢。ripple 的点击会在落点漾开一圈新涟漪,拖动沿途留下小水纹。starfield 保持稀疏:点击点亮一小片星尘,拖动撒下一条淡淡星光,两者约一秒后暗去。光影档的 liquid 也会跟随鼠标:划过会卷动墨云,点击从落点扩散出一圈涟漪;grain 按设计保持静态噪点。其余预设仍是整页背景。

项目文件夹

多级文件夹树,保存在 $DSH_HOME 状态文件中,跨工作区共享。任意工作区与会话都可收纳进文件夹;支持拖拽排序(插入前 / 内部 / 插入后)与上移/下移按钮、双击或铅笔图标行内重命名、删除确认、搜索(按名称与引用)、「添加当前会话」,空态与无匹配态都有明确提示。

提示词库

新增与编辑在同一个表单弹窗内完成(名称、正文、标签、收藏,Ctrl/⌘+Enter 保存),不再连续弹三个输入框;列表支持搜索、标签筛选、收藏筛选与手动/最近使用/使用次数/名称四种排序,并记录最近使用与使用次数。删除后 5 秒内可从通知里撤销;导入先显示有效/无效/冲突预览,再选择合并或替换。编辑器中若有未保存修改,按 Esc、点遮罩或取消会先询问「放弃修改 / 继续编辑」。正文可使用 {{变量名}},插入前会弹出变量表单;提示词库可用版本化 JSON 或以二级标题分段的 Markdown 导入导出。

会话导出

以格式卡片选择导出类型,导出时显示「读取会话 → 整理内容 → 生成文件」步骤并支持取消,完成后给出文件名与体积,失败可重试(文件名带日期戳):

  • JSON:标准 messages 结构(user / assistant / tool),meta 携带会话标题、创建时间、工作目录与导出时间,可导入其他工具;
  • Markdown:按角色分块的纯文本;
  • PDF:A4 打印版式 HTML,浏览器打开后打印另存为 PDF;图片以 base64 内嵌(最多 30 张、总量 12 MB、单张 ≤ 4 MB)。

工具调用行携带工具名与参数摘要(从配对的 tool/call 事件解析)。

插件状态可导出为版本化 JSON 备份,包含外观、文件夹、提示词、星标、用量和预算,不包含 API Key 或凭据元数据。导入前显示冲突预览,支持合并或覆盖非敏感状态,并自动保留恢复副本。

Mermaid 渲染

聊天中的 ```mermaid 代码块(含助手回复,思维导图 / 流程图 / 时序图等)自动就地渲染为图表:代码块上方出现「图表 / 代码」切换工具条与 mermaid.live 兜底链接,流式输出期间内容完整后即预览,跟随 GUI 明暗主题重绘,渲染失败时保留原代码。检测依据代码块语言标签;无标签(流式中)时按内容启发式判断(关键字前缀 + 完整度检查,语言明确的代码块不会误触)。引擎优先读取随插件安装的本地 Mermaid 11 依赖(离线可用),缺失时回退 jsdelivr / fastly / unpkg 三镜像拉取并在宿主进程内缓存;用户消息下方的渲染按钮与模态窗口(多图切换)保持不变,mermaid.live 链接为 DEFLATE 压缩的 #pako: 格式,打开即还原图表。

效率工具

  • 防自动跳转:强制 scroll-behavior: auto,发送消息不再把视图拽到底部(默认关闭);
  • 公式复制:含公式的消息下方显示 LaTeX / MathML 复制按钮(MathML 可直接粘贴进 Word);
  • 批量归档:勾选多个会话批量归档,运行中会话默认不可选,并分别报告成功与失败数量;DSH 尚未公开恢复接口,插件不提供恢复入口。
  • 会话搜索:可在「当前会话」与「全部会话」之间切换;当前会话可筛选用户、助手和工具内容,结果支持 ↑/↓/Enter 键盘导航并跳转到所属轮次;部署开启了 dsh 事件索引时走索引,否则直接扫描同一份会话日志,面板会说明本次用的是哪条路径。
  • 快捷面板:在非编辑状态按 Ctrl+K / Cmd+K,统一搜索会话、工作区、提示词和常用功能;跨会话全文搜索使用 dsh 官方接口,不可用时如实提示原因。
  • 可靠归档:运行中的会话默认不可选,批量操作分别报告成功与失败数量。

额度与用量

会话头部常驻用量徽标(点一下打开、再点一下关闭):已登录 DSH 账号时直接显示与「设置 > 账号与余额」一致的官方余额;未登录时显示本机费用估算(如 ≈¥0.42)与今日调用次数。额度卡是单屏摘要——可用额度、今日总量、分模型表与本月预算,底栏为「刷新 / 扫描日志 / 完整用量」,点「完整用量」直接打开设置页;完整账本在「设置 > 个性化 > 用量与额度」中。面板提供:

  • 用量与费用(本机记录,无需凭据):今日/历史用量、预算与费用估算全部来自本机会话记录。
  • 余额(仅 DSH 账号):通过宿主账号服务读取「设置 > 账号与余额」同源的充值 + 赠送钱包余额。余额区展示赠送 / 充值金额、余额不足提示,以及账号服务提供的「用量明细 / 充值」链接。未登录时保留本机费用估算并提示到「设置 > 账号与余额」登录;钱包查询尚未就绪时显示为加载中并自动重试,查询失败也会重试且不隐藏本机估算。不再提供 API Key 表单。
  • 今日用量:按模型统计输入 / 输出 / 缓存 token 与调用次数,实时折叠自 session/event 事件。
  • 费用估算:按 DeepSeek 官方峰谷价目(2026-11-14 核对,每百万 tokens)。高峰为北京时间工作日 9–12、14–18 时(不含中国法定节假日);其余时段——周末、法定节假日与其余时间——均为空闲时段,价格恰为高峰的一半。deepseek-flash 峰时输入 ¥2(缓存命中 ¥0.04)、输出 ¥8;deepseek-v4-pro 峰时 ¥9(缓存命中 ¥0.30)、输出 ¥27。缓存写入按未命中输入价计。仅供参考。
  • 扫描:「扫描今日会话日志」重放全部会话、按事件自身时间戳归入今日(跨午夜会话不丢量),完成后显示扫描到的活跃会话数。
  • 历史与预算:7 / 30 / 90 天分段查看趋势和按模型汇总,导出 UTF-8 CSV;可设置人民币月预算与预警比例,并用进度条显示本月使用比例。设置卡片会显示最近刷新时间,查询失败时给出重试入口。

设置入口

「设置 > 个性化」是完整管理页:顶部分组导航(外观、项目文件夹、提示词、搜索、导出、扩展、用量与额度、数据与关于)在窄面板内自动换行,下方为原生设置卡片。会话头部的「个性化」按钮只打开紧凑的外观浮层:锚定按钮、空间不足自动上翻,按 Escape 或点浮层外关闭,关闭后焦点回到触发按钮;浮层不可拖拽,也不会盖住底部输入区。浮层底部的「完整设置」、额度卡的「完整用量」以及其他管理入口会直接打开设置:插件走宿主的真实入口控件(账号菜单 → 设置),再选中「个性化」与目标分区;只有这条路不可用时才回退为 Ctrl+Alt+, 提示。侧边栏底部的「项目」按钮打开同一套项目浮层。

智能体集成

custom_plugin_status 工具报告:外观配置、今日按模型用量、余额、时间线样本、Mermaid 引擎加载情况、状态文件路径与客户端诊断。插件不注入任何系统提示。

版本对应

插件版本 构建并实测过的 dsh 状态
0.9.x 任何 >= 0.1.7-rc.2 的 dsh(开放式;已在 0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4 与 0.2.1-rc.5 实测) 本版本
0.8.x dsh 0.1.7-rc.2、dsh 0.2.0-rc.2 与 dsh 0.2.1-rc.2(实测窗口) 上一版;在 dsh 0.2.1-rc.3 及以后会被拒绝
0.7.x dsh 0.1.7-rc.2 与 dsh 0.2.0-rc.2 上一版;在 dsh 0.2.1-rc.2 上会被拒绝
0.6.x dsh 0.1.7-rc.2 与 dsh 0.2.0-rc.2 上一版;在 dsh 0.2.1-rc.2 上会被拒绝
0.5.x dsh 0.1.7-rc.2(peer 范围 >=0.1.7-rc.2 <0.2.0-0) 在 0.1.x 上没问题;任何 0.2.x 宿主都会拒绝它,dsh 桌面版也算
0.4.2 dsh 0.1.1-rc.1 … 0.1.6 时代 已被取代,在 0.1.7+ 上不要指望可用

0.1.7 改掉了本套件依赖的插件侧契约(会话导航归 ctx.uiWorkspace、会话列表不再提供 当前查看的会话、消息模型移除 tool-result 内容块),两个版本互不替代。dsh 0.2.1-alpha.4 又改掉了兼容门本身:优先读 engines.dsh,只有它缺省时才回退到 @deepseek-ai/dsh-* peer 范围。本包两处声明同一条开放式下限(>=0.1.7-rc.2), 因此任何更新的 dsh 版本都会被放行,不必等插件发版;旧宿主读 peer,新宿主读 engines.dsh,pnpm smoke 会在两者判定不一致时判红。实测过的版本是证据、不是闸门, 见上表与 CHANGELOG。定时 canary 会把已发布插件装进 npm latest/next 里最新的 dsh,真实启动并跑活体探针——真的 API 断裂会变成 issue,而不是用户眼前的“不兼容”。 没有这道闸的更早宿主仍会加载插件,但表现为功能退化:实测 0.1.1-rc.2 上 8 个槽位注册成 7 个,turnTail 条目被拒(该槽位自 0.1.6-alpha.2 起由 chain 改为 list),打开会话、创建分支、跨会话搜索会提示对应服务缺失,而不是抛错。

安装

前置:Node 22+、pnpm,以及 dsh CLI(官方 npm 包 @deepseek-ai/dsh;未全局安装时,可用 npx @deepseek-ai/dsh 代替 dsh)。本版本放行所有 >= 0.1.7-rc.2 的 dsh:engines.dsh 与 @deepseek-ai/dsh-tools peer 都是开放式下限,所以 dsh 0.2.1-alpha.4 及更新版本(优先读 engines.dsh)与旧宿主(读 peer)都不会拒绝更新的 dsh。0.9.0 的构建与测试队列是 0.2.1-rc.3。产物用桌面版自带 CLI 装进隔离的 0.2.1-rc.3 profile,没有使用任何兼容豁免,随后真实冷启动:boot 图 71 行、五个 dsh.client.inject 目标齐全、客户端 bundle 200,371 字节、Mermaid 本地引擎 3,572,661 字节、state / 用量 / 备份路由、UTF-8 往返与桌面转发信任形状全部通过(16 项通过、1 项跳过;跳过的是无会话 profile 上的时间线/导出/搜索,该路径由单测覆盖)。2026-10-30 起构建与测试队列切到 0.2.1-rc.5(11 项客户端 seed 表未变),已发布的 0.9.3 产物也在其上复验:boot 图 71 行、五个 inject 目标齐全、bundle 以 208,217 字节服务、活体探针 16 通过 / 1 跳过;真实桌面版 0.2.1-rc.5 宿主上的桌面形态探针 11 通过 / 0 失败。0.8.0 的产物在 0.2.1-rc.2 上跑过同一套探针(70 行);0.6.0 的产物在 0.2.0-rc.2(66 行)与 0.1.7-rc.2(65 行)上各跑过 19 项里的 18 项;0.7.0 的产物额外在真实桌面安装上过了桌面形态活体探针(见下文「在 dsh 桌面版上」)。验不到的部分和以往一样:回合内的 chips(Mermaid 渲染、LaTeX)需要一次真实的模型回复,无凭据的临时家目录跑不出来,槽位渲染也仍要在浏览器里过一遍。宿主的兼容门分不清“实测过”与“没实测过”,所以写死上界会让每个新 dsh 版本都等到插件再次发版才可用;开放式下限加定时 canary 把这段等待换成自动发现。若确实要跑低于下限的宿主,请安装对应的旧版插件(0.5.0 面向 0.1.7-rc.2)。

从 npm 安装

dsh plugin --profile web add @alexpeng/dsh-custom-plugin
# 重启 dsh web

registry 上是预构建产物,安装端无需从源码构建。

在 dsh 桌面版上

dsh 桌面版是同一套 Web 应用外面的一层 Electron 壳,截至 2026-10-29 随包携带 正好是 dsh 0.2.1-rc.5——桌面发布线把壳和运行时钉成同一个版本,所以桌面端拿到 的永远是某一个确定的 0.2.x 运行时。0.9.0 的开放式范围收 rc.5 及之后的每个桌面构建, 安装不需要任何兼容性豁免;0.8.0 及更早用的是实测窗口,在 rc.5 上会被同一道门拒绝, 给出的信息和 0.2.x 的 Web profile 完全一样。

对 0.2.1-rc.5 的实测(已发布 0.9.3 产物):boot 图里 71 行、我们那一行与五个 inject 目标都在、客户端 bundle 以 208,217 字节服务、Mermaid 引擎本地加载,活体宿主探针 16 项通过、1 项跳过 (跳过的是需要真实会话的会话路径);真实运行中的桌面版 0.2.1-rc.5 宿主上,桌面形态 探针 11 通过 / 0 失败(1 项会话相关链路跳过)。访问围栏与官方 API 围栏同一套信任语义:回环 套接字 + 回环 Host、非 cross-site、origin 缺省或与 Host 一致即放行。壳在把 渲染进程的请求转发给它自己的 Host 之前会删掉 host、origin、sec-fetch-site、 cookie,再挂上它自己的凭证——这种无标记形状因此被直接接受(0.6.0 及之前的围栏 还额外要求同源标记,曾把这套形状全部误拒为 forbidden,0.7.0 起修复并补了围栏级 单测)。异源与跨站请求仍然 403。0.7.0 的产物已在真实桌面安装上按桌面转发形状 逐路由实测过(state / debug / backup / 用量扫描 / Mermaid 引擎预加载与脚本路由 全部 200,异源与跨站仍 403);0.8.0 在冷启动的 0.2.1-rc.2 宿主上复跑了同一套形状, 0.9.0 在 rc.3 上、0.9.3 在 rc.5 的真实桌面上再跑一遍(11 通过 / 0 失败)。 桌面窗口内的视觉验收(液态玻璃观感、面板布局、点阵清除)归装它的人过目。

管桌面 profile 要用桌面版自带的 dsh 命令,不是 npm 装的那个——公开 CLI 拒绝 保留的 desktop profile:

  1. 先启动一次桌面版让 profile 建立,然后完全退出(关窗口只是隐藏;Windows 上 从托盘退出)。
  2. dsh plugin --profile desktop add @alexpeng/dsh-custom-plugin
  3. 重新打开桌面版。应用内的插件管理器也用桌面版自带的 pnpm 在同一个 profile 上 安装和更新,不想开终端就用它。

外观、提示词库、项目文件夹、星标和用量都存在 $DSH_HOME/custom-plugin-state.json,这个文件按设计由桌面版和 Web 共享——两 边各自持有自己的 profiles/<名字>,那里面只放代码不放这个文件——所以在两者 之间切换看到的是同一份数据。两个宿主因此可能同时写它,这就是状态替换把临时文 件按写入进程的 pid 命名的原因。

从 GitHub 安装(源码安装)

dsh plugin --profile web add github:AlexPeng07/dsh-custom-plugin
# 重启 dsh web

git 安装拉取的是源码,prepare 脚本会在安装端构建 lib/。pnpm ≥10 需要一次性授权该构建——把 pnpm 提示的确切包键复制进 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,再重新执行 add。走上方 npm 路线可免去构建授权。

本地链接(开发)

# 构建(本仓库根目录执行)
pnpm install
pnpm build
# 装入 web profile。链接路径不能含空格:Windows 上若源码路径含空格,
# 先创建无空格目录联接(如 F:\dsh-plugin-dev),再链接到联接路径
dsh plugin --profile web add link:F:/dsh-plugin-dev
# 重启 dsh web

包按官方组合包协议声明 manifest:package.json 的 dsh.bundle.patch 指向 cordis.patch.yml 配置层(行 id custom-plugin),dsh.client 声明浏览器半区。dsh plugin add 在 profile 目录内转发给 pnpm,安装后因该声明被自动加入 dsh.profile.bundles;浏览器半区经官方客户端模块系统按同一行加载。

配置

插件读写 $DSH_HOME/custom-plugin-state.json 单个 JSON 文档(默认 ~/.dsh,可用 DSH_HOME 环境变量覆盖),包含外观配置、文件夹、提示词、星标、兼容旧版的数据与最近 90 个北京时间日的用量账本;写入为原子写(临时文件 + 重命名),崩溃不会截断文档。

外观与功能开关(cfg 字段,均有默认值):

配置项 默认值 说明
bg 天青灰 default(无颜色)/ 20 组调色板名之一(深浅色通用;旧存档的 aurora 自动迁移为 default)
bgFx none none / ascii / shader(面板上的「关闭 / 字符 / 光影」);光影档在不支持 WebGL 的页面回退字符档
bgFxPreset flow 当前档位的预设:字符档 flow/rain/ocean/starfield/ripple/static,光影档 liquid/grain;另一档的 id 会重置为该档默认值
bgStrength standard 墨色强度 soft / standard / strong(柔和 / 标准 / 强烈),倍率 0.45 / 0.62 / 0.9;只缩放墨色阶,密度/速度/帧率不受影响。默认「标准」,深度与此前版本的「柔和」一致
bgFocus true 避让正文:正文读取列更淡、页面四周保持浓淡;false 时整页均匀,遮罩完全退出渲染管线
bgDensity、bgSpeed、bgFps、bgFontPx、bgOpacity、bgIntensity -1 面板覆盖值;-1 表示跟随预设,其余值一律 clamp 到当前预设声明的范围(字符档用五项,光影档用密度/速度/帧率/强度)
weather none none / snow / rain / sakura
glass true Custom 面板玻璃总开关
glassMode frost frost 毛玻璃 / liquid 液态玻璃
globalGlass true 全局浮层(弹窗/菜单/提示)加模糊
antiScroll false 防自动跳底
mermaid true Mermaid 图表自动就地渲染(含消息下方渲染按钮)
formula true LaTeX / MathML 复制按钮
monthlyBudgetCny 0 人民币月预算;0 表示关闭提醒
budgetWarningPercent 80 月预算预警百分比(1–100)

安全模型

  • 浏览器仅通过回环地址上的 /api/custom-plugin 路由与宿主通信;每条路由同时校验回环 socket 地址、回环 Host 头与浏览器同源标记(sec-fetch-site / Origin),X-Forwarded-For 永不信任。
  • 浏览器不会收到任何 DeepSeek 凭据。余额仅由宿主通过 DSH 自带的账号服务读取(deepseekAccount,与「设置 → 账号与余额」同源的充值 + 赠送钱包查询),浏览器只拿到钱包金额与账号页链接。余额模块不再接受 API Key、不提供 Key 表单,也不做自己的 Key 查询。
  • 旧版本写下的状态文档里可能还留着 apiKey 字段;它不再作为余额来源,不会发送给浏览器,也不会进入备份。余额模块在没有它时照常工作。
  • 会话导出与时间线数据全部停留在本机。

已知限制

  • Mermaid 引擎来自随插件安装的本地依赖,离线可用;仅当依赖缺失时回退 CDN 拉取(宿主在进程生命周期内缓存)。
  • 用量账本折叠自实时 session/event 记录,只保留最近 90 个北京时间日;错过实时事件时可手动「扫描」,扫描最多并发读取 4 个会话日志。
  • 用量面板会显示峰/闲 token 与费用分布,并提供官方价目链接;没有峰时字段的历史行会标记为“不精确”,不计入费用总额,重新扫描后可更新。
  • 余额只来自 DSH 账号钱包:未登录、或宿主没有账号服务时,卡片显示本机费用估算并提示到「设置 → 账号与余额」登录,没有 API Key 回退。
  • 费用按 DeepSeek 官方峰谷单价估算,仅供参考。
  • 色板在深色模式自动派生同色系深色变体(保留色相与低饱和)。
  • dsh 0.1.7 起支持自定义快捷键。快捷面板固定占用 Ctrl/Cmd+K(不带 Alt/Shift,且编辑器内不触发)。dsh 在 web 上的默认值是 Ctrl+Alt+K(桌面版默认才是裸 Ctrl+K),所以开箱并不冲突;但你可以把某个 dsh 命令重新绑到 Ctrl+K,那样两者会同时响应,请把其中一个换开。
  • DSH 当前没有公开的归档恢复接口;插件不会绕过官方边界修改底层注册表。
  • dsh 自带的 web profile 把 session-query 索引配成 openAt: never,即默认不启用全文搜索。此时会话内搜索改为直接扫描日志(按出现顺序,最多 100 条),快捷面板的跨会话搜索会显示 dsh 给出的不可用原因。

开发

pnpm typecheck      # 类型检查
pnpm test           # vitest 单元测试
pnpm build          # 构建 node ESM 库与浏览器 bundle 到 lib/
pnpm check:readme   # 双语 README 哈希一致性
pnpm smoke          # 构建后契约自检:加载器握手、dsh 会读的清单字段、
                    # patch 行、本地 Mermaid 引擎与真实引擎的失败路径 DOM 回归
pnpm canary         # 已发布插件对 npm latest/next 里最新的 dsh(需要 npm、bash、
                    # curl;--plugin <tgz> 可测本地构建)
pnpm bench:mermaid  # 合成长回合的 Mermaid 扫描/渲染基准(无头 Edge)

scripts/live-dsh-check.sh 是另一条手动探针,对着一个正在运行的隔离 dsh profile (DSH_HOME=… DSH_PORT=… bash scripts/live-dsh-check.sh),在真实会话数据上跑宿主侧全链路: 时间线、三种导出、搜索扫描路径、用量扫描、备份、Mermaid 引擎路由、客户端→宿主的诊断回环、 一次会还原并校验提示词库的 UTF-8 往返,以及访问围栏的三种形态(无标记回环放行、异源拒绝、跨站拒绝)。默认拒绝在真实的 ~/.dsh 上运行(需显式 ALLOW_REAL_DSH_HOME=1),逐项报 PASS/FAIL,被 SKIP 的项会计数并写进收尾行,任一失败即非零退出。 主 CI 没有可对话的宿主;定时的 compat-canary workflow 会对 npm latest/next 里最新的 dsh 自动跑这套探针,失败时开 issue。想看某一版的细节时再手动跑;槽位注册与渲染仍需按上文用浏览器过一遍。

scripts/desktop-shape-probe.mjs 是第三条探针,面向正在运行的 dsh 桌面版。 桌面版 0.2.1+ 让系统分配监听端口,所以用 DSH_PORT 传入它打印的(或正在监听的) 端口——旧版本默认是 19387。探针以桌面壳转发的请求形状(回环 Host、无 origin / sec-fetch-site)逐路由探测 state / debug / backup / 用量扫描 / Mermaid 引擎与 脚本路由,发现宿主已注册的会话后补跑时间线、三种导出与搜索;异源与跨站探针必须 仍是 403。用量扫描会重写当日台账,介意时把 DSH_HOME 指向临时家目录,其余探针 只读;GUI 里还没有会话时先发一条消息再重跑即可。

自己验一个新 dsh 版本只要四条命令,且全程不碰你自己的 harness 家目录:

mkdir -p /tmp/dshnext && cd /tmp/dshnext && npm init -y && npm i @deepseek-ai/dsh@<版本>
DSH_HOME=/tmp/dshnext-home node node_modules/@deepseek-ai/dsh/lib/bin.js plugin --profile web add <打包好的.tgz>
DSH_HOME=/tmp/dshnext-home node node_modules/@deepseek-ai/dsh/lib/bin.js --profile web --no-open --port 13999 &
DSH_HOME=/tmp/dshnext-home DSH_PORT=13999 COOKIE_JAR=/tmp/dshnext/jar.txt bash scripts/live-dsh-check.sh

范围是开放式下限,所以第二条命令会接受任何 >= 0.1.7-rc.2 的版本,不需要兼容豁免。 定时 canary 对 npm latest/next 里最新的版本自动执行这四步;发版前想测本地构建, 可跑 node scripts/compat-canary.mjs <版本> --plugin <打包好的.tgz>。

验桌面版发版要往前多走一步,因为仓库回答不了"用户装的那一版里到底是哪个 dsh": 桌面版把壳和 @deepseek-ai/dsh 钉成同一个精确版本,整套运行时打在 resources/app.asar 里。直接读装好的那个 app,命令只读不写,它会把内置版本连同 "本仓库声明的 engines.dsh / peer 范围收不收它(以及 dsh 实际会读哪道门)"一起打出来:

node scripts/desktop-runtime.mjs "D:/DSH"                    # 传安装目录
node scripts/desktop-runtime.mjs "D:/DSH/resources/app.asar" # 或直接传归档文件

拿到版本号后,再按上面四条命令对着它跑一遍。

许可证

Apache-2.0。部分代码参考 Nagi-ovo/voyager 与 unovue/inspira-ui。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。