AI 能读不能写?两个工具让它真正“动手”改代码

你: 帮我创建一个 hello.py，打印 Hello WorldAI: 好的，我来帮你创建这个文件。    但是我目前只有 read_file 工具，无法写入文件。    你可以手动创建这个文件，内容如下：    print(”Hello World”)    （AI 表示，只有眼睛，没有手，有什么活还是得你自己干）

1. read_file(”main.py”)  → 读入完整内容2. 在脑子里修改3. write_file(”main.py”, 修改后的完整内容)  → 覆盖原文件

1. read_file(”main.py”)  → 找到要改的那几行2. edit_file(”main.py”, old_str=”x = 1”, new_str=”x = 2”)

edit_file(    file_path="main.py",    old_str="x = 1", # 要找的旧文本（必须精确匹配）    new_str="x = 2", # 要替换成的新文本)

{    "type": "function",    "function": {        "name": "write_file",        "description": "创建新文件或覆盖已有文件。如果文件已存在，其内容将被完全替换。",        "parameters": {            "type": "object",            "properties": {                "file_path": {"type": "string", "description": "要写入的文件路径"},                "content": {"type": "string", "description": "要写入的文件完整内容"}            },            "required": ["file_path", "content"]        }    }}

{    "type": "function",    "function": {        "name": "edit_file",        "description": "精确替换文件中的指定内容。找到 old_str 并用 new_str 替换。old_str 必须在文件中精确匹配且唯一。",        "parameters": {            "type": "object",            "properties": {                "file_path": {"type": "string", "description": "要编辑的文件路径"},                "old_str": {"type": "string", "description": "要被替换的原始文本，必须精确匹配（包括空格、缩进、换行）"},                "new_str": {"type": "string", "description": "替换后的新文本"}            },            "required": ["file_path", "old_str", "new_str"]        }    }}

def _write_file(file_path, content):    """创建或覆盖文件"""    try:        os.makedirs(os.path.dirname(file_path) or ".", exist_ok=True)        with open(file_path, "w", encoding="utf-8") as f:            f.write(content)        return f"文件 '{file_path}' 写入成功（{len(content)} 字符）"    except Exception as e:        return f"写入文件失败: {e}"

def _edit_file(file_path, old_str, new_str):    """精确替换文件中的内容"""    try:        with open(file_path, "r", encoding="utf-8") as f:            file_content = f.read()    except FileNotFoundError:        return f"错误：文件 '{file_path}' 不存在，请先使用 read_file 确认"    # 查找 old_str 在文件中的出现次数    count = file_content.count(old_str)    if count == 0:        return f"错误：在文件 '{file_path}' 中未找到指定的 old_str。请使用 read_file 重新读取文件确认内容。"    if count > 1:        return f"错误：old_str 在文件中出现了 {count} 次，不够唯一。请提供更多上下文使 old_str 唯一。"    new_content = file_content.replace(old_str, new_str, 1)    try:        with open(file_path, "w", encoding="utf-8") as f:            f.write(new_content)        return f"文件 '{file_path}' 编辑成功：将 {len(old_str)} 字符替换为 {len(new_str)} 字符"    except Exception as e:        return f"编辑文件失败: {e}"

正确流程：  read_file("main.py")                        ← 先读  edit_file("main.py", old_str="...精确内容...", new_str="...")错误流程：  edit_file("main.py", old_str="...猜测的内容...", new_str="...")    错误：未找到 old_str！  ← 被拒绝    LLM 被迫回头 read_file，再给出正确的 old_str

SYSTEM_PROMPT = """...使用工具时：1. 修改文件前，必须先 read_file 读取文件内容2. 创建新文件用 write_file，修改已有文件用 edit_file3. edit_file 的 old_str 必须从文件中精确复制（包括缩进和空格）4. 如果 edit_file 报错”未找到 old_str”，重新 read_file 后再试..."""

你: 创建一个 hello.py，内容打印 Hello World 并包含一个 main 函数AI: 好的，我来创建这个文件。  执行工具: write_file({'file_path': 'hello.py', 'content': '...'})文件 'hello.py' 写入成功你: 给 hello.py 加上类型注解和文档AI: 让我先读取文件内容。  执行工具: read_file({'file_path': 'hello.py'})def main():    print(”Hello World”)if __name__ == ”__main__”:    main()我看到文件内容了，现在添加类型注解和文档。  执行工具: edit_file({      'file_path': 'hello.py',      'old_str': 'def main():\n    print(”Hello World”)',      'new_str': 'def main() -> None:\n    ”””程序入口，打印问候语”””\n    print(”Hello World”)'  })文件 'hello.py' 编辑成功：42 字符替换为 75 字符已完成！给 main 函数加上了返回类型注解 -> None 和文档字符串。