在 DeepSeek Harness 里对话完成 Excel 工作:建表、编辑、修复公式、图表校验,每次编辑后自动体检公式。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-excel-chat
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:hccccc01333/dsh-excel-chat#path:/bundle
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
简体中文 | English
第三方(dsh.so)对发布版本做静态安全扫描与 安装运行验证:当前 风险 low、0 条严重/高危/中危发现、未检测到外部凭据。


在 DeepSeek Harness 里用自然语言
操作 Excel:说一句「给 D 列加毛利公式、表头加粗、冻结首行、加筛选」,agent 会自动
调用 excel_operate 完成;每次编辑后自动体检公式有没有被弄坏,也可以让它
「检查这个表哪里算错了」并确定性修复。全程在对话里完成,不用记 Excel 的操作路径。
两个不一样的地方
一、编辑后自动体检,而不是改完就交差。
Excel 最烦的不是不会写公式,而是公式被静默弄坏——拖拽填充把范围截短、插入行后
引用错位、查找失败返回 #N/A,Excel 不报错,只是数字开始不对。本插件在每次
excel_operate / excel_task 之后自动跑一遍公式体检(列内 pattern 一致性、硬编码、
空行断链、循环引用、错误值),发现问题可以用确定性修复器改回来,并把修复前后差异
摆给你看。excel_undo 还能按审计日志整体回滚。
二、核心能力不依赖本机装 Excel。 公式校验/修复、读写、样式、汇总、合并、邮件合并、插入图片都是纯 XML 层实现, 在 macOS / Linux / Windows 上都能跑。只有图表创建改参、原生数据透视表、图表导出 PNG、视觉评审、PDF 导出需要 Windows + 本机 Excel(走 COM)。
安装
前提:已安装 DeepSeek Harness(dsh CLI 或桌面端)。
dsh plugin --profile demo add dsh-excel-chat
dsh web --profile demo
想让我们知道有人在用? 官方命令不上报任何东西,所以我们看不见使用者 —— 公开安装计数至今是 0。 换成社区市场的可追踪 CLI 即可(命令与官方完全等价,只是额外上报一条匿名安装结果):
npx dsh1024 plugin --profile demo add dsh-excel-chat
第三方工具(MIT),不是本项目的依赖。不想用就忽略,官方命令一直有效。
从源码或本地目录安装也可以(prepare 会自动构建):
dsh plugin --profile demo add ./bundle
5 分钟上手
仓库里带了一份没有真实业务数据的示例工作簿 examples/sales-ledger.xlsx
(10 条编造的订单),里面故意留了一格静默损坏的公式。拖进对话,照着说三句:
- 「看一下这份台账有没有问题」——它会指出金额列里那一格公式的问题
- 「修掉它」——修复后复验(判定是确定性的,不靠模型自我感觉)
- 「按区域汇总金额,输出到新表」——生成汇总表,表头加粗、冻结首行
不想先装 dsh 也行:克隆仓库后 npm run demo 会在示例文件的副本上跑一遍
「改表 → 体检 → 修复 → 复验 → 输出」,打印引擎的真实输出 —— 这五步都不需要模型。
输出内容由测试钉住,少一个阶段、或者修复失效了,测试会红。
对话里的快捷命令
| 命令 | 作用 |
|---|---|
/excel-set |
直接设置某个单元格的值(绕过规划器,最快路径) |
/excel-undo |
按审计日志回滚上一次 excel_operate 编辑 |
/excel-doctor |
自检:插件是否加载、工具注册数、bundle 与当前 dsh 是否兼容 |
工具没出现时先跑自检——它会把「插件没被加载」和「加载了但注册失败」区分开:
dsh-excel-chat-doctor # npm 全局 / npx 可用时
~/.dsh/profiles/demo/node_modules/.bin/dsh-excel-chat-doctor
切换语言
插件默认用中文输出(体检报告、数据洞察、能力菜单、修复摘要、操作警告、doctor 自检)。
在 profile 的 cordis.patch.yml 里加一条覆盖即可切成英文:
- id: vera
config:
language: en # zh(默认)| en
工作簿里的数据不会被翻译——汇总标签(总计)、生成的表名(-汇总)、岗位模板名
都是写进文件的产物,而且有代码依赖它们(patterns.ts 正是靠 总计/小计 识别并跳过
汇总行),翻译会让行为静默改变。用户自己的表名、列名、单元格内容当然也保持原样。
可以这么说
- 「帮我把 report.xlsx 做成报表:D 列毛利、E 列合计、表头加粗、冻结首行、加筛选」
- 「检查 sales.xlsx 的公式哪里错了并修复」
- 「按区域生成透视表和柱状图」
- 「这张表有什么问题?」——会先跑数据洞察 + 公式体检,再给下一步建议
- 「先给我看看这个文件」——输出列类型/缺失/唯一值/样例,以及建议读取范围
可靠性
144 个职场任务的自建评测语料
(ExcelBench lite:编辑 77 / 分析 27 / 公式 22 / 多步工作流 18),goal 模式 + glm-5.3-flash
全量实测任务成功率 86%(DeepSeek 基线 52%)。逐次跑分的公开结果表
由原始输出生成,任何人都能跑一行加进去;失败归因、复测方式与已知局限
都写在评测文档里。单元测试在 CI 上全绿(node --test tests/*.test.ts)。
工具(25 个)
理解文件
excel_read— 精确读取单元格状态(值/公式/类型/格式/合并/数据有效性)excel_profile— 大表速览:表头、每列类型/缺失/唯一值/区间/样例 + 建议读取范围excel_semantic_profile— 语义画像:列角色(时间/维度/指标/标识)、粒度、跨表关联键excel_menu— 不知道怎么描述就给菜单:一句话摘要 + 清洗/报表/透视/图表等可选方案excel_insight— 数据洞察:摘要 + 缺失/重复/异常值/负值/空格等体检 + 下一步建议excel_preview— 表格预览:Markdown 表格(对话内展示)+ HTML 预览文件
公式
excel_validate_formulas— 公式静默错误检测(列 pattern、hardcode、空行、循环引用、错误值)excel_compile_formula— Formula IR → 确定性 Excel 公式excel_explain_formula— 公式白话解释(函数、引用区域、跨表引用)excel_trace— 公式依赖链路:引用(它读了谁)/ 从属(谁读了它),可指定层数excel_find_errors— 列出所有错误值单元格,附产生它的公式与按错误码计数excel_repair_formulas— 确定性修复 + 可选 LLM 修复,输出.repaired.xlsx并复验 (可用autoTable自动识别表头)excel_autofix— 一键自愈:体检 → 修复 → 复检 → 人话汇报,附带隐藏健康报告表excel_health_report— 把体检报告写进工作簿本身(隐藏表:健康分 + 异常清单)
操作与任务
excel_operate— 职场级 Excel 操作:写值(自动类型识别)、填充/序列、行列增删、 复制/移动/转置、格式刷、公式转值、排序(多键/按颜色/自定义序列)、report一键 报表、分类汇总、动态透视、交叉表、两表关联回填、高级筛选、样式、数据有效性、 条件格式、自动筛选、结构化表格、插入图片、导入/导出 CSV(导出默认加公式注入 防护,导入会还原)、页面设置、页眉页脚、命名区域、冻结窗格、隐藏行列、分组折叠、 超链接、批注、迷你图、查找替换、工作表保护、邮件合并、数据清洗(去重/补空/分列/ 大小写/全角半角)、模糊匹配;操作后自动复验公式并写审计日志excel_task— 多步编排(每步自动体检/修复)+ goal 闭环(LLM 规划 → 执行 → 验证 → 未达成自动重规划)excel_undo— 按审计日志回滚excel_operate的编辑(单元格类型一并还原)excel_diff_workbook— 两个 workbook 的单元格差异
图表与导出
excel_validate_charts— 图表结构校验excel_validate_charts_visual— Excel 导出 PNG + 视觉 LLM 评审(Windows)excel_create_chart/excel_modify_chart— 用本地 Excel 创建与修改图表(类型、 标题、图例、坐标轴,Windows)excel_create_pivot— 原生数据透视表(多行/列字段、筛选器 + 值字段,Windows)excel_export_charts— 用本地 Excel 把图表导出为 PNG(Windows)excel_export_pdf— 用本地 Excel 把工作簿或单个工作表导出为 PDF(Windows)
实际效果
| 公式体检 + 自动修复:差异一目了然 | 数据洞察:自动发现数据问题 |
|---|---|
![]() |
![]() |

截图都是 DeepSeek Harness Web 里真实模型调用工具后、在消息流工具行内渲染出的结果。 更多截图与架构说明见 GitHub 仓库首页。
文档
开发
npm run build # 源码安装时 prepare 会自动执行
node --test tests/*.test.ts
License: MIT
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37546
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36997
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8164
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5864
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2147
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 1456
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。


社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。