feat(PHASE-05): 最小 Write 工具 + 工具优先级优化(写文件调用次数大幅下降)
This commit is contained in:
parent
587331cbb8
commit
67f6467da0
2
.gitignore
vendored
2
.gitignore
vendored
@ -14,7 +14,7 @@ venv/
|
|||||||
*.log
|
*.log
|
||||||
logs/
|
logs/
|
||||||
.tmp/
|
.tmp/
|
||||||
|
test/
|
||||||
# IDE
|
# IDE
|
||||||
.vscode/
|
.vscode/
|
||||||
.idea/
|
.idea/
|
||||||
|
|||||||
@ -38,8 +38,10 @@
|
|||||||
|
|
||||||
- `Read`:用于读取文件内容。
|
- `Read`:用于读取文件内容。
|
||||||
- `Glob`:用于按模式查找文件。
|
- `Glob`:用于按模式查找文件。
|
||||||
|
- 创建或覆盖文件时,优先使用 `Write` 工具。
|
||||||
- `Bash`:用于执行必须通过 shell 完成的最小命令。
|
- `Bash`:用于执行必须通过 shell 完成的最小命令。
|
||||||
- 只有在 Bash 确实必要时才使用 Bash。
|
- 只有在 Bash 确实必要时才使用 Bash。
|
||||||
|
- 不要用 Bash 拼接文件内容。
|
||||||
- Windows 环境下优先使用兼容写法,不默认使用 `cat <<EOF`、`ls -la` 等 Unix 风格写法。
|
- Windows 环境下优先使用兼容写法,不默认使用 `cat <<EOF`、`ls -la` 等 Unix 风格写法。
|
||||||
- 同一写入或创建目标,最多尝试 2 种不同 Bash 方案。
|
- 同一写入或创建目标,最多尝试 2 种不同 Bash 方案。
|
||||||
- 如果两次 Bash 方案失败,应立即收敛:
|
- 如果两次 Bash 方案失败,应立即收敛:
|
||||||
|
|||||||
@ -20,6 +20,7 @@
|
|||||||
- 重构时:
|
- 重构时:
|
||||||
- 先找全部用法
|
- 先找全部用法
|
||||||
- 避免修改无关文件
|
- 避免修改无关文件
|
||||||
|
- 需要创建或覆盖文件时,优先使用 `Write` 工具,而不是 `Bash`
|
||||||
- Windows 下先验证 shell 兼容性,再选择命令写法
|
- Windows 下先验证 shell 兼容性,再选择命令写法
|
||||||
|
|
||||||
## 沟通风格
|
## 沟通风格
|
||||||
|
|||||||
@ -43,6 +43,21 @@ def build_default_tools(workspace: Path) -> list[Tool]:
|
|||||||
},
|
},
|
||||||
execute=lambda data: glob_tool(workspace, data),
|
execute=lambda data: glob_tool(workspace, data),
|
||||||
),
|
),
|
||||||
|
Tool(
|
||||||
|
name="Write",
|
||||||
|
description="创建或覆盖工作区内的文本文件。",
|
||||||
|
input_schema={
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"path": {"type": "string", "description": "相对工作区的文件路径"},
|
||||||
|
"content": {"type": "string", "description": "要写入的完整文本内容"},
|
||||||
|
"encoding": {"type": "string", "description": "文件编码,默认 utf-8"},
|
||||||
|
},
|
||||||
|
"required": ["path", "content"],
|
||||||
|
"additionalProperties": False,
|
||||||
|
},
|
||||||
|
execute=lambda data: write_tool(workspace, data),
|
||||||
|
),
|
||||||
Tool(
|
Tool(
|
||||||
name="Bash",
|
name="Bash",
|
||||||
description="在工作区中执行一条 shell 命令。",
|
description="在工作区中执行一条 shell 命令。",
|
||||||
@ -82,6 +97,20 @@ def glob_tool(workspace: Path, data: dict[str, Any]) -> str:
|
|||||||
return "\n".join(matches[:200])
|
return "\n".join(matches[:200])
|
||||||
|
|
||||||
|
|
||||||
|
def write_tool(workspace: Path, data: dict[str, Any]) -> str:
|
||||||
|
path = _safe_path(workspace, str(data["path"]))
|
||||||
|
if path.exists() and path.is_dir():
|
||||||
|
return f"目标是目录,不能写入文件: {path.relative_to(workspace)}"
|
||||||
|
if not path.parent.exists():
|
||||||
|
return f"父目录不存在: {path.parent.relative_to(workspace)}"
|
||||||
|
|
||||||
|
existed = path.exists()
|
||||||
|
encoding = str(data.get("encoding") or "utf-8")
|
||||||
|
path.write_text(str(data["content"]), encoding=encoding)
|
||||||
|
action = "已覆盖" if existed else "已创建"
|
||||||
|
return f"{action}文件: {path.relative_to(workspace)}"
|
||||||
|
|
||||||
|
|
||||||
def bash_tool(workspace: Path, data: dict[str, Any]) -> str:
|
def bash_tool(workspace: Path, data: dict[str, Any]) -> str:
|
||||||
command = str(data["command"])
|
command = str(data["command"])
|
||||||
proc = subprocess.run(
|
proc = subprocess.run(
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user