fuxin-batch-undo — 福昕 Office 批次撤销技能
产品分类: Word / Excel / PowerPoint(写批次归属于当前活动产品) 依赖: FuxinAiService(端口见
fuxin-office-bridge「运行端口」,由MCPServerPort.ini读取) 需要确认: 是(涉及文档写操作及批次生命周期;不写前确认,写后引导撤销)
功能概述
本技能管理与编排福昕 Office 的批量操作与事务边界:
- 显式批次管理 — 将多个写操作放入一个批次(begin → 多个操作 → end), 整组操作以单一事务呈现,用户可一次撤销全部
- 单事务合并提示 — 即使不显式开启批次,网关也会将一次调用内的多个写步骤 合并为单一事务,一次 Ctrl+Z 即可整组撤销
- 撤销引导 — 提供批次撤销的操作说明
⚠️ 注意:
undo_action并不是注册到网关的独立场景工具。撤销实际上通过 事务合并后的一次性撤销完成。本技能负责编排批次边界与撤销引导,而非直接调用 一个名为undo_action的工具。
架构与预检
用户 → FuxinAiService(端口见 `fuxin-office-bridge`「运行端口」)→ 产品场景工具(合并为事务) → Office App
执行前需预检(见 fuxin-office-bridge):确认网关与产品链路就绪、存在活动文档。
使用方式
隐式(默认)
各产品技能(word/excel/ppt)的写操作默认由网关合并为单一事务,用户只需 一次 Ctrl+Z 即可整组撤销本次调用产生的全部变更。无需额外开启批次。
显式批次(需要跨多次独立调用整体撤销时)
当需要把多次独立的工具调用归入同一批次,以便整体撤销时:
- 明确告知用户将开启一个批次
- 在批次内依次执行各产品写操作
- 制作批次完成说明,向用户确认撤销方式(一次撤销整组)
- 如需整体撤销,引导用户执行一次性撤销操作
具体批次原语(begin/end)遵循网关对
{产品}_begin_batch/{产品}_end_batch的约定; 撤销以批次归属的单次事务为准。
撤销引导文案
完成批次后向用户输出:
本次共执行 N 项操作,已合并为一个批次。
如需要撤销整组变更,请按一次 撤销(Ctrl+Z) 即可一次性回退全部。
与其它技能协同
- 写入方:
fuxin-word/fuxin-excel/fuxin-ppt的写操作默认已合并为事务 - 预检:批次开启前先跑
fuxin-office-bridge - 编排:跨产品多步骤批次由
fuxin-office汇总层统一编排并在此汇聚撤销边界
微信扫一扫