DSH+

面向 DSH（DeepSeek Harness）的增强插件集，发布于 npm @dsh-plus scope

DSH+ 以 pnpm monorepo 形式维护一组 DSH 增强插件。每个插件都是独立的 ESM npm 包（cordis 约定导出），全部发布在 npm 的 @dsh-plus scope 下，可单独安装，也可经 @dsh-plus/bundle-main 聚合为一层有序的 cordis patch 统一装配。

插件一览

包	版本	类型	说明	文档
`@dsh-plus/ui-mobile-fit`	0.1.3	UI	纯 CSS 覆盖的移动端窄屏响应式适配，不 fork 上游、跟随升级	docs
`@dsh-plus/remote-settings`	0.1.0	UI	修复非 loopback 访问（loopback-rewrite 反代）下设置→模型目录报错与插件配置卡片不渲染	docs
`@dsh-plus/notify-email`	0.1.0	service + UI	任务完成 / 等待决策 / 出错停止时向指定邮箱发送邮件通知	docs
`@dsh-plus/llm-pi`	0.1.0	service + UI	基于 pi-ai 的自定义 LLM 路由：三协议 route、官方目录继承、全量 compat、models.dev 兜底	docs
`@dsh-plus/lifeboat`	0.1.0	service	故障救生艇：兄弟插件崩溃自动隔离（写 patch 层禁用）+ LLM 应急翻译 + 邮件告警	docs
`@dsh-plus/reload`	0.1.0	service + UI	设置页「重新加载」按钮与 `/reload` 命令：两段确认+倒计时后重启 dsh-web，恢复后自动刷新	docs
`@dsh-plus/usage-panel`	0.1.0	service + UI	全量会话 token 用量面板：实时+历史扫描双通道聚合，按日/模型报表，可选价目估算费用	docs
`@dsh-plus/access-gate`	0.1.0	service + UI	Web 访问围栏（已合并官方认证）：官方 cookie 为唯一凭据，未认证导航渲染 token 输入页（PWA 可恢复），可选 IP 附加围栏，loopback 管理通道取当前认证链接	docs
`@dsh-plus/boot-retry`	0.1.0	service	弱网引导重试：经官方 `__DSH_TRANSPORT__.loadBundle` 缝注入零缓存重试加载器，消除一次抖动导致的「Failed to load plugins」；不改 URL/不缓存，HMR 语义不变	docs
`@dsh-plus/subagent-model`	0.2.0	service	子代理独立模型配置：按 provider 为 subagent/subagent_fork 注入 agentOptions（provider/model/思考程度），`default` 条目共享单条路由；主代理显式选择仍优先	docs
`@dsh-plus/web-terminal`	0.1.0	service + UI	Web 终端工作台：多会话标签 + 桌面分屏（拖拽调宽）+ scrollback 回放，dsh 运行期间会话保活（类 tmux detach/attach）	docs
`@dsh-plus/tool-text-transform`	0.1.0	tool	纯函数演示工具（uppercase / lowercase / reverse / length），插件链路参考实现	docs
`@dsh-plus/bundle-main`	0.1.0	bundle	聚合编排层：按序 insert 正式插件行，单插件脱离 bundle 亦可独立安装	—
`@dsh-plus/shared`	0.1.0	library	工作区共享纯函数库（非插件）	—

快速开始

环境要求

Node.js ≥ 22（测试依赖 node --test 直接运行 TypeScript）
pnpm（经 corepack 启用）
已安装 DSH（@deepseek-ai/dsh，基准版本 0.1.5-rc.2）

安装到 DSH

所有包已发布到 npm，直接用 dsh plugin 安装即可（工作区内部依赖会正常解析）：

# 安装单个插件到 web profile
dsh plugin --profile web add @dsh-plus/ui-mobile-fit

# 或安装聚合包：cordis.patch.yml 会把全部正式插件按序装配进组合树
dsh plugin --profile web add @dsh-plus/bundle-main

安装后重启 dsh web 生效；带配置界面的插件在 webui「设置 → 插件 → 插件配置」中调整，持久化到 $DSH_HOME/settings.yaml 并热生效。

从源码构建

pnpm install      # 安装 workspace 依赖
pnpm build        # 构建全部插件（产物在 packages/*/lib）
pnpm lint         # biome 静态检查（lint + format + import 整理）
pnpm lint:fix     # biome 自动修复并格式化
pnpm test         # 运行全部单元测试（纯逻辑，无网络、零 API 费用）

# 本地开发：link 安装，配合 tsdown --watch 热更浏览器半
dsh plugin --profile web add link:packages/ui-mobile-fit

仓库结构

packages/
  ui-mobile-fit/        移动端窄屏适配（UI 覆盖）
  notify-email/         任务结束邮件通知
  llm-pi/               自定义 LLM 路由
  lifeboat/             故障救生艇（隔离/应急翻译/告警）
  reload/               设置按钮 + /reload 命令重启 dsh-web
  usage-panel/          用量统计面板（token 聚合/报表/费用估算）
  access-gate/          Web 访问围栏（合并官方认证 / token 输入页恢复 PWA / IP 附加围栏）
  web-files/            Web 内嵌类 SFTP 文件浏览与编辑
  web-terminal/         Web 终端工作台（多会话/分屏/保活）
  tool-text-transform/  演示工具（dev-only，不进生产 bundle）
  bundle-main/          聚合编排层
  shared/               共享纯函数库
scripts/
  dshctl.py             开发/分发入口（测试、mock 调试、dev 实例、npm 发版）
  dshctl/               dshctl 实现与 dsh-dev-mock 技能
  mock_llm.py           本机 mock LLM（开发零真实 API 费用）
  tests/                dshctl 单元测试

开发

python3 scripts/dshctl.py --help        # 全部子命令与用法
python3 scripts/dshctl.py test          # 静态检查 + 构建 + 单测
python3 scripts/dshctl.py dev up        # 起 dev 实例（mock LLM，零费用）

本机差异经环境变量配置（DSHCTL_DSH_BIN / DSHCTL_TS_HOOK_REPO / DSHCTL_TOKEN_FILES），或写入 scripts/dshctl/local_config.py（不入库）。

@dsh-plus/tool-text-transform

AI Analysis

Install

README