SuperAPI AI 工具集

freeze

编程与开发

查看项目

更新于 11-08 20:16

技能介绍

freeze 是 gstack 中的文件编辑范围控制技能,核心用途是把当前会话的 Edit 和 Write 操作限制在用户指定的目录内。资料显示,它会在每次 Edit/Write 调用时读取工具输入 JSON 中的 file_path,并检查路径是否以冻结目录开头;若不在该目录下,就返回 permissionDecision: "deny" 直接阻止操作。

主要能力:将编辑边界锁定到单一目录,且边界在会话期间通过状态文件持续生效;支持重新运行 /freeze 更改边界,或通过 /unfreeze、结束会话解除限制;冻结目录末尾会补上 /,防止 /src 误匹配 /src-old。

使用方式:技能启动后会通过 AskUserQuestion 询问要限制编辑的目录,用户以文本输入路径;随后将路径解析为绝对路径、确保末尾带斜杠并写入 freeze 状态文件,同时告知用户编辑已限制到该路径。资料还包含一段记录技能使用情况的 shell 命令,会向 ~/.gstack/analytics/skill-usage.jsonl 追加 JSON 行。

适用场景:调试时防止意外“修复”无关代码;希望把改动限定在一个模块或文件夹;用户明确要求冻结、限制编辑、只编辑该文件夹或锁定编辑。

限制:仅作用于 Edit 和 Write 工具,Read、Bash、Glob、Grep 不受影响;它用于防止误编辑,不是安全边界,sed 等 Bash 命令仍可修改边界外文件。其他收费、平台或效果信息暂未提供。