用 AI 助手配置 PecoFence：先备份，再整理桌面

PecoFence 自带的 pecofence-cli 可以让本机 AI 编程助手读取当前设置、创建桌面分组和整理规则。为了避免一次指令改乱桌面，先检查现状并导出配置，再让助手提出有限的变更，逐项核对后才应用规则。本文依据 PecoFence 官方手册和 CLI 文档整理，未实际运行 PecoFence、CLI 或 AI 助手。

适用范围

适用于已在 Windows 桌面启动 PecoFence，想用 Claude Code、Codex、Cursor 或其它能运行本地命令的助手调整桌面布局与自动整理规则的用户。软件资源当前记录 v0.2.3；官方手册和 CLI 文档是滚动文档，没有声明本文步骤专属于该构建。Microsoft Store 版可直接从命令行调用 pecofence-cli；安装版或便携版若命令不可用，按官方 CLI 指南确认可执行文件路径。本文不让助手自行处理敏感文件、执行不明文件移动或导入整份旧配置。

第一步：先查看现状并做两类备份

1. 启动 PecoFence，确认桌面分组正常显示。关闭正在打开的 PecoFence 菜单或对话框，再打开终端；CLI 请求由应用处理，菜单或对话框未关闭时可能等待超时。

2. 让助手先运行 pecofence-cli skill 和 pecofence-cli describe，并阅读输出中的使用说明与命令 schema。再读取当前状态：

   pecofence-cli status
   pecofence-cli settings get
   pecofence-cli fence list
   pecofence-cli rule list
   

   先检查助手准备操作的设置、分组名称和规则目标是否与当前桌面相符。若不了解某个规则的匹配条件或目标 fence，先暂停并询问，不要让助手猜。

3. 在 CLI 导出配置前，选一个从未使用过的备份文件名，例如带日期时间的文件名：

   pecofence-cli config export "$env:USERPROFILE\pecofence-before-ai-20261020-1430.json"
   

   导出包括设置、规则和布局；如果目标文件已经存在，导出会覆盖它，所以每次使用新的名称。也可以在 PecoFence 设置中的“Layout and backups”保存布局快照，作为快速恢复分组位置、尺寸和图标的额外方式。

配置导出和布局快照用途不同：快照只保存 fence 布局，不含全局设置和规则；两者都不备份文件内容，也不能撤销通过文件夹 fence 实际移动的文件。PecoFence 还会每日保存完整配置备份并保留最近 7 份，但不要把自动备份当作本次变更前已验证可用的唯一副本。

第二步：让变更范围具体、可检查

给助手明确说明要达到的结果、允许改动的设置或 fence，以及禁止事项。例如：

先读取 pecofence-cli skill、describe、当前设置、fence 和规则。不要移动、重命名或删除文件。只新增一个名为“Projects”的普通 fence，并添加一条只匹配新桌面 PDF 的规则；先说明规则条件、目标 fence 和顺序，等我确认后再执行。先确认配置备份文件存在。

如果只是创建分组，不需要同时改全局主题或 opacity。把规则写成具体条件（例如扩展名为 pdf）和已有目标 fence 名称；如果目标 fence 还不存在，先说明创建顺序。不要把“整理桌面”这样的宽泛要求直接交给自动操作。

在助手提出计划后，逐项确认：新增或变更的 fence、匹配条件、目标位置、规则优先顺序，以及是否影响现有图标。规则顺序会改变哪些条件先匹配，因此应确认新规则插入的位置。官方文档示例会把更具体的发票规则上移到通用文档规则之前。

第三步：先预览规则影响，再实际应用

新增规则后，要求助手读取 pecofence-cli rule list，核对名称、条件、目标 fence 和顺序。应用规则前先运行：

pecofence-cli rule apply --dry-run

查看 dry-run 输出中的匹配对象和目标位置。若出现未知文件、范围过宽、文件夹 fence 或不预期的移动结果，先停止并调整规则；不要确认应用。dry-run 检查后，再由你明确同意，才让助手运行 pecofence-cli rule apply。官方手册说明规则会自动整理之后出现在桌面的新文件；现有图标需要通过“Apply now”或应用规则命令才会按规则整理，手动放置的图标保持原位。

每次变更后重新读取 settings get、fence list 和 rule list，确认结果符合计划。AI 助手通过 CLI 执行设置和布局变更时，桌面会随着每次操作更新；发现偏差就停止后续变更，并记录已发生的操作。

出错时如何恢复

• 如果 fence 位置或尺寸不合适，在设置的“Layout and backups”中选择对应快照并恢复布局。恢复前可以先保存当前布局；恢复快照后会另存一条“Before snapshot restore”快照，便于撤回这次恢复。
• 如果规则或全局设置被改错，使用变更前导出的配置副本，先用 pecofence-cli config check <文件路径> 检查文件，再确认目标路径和覆盖影响。config import 会替换整份配置，并先保存布局快照；只有确认要整体恢复时才使用，不要把它当作单条规则的撤销按钮。
• CLI 若返回超时错误，官方文档提醒请求可能刚好已被应用接收。先重新读取状态，例如 fence list 或 rule list，确认命令是否已生效，再决定下一步；不要盲目重试会改变状态的命令。
• 如果操作涉及 folder fence，拖入或移出其中的文件可能是真实文件移动。配置导出和布局快照都不能恢复文件内容或撤销这类移动；先在资源管理器检查实际文件位置，并使用你自己的文件备份恢复。

官方资料与验证边界

• PecoFence 官方手册：AI 配置、自动整理规则、布局快照与备份：核验于 2026-10-20；说明助手先读取 CLI skill/describe、检查并备份配置，以及规则和布局备份的边界。
• PecoFence CLI 官方指南：核验于 2026-10-20；列出 config export、规则命令、rule apply --dry-run、超时后的状态复核和导入行为。
• PecoFence v0.2.3 官方发布页：发布于 2026-10-17。该发布页用于确认资源版本；没有说明本教程的操作专属于 v0.2.3。

以上步骤根据公开官方文档编写，未运行命令或操作真实桌面。CLI 的实际输出、规则匹配结果和恢复过程应以你安装的版本及本机配置为准。