- Home
- Plugins
- Tools & Capabilities
- dsh-office
dsh-office
copylee711/dsh-office
Windows only: the agent edits documents inside the Word, Excel and PowerPoint (Microsoft Office or WPS Office) windows you have open, through the applications' automation interface, so changes appear live and you can edit alongside; it reads structure, applies batches of edits, renders pages to images to check layout, and saves or exports PDF.
Install
dsh plugin --profile web add github:copylee711/dsh-officeREADME
dsh-office
让 DeepSeek Harness 直接在你电脑上打开的 Word、Excel、PowerPoint 里改文档。AI 不改写文件,而是通过 Office 的自动化接口(COM)让应用自己执行修改,所以改动会实时出现在窗口里,你可以边看边一起编辑,格式不会因为换工具保存而走样。
仅支持 Windows,需要本机装有微软 Office 或 WPS Office。

上图是一次真实操作的录屏(只录了 Word 窗口):AI 按要求写出标题、导语和表格,随后检查排版并修正。下图是对话里的交付结果,以及设置页。
| 对话与交付的文件 | 设置页 |
|---|---|
![]() | ![]() |
功能
| 功能 | 说明 |
|---|---|
| 在打开的文档里改 | 文件正开着也能改(直接改文件的做法这时会因为文件被占用而失败);文件已经打开就直接接着用,不会再开一份 |
| 实时可见,可以一起改 | 每一步修改即时出现在 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 秒,之后缓存),不需要 Python、LibreOffice 或 node-gyp |
安装
DSH 桌面版:插件 → 添加插件,输入 @copylee/dsh-office,安装后启用。
命令行(web 等其他 profile):
dsh plugin --profile web add @copylee/dsh-office@latest
要求:Windows 10 / 11(自带 .NET Framework 4.8),微软 Office(Word、Excel、PowerPoint,装了哪个就能用哪个)或 WPS Office(文字、表格、演示),DSH 0.2.0-rc.2 或更高。
使用
直接说要做什么,例如:
- 用 Word 写一份季度工作总结,保存到桌面
- 打开 D:\数据\销售.xlsx,加一列金额并在最后一行求和,再画一个柱状图
- 把我现在开着的 PPT 第 3 页的标题改短一点,正文改成三条要点
AI 干活的同时你可以直接在窗口里改。你正在单元格里输入、或者开着对话框时,Office 不接受外部修改,AI 会等几秒再试。
AI 只有在调用保存时才写入文件,不会替你关闭文档。
Agent 工具
| 工具 | 作用 |
|---|---|
office_open | 在 Word / Excel / PowerPoint 里打开文件;路径不存在则新建;已打开则直接使用 |
office_status | 列出三个应用里现在打开了什么、哪些有未保存的修改 |
office_read | 把打开的文档读成文本(段落 / 单元格 / 形状) |
office_edit | 按顺序执行一批修改,不保存 |
office_render | 把一页 / 一张幻灯片 / 一个单元格区域渲染成图片;Word 和 PowerPoint 一次最多看 4 页,或用总览把全部页面拼成一张图 |
office_save | 保存;给出路径时另存为,扩展名为 .pdf 时导出 PDF;改完没看过成品时附带各页图片 |
office_close | 关闭 AI 自己打开或新建的文档;你原本开着的文档会被拒绝,有未保存修改时必须明确说保存还是丢弃 |
office_help | 列出某个应用(Word / Excel / PowerPoint)下 office_edit 的全部操作和字段 |
office_edit 支持的操作:
- Word:
insert_diagram(流程图、结构图:用 Word 自己的形状画在文档里,节点按行列摆放,连线自动走直角,画完仍可逐个编辑)、insert_paragraphs、set_text、replace_text、format_text、delete_range、insert_table、set_cell、insert_image、set_image、format_table、insert_references、insert_footnote、edit_footnote、delete_footnote、footnote_settings、style_format、page_setup、page_numbers、header、page_break、insert_toc、update_fields - Excel:
write_range(值或公式)、format_range、autofit、insert_rows、delete_rows、add_sheet、rename_sheet、delete_sheet、add_chart - PowerPoint:
theme(配色之外还可定卡片、圆角、项目符号的样式,以及 LaTeX Beamer 风格的外框)、slide(成品版式;其中grid由 AI 按行列自由组合图表、数字、表格、步骤、引语等部件,不用给坐标)、add_slide、set_text、format_text、add_textbox、add_image、add_smartart、add_table、add_shape、set_shape、delete_shape、delete_slide、move_slide、duplicate_slide、set_layout、set_background、set_notes
原生脚注
法学、历史等使用脚注体例的文稿,可以直接要求 AI 使用原生脚注、每条写完整出处。它与 \cite{} 加文末参考文献是两种不同功能。
{"op":"insert_paragraphs","items":[{"text":"有关这一观点的论证[fn:张三:《示例论文》,《示例期刊》2026年第1期,第12—15页。],还可比较其他资料\\footnote{Author. Full citation, 2026, pp. 20–23.}。"}]}
修改已有文稿,先 office_read {"footnotes":true,"full":true} 读取全部脚注;新增时用 insert_footnote {para, expect, find?, occurrence?, where?, text},不传 find 插在段末,传入时默认位于第一次匹配文字之后。编辑、删除用 edit_footnote / delete_footnote,必填 footnote(读取结果的集合序号)和 expect(脚注原文开头)。edit_footnote 可以更新 text 及格式;局部格式用 format_text {footnote, expect, find, italic: true} 等。
正文中的 [footnote:7] 表示脚注集合第 7 条;每页或每节重编号时,页面显示的编号可能是 1,不能用它代替集合序号。增删后重新读取再操作。读取结果同时给出正文段落、段内位置、页与节;非常规编号样式无法可靠表示时,显示编号标为不可用,不会拿集合序号冒充。
footnote_settings {numbering: "continuous" | "section" | "page", section?} 调整全篇或指定节的编号规则。普通插入保留文档原有规则和样式。脚注中可以写 **加粗** 和 $E=mc^2$;内联语法支持配对花括号/方括号及转义分隔符,不支持脚注嵌套,未闭合或空脚注会被拒绝。给脚注起始符加一个反斜杠可保留字面文本。
含已有脚注的段落禁止整段 set_text,请用不跨过脚注引用标记的局部 replace_text;明确删除正文范围的 delete_range 会连同其中的脚注一起删除,并报告数量。
设置
设置 → Office。每项改动自动保存。
| 设置 | 默认 | 说明 |
|---|---|---|
| 办公套件 | 自动 | 新打开的文件用哪个软件:自动(装了微软 Office 就用它,否则用 WPS)、微软 Office、WPS Office。已经打开着的文档始终在它所在的软件里修改 |
| 跟随 AI 的修改位置 | 开 | 窗口自动滚动到 AI 正在修改的位置;关闭为静默执行 |
| 逐字写入 | 开 | 文字像打字一样逐步出现;关闭后写得最快 |
| 静默模式 | 关 | 在后台完成,不弹窗口、不显示卡片、一次写入;回合结束时自动保存并关闭后台打开的文档。开启后“跟随”“逐字写入”“迷你卡片”不再起作用 |
| 迷你卡片 | 开 | AI 修改文档期间在右下角显示带“查看”“快速”开关的小卡片。在卡片上切换过的开关(包括你离开文档窗口后自动熄灭的“查看”),到 DSH 重启前以卡片为准 |
| 交付前整体视觉检查 | 开 | 保存时自动把整份文档的总览图交给 AI 检查;会多用一些 token |
| 优先在真实 Office 里操作 | 开 | DSH 桌面版自带 office-docx / office-xlsx / office-pptx 技能,用脚本生成文件。开启后,AI 第一次想加载这些技能时会被引回本插件(对应的 Office 应用已安装时才拦);它再次请求时放行 |
| 打开文档时显示到前台 | 开 | 关闭后文档仍会打开,只是不抢当前窗口 |
| 核对排版的图片宽度 | 1100 像素 | office_render 给模型的图片宽度;越大越清晰,也越费 token |
设置页还会显示三个应用是否安装、是否在运行、打开了哪些文档。
限制
- Excel 和 PowerPoint 里 AI 的修改无法用 Ctrl+Z 撤回(Excel 的外部修改不进撤销栈,并且会清空已有的撤销记录)。只有 Word 支持整批撤销。
- 你正在单元格里输入、或 Office 开着模态对话框时,修改会被 Office 拒绝;插件等待约 5 秒后报告“应用忙”。
- Excel 区域的图片是通过剪贴板取得的,渲染时剪贴板里的文字会被保留,图片、文件等其他内容会丢失。
- 公式由插件自己启动的一份不可见的 Word 解析,不动你正在用的 Word。它只在一批修改期间存在(启动约 1 秒),这一批结束就关闭;万一插件中途被强行结束而留下了它,下次插件启动时会清掉。Excel 里还不能写原生公式。
- PowerPoint 的公式经剪贴板放入幻灯片。做法与电脑控制插件一致:先把剪贴板上的全部内容存起来,每写完一段文字立刻放回,且不进剪贴板历史;这期间你自己复制了新内容的话,以你的为准,不会被覆盖。Word 复制公式的那一下仍会出现在 Win+V 历史里。
- PowerPoint 的表格单元格和 SmartArt 节点里放不了排好版的公式,公式在那里写成带上下标的文字。
- 引用按编号书写,插入或删除文献后不会自动重新编号。
- 兼容模式(Word 97–2003 格式)的文档里不能建立原生公式。
- WPS 文字里的公式是原生公式(由插件把 LaTeX 转成公式格式后插入),带编号的公式其编号跟在公式后面而不是靠右;WPS 演示不接受公式(不能建立,也不能粘贴),那里的公式由 WPS 文字排好后以矢量图片叠在文字上:颜色和字号与所在文字一致,放大不糊,但不能编辑,也不能转回文字;移动或改写带公式的文本框后需要重写其文本以重新摆放。幻灯片里公式多的话,推荐用 PowerPoint。WPS 文字里窗口不会跟随滚动到修改位置;资源管理器里双击后台文档时的行为没有像微软 Office 那样专门处理。其余操作与微软 Office 相同。
- 没有打开 Office 时处理文件、批量转换格式不在本插件范围内。
数据与隐私
插件只在本机运行,不联网。它读写的是你让 AI 处理的文档;office_render 生成的图片作为附件保存在会话历史里,和 DSH 的其他图片附件一样。
工作原理
宿主侧是一个 Cordis 插件,注册上面六个工具。它启动一个常驻的小程序(helper/OfficeHelper.cs,C# 5,运行时由系统自带的 csc.exe 编译,按源码哈希缓存在 %LOCALAPPDATA%\dsh-office\),通过标准输入输出逐行交换 JSON。helper 用 COM 附着到正在运行的 Office 应用(没有运行则启动并显示出来),按后期绑定调用它们的对象模型。每条命令结束后 helper 释放全部 COM 引用,这样你关掉 Office 时进程能正常退出。
开发
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
node scripts/office-smoke.mjs # 真实 Office:只操作脚本自己在临时目录里新建的文档
node scripts/office-smoke.mjs --wps # 同样的步骤,在 WPS Office 里
node scripts/footnotes-smoke.mjs # 原生脚注、公式、保存重开及跨页/跨节编号验收
node scripts/footnotes-smoke.mjs --wps # WPS 文字独立验收
许可证
MIT
Related plugins
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora

