Skip to content
Back to search

wali-dsh-plugin

Deepseek Harness 宠物插件

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fuzhengwei--wali-dsh-plugin/badge.svg)](/listings/fuzhengwei--wali-dsh-plugin)

HTML

<a href="/listings/fuzhengwei--wali-dsh-plugin"><img src="/api/listings/fuzhengwei--wali-dsh-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install -g @deepseek-ai/dsh

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 365 lines
  1. # wali-dsh-plugin
  2. `wali-dsh-plugin` 是一个安装在 DSH Web 端的桌面宠物插件。安装后,页面右下角会出现一个悬浮宠物,它会跟随会话状态变化、展示提示卡片,并支持头像、背景图、股票主题等交互。
  3. ## 功能简介
  4. - 在 DSH Web 界面显示悬浮桌面宠物
  5. - 根据当前会话状态展示不同提示
  6. - 支持切换形象、上传头像、上传背景图
  7. - 支持切换“图片主题 / 股票 K 线主题”
  8. - 以 npm 插件形式分发,可通过 `dsh plugin` 安装
  9. - 无需修改宿主项目源码
  10. ## 前置要求
  11. 安装前请先确认:
  12. - 已安装 `Node.js` 与 `npm`
  13. - 本机可以访问 npm registry
  14. - 使用的是支持插件机制的 DSH 版本
  15. ---
  16. ## 快速开始
  17. 如果你只想先跑起来,按下面顺序执行即可:
  18. ### 1) 安装 DSH
  19. ```bash
  20. npm install -g @deepseek-ai/dsh
  21. ```
  22. ### 2) 确认 DSH 已安装成功
  23. ```bash
  24. dsh --version
  25. ```
  26. ### 3) 安装插件
  27. ```bash
  28. dsh plugin --profile web add wali-dsh-plugin
  29. ```
  30. ### 4) 启动 DSH Web
  31. ```bash
  32. dsh web
  33. ```
  34. 默认情况下,DSH Web 通常会运行在:
  35. ```text
  36. http://127.0.0.1:3080
  37. ```
  38. ### 5) 刷新页面确认插件生效
  39. 安装完成后,如果浏览器里已经打开了 DSH 页面,请手动刷新一次。如果插件是在 `dsh web` 已运行时安装的,建议直接重启一次 `dsh web`,再刷新页面。
  40. ---
  41. ## 1. 怎么安装 DSH
  42. 如果本机还没有安装 `dsh`,请先执行:
  43. ```bash
  44. npm install -g @deepseek-ai/dsh
  45. ```
  46. 安装完成后,使用下面的命令检查是否成功:
  47. ```bash
  48. dsh --version
  49. ```
  50. 如果你不想全局安装,也可以临时使用:
  51. ```bash
  52. npx @deepseek-ai/dsh --version
  53. ```
  54. ---
  55. ## 2. 怎么启动 DSH
  56. 启动 DSH Web:
  57. ```bash
  58. dsh web
  59. ```
  60. 如果你没有全局安装 `dsh`,也可以这样启动:
  61. ```bash
  62. npx @deepseek-ai/dsh web
  63. ```
  64. 启动成功后,通常可在浏览器打开:
  65. ```text
  66. http://127.0.0.1:3080
  67. ```
  68. 说明:
  69. - `dsh web` 启动后通常会持续占用当前终端
  70. - 如果你还要执行插件安装、更新、卸载命令,建议新开一个终端窗口操作
  71. ---
  72. ## 3. 怎么安装插件
  73. ### 安装最新版
  74. ```bash
  75. dsh plugin --profile web add wali-dsh-plugin
  76. ```
  77. ### 安装指定版本
  78. 例如安装 `0.1.2`:
  79. ```bash
  80. dsh plugin --profile web add wali-dsh-plugin@0.1.2
  81. ```
  82. ### 安装完成后要做什么
  83. 安装完成后,请执行以下动作:
  84. 1. 如果 `dsh web` 正在运行,先停止它
  85. 2. 重新启动 `dsh web`
  86. 3. 刷新浏览器页面
  87. 重启命令:
  88. ```bash
  89. dsh web
  90. ```
  91. ---
  92. ## 4. 怎么更新插件
  93. 当前最稳妥的更新方式是:先卸载旧版本,再安装新版本。
  94. ### 更新到最新版
  95. ```bash
  96. dsh plugin --profile web remove wali-dsh-plugin
  97. dsh plugin --profile web add wali-dsh-plugin@latest
  98. ```
  99. ### 更新到指定版本
  100. 例如更新到 `0.1.2`:
  101. ```bash
  102. dsh plugin --profile web remove wali-dsh-plugin
  103. dsh plugin --profile web add wali-dsh-plugin@0.1.2
  104. ```
  105. ### 更新后必须重启
  106. 更新完成后,请重新启动 DSH Web 并刷新页面:
  107. ```bash
  108. dsh web
  109. ```
  110. ---
  111. ## 5. 怎么卸载插件
  112. 卸载命令:
  113. ```bash
  114. dsh plugin --profile web remove wali-dsh-plugin
  115. ```
  116. 卸载完成后,同样建议:
  117. 1. 停止当前运行中的 `dsh web`
  118. 2. 重新执行 `dsh web`
  119. 3. 刷新浏览器页面
  120. ---
  121. ## 6. 一套可以直接复制执行的命令
  122. ### 首次安装:安装 DSH + 安装插件 + 启动 Web
  123. ```bash
  124. npm install -g @deepseek-ai/dsh
  125. dsh --version
  126. dsh plugin --profile web add wali-dsh-plugin
  127. dsh web
  128. ```
  129. ### 插件更新到最新版
  130. ```bash
  131. dsh plugin --profile web remove wali-dsh-plugin
  132. dsh plugin --profile web add wali-dsh-plugin@latest
  133. dsh web
  134. ```
  135. ### 插件卸载
  136. ```bash
  137. dsh plugin --profile web remove wali-dsh-plugin
  138. dsh web
  139. ```
  140. ---
  141. ## 7. 怎么确认插件已经安装成功
  142. 安装后如果页面没有立即显示宠物,可按下面顺序检查:
  143. ### 方式一:检查配置里是否已经包含插件
  144. ```bash
  145. dsh web --dump-config | rg "wali-dsh-plugin|ui-pet"
  146. ```
  147. 如果输出里能看到 `wali-dsh-plugin` 或相关注入配置,说明插件已经写入到 `web profile`。
  148. ### 方式二:重启 DSH Web
  149. ```bash
  150. dsh web
  151. ```
  152. 然后刷新浏览器页面。
  153. ---
  154. ## 8. 插件使用说明
  155. 安装并刷新页面后:
  156. - 宠物会默认显示在页面右下区域附近
  157. - 点击宠物可打开交互菜单
  158. - 可上传头像、上传背景图、切换形象
  159. - 可切换到股票主题,并设置股票代码
  160. - 可填写 `Twelve Data API Key` 获取真实 K 线
  161. ### 股票主题说明
  162. - 默认使用内置演示 K 线数据,开箱即可预览效果
  163. - 在宠物菜单中切换到“股票主题”后,可设置股票代码,例如 `AAPL`、`TSLA`、`NVDA`
  164. - 支持输入多个股票代码,使用英文逗号分隔,例如 `AAPL, TSLA, NVDA`,卡片会自动轮播展示
  165. - 支持直接对接 `Twelve Data`:在菜单里填写 `Twelve Data API Key` 后,会自动请求官方 `time_series` 接口获取真实 K 线
  166. - 菜单里提供“获取 Twelve Data API Key”按钮,可直接跳转到 `https://twelvedata.com/account/api-keys`
  167. - 当前实现是浏览器前端直连,`API Key` 会保存在本地浏览器存储中;如果后续面向多人使用,更建议改成你自己的服务端代理
  168. ---
  169. ## 9. 常见问题
  170. ### 安装成功,但页面没有看到宠物
  171. 请依次检查:
  172. ```bash
  173. # 1) 确认插件已安装到 web profile
  174. dsh web --dump-config | rg "wali-dsh-plugin|ui-pet"
  175. ```
  176. ```bash
  177. # 2) 重启 dsh web
  178. dsh web
  179. ```
  180. 然后刷新浏览器页面。
  181. ### npm 已经有新版,但 `dsh plugin add` 还是装到旧版
  182. 这通常是因为本机 `pnpm` 使用了镜像源,镜像同步滞后。
  183. 可在 profile 目录写入官方 registry:
  184. ```bash
  185. printf 'registry=https://registry.npmjs.org/\n' > ~/.dsh/profiles/web/.npmrc
  186. ```
  187. 然后重新安装最新版:
  188. ```bash
  189. dsh plugin --profile web remove wali-dsh-plugin
  190. dsh plugin --profile web add wali-dsh-plugin@latest
  191. ```
  192. ### 启动 `dsh web` 报端口占用
  193. 说明已有旧的 `dsh web` 进程在运行。先停止旧进程,再重新启动即可。
  194. ---
  195. ## 10. 包地址
  196. - npm: `https://www.npmjs.com/package/wali-dsh-plugin`
  197. - repository: `https://github.com/fuzhengwei/wali-dsh-plugin`
  198. - issues: `https://github.com/fuzhengwei/wali-dsh-plugin/issues`
  199. ---
  200. ## 11. 本地开发
  201. 安装依赖并构建:
  202. ```bash
  203. pnpm install
  204. pnpm run bundle
  205. ```
  206. 监听开发:
  207. ```bash
  208. pnpm run watch
  209. ```
  210. ---
  211. ## 12. 发布
  212. 发布前会自动执行构建(`prepublishOnly`):
  213. ```bash
  214. npm version patch
  215. npm publish --access public
  216. ```
  217. 如需升级版本号,也可以使用:
  218. ```bash
  219. npm version minor
  220. npm publish --access public
  221. ```
  222. 或:
  223. ```bash
  224. npm version major
  225. npm publish --access public
  226. ```
  227. ---
  228. ## 13. 项目结构
  229. - `package.json`:npm 包配置与 DSH 声明
  230. - `cordis.patch.yml`:注入到 DSH profile 的 bundle patch
  231. - `src/index.ts`:宿主侧插件入口
  232. - `src/client/*`:浏览器端宠物实现
  233. ---
  234. ## 14. 维护说明
  235. - npm 发布只会带上 `files` 中声明的文件
  236. - 如果修改包名,需要同步更新 `cordis.patch.yml` 中的插件名

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.