walioffice-dsh-plugin
WaLiOffice 办公工具套件 — DeepSeek Harness (DSH) 插件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:fuzhengwei/walioffice-dsh-plugin#6d886a0a5d8a92781deee13ddedaddd1ca07162dWalioffice Dsh Plugin 以 walioffice-dsh-plugin 发布，当前版本为 0.1.15。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
walioffice-dsh-plugin 是可直接安装到 DeepSeek Harness（DSH）Web profile 的办公工具插件。插件以单个 npm 包发布，安装后一次注册 10 个办公工具，并自动注入 WaLiOffice Web 界面，无需复制源码到 DSH 仓库。
22.19+ 或 24+插件运行在 DSH 的 web profile 中；只安装到其他 profile 不会自动启用 Web 界面。
| 工具 | 功能 | 输出 |
|---|---|---|
ppt_plan | 生成 PPT 大纲与页面规划 | JSON |
ppt_generate | 生成完整演示文稿 | .pptx |
doc_generate | 生成 Word 文档 | .docx |
md_generate | 生成 Markdown 文档 | .md |
sheet_generate | 生成结构化表格 | .xlsx |
chart_generate | 生成 ECharts 图表配置 | JSON |
drawio_generate | 生成 draw.io 图表 | XML |
image_prompt | 调用 Agnes Image API 生成图片 | 图片 URL |
video_generate | 调用 Agnes Video API 生成视频 | 视频 URL |
video_storyboard | 生成视频分镜方案 | JSON |
生成的 .pptx、.docx、.xlsx 和 .md 文件默认保存在启动 DSH 时工作目录下的 output/ 目录。图片与视频工具返回远程资源 URL，不会自动把远程资源下载到该目录。
安装后，DSH Web 会增加 WaLiOffice 客户端界面：
安装前请确认已经具备以下条件：
22.19+ 或 24+。web profile。先逐条检查版本：
node --version
npm --version
如果电脑中已经安装 DSH，再检查 DSH 版本：
dsh --version
以下命令适用于第一次安装。每条命令执行成功后，再执行下一条。
如果还没有安装 DSH，执行：
npm install --global @deepseek-ai/dsh
确认 DSH 命令可用：
dsh --version
插件必须安装到 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 界面不会加载。
在安装插件的同一个终端中执行：
dsh web
然后打开 DSH Web 页面。若安装插件前已经启动了 dsh web，请先停止旧进程，再重新执行上面的启动命令，并刷新浏览器页面。
基础办公工具默认使用 DSH 已配置的 LLM。如果需要明确指定 provider 和模型，请在启动 DSH 之前，在同一个终端逐条执行：
export WALIOFFICE_LLM_PROVIDER=deepseek
export WALIOFFICE_LLM_MODEL=deepseek-chat
然后启动 DSH：
dsh web
插件的配置优先级如下：
WALIOFFICE_LLM_PROVIDER、WALIOFFICE_LLM_MODELDSH_LLM_PROVIDER、DSH_LLM_MODEL只有使用 image_prompt、video_generate 或 video_storyboard 时，才需要额外配置图片或视频 API。配置图片 API 时，逐条执行：
export AGNES_IMAGE_BASE_URL=https://your-image-api.example.com
export AGNES_IMAGE_API_KEYS=key-1,key-2
图片工具使用的模型是 agnes-image-2.1-flash。如果 DSH 通过 ~/.dsh/settings.yaml 管理模型，请确保该模型已经配置。
配置视频 API 时，逐条执行：
export AGNES_VIDEO_BASE_URL=https://your-video-api.example.com
export AGNES_VIDEO_API_KEYS=key-1,key-2
视频工具使用的模型是 agnes-video-v2.0。如果 DSH 通过 ~/.dsh/settings.yaml 管理模型，请确保该模型已经配置。
配置完成后，必须在同一个终端启动 DSH：
dsh web
如果不使用 AGNES_* 变量，也可以使用兼容变量 LLM_IMAGE_*、LLM_VIDEO_*。插件还支持从 DSH 的 ~/.dsh/settings.yaml、~/.dsh/.credentials.yaml 读取配置。仓库中的 .env.example 只是变量清单，DSH 不会自动加载 .env 文件。
不要把真实 API key 写入 README、提交到 Git，或发布到 issue。
dsh web。可直接尝试以下任务：
生成一份关于人工智能入门的 PPT，包含 8 页，最后输出 pptx 文件。
把下面的会议纪要整理成 Word 文档，并保存为 docx 文件。
根据以下销售数据生成 Excel 表格，并增加一个按月份统计的图表。
.pptx、.docx、.xlsx 和 .md 文件默认写入启动 DSH 时所在目录的 output/ 文件夹。先查看当前目录：
pwd
再查看生成的文件：
ls -la output
图片和视频工具返回远程资源 URL，不会自动下载到 output/。
为避免 profile 缓存或旧进程继续使用旧代码，推荐使用“停止 DSH → 删除旧插件 → 安装新插件 → 重启 DSH”的方式升级。
第 1 步，停止正在运行的 dsh web。在运行该命令的终端按 Ctrl+C。
第 2 步，删除旧版本插件：
dsh plugin --profile web remove walioffice-dsh-plugin
第 3 步，安装最新版插件：
dsh plugin --profile web add walioffice-dsh-plugin@latest
第 4 步，确认插件版本：
dsh plugin --profile web list
也可以先查看 npm registry 当前的最新版：
npm view walioffice-dsh-plugin version --registry=https://registry.npmjs.org/
然后安装返回的明确版本号：
dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
第 5 步，重新启动 DSH Web：
dsh web
最后刷新浏览器页面。如果页面仍显示旧界面，请完全关闭旧的 DSH 进程后再启动一次。
先查看当前 DSH 版本：
dsh --version
升级到 npm 上的最新版：
npm install --global @deepseek-ai/dsh@latest
再次确认升级结果：
dsh --version
升级 DSH 后重新启动 Web：
dsh web
如果升级 DSH 后出现插件兼容或页面加载问题，按“升级 WaLiOffice 插件到最新版”中的步骤重新安装插件。
第 1 步，删除当前版本：
dsh plugin --profile web remove walioffice-dsh-plugin
第 2 步，安装需要回退的版本：
dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
第 3 步，重启 DSH Web：
dsh web
只卸载 WaLiOffice 插件，不会卸载 DSH：
dsh plugin --profile web remove walioffice-dsh-plugin
卸载后重新启动 DSH Web：
dsh web
如果还要卸载 DSH 本身，执行：
npm uninstall --global @deepseek-ai/dsh
确认插件安装在 web profile，并完整重启 dsh web。先检查插件：
dsh plugin --profile web list
如果列表中没有插件，重新安装：
dsh plugin --profile web add walioffice-dsh-plugin@latest
然后重启：
dsh web
先确认 DSH 的 LLM provider 已配置，再查看 DSH 日志。图片和视频工具还需要对应的 API 地址与密钥；基础文档、表格和演示工具不需要 Agnes API。
先查看 npm registry 上的最新版：
npm view walioffice-dsh-plugin version dist-tags.latest --registry=https://registry.npmjs.org/
然后按顺序删除旧版、安装明确版本并重启：
dsh plugin --profile web remove walioffice-dsh-plugin
dsh plugin --profile web add walioffice-dsh-plugin@<版本号>
dsh web
先检查启动 DSH 时的当前工作目录：
pwd
再检查 output/：
ls -la output
插件不会把产物写入 npm 全局安装目录。
安装源码依赖：
pnpm install
执行类型检查：
pnpm run typecheck
构建插件 bundle：
pnpm run bundle
检查 npm 打包内容：
pnpm run pack:check
构建产物：
lib/index.js
lib/index.d.ts
lib/client.js
cordis.patch.yml
本地打包并安装测试：
先生成本地 tarball：
pnpm pack
再将下面的路径替换为实际生成的 tarball 路径：
dsh plugin --profile web add /absolute/path/to/walioffice-dsh-plugin-<版本号>.tgz
最后启动 DSH Web：
dsh web
发布前检查：
pnpm run typecheck
pnpm run bundle
npm pack --dry-run
npm pack --dry-run 应至少包含 README.md、lib/index.js、lib/index.d.ts、lib/client.js、cordis.patch.yml 和 .env.example。
src/index.ts 对外发布入口
cordis.patch.yml DSH 自动挂载配置
packages/extensions/
walioffice-dsh-office Office 服务与 LLM helper
walioffice-dsh-office-bundle 10 个工具的聚合入口
walioffice-dsh-office-render-* PPTX/DOCX/XLSX 渲染器
walioffice-dsh-tool-* 各办公工具实现
根包构建时会把所有 @walioffice/* workspace 模块合并到 lib/index.js，最终安装者只需要安装 walioffice-dsh-plugin 一个包。
walioffice-dsh-pluginpublishConfig.access=public）dsh、dsh-plugin、deepseek-harness、office、pptx、docx、xlsxMIT