ZCode Office 文档技能与 Computer Use

Office 文档技能（默认启用插件）

ZCode 内置四个内容型文档 skill 插件，各自还可发布一个视觉验证 subagent：

插件	技能	内容	附带 Agent
`documents-plugin`	`docx`	Word 文档制作，含 OOXML/docx-js 参考与校验脚本	`visual-judge`
`spreadsheets-plugin`	`xlsx`	XLSX 创建/编辑/分析/图表/转换	`visual-judge`
`presentations-plugin`	`pptx`	PPTX 演示文稿制作	`visual-judge`
`pdf-plugin`	`pdf`	PDF 排版渲染（报告/简历/海报/封面），含 typesetting/briefs/configs/scripts	`visual-judge`

visual-judge subagent（四个插件内容一致）的 frontmatter：

name: visual-judge
color: yellow
model: account:bigmodel-individual-coding-plan/GLM-5.3-Flash
thoughtLevel: max
tools: [Read, Bash]

职责：对渲染后的页图做唯一视觉验收（pptx/docx/xlsx/pdf/poster/chart），逐页返回 pass/fail JSON，只读不改。

上游 docs/product-capability-map.md 明确：当前 Office 产品基础是 PDF、DOCX/DOC、XLSX 的只读 Preview Pane + 官方 Document Skills；这不等于已具备 Office 原生编辑器、批注/修订或 PPTX 原生预览——这些仍是规划。原生编辑/转换/保存属 Host Workbench Services 边界，Renderer 不直接引用 Node/LibreOffice/本地路径实现。

Computer Use（CUA）

packages/zcode-cua 是 fail-closed 占位

packages/zcode-cua（@zcode/zcode-cua v0.6.3）在当前检出中是接口形状保留、运行时全部关闭的桩：

package.json 标 zcodeCuaPlaceholder: true，description 明确”本 build 不含 Computer Use：所有运行时 surface 报告 unavailable 并 fail closed”。
index.js 的 createComputerUseRuntime().execute() 恒返回 {isError:true} 文本。
broker.js 的 callBrokerMethod / dispatchRequest / handleRequestLine 抛 BrokerError；isBrokerMethod 恒 false。
broker-server.js 所有安装/校验/启动方法为 unavailableReject。
导出的 .d.ts 与真实 CUA 保持 API 兼容，消费方（@zcode/services、desktop）无需条件编译。

NOTICE.md 也声明：本仓随附的 Computer Use 包为不可用占位实现。

computer-use 插件

apps/zcode-cli/packages/zcode-cua-plugin（插件名 computer-use v0.6.4）：提供 computer-use 技能、docs/computer-use.md、scripts，runtimeTopLevelPaths: ["node_modules"]（Sharp）。默认关闭，受 feature flag 门控；CUA 插件关闭时无法从 UI/CLI/MCP 看到（resolveOfficialPluginRoots() 门控）。

共同 runtime：node_repl

Browser Use 与 Computer Use 共用 node-repl-host 包提供的 node_repl MCP 宿主；js / mcp__node_repl__js 工具由启用态决定。Node REPL 的 host MCP 由宿主统一提供，不由插件 manifest 声明。详见 mcp-integration。

CUA 权限 broker

packages/services/src/cua-permission-broker：ICuaPermissionService、ICuaPipSessionService。docs/cua-permission-broker/（9 篇）与 docs/cua/（14 篇）是设计资产。

上游能力地图记录的当前事实：Computer Use 是 macOS/Windows desktop-local、显式 opt-in / kill switch 的内部 beta；签名 Helper、peer/token 校验、权限和输入执行失败时必须 fail closed；手机 Web 只能经 shared-host attachment 复用桌面已存在的 Local Host，SSH/WSL/Docker 或 mobile remote Host 不得另起本地 Computer Use Helper。

Wiki AI

目录