前言¶
DSH 插件机制允许在会话层补充宿主端命令。对于“打开某个常用网页”这类操作,如果每次都交给模型再返回动作,链路偏长,也不需要模型参与。
dsh-command-douyin 解决的是这个具体动作:在 DSH Web 会话中输入 /douyin,直接在默认浏览器打开网页版抖音。
这是什么¶
dsh-command-douyin 是一个 DSH 插件,维护者为 chu557,许可证为 MIT。
它的定位是宿主端命令插件:注册 /douyin 全局命令,在默认浏览器中打开:
https://www.douyin.com/?recommend=1
package.json 中包名为 dsh-command-douyin,版本为 0.1.0,private 为 true。
核心功能¶
命令注册¶
- 通过
ctx.commands(@deepseek-ai/dsh-commands)注册命令。 - Web 客户端的
/菜单可以自动发现该命令。 - 在任意会话输入框输入
/douyin并回车,或在/菜单中选择,命令直接执行,无需模型回合。
打开浏览器¶
插件使用 @deepseek-ai/dsh-native-command 的 runNativeCommand 打开目标地址,不同平台的调用方式如下:
- Windows:
rundll32 url.dll,FileProtocolHandler <url> - macOS:
open <url> - Linux:
xdg-open <url>
默认打开地址为:
https://www.douyin.com/?recommend=1
参数规则¶
/douyin 不接受参数。带参数时返回:
Usage: /douyin (no arguments)
安装与启用¶
下面是 web profile 的启用步骤。补丁层在启动时合成,运行中的实例不会热挂载新 bundle 或补丁行,因此完成安装或补丁变更后需要重启 dsh web。
真实目录复制方式¶
1、把插件包以真实目录复制到共享 node_modules。以下为 PowerShell 示例:
Copy-Item -Recurse -Force "<本目录>" "$env:DSH_HOME\profiles\node_modules\dsh-command-douyin"
这一步是把包放到 DSH Web profile 可发现的依赖位置。这里强调使用真实目录,而不是 junction 或符号链接。
2、在 $env:DSH_HOME\profiles\web\cordis.patch.yml 中加入补丁行:
- insert:
- id: command-douyin
name: 'dsh-command-douyin'
3、重启 dsh web:
dsh web
4、验证配置树中出现了命令:
dsh --profile web --dump-config
输出树中应出现 id: command-douyin 一行。
备选:正式 bundle 安装¶
如果环境中有 pnpm,可以使用正式 bundle 安装命令:
dsh plugin --profile web add link:<本目录的绝对路径>
该命令会在 profile 的 package.json 中登记依赖,并把 dsh-command-douyin 追加进 dsh.profile.bundles。完成后同样需要重启 dsh web。
依赖要求¶
package.json 声明了如下 peerDependencies:
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
"@deepseek-ai/dsh-native-command": "^0.1.0-rc.6"
}
宿主环境需要满足这些版本要求,否则依赖解析或命令注册可能失败。
典型用法¶
1、启动 DSH Web 会话后,在输入框输入:
/douyin
然后回车。
2、也可以在 / 菜单中选择对应命令。
3、执行后,默认浏览器会打开网页版抖音。
适用场景与注意¶
适合在 DSH Web 会话中经常打开抖音网页版、希望绕过模型回合的开发者或日常使用者。
安装前需要注意:
- 插件以当前
dsh进程权限运行,建议先检查源码与行为,再决定是否安装。 - 许可证为
MIT。 - Node ESM 会按真实路径解析依赖,junction 或符号链接可能导致
@deepseek-ai/dsh-native-command解析失败。 link:依赖经 pnpm 安装为链接形式,也可能遇到同样的 ESM 按真实路径解析问题;如遇加载失败,改用真实目录复制方式。- 补丁层在启动时合成,运行中的实例不会热挂载新 bundle 或补丁行,需要重启
dsh web。
相关地址¶
社区目录页:
https://www.skillhub.cn/plugins/chu557/douyin-plugin-dsh-plugin
GitHub 地址:
https://github.com/chu557/douyin-plugin-dsh-plugin