@copylee/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 imag
Install
dsh plugin --profile web add @copylee/dsh-office
Sandbox test results
| Stage | Result |
|---|---|
| 1 install | ✓ |
| 2 list | ✓ |
| 3 mount | ✓ |
| 4 boot | — |
Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).
README
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 秒,之后缓存
…(truncated)
Rendered from the README published on npm. Formatted only, not edited.
Versions
Published on npm::44,最后更新 2026-10-23