Files
AgentLab/backend/app/tools/builtin/files.py
T
ThearchyHelios dead51ae56 数据目录里的文件一律先写临时文件再改名:新增 core/atomic(同目录、带随机后缀的临时文件,写完 os.replace;只该生成一次的用 os.link 建,已有就不动)
- 工件(内容寻址):以前共用 <id>.tmp,两个进程同时写同一份内容时后到的会截断先到的半成品、先到的改名又让后到的改名失败;现在各写各的临时文件
- 加密密钥 .secret_key、断言签名私钥:几个进程同时第一次启动时只建出一把,后到的读先到的那一把(以前各生成一把,各自加密、签名的东西对方认不得),文件从建出来起就是 0600
- 附件抽出文字的缓存:临时文件名带随机后缀
- 文件工具(file_write)的覆盖和追加、三种系统沙箱写进工作目录的代码和输入文件、seatbelt 的策略文件:先写临时文件再改名
- 上传表格的版本库、原件存档、记录表本来就是这样写的,不动
2026-10-19 10:01:20 +08:00

112 lines
3.7 KiB
Python

from __future__ import annotations
from pathlib import Path
from typing import Any
from pydantic import BaseModel, Field
from app.core import atomic
from app.core.config import settings
from app.tools.registry import ToolContext, register
_MAX_READ = 200_000
def _resolve(rel: str, ctx: ToolContext) -> Path:
"""把相对路径锁死在这次运行自己的工作目录里。
两道关都要过:session_dir() 先净化 session_id 再定根目录,然后 rel
先 resolve 再比对根。少了第一道,`../../etc/passwd` 里的越界检查就是
在一个被挪到 /etc 的"根"下面做的,检查照样通过——这正是之前的漏洞。
"""
root = settings.session_dir(ctx.sandbox_session)
root.mkdir(parents=True, exist_ok=True)
target = (root / rel.lstrip("/")).resolve()
if target != root and root not in target.parents:
raise ValueError(f"路径越界:{rel}")
return target
class FileReadArgs(BaseModel):
path: str = Field(description="相对工作目录的文件路径")
@register(
name="file_read",
category="文件",
description="读取工作目录下的文件内容。",
args_schema=FileReadArgs,
)
async def file_read(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
args = FileReadArgs(**kwargs)
try:
target = _resolve(args.path, ctx)
except ValueError as e:
return {"error": str(e)}
if not target.exists():
return {"error": f"文件不存在:{args.path}"}
if target.is_dir():
return {"error": f"{args.path} 是目录,请使用 file_list"}
data = target.read_bytes()[:_MAX_READ]
return {
"path": args.path,
"size": target.stat().st_size,
"content": data.decode("utf-8", errors="replace"),
"truncated": target.stat().st_size > _MAX_READ,
}
class FileWriteArgs(BaseModel):
path: str = Field(description="相对工作目录的文件路径")
content: str = Field(description="要写入的内容")
append: bool = Field(default=False, description="追加而不是覆盖")
@register(
name="file_write",
category="文件",
description="写入文件到工作目录。父目录会自动创建。",
args_schema=FileWriteArgs,
dangerous=True,
)
async def file_write(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
args = FileWriteArgs(**kwargs)
try:
target = _resolve(args.path, ctx)
except ValueError as e:
return {"error": str(e)}
# 先写临时文件再改名(core/atomic):同一个工作目录里正在跑的代码、另一台机器上读共享数据目录的一方,看到的要么是
# 旧的整份、要么是新的整份。追加也一样:读出原有的、接上新的、整份换掉
before = target.read_bytes() if args.append and target.is_file() else b""
atomic.write_bytes(target, before + args.content.encode("utf-8"))
return {"path": args.path, "bytes": target.stat().st_size, "ok": True}
class FileListArgs(BaseModel):
path: str = Field(default=".", description="要列出的目录")
@register(
name="file_list",
category="文件",
description="列出工作目录下的文件。",
args_schema=FileListArgs,
)
async def file_list(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
args = FileListArgs(**kwargs)
try:
target = _resolve(args.path, ctx)
except ValueError as e:
return {"error": str(e)}
if not target.exists():
return {"path": args.path, "entries": []}
entries = [
{
"name": p.name,
"type": "dir" if p.is_dir() else "file",
"size": p.stat().st_size if p.is_file() else None,
}
for p in sorted(target.iterdir())[:500]
]
return {"path": args.path, "entries": entries}