A-G-guy/dsh-plus--packages-shared2

@dsh-plus/shared

dsh-plus workspace shared pure helpers (not a dsh plugin)

AI 分析

该插件暂无 AI 分析内容。

包名
@dsh-plus/shared
版本
0.1.17
许可证
MIT
最近更新
2026年9月12日

安装

此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗

DSH+

面向 DSH(DeepSeek Harness) 的增强插件集,发布于 npm @dsh-plus scope

License: MIT npm @dsh-plus Node pnpm dsh


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

插件一览

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

快速开始

环境要求

  • 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(不入库)。

许可证

MIT © 2026 agguy