Horizon215/dsh-plugins

dsh-plugins

Community client-UI plugins for DeepSeek Harness (dsh) — 社区开发的 DeepSeek Harness 客户端 UI 插件。

中文

五个即装即用的 Web UI 插件。当前从 GitHub 源码安装（npm 包稍后发布）：

git clone https://github.com/Horizon215/dsh-plugins.git
cd dsh-plugins
pnpm install && pnpm build
dsh plugin --profile web add file:./packages/prompt-templates file:./packages/token-stats file:./packages/quest-mascot file:./packages/previously-on file:./packages/mode-switcher

装完重启 dsh web 即可（插件声明了 dsh.bundle，会自动装配进 profile，无需手动改配置）。

🐳 dsh-quest-mascot —— 打工鲸伙伴

鲸鱼娘趴在输入框上

- 四套皮肤同一只鲸：标准=经典鲸 / PTC=极客鲸 / 极简=素素鲸 / 创造=星光鲸，跟随会话模式自动换装；右键可手动钉皮肤或恢复跟随
- 摸头杀：单击脸红冒爱心，连击有彩蛋（7 连击放烟花庆祝），双击转圈，悬停歪头；键盘 Enter 也能摸
- 跟着任务实时变脸：规划 📋 → 阅读 📖 → 思考 💭 → 打工 🔨 → 收工 🎉，卡住会晕圈，泡泡同步播报步骤+耗时
- 闲置久了趴着打瞌睡（1/5/15 分钟可调），点一下唤醒；安静模式只留表情不要语音
- 闲暇吐泡泡：上轮战报、今日统计（联动 token-stats 播报 ≈成本）、小贴士、四套性格俏皮话轮换
- 设置页「打工伙伴」：逐模式皮肤、安静模式、打瞌睡延迟；44 帧 512px AI 贴纸无损 WebP 内联，中英双语、尊重 reduced-motion

📊 dsh-token-stats —— Token 用量与成本统计

每轮用量条

- 每轮用量条：每轮对话末尾显示 输入 · 输出 | 缓存命中率 | 耗时 | ≈成本
- 本会话徽章：侧栏底部（设置按钮上方）实时显示当前会话 tokens + ≈成本 + 缓存命中率，附「今天 · 全部会话」全局一行
- 汇总仪表盘（设置 → 用量与成本）：后台扫描器覆盖全部会话（含从未打开过的），四格指标 + 缓存命中率 + 估算成本 + 总请求数，可一键重扫；清空统计不会被扫描复活
- 一个时间范围管全部：今天 / 近 7 天 / 近 30 天 / 全部 同时驱动仪表盘、趋势图、模型表
- 按天下钻：点击趋势图任意一天，看当天每个会话各烧了多少
- 使用趋势图：累计用量面积图，随对话动态增长；切换范围有描绘动画
- 按模型统计：分模型的 请求数 / tokens / ≈成本 / 单次均价，按事件真实时间归属
- 价格预设：内置 DeepSeek V4-Flash / V4-Pro / Kimi K3（人民币与美元）刊例价，可选手动微调；改价后所有展示实时重算

设置页

按天下钻

侧栏本会话徽章

📝 dsh-prompt-templates —— 提示词模板库

模板管理

- 输入框右侧新增模板按钮，保存常用提示词
- 一键插入到草稿（自动空行拼接）或插入并发送
- 模板增删改查，两步删除防误触；首次使用自带三条起步模板（可删）
- 数据保存在浏览器 localStorage，不上传任何服务器

🎬 dsh-previously-on —— 前情提要 + 交接单

前情提要卡

- 打开旧会话，输入框上方淡出美剧片头式回顾：目标 · 轮数/步数 · 最后活跃 · 未完成 TODO · 你上次说的话
- 📋 复制交接单：把目标 / 进展 / 待办 / 最近发言 / 涉及文件（从工具调用参数折叠）生成零 LLM 的 Markdown 交接单，一键进剪贴板
- 🚀 带去新会话：在同一工作区、以同一智能体模式新建会话并自动跳过去，交接单作为第一条消息排入队列——长任务轻装续跑
- 约 14 秒自动淡出；按会话记忆已读轮数，有新进展或静默 2 小时后才再次播报
- 零 LLM 消耗：全部由会话日志与官方投影确定性折叠；人类消息按来源过滤，不会把上下文注入当成你的发言

交接单带入新会话

🎛️ dsh-mode-switcher —— 模式切换器
模式胶囊条

- 输入框上方一排模式胶囊：Plan · 审查 · 快答，点一下切换、再点退出，激活常亮
- 驱动官方 Plan 模式而非重造：Plan 胶囊走 /plan 命令通道，官方 Plan 芯片、输入框占位文案、exit_plan_mode 流程全部跟随
- 审查模式：改编自 OpenAI Codex 的审查 rubric（Apache-2.0）——只读审查、发现按 [P0]–[P3] 分级、结尾一行总体结论
- 快答模式：改编自 Codex 默认协作模式——先给答案、合理假设优于追问、最少工具调用
- 状态只落日志：modeswitch/mode 会话事件最后一条生效，刷新/恢复/分叉后模式都在；提示词段注入可在会话日志 request/header 里验证
- 也支持斜杠命令：/mode review /mode quick /mode off

Plan 模式联动

审查模式实战

兼容性

- 需要 dsh ≥ 0.1.0-rc.5（在 0.1.0-rc.5 / 0.1.0-rc.6 上验证通过）
- 仅 Web UI（dsh web），TUI/headless 不受影响
- 所有数据仅存浏览器本地；成本为估算值，以供应商账单为准

卸载

dsh plugin --profile web remove @your-scope/dsh-prompt-templates @your-scope/dsh-token-stats @your-scope/dsh-quest-mascot @your-scope/dsh-previously-on @your-scope/dsh-mode-switcher

本地开发

pnpm install
pnpm typecheck   # 类型检查（对齐官方 monorepo 的严格度）
pnpm build       # 产出 packages/*/lib/client.js

构建预设 build/client-bundle.mjs 提取自官方仓库的 packages/client/tsdown.client.ts（MIT），
包含模块表 externals、纯净性检查和 CSS Modules 内联，与官方插件的构建产物结构完全一致。

English

Five drop-in client-UI plugins for the DeepSeek Harness web UI. Install from source (npm packages coming soon):

git clone https://github.com/Horizon215/dsh-plugins.git
cd dsh-plugins
pnpm install && pnpm build
dsh plugin --profile web add file:./packages/prompt-templates file:./packages/token-stats file:./packages/quest-mascot file:./packages/previously-on file:./packages/mode-switcher

Restart dsh web afterwards — the packages declare dsh.bundle, so they join the profile automatically (no manual config edits).

dsh-quest-mascot — quest whale companion

- A Q-version whale-hoodie girl perched on the composer — always in view, never in the way
- Reacts live: thinking 💭 → working 🔨 → done fireworks 🎉 (or dizzy when stuck)
- Blows slow spout bubbles after ~8s idle: quest report & today stats (≈cost via token-stats price config), tips, quips
- Chinese & English follow the UI locale; in-memory only, nothing uploaded

dsh-token-stats — token usage & cost

- Per-turn chip under each completed turn: input · output | cache hit | duration | ≈cost
- This-session badge at the sidebar foot (above Settings): tokens + ≈cost + cache-hit detail, plus a "today · all sessions" line
- Aggregate dashboard (Settings → Usage & Cost): a background scanner covers every session (even never-opened ones) via the same loopback RPC the UI uses — four-bucket cards, cache-hit bar, estimated cost + request count, one-click rescan; reset survives rescanning
- One range scopes everything: Today / 7d / 30d / All drives dashboard, trend chart and model table together
- Day drill-down: click any day in the trend chart for that day's per-session breakdown
- Usage trend: cumulative area chart, growing live as turns complete
- 价格预设：DeepSeek V4-Flash / V4-Pro / Kimi K3 标价（人民币与美元），可自由编辑；每次显示都实时重新计价

dsh-prompt-templates — 提示词模板库

- 输入框工具栏按钮打开管理弹窗：创建 / 编辑 / 删除模板
- 插入 追加到草稿（以空行连接）；插入并发送 立即发送
- 三个初始预设（中文）在空库中一次性植入——删除后永不复活
- 模板持久化在浏览器 localStorage 中——数据不离开本机

dsh-previously-on — “前情提要……”回顾 + 交接

- 重新打开旧会话时，一张 电视风格回顾卡片 会在输入框上方淡入：目标 · 轮次/步数 · 最后活跃时间 · 待办 TODO · 你的最后发言
- 📋 复制交接 —— 将目标 / 进度 / TODO / 最后发言 / 涉及的文件（来自工具调用参数）折叠成一份零 LLM 的 Markdown 交接文档，直接送入剪贴板
- 🚀 带入新会话 —— 在 同一工作区 以 同一 agent 预设 创建新会话，跳转过去并将该文档作为首条消息排队：长任务轻装继续，不受旧会话上下文膨胀拖累
- 约 14 秒后自动淡出；按会话记录关闭状态，仅在进度更新或静默 2 小时后重新显示
- 零 LLM 成本 —— 从会话日志和官方投影确定性折叠而成；人类发言按消息来源类型过滤

dsh-mode-switcher — 协作模式胶囊

- 输入框上方的一键模式胶囊：Plan · Review · Quick —— 点击切换，再次点击退出
- 驱动官方 plan 模式，而非重新实现：通过命令通道执行 /plan /plan off，读取宿主投影回执；在没有 plan 模式的部署中胶囊隐藏
- Review 模式 —— 改编自 OpenAI Codex 的审查准则（Apache-2.0）：只读审查者立场，发现项标记为 [P0]–[P3]，一行结论
- Quick 模式 —— 改编自 Codex 的默认协作模式：先回答，以假设代替提问，最少工具
- 仅日志状态：最后一个 modeswitch/mode 事件生效——在重载/恢复/分叉后依然保留；注入的提示词段落可在会话日志的 request/header 中验证
- 也支持斜杠命令：/mode review /mode quick /mode off

兼容性与隐私

- 需要 dsh ≥ 0.1.0-rc.5（已在 rc.5/rc.6 上验证），仅限 Web UI
- 所有数据保存在浏览器 localStorage 中；费用为估算值——以你的服务商账单为准

开发

pnpm install && pnpm typecheck && pnpm build

构建预设（build/client-bundle.mjs）提取自上游仓库的
packages/client/tsdown.client.ts（MIT）——包含模块表外部依赖、包纯净性
门禁以及 CSS Modules 内联，产出的构件与第一方插件字节结构完全一致。

许可证

MIT