中文EN

@copylee/dsh-office

docs已测通过npmMIT

仅 Windows:Agent 通过办公软件的自动化接口,直接在你打开的 Word、Excel、PowerPoint(微软 Office 或 WPS Office)窗口里改文档,改动实时出现,你可以同时编辑;可读取结构、批量修改、把页面渲染成图片核对排版、保存或导出 PDF。

下载量 / Downloads
5,565
依赖体积 / node_modules
1.28 MB
测试时间 / Tested
2026-11-06
DSH 版本 / Version
0.2.2-rc.1

安装

dsh plugin --profile web add @copylee/dsh-office

沙箱测试结果

阶段结果
1 安装✓
2 列装✓
3 挂载✓
4 启动—

四阶段在隔离沙箱里跑:安装(有网)→ 列装 → 挂载 → 启动(后三步断网)。

README

dsh-office

![Awesome DSH Plugin](https://awesome-dsh-plugin.com)

![npm](https://www.npmjs.com/package/@copylee/dsh-office)

让 DeepSeek Harness 直接在你电脑上打开的 Word、Excel、PowerPoint 里改文档。AI 不改写文件,而是通过 Office 的自动化接口(COM)让应用自己执行修改,所以改动会实时出现在窗口里,你可以边看边一起编辑,格式不会因为换工具保存而走样。

仅支持 Windows,需要本机装有微软 Office 或 WPS Office。

上图是一次真实操作的录屏(只录了 Word 窗口):AI 按要求写出标题、导语和表格,随后检查排版并修正。下图是对话里的交付结果,以及设置页。

对话与交付的文件 · 设置页

![对话:AI 说明文档结构并交付 读书会通知.docx](assets/chat.png) · ![设置 → Office:应用状态、办公套件、行为开关](assets/settings.png)

功能

功能 · 说明

在打开的文档里改 · 文件正开着也能改(直接改文件的做法这时会因为文件被占用而失败);文件已经打开就直接接着用,不会再开一份

实时可见,可以一起改 · 每一步修改即时出现在 Word / Excel / PowerPoint 窗口里。你可以同时在里面打字、调格式,AI 每次动手前读到的都是文档当下的样子

不需要窗口在前台 · 修改不靠鼠标键盘,Office 窗口被挡住或在后台也照常进行,你可以同时用电脑做别的事

静默模式 · 在设置里开启后,AI 在后台完成工作:不弹出 Word、Excel、PowerPoint 的窗口,不显示迷你卡片,文字一次写入。Word 和 Excel 用一个单独的、不可见的实例(不碰你正开着的窗口),PowerPoint 以无窗口方式打开文稿;渲染检查照常进行。回合结束时,后台打开的文档自动保存并关闭,后台实例随之退出。你自己已经打开着的文档仍在原处修改,只是不滚动、不弹卡片。Excel 的纯数据处理此时允许 AI 借助 Python(在工作簿未打开时),图表与格式仍由 Excel 自己完成;Word 和 PowerPoint 始终由 Office 排版。确需操作窗口时,AI 可以用 office_open {show: true} 把文档调出来。后台文档打开期间你在资源管理器里双击同一个文件:Word 和 Excel 会提示文件正在使用(可以只读打开,不影响 AI 的工作);PowerPoint 只有一个进程,文稿会直接显示出来,AI 继续写,回合结束时保存但不再替你关闭

跟随与静默 · 默认“跟随”:AI 改到哪里,窗口自动滚动到哪里(Word 滚到那一段,Excel 滚到那片单元格,PowerPoint 切到那一页),不动你的光标和选区。关闭即静默执行,不动你的视图

逐字写入 · 文字分小段写出,像打字一样出现,表格逐行填入,而不是整块贴上去。每段约多花 0.3 秒,可关闭

迷你卡片 · AI 每次动手修改文档时,屏幕右下角出现一张小卡片:正在改哪个文档、改到第几项,带“查看”“快速”两个开关(“快速”亮起时文字一次写入,熄灭时逐字写入),点一下立即生效(正在进行的这一批也跟着变)。点“查看”会把文档窗口带到前台并跟随修改位置,按钮变成“查看中”;你切到别的窗口后它自动熄灭,再点一次回来。可拖动,不抢焦点;AI 读取、检查、保存期间卡片也留着,这一轮回答结束时消失

原生公式 · AI 在文字里用 $...$(行内)和 $$...$$(单独一行)写 LaTeX,由 Word 自己的 LaTeX 解析器读成原生公式,所以常规 LaTeX 写法都能用(\mathfrak、\bigoplus、矩阵、分段函数等),不需要逐个符号适配;Word 不认识的写法退回插件自带的转换,仍失败的保留原文并在结果里提示。单独一行的公式末尾加 \tag{1} 即在右侧对齐编号。Word 的正文、表格单元格、题注、查找替换内容,以及 PowerPoint 的标题、正文、文本框里都可以写

引用与参考文献 · 正文里写 \cite{1}、\cite{2,5}、\cite{3-6},变成上标 [1]、[2,5]、[3-6];insert_references 生成参考文献列表。引用是 Word 的交叉引用域,按住 Ctrl 点击跳到对应文献

原生脚注 · Word / WPS 文字中插入、读取、编辑、删除真正的页底脚注,编号随增删自动重排,支持连续、每节或每页重编号。正文可内联写 [fn:完整引注] 或 \footnote{完整引注};脚注支持加粗、局部斜体、字体字号和 $...$ 原生公式,与 \cite{} 文末参考文献共存

样式与版式 · 直接修改样式本身(标题用什么字体字号、是否自动编号,正文的字体、行距、首行缩进),所有用到它的段落一起变;设置纸张和页边距、页码、页眉、目录(保存时自动刷新)、某段另起一页。这些都不需要再去点 Word 的对话框

填模板 · 报告模板常把正文放在大单元格里。这类表格会按段落展开给模型看,正文、公式、表格都写进单元格里面,而不是堆到文档末尾;新写的正文沿用旁边正文的字体、字号和行距

规范的图表题注 · 插入表格或图片时给出题注,插件按规范排:自动编号(“表 1”“图 1”,是 Word 题注域,增删后自动重排)、居中、表题在上、图题在下;图表前后留出段间距,图片居中

不被自带技能带偏 · DSH 桌面版自带的 Office 技能会让模型写脚本生成文件,这样你看不到过程,文件开着时还会写入失败。插件在模型第一次加载这些技能时把它引回来,确有需要(批量转换、应用打不开的文件)再次请求即放行

交付前整体视觉检查 · 保存时如果 AI 改完之后还没看过成品,保存结果会自动附上整份文档的总览图让它过一遍,有问题先修再保存。总览图把各页(或各张幻灯片)带页码拼在一张图里,一张最多 6 页,最多 18 页;模型也可以随时主动调出总览,再放大某一页细看

不拆词、不重复编号 · 插件写入的段落、表格、题注一律按整词换行(有些模板的样式带着“允许西文在单词中间换行”,会把 37000 拆成 37 和 000);标题文字自带编号而样式又自动编号时,去掉自动的那个

提醒纯文本公式 · 正文里出现 d_k、10^18 这类没写成公式的下标和幂时,结果里会提醒模型改用公式

三线表与表格格式 · insert_table 的 borders 可选 grid(全框线)、three-line(论文三线表:上下粗线、表头下细线)、none;format_table 修改已有表格的框线、字号、行高、是否保持在同一页

图片尺寸 · set_image 调整已有图片的宽高(磅或 "12cm");插图所在段落不受固定行距裁切。插入的图(Word 与 PowerPoint,支持 PNG、JPG、SVG 矢量图)如果被缩到远小于绘制时的尺寸,结果里会告诉 AI 图中文字实际只有几磅,让它按版面重画

消除图表前的留白 · fill_gaps:图或表在上一页放不下而整块移到下一页时,上一页底部会空出一截;这条指令像排版软件那样把图表后面的正文段落提到图表前面,把空白填上(不会让正文越过标题)

图表与正文连续写 · insert_paragraphs 的条目里可以直接放图片或表格,按顺序落在前后段落之间,不必再数段落号

成型版式的幻灯片 · PowerPoint 里 AI 不再自己摆文本框:先选一套主题(ink、paper、ocean、forest、graphite 五套浅色,night、chalk、plum 三套深色,可改单个颜色和字体),再用一条 slide 指令生成一整页——封面、目录、章节页、要点、卡片、数据、图表(柱状、条形、折线,由形状绘制)、表格、公式卡片、时间线、流程、对比、满版配图、引言、结束页。版面、配色、字号、页码、切换和入场动画由插件按主题排好;标题里的 词 以强调色加粗,$...$ 是公式,卡片可带线性图标。要点页配图时按图的形状排版:宽图横跨整页、要点排在图下,其他图放在文字旁边;图表、示意图用“配图页”时整张完整显示。整份演示文稿通常一两次调用完成

更多版式与自由画布 · 定理 / 定义页(陈述卡片 + 证明思路)、图组页(2–6 张图带题注)、总结页(大号编号的要点)、对开页(半页满版图)、封面与结束页的满版样式;图表页新增由形状绘制的散点图(可带最小二乘拟合线、方程和 R²)、函数曲线图、饼图和圆环图;表格单元格里的公式是真正的公式。没有合适版式时用“画布”:AI 在 960×540 的画布上自己摆放文字、卡片、色块、箭头、图片、公式、数据、图表,颜色和字体仍跟随主题;摆好的页可以用 reuse_slide 复用

章节页样式、代码页与框图 · 章节页有四种样式(整页色底、左侧色块配编号、横向色带、淡色大编号),一份演示文稿统一用一种,未指定时随机取一种,不同文稿不再千篇一律。新增代码页(深色面板、行号、关键字和注释着色)。画布上的方框可以起名并用连接线相连(直线、折线、曲线,带箭头,自动找最近的边),用来画网络结构、流程管线这类框图。曲线图在线的末端直接标名称(相近的自动错开),可加参考线和标注

主题与背景 · 新增三套主题:sepia(旧纸张底、暗红配金、衬线标题,适合历史与人文)、crimson(暖白底、红配金,适合党政与纪念)、slate(冷灰底带细网格,适合工程技术)。背景不再只有纯色:旧纸张(颗粒与暗角)、渐变、网格、圆点,或把一张图片淡淡地铺在每一页后面

图片裁切 · 照片铺满版位时,竖长的图保留上部(人像的头部所在),可用 focus 指定保留哪一部分,图组里可用 fit: "contain" 完整显示;被裁掉较多的图会在结果里点名,提醒 AI 去看。图组页遇到竖图(人物肖像)排成一行竖格,最后一行不满时居中

幻灯片图示与表格 · PowerPoint 里可以直接生成原生 SmartArt(流程、循环、层次结构、组织结构图、棱锥、维恩图等 20 种常用版式,条目可带下级)、原生表格、常用形状和连线,正文可写多级要点

操作说明按需提供 · 每次请求只带一段简短说明;某个应用的全部操作清单在 AI 第一次打开或读取该应用的文档时随结果给出一次,之后可用 office_help 再取。用不到的应用不占上下文

表格跨页 · 表头行在下一页重复,单行不被拆到两页,表题不会单独留在页尾

Excel 数据处理 · 长表格不必逐行读:office_read 对超过 60 行的表自动给出每一列的概况(数值、文本、日期、空白各多少,最小值、中位数、最大值,各取值及次数,以及值得注意的地方:多余空格、写成文本的数字和日期、类型混杂、离群值、空行、重复行)。清洗:clean(去空格、删指定字样、统一大小写、取值改名、把“¥1,299”“89元”“10%”读成数字、把“2025/3/1”“20250301”“3月1日”读成日期)、replace、fill_blanks、remove_duplicates、按条件 delete_rows、sort、filter、copy_range(保留原表、在副本上清洗)。每一步都报告改了多少格、删了哪些行

Excel 分析与图表 · add_column / fill_formula 把一个公式填满一列并报告出错的单元格;pivot 建数据透视表(行、列、值、筛选,日期按月、季、年分组,结果直接返回);add_chart 支持柱状、条形、堆积、折线、饼图、圆环、散点、面积、雷达和组合图(次坐标轴),可设标题、坐标轴标题、数据标签、图例,结果里给出图表占用的单元格并提示与其他图表重叠;set_chart、delete_chart;table、conditional_format、freeze、validation。office_render 可以看带图表的区域,也可以单独看一张图表

批量编辑 · office_edit 一次调用按顺序执行一批修改(写一整篇文档、填一张表加公式加图表、做几页幻灯片),中途某一项失败就停下并报告已完成哪些

改错位置的防护 · Word 按“段落编号 + 这段开头的文字”定位。你刚改过导致编号对不上时,这一步会被拒绝并要求重新读取;改写和删除段落必须带开头文字

Word 一次撤销 · AI 的一批修改在 Word 里是一个撤销步骤,按一次 Ctrl+Z 整批撤回

读结构 · Word:带编号的段落、标题级别、表格;Excel:工作表、单元格的值和公式;PowerPoint:每页的形状(名称、类型、位置、文字)

看排版 · office_render 把 Word 的一页、PowerPoint 的一页或 Excel 的一个区域渲染成图片给模型核对,不依赖截图,窗口在后台也能出图

写错参数会被指出 · 操作里出现它不认识的字段时,结果里会点名哪个字段被忽略,而不是悄悄不生效

零安装依赖 · 首次使用时用 Windows 自带的 .NET Framework csc.exe 编译一个小 helper(约 1 秒,之后缓存

…(truncated)

以上内容来自 npm 上的 README,我们只做格式化,不改内容。

版本

npm 上共发布:44,最后更新 2026-10-23

链接

GitHub · Homepage · npm

同类插件