dsh-excel-chat

dsh-excel-chat — 和 Excel 对话，把活干完

简体中文 | English

_{第三方（dsh.so）对发布版本做静态安全扫描与 安装运行验证：当前 风险 low、0 条严重/高危/中危发现、未检测到外部凭据。}

在 DeepSeek Harness 里用自然语言 操作 Excel：说一句“给 D 列加毛利公式、表头加粗、冻结首行、加筛选”，agent 会自动 调用 excel_operate 完成；每次编辑后自动体检公式有没有被弄坏，也可以让它 “检查这个表哪里算错了”并自动修复。所有工作都在对话里完成，不需要记 Excel 操作。

为什么用它

大多数“让 AI 改表格”的方案到执行就结束了——它把公式写下去，然后告诉你“已完成”。 这个项目在执行之后还有两步，那两步才是它存在的理由：

1. 它验证自己有没有改坏。 每次操作后自动体检：列内公式模式是否偏移、有没有 hardcode、引用是否失效、有没有循环引用。改坏了它会说，而不是等你打开 Excel 才发现。
2. 它给出改前改后的证据。 单元格级 diff、可回滚的审计日志、写进文件本身的健康报告。

第三件不太显眼但同样重要：核心能力不依赖 Excel。公式校验与修复、读写单元格、 样式、汇总、关联、透视表（写 XML）都是纯 JavaScript 实现的，macOS 和 Linux 上一样能跑； 只有需要真正调用 Excel 的功能（图表、原生透视表、PDF 导出）才要求 Windows。

最近更新

v0.43.0（2026-10-15）· 完整更新日志 · Releases

目录

• 为什么用它 · 最近更新
• 功能实录 · 架构 · 5 分钟上手
• 工具（先看懂文件 · 动手改文件 · 公式体检与修复 · 对比与图表）
• 评测与可靠性 · 已知限制 · 相关链接

想先看它跑起来？克隆仓库后 npm run demo 会在示例文件上走完 改表 → 体检 → 修复 → 复验 → 输出，打印引擎的真实输出 —— 不需要模型，也不需要先装 dsh。 完整输出与上手步骤见 5 分钟上手。

_{以前这里放的是 2026-08-15 录的演示（约 v0.23），界面和操作目录都已经变了，留着会误导。 现在随版本一起更新的是 npm run demo，并且有测试钉住它的输出 （少了一个阶段、或者修复失效了，测试会红）。一版新的界面录屏欢迎贡献。}

功能实录（对话内真实截图）

能力菜单：给文件就给你选项	数据洞察：自动发现数据问题

表格预览：对话内真网格	公式体检 + 自动修复：差异一目了然

下面这张是为什么敢让它动手：同一列公式，一行被静默弄坏，它指出来并修好—— 图中的异常位置、修复前后公式、健康分都是引擎真实输出。

四张截图都是 DeepSeek Harness Web 里真实模型调用工具后，在消息流工具行内 渲染出的结果：能力菜单、问题清单、可编辑表格、修复前后差异。

架构

flowchart LR
  U[用户自然语言] --> H[DeepSeek Harness]
  H --> P["excel_profile / excel_read · 结构速览 / 分页读取"]
  P --> M["excel_menu / excel_insight · 能力菜单 / 数据洞察"]
  M --> O["excel_operate / excel_task · 操作 DSL / 多步编排 / Goal 闭环"]
  O --> V["excel_validate_formulas · 公式体检"]
  V -->|异常| R["excel_autofix / excel_repair_formulas · 确定性修复 + LLM 修复"]
  V -->|干净| OUT[输出 workbook]
  R --> V2[复验]
  V2 --> OUT
  OUT --> X["excel_explain_formula / excel_diff_workbook / excel_undo · 解释 / 对比 / 可回滚"]

核心闭环：理解 → 操作 → 验证 → 修复 → 复验 → 输出；excel_task 的 goal 模式 把这条闭环升级为 Plan → Act → Observe → Verify → Replan 的 Agent 循环。

5 分钟上手

第一步：先看它做什么（不用装 dsh）

git clone https://github.com/hccccc01333/dsh-excel-chat && cd dsh-excel-chat
npm install && npm run demo

npm run demo 在示例文件的副本上跑一遍完整闭环，打印的是引擎的真实输出：

① 改表   「按区域汇总金额，输出到新表」
         销售台账-汇总：A1「区域」 B1「金额 合计」/ 华东 / 华北 / 华南 / 总计
② 体检   编辑后自动体检：87 个单元格，14 条公式 —— 检出 1 处异常
         · 销售台账!G9  [reference-offset]
③ 修复   销售台账!G9   =E9*F8  →  =E9*F9
④ 复验   异常 0 —— 公式列重新一致
⑤ 输出   repaired.xlsx + 审计日志（改前改后都在，可回滚）

注意第 ② 步：那处错误表里本来就有 —— 你只让它汇总，它顺手查了出来。 examples/sales-ledger.xlsx 就是仓库里那一份，没有任何真实业务数据—— 10 条编造的订单、3 个编造的区域。演示跑在临时副本上，仓库里的文件不会被改动。

第二步：接上对话

前提：已安装 DeepSeek Harness（dsh CLI 或桌面端）。

dsh plugin --profile demo add dsh-excel-chat      # 从 npm 安装
# 或从 GitHub 安装：
# dsh plugin --profile demo add github:hccccc01333/dsh-excel-chat
# 或本地 bundle 目录：
# dsh plugin --profile demo add ./bundle
dsh web --profile demo                             # 打开对话界面

_{想让我们知道有人在用？ 官方命令不上报任何东西，所以我们看不见使用者 —— 这个插件至今的公开安装计数是 0。 换成社区市场的可追踪 CLI 即可（命令与官方完全等价，只是额外上报一条匿名安装结果， 一个本地生成的安装 ID，不是账号、也不是人）：}

npx dsh1024 plugin --profile demo add dsh-excel-chat

_{它是第三方工具（MIT，源码）， 不是本项目的依赖。不想用就忽略这段，官方命令一直有效。}

装完先自检一次，确认宿主包隔离和引擎都正常：

dsh-excel-chat-doctor                              # npm 全局/npx 可用时
# 或 profile 内直接跑：
# ~/.dsh/profiles/demo/node_modules/.bin/dsh-excel-chat-doctor

把 examples/sales-ledger.xlsx 拖进对话，照着说三句，就能走完 理解 → 操作 → 验证 → 修复 → 复验 → 输出：

1. 「看一下这份台账有没有问题」——它会指出金额列里那一格公式的问题
2. 「修掉它」——修复后复验（这一步的判定是确定性的，不靠模型自我感觉）
3. 「按区域汇总金额，输出到新表」——生成汇总表，表头加粗、冻结首行

也可以换成别的说法，或者换成你自己的文件：

• “帮我把 report.xlsx 做成报表：D 列毛利、E 列合计、表头加粗、冻结首行、加筛选”
• “检查 sales.xlsx 的 D 列公式有没有错，不对的修掉”
• “按区域生成透视表，金额合计，再生成柱状图”

平台说明：公式校验/修复、读写单元格、样式、汇总、合并、邮件合并等功能跨平台； 图表创建/改参、原生透视表、图表 PNG 导出、PDF 导出需要 Windows + 本机安装 Excel。

锁定版本：dsh plugin --profile demo add dsh-excel-chat@0.43.0（不写版本默认 latest）。

切换输出语言（默认中文）：在 profile 的 cordis.patch.yml 里加一条覆盖—— - id: vera / config: / language: en。注意只翻译给人看的消息，工作簿里的数据 （汇总标签、生成的表名）不翻译，因为代码依赖它们。详见 docs/usage.md。

完整使用指南见 docs/usage.md，岗位用法（运营/产品/数分）见 docs/roles.md。

工具

按你想做什么分组，不是按代码模块。

先看懂文件

GitHub で README 全文を読む →