FE="python3 /path/to/fast-edit/fast_edit.py"

# 预览
$FE show FILE START END

# 编辑 (行号 1-based, inclusive)
$FE replace FILE START END "content\n"
$FE insert FILE LINE "content\n"        # LINE=0 表示开头
$FE delete FILE START END

# 批量编辑 (JSON)
$FE batch spec.json
echo '{"file":"a.py","edits":[...]}' | $FE batch --stdin

# 粘贴保存
$FE paste FILE                    # 从剪贴板
$FE paste FILE --stdin            # 从 stdin
$FE paste FILE --stdin --extract  # 提取 ```...``` 代码块
$FE paste FILE --stdin --base64   # stdin 内容是 base64 编码

# 批量写文件 (多文件创建)
$FE write spec.json
echo '{"files":[...]}' | $FE write --stdin

# 类型检查
$FE check FILE
$FE check FILE --checker mypy

# 从 OpenCode 存储中提取用户粘贴的大文件 (绕过 AI token 输出瓶颈)
$FE save-pasted FILE                      # 自动找最近的大粘贴 (>=20行)
$FE save-pasted FILE --min-lines 50       # 自定义行数阈值
$FE save-pasted FILE --msg-id msg_xxx     # 指定消息 ID
$FE save-pasted FILE --extract            # 提取 ```...``` 代码块
$FE save-pasted FILE --nth 2              # 第2个最近的大粘贴

{
  "file": "/path/to/file.py",
  "edits": [
    {"action": "replace-lines", "start": 10, "end": 12, "content": "new\n"},
    {"action": "insert-after", "line": 25, "content": "# comment\n"},
    {"action": "delete-lines", "start": 40, "end": 42}
  ]
}

{
  "files": [
    {"file": "/tmp/a.py", "content": "def a():\n    pass\n"},
    {"file": "/tmp/b.py", "content": "```python\ndef b(): pass\n```", "extract": true},
    {"file": "/tmp/c.py", "content": "ZGVmIGMoKTogcGFzcwo=", "encoding": "base64"}
  ]
}

用户: 保存这个到 /tmp/app.py
```python
def main():
    print("hello")

### 用户粘贴含特殊字符的代码 (推荐)

当代码包含引号、`$变量`、反斜杠等特殊字符时，用 base64 避免 shell 转义问题：

```bash
# 用户粘贴: print('hello $USER')
# AI 先 base64 编码，再传给 fast-edit
echo -n "print('hello \$USER')" | base64 | xargs -I{} sh -c 'echo {} | $FE paste /tmp/app.py --stdin --base64'

# 或者更简单：
printf '%s' "print('hello \$USER')" | base64 > /tmp/b64.txt
cat /tmp/b64.txt | $FE paste /tmp/app.py --stdin --base64

# 直接从 OpenCode 的本地存储提取，零 token 输出
$FE save-pasted /tmp/big_file.php

# 然后正常编辑
$FE show /tmp/big_file.php 1 20
$FE replace /tmp/big_file.php 10 12 "new content\n"

用户: 保存这两个文件
file1.py:
```python
def a(): pass

def b(): pass

## 文件结构

## 性能对比

| 场景 | Edit 工具 | fast-edit |
|------|-----------|-----------|
| 500行文件 3处编辑 | ~15s (3次调用) | **<0.1s** (batch) |
| AI Token 输出 | old+new 字符串 | **仅行号+内容** |
| LSP 等待 | 每次 0-5s | **0** |

## 编辑后验证

**推荐**：编辑完成后调用 `lsp_diagnostics` 检查类型错误：

**备选**：如果 LSP 不可用，用 fast-edit 内置的 check 命令：

```bash
$FE check /path/to/edited_file.py