Skip to content
Back to search

walioffice-dsh-plugin

Deepseek Harness Walioffice 办公软件 插件

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--walioffice-dsh-plugin/badge.svg)](/listings/fuzhengwei--walioffice-dsh-plugin)

HTML

<a href="/listings/fuzhengwei--walioffice-dsh-plugin"><img src="/api/listings/fuzhengwei--walioffice-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.

以下命令适用于第一次安装。每条命令执行成功后,再执行下一条。

第 1 步:安装 DSH

如果还没有安装 DSH,执行:

npm install --global @deepseek-ai/dsh

确认 DSH 命令可用:

dsh --version

第 2 步:安装 WaLiOffice 插件

插件必须安装到 `web` profile,执行:

dsh plugin --profile web add walioffice-dsh-plugin

如果需要安装指定版本,把 `<版本号>` 替换成实际版本,例如 `0.1.15`:

dsh plugin --profile web add walioffice-dsh-plugin@<版本号>

查看插件是否已经安装:

dsh plugin --profile web list

输出中应能看到 `walioffice-dsh-plugin`。不要省略 `--profile web`,否则插件可能被安装到其他 profile,Web 界面不会加载。

第 3 步:启动 DSH Web

在安装插件的同一个终端中执行:

dsh web

然后打开 DSH Web 页面。若安装插件前已经启动了 `dsh web`,请先停止旧进程,再重新执行上面的启动命令,并刷新浏览器页面。

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 · 491 lines
  1. # walioffice-dsh-plugin
  2. `walioffice-dsh-plugin` 是可直接安装到 DeepSeek Harness(DSH)Web profile 的办公工具插件。插件以单个 npm 包发布,安装后一次注册 10 个办公工具,并自动注入 WaLiOffice Web 界面,无需复制源码到 DSH 仓库。
  3. ## 兼容要求
  4. - DSH:支持 Web profile,并建议使用与插件 peer dependencies 匹配的最新版
  5. - Node.js:`22.19+` 或 `24+`
  6. - npm:用于安装 DSH 与插件;pnpm 仅用于源码开发
  7. - LLM:基础办公工具使用 DSH 已配置的 LLM provider
  8. 插件运行在 DSH 的 `web` profile 中;只安装到其他 profile 不会自动启用 Web 界面。
  9. ## 工具清单
  10. | 工具 | 功能 | 输出 |
  11. | --- | --- | --- |
  12. | `ppt_plan` | 生成 PPT 大纲与页面规划 | JSON |
  13. | `ppt_generate` | 生成完整演示文稿 | `.pptx` |
  14. | `doc_generate` | 生成 Word 文档 | `.docx` |
  15. | `md_generate` | 生成 Markdown 文档 | `.md` |
  16. | `sheet_generate` | 生成结构化表格 | `.xlsx` |
  17. | `chart_generate` | 生成 ECharts 图表配置 | JSON |
  18. | `drawio_generate` | 生成 draw.io 图表 | XML |
  19. | `image_prompt` | 调用 Agnes Image API 生成图片 | 图片 URL |
  20. | `wali_video_generate` | 调用 Agnes Video API 生成视频 | 视频 URL |
  21. | `video_storyboard` | 生成视频分镜方案 | JSON |
  22. 生成的 `.pptx`、`.docx`、`.xlsx` 和 `.md` 文件默认保存在启动 DSH 时工作目录下的 `output/` 目录。图片与视频工具返回远程资源 URL,不会自动把远程资源下载到该目录。
  23. ## Web 界面
  24. 安装后,DSH Web 会增加 WaLiOffice 客户端界面:
  25. - 输入框上方的办公类型栏,可选择 Word、Markdown、Excel、PPT、图表、Draw.io、图片和视频
  26. - 综合模式会按交付物类型主动路由工具;明确要求文件类型时优先遵循用户指定,不会把“只要图表”误判为 Excel
  27. - 页面右侧的 WaLiOffice 面板,集中展示工具入口与最近产物
  28. - 10 个办公工具的专属执行结果卡片
  29. - 工具执行完成后,产物自动进入右侧预览与汇总列表
  30. ## 安装前准备
  31. 安装前请确认已经具备以下条件:
  32. 1. 已安装 Node.js `22.19+` 或 `24+`。
  33. 2. 已安装 npm。npm 会随 Node.js 一起安装。
  34. 3. DSH 支持 `web` profile。
  35. 4. 已在 DSH 中配置基础 LLM provider。文档、表格、PPT、图表和 Draw.io 工具都使用该 provider。
  36. 先逐条检查版本:
  37. ```bash
  38. node --version
  39. ```
  40. ```bash
  41. npm --version
  42. ```
  43. 如果电脑中已经安装 DSH,再检查 DSH 版本:
  44. ```bash
  45. dsh --version
  46. ```
  47. ## 安装
  48. 以下命令适用于第一次安装。每条命令执行成功后,再执行下一条。
  49. ### 第 1 步:安装 DSH
  50. 如果还没有安装 DSH,执行:
  51. ```bash
  52. npm install --global @deepseek-ai/dsh
  53. ```
  54. 确认 DSH 命令可用:
  55. ```bash
  56. dsh --version
  57. ```
  58. ### 第 2 步:安装 WaLiOffice 插件
  59. 插件必须安装到 `web` profile,执行:
  60. ```bash
  61. dsh plugin --profile web add walioffice-dsh-plugin
  62. ```
  63. 如果需要安装指定版本,把 `<版本号>` 替换成实际版本,例如 `0.1.15`:
  64. ```bash
  65. dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
  66. ```
  67. 查看插件是否已经安装:
  68. ```bash
  69. dsh plugin --profile web list
  70. ```
  71. 输出中应能看到 `walioffice-dsh-plugin`。不要省略 `--profile web`,否则插件可能被安装到其他 profile,Web 界面不会加载。
  72. ### 第 3 步:启动 DSH Web
  73. 在安装插件的同一个终端中执行:
  74. ```bash
  75. dsh web
  76. ```
  77. 然后打开 DSH Web 页面。若安装插件前已经启动了 `dsh web`,请先停止旧进程,再重新执行上面的启动命令,并刷新浏览器页面。
  78. ## 配置
  79. ### 基础办公工具
  80. 基础办公工具默认使用 DSH 已配置的 LLM。如果需要明确指定 provider 和模型,请在启动 DSH 之前,在同一个终端逐条执行:
  81. ```bash
  82. export WALIOFFICE_LLM_PROVIDER=deepseek
  83. ```
  84. ```bash
  85. export WALIOFFICE_LLM_MODEL=deepseek-chat
  86. ```
  87. 然后启动 DSH:
  88. ```bash
  89. dsh web
  90. ```
  91. 插件的配置优先级如下:
  92. 1. `WALIOFFICE_LLM_PROVIDER`、`WALIOFFICE_LLM_MODEL`
  93. 2. `DSH_LLM_PROVIDER`、`DSH_LLM_MODEL`
  94. 3. DSH 自身已配置的 LLM provider
  95. ### 图片和视频工具(可选)
  96. 只有使用 `image_prompt`、`wali_video_generate` 或 `video_storyboard` 时,才需要额外配置图片或视频 API。配置图片 API 时,逐条执行:
  97. ```bash
  98. export AGNES_IMAGE_BASE_URL=https://your-image-api.example.com
  99. ```
  100. ```bash
  101. export AGNES_IMAGE_API_KEYS=key-1,key-2
  102. ```
  103. 图片工具使用的模型是 `agnes-image-2.1-flash`。如果 DSH 通过 `~/.dsh/settings.yaml` 管理模型,请确保该模型已经配置。
  104. 配置视频 API 时,逐条执行:
  105. ```bash
  106. export AGNES_VIDEO_BASE_URL=https://your-video-api.example.com
  107. ```
  108. ```bash
  109. export AGNES_VIDEO_API_KEYS=key-1,key-2
  110. ```
  111. 视频工具使用的模型是 `agnes-video-v2.0`。如果 DSH 通过 `~/.dsh/settings.yaml` 管理模型,请确保该模型已经配置。
  112. 配置完成后,必须在同一个终端启动 DSH:
  113. ```bash
  114. dsh web
  115. ```
  116. 如果不使用 `AGNES_*` 变量,也可以使用兼容变量 `LLM_IMAGE_*`、`LLM_VIDEO_*`。插件还支持从 DSH 的 `~/.dsh/settings.yaml`、`~/.dsh/.credentials.yaml` 读取配置。仓库中的 [`.env.example`](.env.example) 只是变量清单,DSH 不会自动加载 `.env` 文件。
  117. 不要把真实 API key 写入 README、提交到 Git,或发布到 issue。
  118. ## 使用
  119. ### 通过 Web 界面使用
  120. 1. 启动 DSH Web:`dsh web`。
  121. 2. 在输入框上方选择办公类型,或选择综合模式。
  122. 3. 输入任务要求,例如“根据下面的内容生成一份 PPT”或“把这组数据整理成 Excel”。
  123. 4. 等待工具执行完成。
  124. 5. 在右侧 WaLiOffice 面板查看预览、最近产物和汇总结果。
  125. 可直接尝试以下任务:
  126. ```text
  127. 生成一份关于人工智能入门的 PPT,包含 8 页,最后输出 pptx 文件。
  128. ```
  129. ```text
  130. 把下面的会议纪要整理成 Word 文档,并保存为 docx 文件。
  131. ```
  132. ```text
  133. 根据以下销售数据生成 Excel 表格,并增加一个按月份统计的图表。
  134. ```
  135. ### 查看生成文件
  136. `.pptx`、`.docx`、`.xlsx` 和 `.md` 文件默认写入启动 DSH 时所在目录的 `output/` 文件夹。先查看当前目录:
  137. ```bash
  138. pwd
  139. ```
  140. 再查看生成的文件:
  141. ```bash
  142. ls -la output
  143. ```
  144. 图片和视频工具返回远程资源 URL,不会自动下载到 `output/`。
  145. ## 升级
  146. ### 升级 WaLiOffice 插件到最新版
  147. 为避免 profile 缓存或旧进程继续使用旧代码,推荐使用“停止 DSH → 删除旧插件 → 安装新插件 → 重启 DSH”的方式升级。
  148. 第 1 步,停止正在运行的 `dsh web`。在运行该命令的终端按 `Ctrl+C`。
  149. 第 2 步,删除旧版本插件:
  150. ```bash
  151. dsh plugin --profile web remove walioffice-dsh-plugin
  152. ```
  153. 第 3 步,安装最新版插件:
  154. ```bash
  155. dsh plugin --profile web add walioffice-dsh-plugin@latest
  156. ```
  157. 第 4 步,确认插件版本:
  158. ```bash
  159. dsh plugin --profile web list
  160. ```
  161. 也可以先查看 npm registry 当前的最新版:
  162. ```bash
  163. npm view walioffice-dsh-plugin version --registry=https://registry.npmjs.org/
  164. ```
  165. 然后安装返回的明确版本号:
  166. ```bash
  167. dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
  168. ```
  169. 第 5 步,重新启动 DSH Web:
  170. ```bash
  171. dsh web
  172. ```
  173. 最后刷新浏览器页面。如果页面仍显示旧界面,请完全关闭旧的 DSH 进程后再启动一次。
  174. ### 升级 DSH
  175. 先查看当前 DSH 版本:
  176. ```bash
  177. dsh --version
  178. ```
  179. 升级到 npm 上的最新版:
  180. ```bash
  181. npm install --global @deepseek-ai/dsh@latest
  182. ```
  183. 再次确认升级结果:
  184. ```bash
  185. dsh --version
  186. ```
  187. 升级 DSH 后重新启动 Web:
  188. ```bash
  189. dsh web
  190. ```
  191. 如果升级 DSH 后出现插件兼容或页面加载问题,按“升级 WaLiOffice 插件到最新版”中的步骤重新安装插件。
  192. ### 回退到指定插件版本
  193. 第 1 步,删除当前版本:
  194. ```bash
  195. dsh plugin --profile web remove walioffice-dsh-plugin
  196. ```
  197. 第 2 步,安装需要回退的版本:
  198. ```bash
  199. dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
  200. ```
  201. 第 3 步,重启 DSH Web:
  202. ```bash
  203. dsh web
  204. ```
  205. ## 卸载
  206. 只卸载 WaLiOffice 插件,不会卸载 DSH:
  207. ```bash
  208. dsh plugin --profile web remove walioffice-dsh-plugin
  209. ```
  210. 卸载后重新启动 DSH Web:
  211. ```bash
  212. dsh web
  213. ```
  214. 如果还要卸载 DSH 本身,执行:
  215. ```bash
  216. npm uninstall --global @deepseek-ai/dsh
  217. ```
  218. ## 常见问题
  219. ### 安装后页面没有 WaLiOffice
  220. 确认插件安装在 `web` profile,并完整重启 `dsh web`。先检查插件:
  221. ```bash
  222. dsh plugin --profile web list
  223. ```
  224. 如果列表中没有插件,重新安装:
  225. ```bash
  226. dsh plugin --profile web add walioffice-dsh-plugin@latest
  227. ```
  228. 然后重启:
  229. ```bash
  230. dsh web
  231. ```
  232. ### 安装成功但工具不可用
  233. 先确认 DSH 的 LLM provider 已配置,再查看 DSH 日志。图片和视频工具还需要对应的 API 地址与密钥;基础文档、表格和演示工具不需要 Agnes API。
  234. ### 更新后仍然是旧版本
  235. 先查看 npm registry 上的最新版:
  236. ```bash
  237. npm view walioffice-dsh-plugin version dist-tags.latest --registry=https://registry.npmjs.org/
  238. ```
  239. 然后按顺序删除旧版、安装明确版本并重启:
  240. ```bash
  241. dsh plugin --profile web remove walioffice-dsh-plugin
  242. ```
  243. ```bash
  244. dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
  245. ```
  246. ```bash
  247. dsh web
  248. ```
  249. ### 生成文件在哪里
  250. 先检查启动 DSH 时的当前工作目录:
  251. ```bash
  252. pwd
  253. ```
  254. 再检查 `output/`:
  255. ```bash
  256. ls -la output
  257. ```
  258. 插件不会把产物写入 npm 全局安装目录。
  259. ## 本地开发
  260. 安装源码依赖:
  261. ```bash
  262. pnpm install
  263. ```
  264. 执行类型检查:
  265. ```bash
  266. pnpm run typecheck
  267. ```
  268. 构建插件 bundle:
  269. ```bash
  270. pnpm run bundle
  271. ```
  272. 检查 npm 打包内容:
  273. ```bash
  274. pnpm run pack:check
  275. ```
  276. 构建产物:
  277. ```text
  278. lib/index.js
  279. lib/index.d.ts
  280. lib/client.js
  281. cordis.patch.yml
  282. ```
  283. 本地打包并安装测试:
  284. 先生成本地 tarball:
  285. ```bash
  286. pnpm pack
  287. ```
  288. 再将下面的路径替换为实际生成的 tarball 路径:
  289. ```bash
  290. dsh plugin --profile web add /absolute/path/to/walioffice-dsh-plugin-<版本号>.tgz
  291. ```
  292. 最后启动 DSH Web:
  293. ```bash
  294. dsh web
  295. ```
  296. 发布前检查:
  297. ```bash
  298. pnpm run typecheck
  299. ```
  300. ```bash
  301. pnpm run bundle
  302. ```
  303. ```bash
  304. npm pack --dry-run
  305. ```
  306. `npm pack --dry-run` 应至少包含 `README.md`、`lib/index.js`、`lib/index.d.ts`、`lib/client.js`、`cordis.patch.yml` 和 `.env.example`。
  307. ## 项目结构
  308. ```text
  309. src/index.ts 对外发布入口
  310. cordis.patch.yml DSH 自动挂载配置
  311. packages/extensions/
  312. walioffice-dsh-office Office 服务与 LLM helper
  313. walioffice-dsh-office-bundle 10 个工具的聚合入口
  314. walioffice-dsh-office-render-* PPTX/DOCX/XLSX 渲染器
  315. walioffice-dsh-tool-* 各办公工具实现
  316. ```
  317. 根包构建时会把所有 `@walioffice/*` workspace 模块合并到 `lib/index.js`,最终安装者只需要安装 `walioffice-dsh-plugin` 一个包。
  318. ## 发布信息
  319. - npm 包:`walioffice-dsh-plugin`
  320. - 发布方式:公开 npm 包(`publishConfig.access=public`)
  321. - GitHub:<https://github.com/fuzhengwei/walioffice-dsh-plugin>
  322. - 市场摘要:为 DeepSeek Harness Web 提供文档、表格、演示文稿、图表、Draw.io、图片和视频生成能力
  323. - 推荐关键词:`dsh`、`dsh-plugin`、`deepseek-harness`、`office`、`pptx`、`docx`、`xlsx`
  324. ## License
  325. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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