aionclaw需手动启用事务保障多步操作一致性:开启「启用原子事务保护」开关,或用@transaction标记技能/yaml/指令,亦可手动通过start/commit/rollback控制事务边界。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

给多步数据修改增加事务
当你要连续执行多个文件写入、数据库更新或跨应用状态变更操作时,必须确保全部成功才提交,任一失败就回滚,否则极易出现数据不一致。AionClaw 默认不启用事务保护,需手动开启并包裹关键步骤。
启用内置事务引擎
打开 AionClaw 主界面 → 点击左下角「设置」图标 → 进入「高级行为」页签 → 将「启用原子事务保护」开关置为开启状态。
这一步必须在执行任何多步修改前完成,【关闭状态下所有操作均无回滚能力】。开启后,系统会自动为后续涉及文件写入、SQLite 操作、剪贴板批量替换等高风险动作注入事务上下文。
用 @transaction 标记自定义技能
方法一:在技能 YAML 文件顶部添加声明
打开技能编辑器 → 找到对应技能的 .yml 文件 → 在第一行插入 @transaction 标签 → 保存并重新加载技能。
方法二:在自然语言指令中直接声明
在聊天框输入指令时,开头加上「@transaction」前缀,例如:@transaction 把 Excel 表里所有“待审核”改成“已归档”,再把对应行复制到归档表,最后删除原表该行。系统识别到该标记后,会将整条指令拆解为单个事务单元执行。
注意:若指令中包含调用外部 HTTP 接口或启动第三方程序,事务仅保障本地操作回滚,无法约束远程服务状态。
手动控制事务边界
第一步:发送指令 START TRANSACTION,触发事务开启并返回唯一事务 ID(如 tx_8a3f)
第二步:依次执行各数据修改动作,每步完成后检查返回状态码是否为 200 OK 或 success
第三步:全部成功则发送 COMMIT TRANSACTION tx_8a3f;任一失败立即发送 ROLLBACK TRANSACTION tx_8a3f
该方式适用于需要精确判断中间状态、或嵌套调用多个子技能的复杂流程。事务 ID 有效期为 15 分钟,超时未提交或回滚将被系统自动终止并清理锁资源。











