Files
kicer b3a0d5370c feat(local): 本地自建 office 预览网关,技能恢复服务器同源行为
- 新增 local/preview-gateway.js:零依赖复刻 executor :3100 的数据面(/preview 转发、SSE 与
  /api/* 按 Referer 认领槽位、4 槽 LRU + 闲置回收、缺二进制给安装页而不是无限转圈),
  不复刻 unshare/nsenter/mount 牢笼——本地没有沙箱,命令与 watch 本就同机同盘
- local/start.sh:选空闲端口起网关,经 PREVIEW_PROXIES 登记进 core 反代;端口写入
  .runtime/preview.port;local/stop.sh 兜底清理时一并收掉
- skills/office 回到 v2.5.0 行为:本地也发预览卡片、watch 族照旧隐藏,不再有 LOCAL 分支;
  binary missing 的报错改为指向技能自己的 AGENTS.md(平台中立)
- 网关按平台分支:进程回收(POSIX 进程组 / Windows taskkill /T)、二进制名(.exe、也认
  officecli-* 资产名)、POSIX 自动补 chmod +x;会话目录解析修正为读 {session:{work_dir}} 并限流
- 文档:docs/local-mode.md 补 4.15 与验证结果,local/README.md 补预览、日志与端口
2026-11-11 22:12:14 +08:00

1.5 KiB

name, description, required
name description required
office Office 文档(docx/xlsx/pptx)创建、精确编辑、结构检视 true

功能

Word / Excel / PPT(.docx/.xlsx/.pptx)的创建、读取、精确修改与结构检视。

调用方式

所有操作通过 terminal 工具执行同一个入口脚本(cwd 已是任务目录,直接用相对文件名;不要自行调用底层文件执行操作):

office <command> [args...]

先用 office help 看命令清单,用 office help <主题>(如 office help docx paragraph)查具体元素的属性 schema——参数与属性以 help 为准,不要凭记忆猜。

常用动线:

  • office create <file> 新建文档
  • office open <file> 打开已有文档
  • office set / get / query <file> ... 按 schema 精确改动与读取;每次改动自动落盘
  • office view <file> outline|stats|issues|text 结构/语义自检
  • office save / close <file> 收尾(改动已自动落盘,save 只是显式冲刷)
  • office get-pos <file> 回读用户在预览里选中的文件内容(返回 JSON,path 里的 @id 可稳定用于后续 set/get 定位)

预览协作

create/open 成功后,用户可自行查看该文档的实时预览(预览页上的选区、标注类交互之后都能被 get-pos 读到)。用户反馈"看第几段/选中了哪里/修改哪里"时,优先用 get-pos 读回选区再针对性改。

注意

  • 所有操作文档在任务目录里。
  • view 的渲染族(html/screenshot/pdf 等)本环境不可用;要 PDF 用 x2pdf 技能。