办公文档读写 jiazekang/dsh-office

dsh-office

DSH Office 文档插件：Excel 读取 + 精准修改 + 办公文件拖入附件栏。

结构

packages/
dsh-office/ # Office 文档工具插件：Excel 读取/精准修改（exceljs）+ 拖入附件栏

常用命令（在仓库根目录执行）

pnpm install # 安装所有包依赖
pnpm --filter dsh-office build # 构建单个插件（tsc 类型检查 + tsdown 打包到 lib/）
pnpm --filter dsh-office smoke # dsh-office 冒烟测试（真实文件读写验证）
pnpm --filter dsh-office watch # 开发热构建
pnpm -r typecheck # 全部包类型检查

安装 / 联调（web profile）

把本地开发版挂到 web profile（link: 协议，改完重新 build 即生效）
dsh plugin --profile web add link:D:\Porject\DSH\dsh-office\packages\dsh-office

dsh-office 的 exceljs 是外部依赖，link: 开发模式下需单独装进 profile
dsh plugin --profile web add exceljs

不启动服务查看合并后的配置树，确认插件行已进入
dsh --profile web --dump-config

重启 dsh web 后生效

发布到 npm

cd packages/dsh-office
npm publish
用户安装：dsh plugin --profile web add dsh-office （npm 安装会自动带上 exceljs 依赖，无需手动装）

插件写法速记

- 插件 = 导出 name / inject / Config / apply 的 npm 包。
- 工具用 defineTool({ name, description, parameters, output, execute }) 定义，参数与输出都必须是 JSON Schema，output.render 返回 ContentBlock[]。
- 所有注册都包在 ctx.effect(fn, label) 里，卸载时自动清理。
- @deepseek-ai/* 运行时服务声明为 peerDependencies，构建时保持外部（deps.neverBundle），运行时由宿主进程解析，避免重复实例。
- 包内 cordis.patch.yml 用 insert 把插件行加进 roster；声明 dsh.bundle.patch 后 dsh plugin add 会自动把它加入 profile 的 bundles 层。

更完整的参考：@linxin666/dsh-ssh（服务端全流程）与 @linxin666/dsh-client-ui-task-board（客户端全流程），源码见 https://github.com/zhu1090093659/dsh-web-ui。