dsh-plugin-office-fill-tool:用模板与台账批量生成 Office 文件

前言

在 DSH 里让模型帮用户「按模板填一批 Excel 或 Word」,常见做法是手写脚本、逐文件打开 Office,或把生成逻辑拆成多步工具调用。模板格式(边框、合并单元格、行级样式)一多,维护成本会上去;若还要把生成结果的路径列表回传给对话,还要再包一层返回结构。

下面介绍维护者 ten-feng 发布的 dsh-plugin-office-fill-tool(社区分类:工作流)。它把「模板 + 数据台账 → 批量文件 + 文件列表 JSON」收成插件能力,供 DSH 在 Windows 桌面环境下调用。

这是什么

dsh-plugin-office-fill-tool 是 DeepSeek Harness(DSH)插件:根据 Excel/Word 模板和数据台账批量生成 Office 文件,并向模型返回生成文件的目录与列表。简介原文为:DSH plugin: batch-generate Office files from templates and data ledgers。

插件通过 Cordis patch 接入 DSH 工具面;当前 package 版本为 0.2.0,许可证 MIT。社区目录页:ten-feng/dsh-plugin-office-fill-tool;源码与说明:GitHub 仓库。

核心功能

README 中明确的能力如下。

  1. batch_generate_files:传入 template、data、output_dir、mode,在后台生成文件,返回 folder、count、files。
  2. open_office_fill_tool:打开 Windows 图形界面,供手动操作。
  3. 模板类型:支持 Excel(.xlsx)与 Word(.docx)模板。
  4. 格式保留:生成时保留模板的单元格边框、行级格式、合并单元格等格式。

实现上,插件包内带有 Windows 可执行程序 bin/office fill tool.exe(及 _internal/ 依赖),由 DSH 在首次调用时执行本机 exe 完成生成。

安装与启用

环境要求:仅 Windows;DSH 版本 >= 0.2.1-rc.2(见 package.json 的 engines.dsh)。

从 GitHub 安装(README 原文命令):

dsh plugin --profile desktop add github:ten-feng/dsh-plugin-office-fill-tool

安装后重启 DSH,在插件页应看到 office fill tool。

也可使用本地目录或 tarball 安装:

dsh plugin --profile desktop add "C:\path\to\dsh-plugin-office-fill-tool"
dsh plugin --profile desktop add .\dsh-plugin-office-fill-tool-0.2.0.tgz

卸载:

dsh plugin --profile desktop remove dsh-plugin-office-fill-tool

DSH 生态采用「一切皆插件」的思路;社区目录站点 skillhub.cn 为独立索引,与 DeepSeek / 幻方无官方从属关系,安装前建议自行查看仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行,首次执行 exe 时部分安全软件可能拦截,需按本机策略放行。

典型用法

在 DSH 对话中,可让模型调用 batch_generate_files,并给出本机路径与模式,例如 README 中的示意:

用 batch_generate_files 生成文件:
template = C:...\模板.xlsx
data = C:...\台账.xlsx
output_dir = C:...\输出
mode = excel

返回结构示例:

{
  "folder": "C:\\...\\输出\\生成文件_20261025",
  "count": 9,
  "files": ["C:\\...\\A区.xlsx", "C:\\...\\B区.xlsx"]
}

需要图形界面逐项操作时,可调用 open_office_fill_tool,而不走批量参数路径。

适用场景与限制

适合:Windows 上已在 DSH 桌面 profile 中使用工作流类插件;有固定 Excel/Word 模板和 Excel 类数据台账,需要按行或按规则批量出文件,并把路径列表交给后续对话或工具链。

限制(README 原文):

  • 仅 Windows 可用(exe 为 Windows 程序)。
  • 生成配置和日志写在插件 bin/ 目录。
  • 第一次调用时 DSH 需要能执行本机 exe,部分安全软件可能拦截。

仓库根目录主要文件包括 index.js、cordis.patch.yml、package.json 与 bin/ 下的可执行文件;具体字段与 patch 行为以仓库当前版本为准。

结尾

dsh-plugin-office-fill-tool 把模板填充与台账驱动批量生成封装成 DSH 工具,并在对话中返回 folder / count / files,便于模型继续引用生成结果。非 Windows 环境无法使用;安装与调用前请核对 DSH 版本与 exe 执行策略。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜