DSH Plugins
本仓库集中维护 DeepSeek Harness 插件。开发、构建、类型检查和发布验证共用一套工具;每个插件保留独立包名、版本、运行依赖、导出与 DSH 声明,并单独生成可安装的 .tgz。
| 目录 | 版本 | 入口 | 功能 | 包名 | 相近项目 |
|---|---|---|---|---|---|
| dsh-adb-connect | 0.1.0 | /adb-qr |
ADB 二维码配对与会话通知 | @plutocrown/dsh-adb-connect |
dsh-android-tool(二维码配对)、dsh-adb-ultimate(配对码与设备管理) |
| dsh-miloco | 0.3.0 | 设置 → Miloco 米家 | 米家设备、自动化及事件接入 | @plutocrown/dsh-miloco |
dsh-miloco-bridge、mira_miloco |
| dsh-open-xiaoai | 0.1.2 | 设置 → 小爱音箱 | 小爱原生识别、设置页与主会话选择 | @plutocrown/dsh-open-xiaoai |
Open-XiaoAI(音箱端客户端) |
| dsh-plugin-classifier | 0.1.0 | 设置 → 内置插件 → 按类型区分 | 按类型区分已安装插件的静态能力 | @plutocrown/dsh-plugin-classifier |
dsh-capability-menu、dsh-plugin-security-review、dsh-community-plugins |
| dsh-xiaomi-gateway | 0.2.1 | 侧边栏 | 小米网关页面与可选自动登录 | @plutocrown/dsh-xiaomi-gateway |
@eyaeya/xgg-cli(中枢极客版命令行)、dsh-mijia-sidebar(侧边栏设备控制) |
| dsh-skill-manager | 0.1.0 | 设置页 | 按模式开关技能 | @plutocrown/dsh-skill-manager |
dsh-mode-skills(0.5.1,侧栏;功能参照,本仓库重写)、dsh-skills-manager、dsh-modes、dsh-skill-mgr、@linxin666/dsh-client-ui-skill-explorer(不好用,还自定义 UI) |
| dsh-plugin-tts | 0.1.0 | 每条回复的朗读按钮 | 把助手回复转成语音 | @plutocrown/dsh-plugin-tts |
@memef1f1y/dsh-plugin-tts(0.7.2,本仓库 fork)、voice_for_dsh、dsh-speak、dsh-local-tts、dsh-talk、dsh-tts-speakout |
| dsh-mobile-remote(尚未放入) | 0.1.0 | 设置 → 手机连接 | 扫码用局域网地址打开同一份 DSH | dsh-mobile、dsh-plugin-qr-connect、dsh-pair、dsh-remote-web-ui、@linxin666/dsh-remote-bridge |
开发
本仓库插件尚未首次发布,不维护历史配置、旧数据格式或旧 Assistant 管理项目的兼容入口。首次发布前,配置与数据按当前版本设计;新增功能不引入旧字段转换、旧目录导入或历史版本迁移分支。
在本仓库根目录执行,使用 Bun 1.4.4 和 Node >=22.13:
bun install --frozen-lockfile
bun run check # 共享工具及全部插件的类型检查
bun run test # 运行已有离线测试;没有测试的插件跳过
bun run build # 为每个插件生成自己的 dist/
bun run validate # 类型检查、已有离线测试、构建
命令可指定一个或多个插件目录名,也支持完整包名:
bun run validate dsh-miloco
bun run build dsh-adb-connect dsh-xiaomi-gateway
进入任意插件目录后,bun run check / build / test / validate 等命令仍可使用;它们调用父目录的共用工具。依赖统一在仓库根安装,提交一份根 bun.lock。源码构建需要完整仓库;仅复制一个插件源码目录不会携带开发工具。
界面资源
静态样式使用独立 .css 文件,图标使用各插件 src/icons/(或 src/client/icons/)中的 .svg 文件:
import css from './client.css' with { type: 'text' };
import SettingsIcon from './icons/settings.svg?react';
共用构建工具把 CSS 文本和 SVG React 组件合入客户端脚本。样式仍由插件或组件生命周期负责挂载和卸载;SVG 使用 DSH 提供的 React,保留 currentColor 和传入的尺寸、样式及无障碍属性。消费者安装单个插件包即可,不需要 SVG 构建依赖,也不会为这些资源额外发起请求。
单独安装与发布包
bun run pack # 检查、测试、构建后分别打包
bun run pack dsh-miloco # 只打包一个插件
bun run verify:package dsh-miloco # 验证已有的实际 tarball
bun run verify # 全部检查、打包及独立安装验证
归档输出到各插件自己的 artifacts/。消费者只需要其中一个包:
dsh plugin --profile web add file:/absolute/path/plutocrown-dsh-miloco-0.2.0.tgz
每次发行验证都会在仓库外的临时目录安装该插件,使用生产依赖并用 Node 导入 Host、检查浏览器脚本。归档不含共享工具、源码测试、环境或凭据,不允许以 workspace: / file: / link: 引用父仓库或兄弟插件。安装和运行不需要本仓库、Bun、TypeScript 或其他插件;设备服务及具体功能的外部要求见各包 README。
需要 link: 开发时,先构建对应插件,再将插件目录链接到 DSH;不要链接本仓库根。各包原有 private / publishConfig 策略保留,打包命令不会自动发布 npm,也不会重启本机 DSH。
No comments yet. Be the first to write one.