@ betteroffice/ 代理服务器

通过 TypeScript SDK 从代理服务器搜索、阅读、编辑和预览 DOCX、 XLSX 和 PPTX 文件 或 betteroffice-mcp 服务器。 代理处理大型文件的方式 : grep,读取一个小区域,进行精确的编辑,检查结果,导出.

不需要模型提供者,API密钥或代理框架.

安装

bun add @betteroffice/agents

要求节点.js 22或后.

使用量

MCP 服务器

bunx --package @betteroffice/agents betteroffice-mcp --root /absolute/path/to/documents

服务器在stdin/stdout上会说出MCP,所以从一个MCP客户端连接. 例如,使用 Codex :

codex mcp add betteroffice -- /absolute/path/to/node_modules/.bin/betteroffice-mcp --root /absolute/path/to/documents

导出时总是写出一个新的文件, 并且绝不覆盖已有的文件 。 路径检查不是 操作系统沙盒,所以使用您控制的工作空间目录.

SDK 软件

import { readFile, writeFile } from 'node:fs/promises';
import { openDocx } from '@betteroffice/agents';
import { renderDocxPage } from '@betteroffice/agents/render';

const doc = await openDocx(await readFile('report.docx'), {
  name: 'report.docx',
  renderer: renderDocxPage,
});

try {
  const [hit] = doc.grep({ query: '€4.2 million' }).matches;
  if (!hit) throw new Error('Revenue text not found');
  const proposal = doc.propose({
    author: 'report-agent',
    note: 'Update the executive summary revenue',
    edits: [{ match: hit.match, newText: '€5.1 million' }],
  });

  const preview = await doc.render(1, proposal.id);
  await writeFile('preview.png', preview.png);
  console.log(doc.review(proposal.id), await doc.verify(proposal.id));
  await writeFile('report-revised.docx', await doc.export(proposal.id), { flag: 'wx' });
} finally {
  doc.close();
}

出口待决提案后,该文件保持不变。 要应用它,打电话 await doc.accept(proposal.id) 接下来 doc.export() 没有身份证 对于Word跟踪的变化, 调用 doc.accept(id, { tracked: true, date: '2026-09-27T12:00:00Z' })。 。 。 .

入境点

DOCX 和 PPTX 文档阶段文本编辑 grep, (中文(简体) ), read 财务报告和审定财务报表 propose; 工作手册的使用 readCells 财务报告和审定财务报表 proposeCells 换句话说 所有适配器共享 review, (中文(简体) ), accept, (中文(简体) ), reject, (中文(简体) ), verify, (中文(简体) ), export 财务报告和审定财务报表 close。 。 。 . openXlsx 财务报告和审定财务报表 openPptx 在节点装入捆绑的 Web Assembly; 在 a 浏览器,将模块字节传递为 wasm。浏览器中的 DOCX 预览需要自定义 DocumentRenderer 而不是节点帆布渲染器.

MCP工具

编辑和参考

• 参考资料ref, (中文(简体) ), match, (中文(简体) ), revision, (中文(简体) ), version)属于公开会议。 重新打开文件 创造出新的。 页面,幻灯片和段落编号为一基;文本抵消为零基.
• DOCX和PPTX搜索默认为字面和大小写不敏感. XLSX 密码 office_grep 搜索 以区分大小写的方式显示值.
• 一项提案有1-32个单独的替换人,在一份临时副本之前经过验证 原子更新. 改变目标使其变得僵化(STALE_TARGET:再读再求婚.
• 新文本采用第一个被替换字符的格式。 保留几种风格 将该段改为整个段.
• 段落间隔、内嵌和现有跟踪改动不受文本提案的影响.
• 承诺的 XLSX 或 PPTX 编辑无效所有未完成的手柄、光标和为此提出的建议 文档.
• 结果被分解(nextCursor, (中文(简体) ), nextOffset, (中文(简体) ), nextStart) (中文(简体) ). 结果的一页从来不是 彻底搜索.

限制

• 最多16 000个UTF-16单元的读取返回和100个格式化运行;最多100个项目的读取返回.
• MCP服务器最多可打开10个文件,每个文件最多64个米B,每个文件最多可保存64个提案 文档。 所有状态都在内存中:关闭客户端前导出.
• Stdin上面的MCP消息封顶为一米B.
• verify 证实保存的文件重新打开 。 它不检查视觉的忠诚度或者 编辑完全正确;为此使用读取并预览.
• 预览使用 BetterOffice 版式引擎和捆绑的字体,而不是像素等同的字体 办公室 安装 @betteroffice/fonts-cjk 为CJK格言.

文档

• 代理指南
• @betteroffice/docx
• @betteroffice/xlsx
• @betteroffice/pptx
• 格式化 eval 套件
• 仓库