动作防护

行动前检查，行动后记录。绝不重复执行同一操作。

为何存在

AI代理在会话之间会丢失状态。如果没有已完成操作的记录，你将面临：

• - 对同一帖子重复回复
• 发送重复的代币转账（链上不可撤销）
• 重复部署同一构建版本
• 向同一人发送相同邮件

此技能为任何外部操作提供通用的去重层。

快速开始

bash

行动前检查 — 若已执行则退出代码1

node scripts/guard.js check <动作类型> <目标ID>

行动后记录

node scripts/guard.js record <动作类型> <目标ID> [--note 上下文说明] [--parent <父ID>]

示例

node scripts/guard.js check reply 2033701370289963286 node scripts/guard.js record reply 2033701370289963286 --note 回复了@startupideaspod --parent 2033500000000000000 node scripts/guard.js check send CPcrV6UeL8CcEvC7rCV6iyUDxbkT5bkJifbz5PUs6zfg node scripts/guard.js record send CPcrV6UeL8CcEvC7rCV6iyUDxbkT5bkJifbz5PUs6zfg --note 250K WREN空投

退出代码

• - 0 — 可安全执行（未发现先前操作）
• 1 — 停止 — 操作已执行（详细信息输出至stderr）
• 2 — 错误（配置缺失等）

工作原理

1. 1. 检查 对 <动作类型>:<目标ID> 进行哈希运算并在日志中搜索
2. 同时检查 --parent 是否匹配 — 捕获对同一帖子的不同回复这类重复
3. 记录 追加至 .action-guard/actions.jsonl
4. 数据跨会话持久化 — 在上下文重置后依然保留

动作类型

可使用任意字符串。常见类型：

类型	用途
reply	社交媒体回复
post

原创帖子 |
| send | 代币/加密货币转账 |
| email | 外发邮件 |
| deploy | 生产环境部署 |
| dm | 私信 |
| webhook | Webhook触发 |

CLI参考

node scripts/guard.js <命令> [选项]

命令：
check <类型> <目标> 检查操作是否已执行
record <类型> <目标> 记录已完成的操作
history [--type <类型>] 显示近期操作
stats 按类型统计操作数量
search <查询> 搜索备注

选项：
--note 文本 上下文备注（用于record命令）
--parent 父/目标ID（捕获对同一帖子的重复回复）
--days 限制历史记录为N天（默认：30）
--data-dir <路径> 数据目录（默认：.action-guard/）

集成模式

在定时任务或自动化中，始终包裹操作：

在每个操作之前：
node guard.js check <类型> <目标>
若退出代码为1 → 跳过（已执行）

执行操作

成功之后：
node guard.js record <类型> <目标> --note 你做了什么 --parent <父ID（如适用）>

数据格式

操作存储在 .action-guard/actions.jsonl（每行一个JSON对象）：

json
{type:reply,target:2033701370289963286,parent:2033500000000000000,note:回复了@startupideaspod,ts:2026-03-16T21:30:00.000Z}

JSONL格式意味着：无需解析整个文件，只需追加。快速grep。易于清理。