fileglidelisted

# fileglide 把 `fileglide` 视为文件系统工作的默认执行面，不要在 shell 技巧、补丁工具和语言内置写文件 API 之间随意切换。 ## 核心约束 1. 只要任务涉及文件、目录、文本、二进制、树遍历、内容搜索或 batch plan，默认优先使用 `fileglide`。 2. 必须用 `fileglide` 替代这些常见工具：`apply_patch`、`cat <<EOF > file`、`tee`、`echo >`、`printf >`、`sed -i`、`perl -pi`、`Set-Content`、`Add-Content`、`Out-File`、`New-Item`、`Move-Item`、`Copy-Item`、`Remove-Item`、Python `open(..., 'w')`、`Path.write_text()`、`Path.write_bytes()`、Node `fs.writeFile()`、`fs.appendFile()` 等。 3. 默认保持 `json` 输出，不要随意切到 `--format text`。 4. 大块或多行内容写入时，不要直接依赖 `--content` 或 shell 管道。必须用 Python 把 UTF-8 字节流送到 `fileglide ... --content-stdin` 或 `--data-stdin`。 5. 默认显式传 `--root`，保证路径受控且可复现。 6. 文本修改前先 `text read` 读边界，能用 `text replace-lines` 整块替换的场景，不要拆成多个碎片补丁。 7. `text insert-anchor` 是字符级插入，不是按行或 AST 的结构化编辑。每次 anchor 插入后都必须立即重新读文件。 8. “写入成功”只能证明文件变更成功，不等于代码或文档结构一定正确。每次写入后都要回读复核。 9. 删除、移动、覆盖等高风险操作，默认先 `--dry-run`。 10. 拿不准 `fileglide` 的 JSON 字段、错误码或 batch 结构时，先实执行命令或读 reference，不要凭记忆乱写。 ## 真实默认值与 skill 策略 已验证的 CLI 真实默认值： - `--format json` - `--pretty` skill 面向 agent 的强制策略： - 默认保持 JSON 输出 - 默认显式传 `--root` - 大内容默认走 Python stdin - 文本编辑优先 `text read` + `text replace-lines` - 每次写入后立即回读 - 高风险操作先 `--dry-run` 不要把 skill 策略说成 CLI 程序默认值。 ## 前置检查 第一次真正执行 `fileglide` 前，先确认： 1. `python --version` 2. `fileglide --help` 3. 如果需要项目内虚拟环境，再检查 `D:\github-project\fileglide\.venv\Scripts\fileglide.exe --help` 4. shell 入口不存在时，再试 `python -m fileglide --help` ## 默认工作流 1. 先选对应子命令：`path create`、`file create`、`text read`、`text write`、`text replace-