fix: remove unnecessary uid para & remove filesystem tools in browser toolkit

ARCHITECTURE_IMPROVEMENT.md

@@ -0,0 +1,137 @@
+# 架构改进：移除不必要的 uid 参数
+
+## 问题识别
+
+用户发现了一个架构设计问题：框架在 `agent/tools/registry.py` 中**无条件注入 uid 参数**，导致所有工具函数都必须声明 `uid: str = ""` 参数，即使它们从不使用这个参数。
+
+### 原始实现的问题
+
+```python
+# agent/tools/registry.py (旧代码)
+# 注入 uid - 无条件注入 ❌
+kwargs = {**arguments, "uid": uid}
+
+# 注入 context - 条件注入 ✅
+sig = inspect.signature(func)
+if "context" in sig.parameters:
+    kwargs["context"] = context
+```
+
+**问题**：
+1. ❌ **不一致**：`context` 是条件注入，`uid` 却是无条件注入
+2. ❌ **强制依赖**：所有工具都必须声明 `uid: str = ""`，即使不使用
+3. ❌ **样板代码**：导致大量无用的参数声明和文档
+4. ❌ **违反原则**：违反了"需要什么就传什么"的设计原则
+
+## 解决方案
+
+### 1. 修复框架注入逻辑
+
+将 uid 改为**条件注入**，与 context 保持一致：
+
+```python
+# agent/tools/registry.py (新代码)
+# 准备参数：只注入函数需要的参数
+kwargs = {**arguments}
+sig = inspect.signature(func)
+
+# 注入 uid（如果函数接受） ✅
+if "uid" in sig.parameters:
+    kwargs["uid"] = uid
+
+# 注入 context（如果函数接受） ✅
+if "context" in sig.parameters:
+    kwargs["context"] = context
+```
+
+**优势**：
+- ✅ **一致性**：uid 和 context 都采用条件注入
+- ✅ **灵活性**：工具可以自由选择是否使用 uid
+- ✅ **简洁性**：不需要的工具不必声明 uid 参数
+- ✅ **符合原则**：遵循"需要什么就传什么"的设计原则
+
+### 2. 清理所有 builtin 工具
+
+从所有不使用 uid 的工具中移除了 uid 参数：
+
+#### 修改的文件 (12个)
+
+| 文件 | 修改的函数数量 |
+|------|--------------|
+| `agent/tools/builtin/browser/baseClass.py` | 22 个函数 |
+| `agent/tools/builtin/read.py` | 1 个函数 |
+| `agent/tools/builtin/write.py` | 1 个函数 |
+| `agent/tools/builtin/edit.py` | 1 个函数 |
+| `agent/tools/builtin/bash.py` | 1 个函数 |
+| `agent/tools/builtin/grep.py` | 1 个函数 |
+| `agent/tools/builtin/glob.py` | 1 个函数 |
+| `agent/tools/builtin/search.py` | 2 个函数 |
+| `agent/tools/builtin/goal.py` | 1 个函数 |
+| `agent/tools/builtin/skill.py` | 2 个函数 |
+| `agent/tools/builtin/sandbox.py` | 4 个函数 |
+| **总计** | **37 个函数** |
+
+#### 每个函数的修改
+
+对于每个函数，完成了：
+1. ✅ 从函数签名中移除 `uid: str = ""` 参数
+2. ✅ 从 docstring 中移除 uid 相关的 Args 说明
+3. ✅ 保留其他所有参数和文档不变
+4. ✅ 函数实现逻辑完全未改动
+
+### 3. 验证结果
+
+```bash
+✅ 所有 13 个文件语法检查通过
+✅ 无残留的 uid 参数（grep 检查：0 个匹配）
+```
+
+## 如何使用 uid 参数
+
+如果某个工具**确实需要**使用 uid 参数（例如需要根据用户ID查询数据），只需在函数签名中声明它：
+
+```python
+@tool()
+async def get_user_notes(query: str, uid: str = "") -> ToolResult:
+    """
+    获取用户的笔记
+
+    Args:
+        query: 搜索关键词
+        uid: 用户ID（框架自动注入）
+
+    Returns:
+        ToolResult: 笔记列表
+    """
+    # 使用 uid 查询数据库
+    notes = await db.query_notes(user_id=uid, query=query)
+    return ToolResult(output=notes)
+```
+
+框架会自动检测到 `uid` 参数并注入它。
+
+## 影响范围
+
+### 兼容性
+
+- ✅ **向后兼容**：现有的需要 uid 的工具（如果有的话）仍然可以正常工作
+- ✅ **新工具**：新工具不再需要强制声明 uid 参数
+- ✅ **无破坏性变更**：所有测试应该继续通过
+
+### 代码质量改进
+
+- 📉 **减少样板代码**：移除了 37 个不必要的参数声明
+- 📈 **提高可读性**：函数签名更简洁，只显示真正使用的参数
+- 📈 **提高一致性**：uid 和 context 采用相同的注入模式
+- 📈 **更符合 Python 习惯**：不强制声明未使用的参数
+
+## 总结
+
+这次架构改进：
+
+1. **修复了框架的设计缺陷**：将 uid 从无条件注入改为条件注入
+2. **清理了所有不必要的样板代码**：移除了 37 个函数的 uid 参数
+3. **提高了代码质量**：更简洁、更一致、更符合 Python 习惯
+4. **保持向后兼容**：不影响现有功能
+
+**感谢用户敏锐的观察！** 这个改进使框架更加优雅和易用。

agent/tools/builtin/bash.py

@@ -29,7 +29,6 @@ async def bash_command(
     workdir: Optional[str] = None,
     env: Optional[Dict[str, str]] = None,
     description: str = "",
-    uid: str = "",
     context: Optional[ToolContext] = None
 ) -> ToolResult:
     """
@@ -41,7 +40,6 @@ async def bash_command(
         workdir: 工作目录，默认为当前目录
         env: 环境变量字典（会合并到系统环境变量）
         description: 命令描述（5-10 个词）
-        uid: 用户 ID
         context: 工具上下文
 
     Returns:

agent/tools/builtin/browser/FILE_OPERATIONS.md

@@ -0,0 +1,201 @@
+# Browser-Use 文件操作指南
+
+## 概述
+
+browser-use 的文件系统工具已迁移到使用 `agent.tools.builtin` 中更强大的实现。
+
+## 文件目录说明
+
+### 浏览器专用目录
+- **路径**: `.browser_use_files/` (在当前工作目录下)
+- **用途**: 存储浏览器会话产生的临时文件
+  - 浏览器下载的文件
+  - 上传到浏览器的文件
+  - 页面截图
+  - 浏览器任务生成的数据
+
+### 项目文件
+- **路径**: 项目根目录及其子目录
+- **用途**: 代码、配置、文档等项目文件
+- **工具**: 使用 builtin 文件工具操作
+
+## 文件工具对比
+
+| 功能 | Browser-Use (已移除) | Builtin (推荐使用) | 增强功能 |
+|------|---------------------|-------------------|---------|
+| 读取文件 | `read_file(file_name)` | `read_file(file_path, offset, limit)` | ✅ 分页读取<br>✅ 图片/PDF支持<br>✅ 二进制检测 |
+| 写入文件 | `write_file(file_name, content, append)` | `write_file(file_path, content, append)` | ✅ Diff预览<br>✅ 追加模式 |
+| 编辑文件 | `replace_file(file_name, old_str, new_str)` | `edit_file(file_path, old_string, new_string, replace_all)` | ✅ 9种智能匹配<br>✅ Diff预览 |
+
+## 使用示例
+
+### 1. 写入文件（覆盖模式）
+
+```python
+from agent.tools.builtin.write import write_file
+
+# 保存浏览器抓取的数据
+await write_file(
+    file_path=".browser_use_files/products.json",
+    content='{"products": [...]}',
+    append=False  # 覆盖写入
+)
+```
+
+### 2. 写入文件（追加模式）
+
+```python
+# 持续抓取数据并追加到文件
+for page in range(1, 10):
+    data = await scrape_page(page)
+    await write_file(
+        file_path=".browser_use_files/data.jsonl",
+        content=f"{data}\n",
+        append=True  # 追加写入
+    )
+```
+
+### 3. 读取文件
+
+```python
+from agent.tools.builtin.read import read_file
+
+# 读取之前保存的数据
+result = await read_file(
+    file_path=".browser_use_files/products.json"
+)
+print(result.output)
+
+# 分页读取大文件
+result = await read_file(
+    file_path=".browser_use_files/large_data.txt",
+    offset=1000,  # 从第1000行开始
+    limit=500     # 读取500行
+)
+```
+
+### 4. 编辑文件
+
+```python
+from agent.tools.builtin.edit import edit_file
+
+# 替换配置文件中的值
+await edit_file(
+    file_path="config.json",
+    old_string='"api_key": "old_key"',
+    new_string='"api_key": "new_key"',
+    replace_all=False  # 只替换唯一匹配
+)
+
+# 替换所有匹配项
+await edit_file(
+    file_path="data.txt",
+    old_string="http://",
+    new_string="https://",
+    replace_all=True  # 替换所有
+)
+```
+
+### 5. 在浏览器任务中使用
+
+```python
+from agent.tools.builtin.browser.baseClass import (
+    navigate_to_url,
+    extract_content,
+    done
+)
+from agent.tools.builtin.write import write_file
+from agent.tools.builtin.read import read_file
+
+async def scrape_task():
+    # 1. 导航到目标网站
+    await navigate_to_url("https://example.com/products")
+
+    # 2. 提取内容
+    result = await extract_content(
+        query="提取所有产品的名称、价格和链接"
+    )
+
+    # 3. 保存到浏览器专用目录
+    await write_file(
+        file_path=".browser_use_files/products.json",
+        content=result.output
+    )
+
+    # 4. 读取验证
+    saved = await read_file(
+        file_path=".browser_use_files/products.json"
+    )
+
+    # 5. 标记任务完成
+    await done(
+        text="已提取并保存产品数据",
+        success=True,
+        files_to_display=[".browser_use_files/products.json"]
+    )
+```
+
+## 智能匹配示例
+
+Builtin 的 `edit_file` 支持9种智能匹配策略，比简单的字符串替换更灵活：
+
+```python
+# 即使缩进不同也能匹配
+await edit_file(
+    file_path="script.py",
+    old_string="""
+def foo():
+    print("hello")
+    """,
+    new_string="""
+def foo():
+    print("world")
+    """
+)
+
+# 支持空白归一化匹配
+await edit_file(
+    file_path="config.txt",
+    old_string="key  =   value",  # 多个空格
+    new_string="key = new_value"  # 会正确匹配并替换
+)
+```
+
+## 最佳实践
+
+1. **浏览器临时文件**: 使用 `.browser_use_files/` 目录
+   ```python
+   await write_file(".browser_use_files/temp_data.json", data)
+   ```
+
+2. **项目文件**: 使用相对或绝对路径
+   ```python
+   await write_file("output/results.csv", csv_data)
+   await edit_file("config.yaml", old_val, new_val)
+   ```
+
+3. **大文件处理**: 使用分页读取
+   ```python
+   # 每次读取2000行
+   offset = 0
+   while True:
+       result = await read_file("large.txt", offset=offset, limit=2000)
+       if not result.metadata.get("truncated"):
+           break
+       offset += 2000
+   ```
+
+4. **数据追加**: 使用append模式
+   ```python
+   # 持续写入日志
+   await write_file("logs.txt", f"{timestamp}: {message}\n", append=True)
+   ```
+
+## 注意事项
+
+- ✅ Builtin工具支持绝对路径和相对路径
+- ✅ 自动创建父目录
+- ✅ 提供详细的diff预览
+- ✅ 支持UTF-8编码
+- ⚠️ 二进制文件建议使用Python标准库直接操作
+- ⚠️ 大文件（>50KB）会被截断显示，但完整内容会保存在metadata中

agent/tools/builtin/browser/baseClass.py

@@ -15,6 +15,12 @@ Native Browser-Use Tools Adapter
 1. 在 Agent 初始化时调用 init_browser_session()
 2. 使用各个工具函数执行浏览器操作
 3. 任务结束时调用 cleanup_browser_session()
+
+文件操作说明：
+- 浏览器专用文件目录：.browser_use_files/ (在当前工作目录下)
+  用于存储浏览器会话产生的临时文件（下载、上传、截图等）
+- 一般文件操作：请使用 agent.tools.builtin 中的文件工具 (read_file, write_file, edit_file)
+  这些工具功能更完善，支持diff预览、智能匹配、分页读取等
 """
 
 import sys
@@ -119,7 +125,9 @@ async def init_browser_session(
     # 创建工具实例
     _browser_tools = Tools()
 
-    # 创建文件系统实例（用于文件操作）
+    # 创建文件系统实例（用于浏览器会话产生的文件）
+    # 注意：这个目录仅用于浏览器操作相关的临时文件（下载、上传、截图等）
+    # 对于一般文件读写操作，请使用 agent.tools.builtin 中的文件工具
     base_dir = Path.cwd() / ".browser_use_files"
     base_dir.mkdir(parents=True, exist_ok=True)
     _file_system = FileSystem(base_dir=str(base_dir))
@@ -315,7 +323,7 @@ def _fetch_profile_id(cookie_type: str) -> Optional[str]:
 # ============================================================
 
 @tool()
-async def navigate_to_url(url: str, new_tab: bool = False, uid: str = "") -> ToolResult:
+async def navigate_to_url(url: str, new_tab: bool = False) -> ToolResult:
     """
     导航到指定的 URL
     Navigate to a specific URL
@@ -325,7 +333,6 @@ async def navigate_to_url(url: str, new_tab: bool = False, uid: str = "") -> Too
     Args:
         url: 要访问的 URL 地址
         new_tab: 是否在新标签页中打开（默认 False）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含导航结果的工具返回对象
@@ -356,7 +363,7 @@ async def navigate_to_url(url: str, new_tab: bool = False, uid: str = "") -> Too
 
 
 @tool()
-async def search_web(query: str, engine: str = "google", uid: str = "") -> ToolResult:
+async def search_web(query: str, engine: str = "google") -> ToolResult:
     """
     使用搜索引擎搜索
     Search the web using a search engine
@@ -364,7 +371,6 @@ async def search_web(query: str, engine: str = "google", uid: str = "") -> ToolR
     Args:
         query: 搜索关键词
         engine: 搜索引擎 (google, duckduckgo, bing) - 默认: google
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 搜索结果
@@ -394,16 +400,13 @@ async def search_web(query: str, engine: str = "google", uid: str = "") -> ToolR
 
 
 @tool()
-async def go_back(uid: str = "") -> ToolResult:
+async def go_back() -> ToolResult:
     """
     返回到上一个页面
     Go back to the previous page
 
     模拟浏览器的"后退"按钮功能。
 
-    Args:
-        uid: 用户 ID（由框架自动注入）
-
     Returns:
         ToolResult: 包含返回操作结果的工具返回对象
     """
@@ -424,7 +427,7 @@ async def go_back(uid: str = "") -> ToolResult:
 
 
 @tool()
-async def wait(seconds: int = 3, uid: str = "") -> ToolResult:
+async def wait(seconds: int = 3) -> ToolResult:
     """
     等待指定的秒数
     Wait for a specified number of seconds
@@ -433,7 +436,6 @@ async def wait(seconds: int = 3, uid: str = "") -> ToolResult:
 
     Args:
         seconds: 等待时间（秒），最大30秒
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含等待操作结果的工具返回对象
@@ -462,14 +464,13 @@ async def wait(seconds: int = 3, uid: str = "") -> ToolResult:
 # ============================================================
 
 @tool()
-async def click_element(index: int, uid: str = "") -> ToolResult:
+async def click_element(index: int) -> ToolResult:
     """
     通过索引点击页面元素
     Click an element by index
 
     Args:
         index: 元素索引（从浏览器状态中获取）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含点击操作结果的工具返回对象
@@ -500,7 +501,7 @@ async def click_element(index: int, uid: str = "") -> ToolResult:
 
 
 @tool()
-async def input_text(index: int, text: str, clear: bool = True, uid: str = "") -> ToolResult:
+async def input_text(index: int, text: str, clear: bool = True) -> ToolResult:
     """
     在指定元素中输入文本
     Input text into an element
@@ -509,7 +510,6 @@ async def input_text(index: int, text: str, clear: bool = True, uid: str = "") -
         index: 元素索引（从浏览器状态中获取）
         text: 要输入的文本内容
         clear: 是否先清除现有文本（默认 True）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含输入操作结果的工具返回对象
@@ -539,7 +539,7 @@ async def input_text(index: int, text: str, clear: bool = True, uid: str = "") -
 
 
 @tool()
-async def send_keys(keys: str, uid: str = "") -> ToolResult:
+async def send_keys(keys: str) -> ToolResult:
     """
     发送键盘按键或快捷键
     Send keyboard keys or shortcuts
@@ -551,7 +551,6 @@ async def send_keys(keys: str, uid: str = "") -> ToolResult:
               - 单个按键: "Enter", "Escape", "PageDown", "Tab"
               - 组合键: "Control+o", "Shift+Tab", "Alt+F4"
               - 功能键: "F1", "F2", ..., "F12"
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含按键操作结果的工具返回对象
@@ -580,7 +579,7 @@ async def send_keys(keys: str, uid: str = "") -> ToolResult:
 
 
 @tool()
-async def upload_file(index: int, path: str, uid: str = "") -> ToolResult:
+async def upload_file(index: int, path: str) -> ToolResult:
     """
     上传文件到文件输入元素
     Upload a file to a file input element
@@ -588,7 +587,6 @@ async def upload_file(index: int, path: str, uid: str = "") -> ToolResult:
     Args:
         index: 文件输入框的元素索引
         path: 要上传的文件路径（绝对路径）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含上传操作结果的工具返回对象
@@ -627,7 +625,7 @@ async def upload_file(index: int, path: str, uid: str = "") -> ToolResult:
 
 @tool()
 async def scroll_page(down: bool = True, pages: float = 1.0,
-                     index: Optional[int] = None, uid: str = "") -> ToolResult:
+                     index: Optional[int] = None) -> ToolResult:
     """
     滚动页面或元素
     Scroll the page or a specific element
@@ -636,7 +634,6 @@ async def scroll_page(down: bool = True, pages: float = 1.0,
         down: True 向下滚动，False 向上滚动
         pages: 滚动页数（0.5=半页，1=全页，10=滚动到底部/顶部）
         index: 可选，滚动特定元素（如下拉框内部）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 滚动结果
@@ -668,7 +665,7 @@ async def scroll_page(down: bool = True, pages: float = 1.0,
 
 
 @tool()
-async def find_text(text: str, uid: str = "") -> ToolResult:
+async def find_text(text: str) -> ToolResult:
     """
     查找页面中的文本并滚动到该位置
     Find text on the page and scroll to it
@@ -677,7 +674,6 @@ async def find_text(text: str, uid: str = "") -> ToolResult:
 
     Args:
         text: 要查找的文本内容
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含查找结果的工具返回对象
@@ -705,16 +701,13 @@ async def find_text(text: str, uid: str = "") -> ToolResult:
 
 
 @tool()
-async def screenshot(uid: str = "") -> ToolResult:
+async def screenshot() -> ToolResult:
     """
     请求在下次观察中包含页面截图
     Request a screenshot to be included in the next observation
 
     用于视觉检查页面状态，帮助理解页面布局和内容。
 
-    Args:
-        uid: 用户 ID（由框架自动注入）
-
     Returns:
         ToolResult: 包含截图请求结果的工具返回对象
 
@@ -745,14 +738,13 @@ async def screenshot(uid: str = "") -> ToolResult:
 # ============================================================
 
 @tool()
-async def switch_tab(tab_id: str, uid: str = "") -> ToolResult:
+async def switch_tab(tab_id: str) -> ToolResult:
     """
     切换到指定标签页
     Switch to a different browser tab
 
     Args:
         tab_id: 4字符标签ID（target_id 的最后4位）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 切换结果
@@ -781,14 +773,13 @@ async def switch_tab(tab_id: str, uid: str = "") -> ToolResult:
 
 
 @tool()
-async def close_tab(tab_id: str, uid: str = "") -> ToolResult:
+async def close_tab(tab_id: str) -> ToolResult:
     """
     关闭指定标签页
     Close a browser tab
 
     Args:
         tab_id: 4字符标签ID
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 关闭结果
@@ -821,14 +812,13 @@ async def close_tab(tab_id: str, uid: str = "") -> ToolResult:
 # ============================================================
 
 @tool()
-async def get_dropdown_options(index: int, uid: str = "") -> ToolResult:
+async def get_dropdown_options(index: int) -> ToolResult:
     """
     获取下拉框的所有选项
     Get options from a dropdown element
 
     Args:
         index: 下拉框的元素索引
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含所有选项的结果
@@ -856,7 +846,7 @@ async def get_dropdown_options(index: int, uid: str = "") -> ToolResult:
 
 
 @tool()
-async def select_dropdown_option(index: int, text: str, uid: str = "") -> ToolResult:
+async def select_dropdown_option(index: int, text: str) -> ToolResult:
     """
     选择下拉框选项
     Select an option from a dropdown
@@ -864,7 +854,6 @@ async def select_dropdown_option(index: int, text: str, uid: str = "") -> ToolRe
     Args:
         index: 下拉框的元素索引
         text: 要选择的选项文本（精确匹配）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 选择结果
@@ -898,7 +887,7 @@ async def select_dropdown_option(index: int, text: str, uid: str = "") -> ToolRe
 
 @tool()
 async def extract_content(query: str, extract_links: bool = False,
-                         start_from_char: int = 0, uid: str = "") -> ToolResult:
+                         start_from_char: int = 0) -> ToolResult:
     """
     使用 LLM 从页面提取结构化数据
     Extract content from the current page using LLM
@@ -907,7 +896,6 @@ async def extract_content(query: str, extract_links: bool = False,
         query: 提取查询（告诉 LLM 要提取什么内容）
         extract_links: 是否提取链接（默认 False，节省 token）
         start_from_char: 从哪个字符开始提取（用于分页提取大内容）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 提取的内容
@@ -946,16 +934,13 @@ async def extract_content(query: str, extract_links: bool = False,
 
 
 @tool()
-async def get_page_html(uid: str = "") -> ToolResult:
+async def get_page_html() -> ToolResult:
     """
     获取当前页面的完整 HTML
     Get the full HTML of the current page
 
     返回当前页面的完整 HTML 源代码。
 
-    Args:
-        uid: 用户 ID（由框架自动注入）
-
     Returns:
         ToolResult: 包含页面 HTML 的工具返回对象
 
@@ -1011,16 +996,13 @@ async def get_page_html(uid: str = "") -> ToolResult:
 
 
 @tool()
-async def get_selector_map(uid: str = "") -> ToolResult:
+async def get_selector_map() -> ToolResult:
     """
     获取当前页面的元素索引映射
     Get the selector map of interactive elements on the current page
 
     返回页面所有可交互元素的索引字典，用于后续的元素操作。
 
-    Args:
-        uid: 用户 ID（由框架自动注入）
-
     Returns:
         ToolResult: 包含元素映射的工具返回对象
 
@@ -1070,7 +1052,7 @@ async def get_selector_map(uid: str = "") -> ToolResult:
 # ============================================================
 
 @tool()
-async def evaluate(code: str, uid: str = "") -> ToolResult:
+async def evaluate(code: str) -> ToolResult:
     """
     在页面中执行 JavaScript 代码
     Execute JavaScript code in the page context
@@ -1079,7 +1061,6 @@ async def evaluate(code: str, uid: str = "") -> ToolResult:
 
     Args:
         code: 要执行的 JavaScript 代码字符串
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含执行结果的工具返回对象
@@ -1113,7 +1094,7 @@ async def evaluate(code: str, uid: str = "") -> ToolResult:
 
 
 @tool()
-async def ensure_login_with_cookies(cookie_type: str, url: str = "https://www.xiaohongshu.com", uid: str = "") -> ToolResult:
+async def ensure_login_with_cookies(cookie_type: str, url: str = "https://www.xiaohongshu.com") -> ToolResult:
     """
     检查登录状态并在需要时注入 cookies
     """
@@ -1204,149 +1185,13 @@ async def ensure_login_with_cookies(cookie_type: str, url: str = "https://www.xi
         )
 
 
-# ============================================================
-# 文件系统工具 (File System Tools)
-# ============================================================
-
-@tool()
-async def write_file(file_name: str, content: str, append: bool = False, uid: str = "") -> ToolResult:
-    """
-    写入文件到本地文件系统
-    Write content to a local file
-
-    支持多种文件格式的写入操作。
-
-    Args:
-        file_name: 文件名（包含扩展名）
-        content: 要写入的文件内容
-        append: 是否追加模式（默认 False，覆盖写入）
-        uid: 用户 ID（由框架自动注入）
-
-    Returns:
-        ToolResult: 包含写入结果的工具返回对象
-
-    Example:
-        write_file("output.txt", "Hello World")
-        write_file("data.json", '{"key": "value"}')
-
-    Note:
-        支持的文件格式: .txt, .md, .json, .jsonl, .csv, .pdf
-    """
-    try:
-        browser, tools = await get_browser_session()
-
-        result = await tools.write_file(
-            file_name=file_name,
-            content=content,
-            append=append,
-            file_system=_file_system
-        )
-
-        return action_result_to_tool_result(result, f"写入文件: {file_name}")
-
-    except Exception as e:
-        return ToolResult(
-            title="写入文件失败",
-            output="",
-            error=f"Failed to write file: {str(e)}",
-            long_term_memory=f"写入文件 {file_name} 失败"
-        )
-
-
-@tool()
-async def read_file(file_name: str, uid: str = "") -> ToolResult:
-    """
-    读取文件内容
-    Read content from a local file
-
-    支持多种文件格式的读取操作。
-
-    Args:
-        file_name: 文件名（包含扩展名）
-        uid: 用户 ID（由框架自动注入）
-
-    Returns:
-        ToolResult: 包含文件内容的工具返回对象
-
-    Example:
-        read_file("input.txt")
-        read_file("data.json")
-
-    Note:
-        支持的文件格式: 文本文件、PDF、DOCX、图片等
-    """
-    try:
-        browser, tools = await get_browser_session()
-
-        result = await tools.read_file(
-            file_name=file_name,
-            available_file_paths=[],
-            file_system=_file_system
-        )
-
-        return action_result_to_tool_result(result, f"读取文件: {file_name}")
-
-    except Exception as e:
-        return ToolResult(
-            title="读取文件失败",
-            output="",
-            error=f"Failed to read file: {str(e)}",
-            long_term_memory=f"读取文件 {file_name} 失败"
-        )
-
-
-@tool()
-async def replace_file(file_name: str, old_str: str, new_str: str, uid: str = "") -> ToolResult:
-    """
-    替换文件中的特定文本
-    Replace specific text in a file
-
-    在文件中查找并替换指定的文本内容。
-
-    Args:
-        file_name: 文件名（包含扩展名）
-        old_str: 要替换的文本
-        new_str: 新文本
-        uid: 用户 ID（由框架自动注入）
-
-    Returns:
-        ToolResult: 包含替换结果的工具返回对象
-
-    Example:
-        replace_file("config.txt", "old_value", "new_value")
-
-    Note:
-        - 会替换文件中所有匹配的文本
-        - 如果找不到要替换的文本，会返回警告
-    """
-    try:
-        browser, tools = await get_browser_session()
-
-        result = await tools.replace_file(
-            file_name=file_name,
-            old_str=old_str,
-            new_str=new_str,
-            file_system=_file_system
-        )
-
-        return action_result_to_tool_result(result, f"替换文件内容: {file_name}")
-
-    except Exception as e:
-        return ToolResult(
-            title="替换文件失败",
-            output="",
-            error=f"Failed to replace file content: {str(e)}",
-            long_term_memory=f"替换文件 {file_name} 失败"
-        )
-
-
 # ============================================================
 # 等待用户操作工具 (Wait for User Action)
 # ============================================================
 
 @tool()
 async def wait_for_user_action(message: str = "Please complete the action in browser",
-                               timeout: int = 300, uid: str = "") -> ToolResult:
+                               timeout: int = 300) -> ToolResult:
     """
     等待用户在浏览器中完成操作（如登录）
     Wait for user to complete an action in the browser (e.g., login)
@@ -1356,7 +1201,6 @@ async def wait_for_user_action(message: str = "Please complete the action in bro
     Args:
         message: 提示用户需要完成的操作
         timeout: 最大等待时间（秒），默认 300 秒（5 分钟）
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 包含等待结果的工具返回对象
@@ -1419,7 +1263,7 @@ async def wait_for_user_action(message: str = "Please complete the action in bro
 
 @tool()
 async def done(text: str, success: bool = True,
-              files_to_display: Optional[List[str]] = None, uid: str = "") -> ToolResult:
+              files_to_display: Optional[List[str]] = None) -> ToolResult:
     """
     标记任务完成并返回最终消息
     Mark the task as complete and return final message to user
@@ -1428,7 +1272,6 @@ async def done(text: str, success: bool = True,
         text: 给用户的最终消息
         success: 任务是否成功完成
         files_to_display: 可选的要显示的文件路径列表
-        uid: 用户 ID（由框架自动注入）
 
     Returns:
         ToolResult: 完成结果
@@ -1634,11 +1477,6 @@ __all__ = [
     'evaluate',
     'ensure_login_with_cookies',
 
-    # 文件系统工具
-    'write_file',
-    'read_file',
-    'replace_file',
-
     # 等待用户操作
     'wait_for_user_action',
 

agent/tools/builtin/edit.py

@@ -23,7 +23,6 @@ async def edit_file(
     old_string: str,
     new_string: str,
     replace_all: bool = False,
-    uid: str = "",
     context: Optional[ToolContext] = None
 ) -> ToolResult:
     """
@@ -45,7 +44,6 @@ async def edit_file(
         old_string: 要替换的文本
         new_string: 替换后的文本
         replace_all: 是否替换所有匹配（默认 False，只替换唯一匹配）
-        uid: 用户 ID
         context: 工具上下文
 
     Returns:

agent/tools/builtin/glob.py

@@ -23,7 +23,6 @@ LIMIT = 100  # 最大返回数量（参考 opencode glob.ts:35）
 async def glob_files(
     pattern: str,
     path: Optional[str] = None,
-    uid: str = "",
     context: Optional[ToolContext] = None
 ) -> ToolResult:
     """
@@ -34,7 +33,6 @@ async def glob_files(
     Args:
         pattern: glob 模式（如 "*.py", "src/**/*.ts"）
         path: 搜索目录（默认当前目录）
-        uid: 用户 ID
         context: 工具上下文
 
     Returns:

agent/tools/builtin/goal.py

@@ -30,7 +30,6 @@ async def goal(
     done: Optional[str] = None,
     abandon: Optional[str] = None,
     focus: Optional[str] = None,
-    uid: str = "",
     context: Optional[dict] = None
 ) -> str:
     """

agent/tools/builtin/grep.py

@@ -26,7 +26,6 @@ async def grep_content(
     pattern: str,
     path: Optional[str] = None,
     include: Optional[str] = None,
-    uid: str = "",
     context: Optional[ToolContext] = None
 ) -> ToolResult:
     """
@@ -40,7 +39,6 @@ async def grep_content(
         pattern: 正则表达式模式
         path: 搜索目录（默认当前目录）
         include: 文件模式（如 "*.py", "*.{ts,tsx}"）
-        uid: 用户 ID
         context: 工具上下文
 
     Returns:

agent/tools/builtin/read.py

@@ -28,7 +28,6 @@ async def read_file(
     file_path: str,
     offset: int = 0,
     limit: int = DEFAULT_READ_LIMIT,
-    uid: str = "",
     context: Optional[ToolContext] = None
 ) -> ToolResult:
     """
@@ -40,7 +39,6 @@ async def read_file(
         file_path: 文件路径（绝对路径或相对路径）
         offset: 起始行号（从 0 开始）
         limit: 读取行数（默认 2000 行）
-        uid: 用户 ID（自动注入）
         context: 工具上下文
 
     Returns:

agent/tools/builtin/sandbox.py

@@ -54,7 +54,6 @@ async def sandbox_create_environment(
     server_url: str = None,
     timeout: float = DEFAULT_TIMEOUT,
     context: Optional[ToolContext] = None,
-    uid: str = "",
 ) -> ToolResult:
     """
     创建一个隔离的 Docker 开发环境。
@@ -150,7 +149,6 @@ async def sandbox_run_shell(
     server_url: str = None,
     request_timeout: float = DEFAULT_TIMEOUT,
     context: Optional[ToolContext] = None,
-    uid: str = "",
 ) -> ToolResult:
     """
     在指定的沙盒中执行 Shell 命令。
@@ -271,7 +269,6 @@ async def sandbox_rebuild_with_ports(
     server_url: str = None,
     timeout: float = DEFAULT_TIMEOUT,
     context: Optional[ToolContext] = None,
-    uid: str = "",
 ) -> ToolResult:
     """
     重建沙盒并应用新的端口映射。
@@ -367,7 +364,6 @@ async def sandbox_destroy_environment(
     server_url: str = None,
     timeout: float = DEFAULT_TIMEOUT,
     context: Optional[ToolContext] = None,
-    uid: str = "",
 ) -> ToolResult:
     """
     销毁沙盒环境，释放资源。

agent/tools/builtin/search.py

@@ -77,7 +77,6 @@ async def search_posts(
     channel: str = "xhs",
     cursor: str = "0",
     max_count: int = 5,
-    uid: str = "",
 ) -> ToolResult:
     """
     帖子搜索
@@ -98,7 +97,6 @@ async def search_posts(
             - weibo: 微博
         cursor: 分页游标，默认为 "0"（第一页）
         max_count: 返回的最大条数，默认为 5
-        uid: 用户ID（自动注入）
 
     Returns:
         ToolResult 包含搜索结果：
@@ -185,7 +183,6 @@ async def search_posts(
 async def get_search_suggestions(
     keyword: str,
     channel: str = "xhs",
-    uid: str = "",
 ) -> ToolResult:
     """
     获取搜索关键词补全建议
@@ -202,7 +199,6 @@ async def get_search_suggestions(
             - douyin: 抖音
             - bili: B站
             - zhihu: 知乎
-        uid: 用户ID（自动注入）
 
     Returns:
         ToolResult 包含建议词数据：

agent/tools/builtin/skill.py

@@ -71,7 +71,6 @@ def _check_skill_setup(skill_name: str) -> Optional[str]:
 async def skill(
     skill_name: str,
     skills_dir: Optional[str] = None,
-    uid: str = ""
 ) -> ToolResult:
     """
     加载指定的 skill 文档
@@ -79,7 +78,6 @@ async def skill(
     Args:
         skill_name: Skill 名称（如 "browser-use", "error-handling"）
         skills_dir: Skills 目录路径（可选，默认按优先级查找）
-        uid: 用户 ID（自动注入）
 
     Returns:
         ToolResult: 包含 skill 的详细内容
@@ -187,14 +185,12 @@ async def skill(
 )
 async def list_skills(
     skills_dir: Optional[str] = None,
-    uid: str = ""
 ) -> ToolResult:
     """
     列出所有可用的 skills
 
     Args:
         skills_dir: Skills 目录路径（可选）
-        uid: 用户 ID（自动注入）
 
     Returns:
         ToolResult: 包含所有 skills 的列表

agent/tools/builtin/write.py

@@ -5,6 +5,7 @@ Write Tool - 文件写入工具
 
 核心功能：
 - 创建新文件或覆盖现有文件
+- 支持追加模式（append）
 - 生成 diff 预览
 """
 
@@ -15,22 +16,22 @@ import difflib
 from agent.tools import tool, ToolResult, ToolContext
 
 
-@tool(description="写入文件内容（创建新文件或覆盖现有文件）")
+@tool(description="写入文件内容（创建新文件、覆盖现有文件或追加内容）")
 async def write_file(
     file_path: str,
     content: str,
-    uid: str = "",
+    append: bool = False,
     context: Optional[ToolContext] = None
 ) -> ToolResult:
     """
     写入文件
 
-    参考 OpenCode 实现
+    参考 OpenCode 实现，并添加追加模式支持
 
     Args:
         file_path: 文件路径
         content: 文件内容
-        uid: 用户 ID
+        append: 是否追加模式（默认 False，覆盖写入）
         context: 工具上下文
 
     Returns:
@@ -59,9 +60,15 @@ async def write_file(
         except Exception:
             old_content = ""
 
+    # 确定最终内容
+    if append and existed:
+        new_content = old_content + content
+    else:
+        new_content = content
+
     # 生成 diff
     if existed and old_content:
-        diff = _create_diff(str(path), old_content, content)
+        diff = _create_diff(str(path), old_content, new_content)
     else:
         diff = f"(新建文件: {path.name})"
 
@@ -71,7 +78,7 @@ async def write_file(
     # 写入文件
     try:
         with open(path, 'w', encoding='utf-8') as f:
-            f.write(content)
+            f.write(new_content)
     except Exception as e:
         return ToolResult(
             title="写入失败",
@@ -80,17 +87,26 @@ async def write_file(
         )
 
     # 统计
-    lines = content.count('\n')
+    lines = new_content.count('\n')
+
+    # 构建操作描述
+    if append and existed:
+        operation = "追加内容到"
+    elif existed:
+        operation = "覆盖"
+    else:
+        operation = "创建"
 
     return ToolResult(
         title=path.name,
-        output=f"文件写入成功\n\n{diff}",
+        output=f"文件写入成功 ({operation})\n\n{diff}",
         metadata={
             "existed": existed,
+            "append": append,
             "lines": lines,
             "diff": diff
         },
-        long_term_memory=f"{'覆盖' if existed else '创建'}文件 {path.name}"
+        long_term_memory=f"{operation}文件 {path.name}"
     )
 
 

agent/tools/registry.py

@@ -211,11 +211,15 @@ class ToolRegistry:
 				current_url = context.get("page_url") if context else None
 				arguments = replace_sensitive_data(arguments, sensitive_data, current_url)
 
-			# 注入 uid
-			kwargs = {**arguments, "uid": uid}
+			# 准备参数：只注入函数需要的参数
+			kwargs = {**arguments}
+			sig = inspect.signature(func)
+
+			# 注入 uid（如果函数接受）
+			if "uid" in sig.parameters:
+				kwargs["uid"] = uid
 
 			# 注入 context（如果函数接受）
-			sig = inspect.signature(func)
 			if "context" in sig.parameters:
 				kwargs["context"] = context