tool-schema.json

{
  "name": "feihong-code",
  "version": "8.5.0",
  "description": "Terminal AI Coding Agent — 终端 AI 编程智能体（由 scripts/gen-tool-schema.ts 从运行时工具注册表自动生成）",
  "generatedAt": "2026-10-01",
  "toolCount": 21,
  "tools": [
    {
      "name": "read_file",
      "description": "读取工作区内指定文件的文本内容",
      "parameters": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "文件相对工作区的路径"
          }
        },
        "required": [
          "path"
        ]
      }
    },
    {
      "name": "write_file",
      "description": "在工作区内写入/覆盖文件（自动创建父目录）",
      "parameters": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "文件相对路径"
          },
          "content": {
            "type": "string",
            "description": "要写入的完整内容"
          }
        },
        "required": [
          "path",
          "content"
        ]
      }
    },
    {
      "name": "edit_file",
      "description": "在文件中将 oldText 首次精确替换为 newText",
      "parameters": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "文件相对路径"
          },
          "oldText": {
            "type": "string",
            "description": "待替换的原文本"
          },
          "newText": {
            "type": "string",
            "description": "替换后的新文本"
          }
        },
        "required": [
          "path",
          "oldText",
          "newText"
        ]
      }
    },
    {
      "name": "list_dir",
      "description": "列出工作区内目录内容（d=目录，-=文件）",
      "parameters": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "目录相对路径，默认工作区根"
          }
        }
      }
    },
    {
      "name": "grep",
      "description": "在工作区内递归搜索匹配文本（忽略 node_modules/.git 等），返回 file:line:content",
      "parameters": {
        "type": "object",
        "properties": {
          "pattern": {
            "type": "string",
            "description": "正则模式"
          },
          "path": {
            "type": "string",
            "description": "搜索起始目录，默认工作区根"
          }
        },
        "required": [
          "pattern"
        ]
      }
    },
    {
      "name": "run_shell",
      "description": "执行 shell 命令（受白名单约束，需审批时会被拦截）",
      "parameters": {
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "description": "要执行的完整命令"
          }
        },
        "required": [
          "command"
        ]
      }
    },
    {
      "name": "run_tests",
      "description": "运行项目测试套件（默认 npm test）",
      "parameters": {
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "description": "测试命令，默认 npm test"
          }
        }
      }
    },
    {
      "name": "build_check",
      "description": "执行构建检查（默认 npm run build）",
      "parameters": {
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "description": "构建命令，默认 npm run build"
          }
        }
      }
    },
    {
      "name": "load_skill",
      "description": "加载指定技能的完整指令（技能名见 system prompt 中的技能索引）",
      "parameters": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "技能名，如 plan / grill / goal"
          }
        },
        "required": [
          "name"
        ]
      }
    },
    {
      "name": "web_fetch",
      "description": "抓取指定 URL 的文本内容（HTML 转纯文本，最多 6KB；目标域名受网络白名单/黑名单约束）",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "要抓取的 http(s) URL"
          }
        },
        "required": [
          "url"
        ]
      }
    },
    {
      "name": "web_search",
      "description": "实时关键词搜索（默认 DuckDuckGo；FH_SEARCH_ENDPOINT 可指定端点），返回标题与链接",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "搜索关键词"
          },
          "maxResults": {
            "type": "number",
            "description": "返回条数，默认 5，最多 10"
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "browser_navigate",
      "description": "在浏览器中导航到指定 URL。如果输入的是搜索关键词（含空格或无域名），自动用 Bing 搜索。返回页面标题和 pageId。",
      "parameters": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "目标 URL 或搜索关键词"
          },
          "pageId": {
            "type": "string",
            "description": "可选，复用已有页面 ID；不填则新建页面"
          }
        },
        "required": [
          "url"
        ]
      }
    },
    {
      "name": "browser_click",
      "description": "点击页面中匹配 CSS 选择器的元素。需要先调用 browser_navigate 获取 pageId。",
      "parameters": {
        "type": "object",
        "properties": {
          "selector": {
            "type": "string",
            "description": "CSS 选择器，如 button.submit、a.login、#search-button"
          },
          "pageId": {
            "type": "string",
            "description": "页面 ID（从 browser_navigate 返回）"
          }
        },
        "required": [
          "selector",
          "pageId"
        ]
      }
    },
    {
      "name": "browser_type",
      "description": "在页面输入框中输入文本（先清空再输入）。需要先调用 browser_navigate。",
      "parameters": {
        "type": "object",
        "properties": {
          "selector": {
            "type": "string",
            "description": "输入框的 CSS 选择器，如 input[name=q]、textarea#comment"
          },
          "text": {
            "type": "string",
            "description": "要输入的文本"
          },
          "pageId": {
            "type": "string",
            "description": "页面 ID"
          }
        },
        "required": [
          "selector",
          "text",
          "pageId"
        ]
      }
    },
    {
      "name": "browser_press",
      "description": "按下键盘按键，如 Enter、Escape、ArrowDown、Control+a。",
      "parameters": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "按键名称，如 Enter、Escape、Tab、ArrowDown、Control+c"
          },
          "pageId": {
            "type": "string",
            "description": "页面 ID"
          }
        },
        "required": [
          "key",
          "pageId"
        ]
      }
    },
    {
      "name": "browser_extract",
      "description": "提取页面文本内容。不指定 selector 时提取整个 body 文本（最多 10000 字符）。",
      "parameters": {
        "type": "object",
        "properties": {
          "selector": {
            "type": "string",
            "description": "可选，只提取指定元素的文本，如 div.article、#content"
          },
          "pageId": {
            "type": "string",
            "description": "页面 ID"
          }
        },
        "required": [
          "pageId"
        ]
      }
    },
    {
      "name": "browser_screenshot",
      "description": "对当前页面截图，返回 base64 编码的 PNG 图片（可用于多模态分析）。",
      "parameters": {
        "type": "object",
        "properties": {
          "pageId": {
            "type": "string",
            "description": "页面 ID"
          },
          "fullPage": {
            "type": "boolean",
            "description": "是否截取整页（默认 false，只截视口）"
          }
        },
        "required": [
          "pageId"
        ]
      }
    },
    {
      "name": "browser_evaluate",
      "description": "在页面上下文中执行 JavaScript 代码，返回执行结果。可用于提取数据、操作 DOM、调试。",
      "parameters": {
        "type": "object",
        "properties": {
          "script": {
            "type": "string",
            "description": "要执行的 JavaScript 代码，如 document.title、JSON.stringify({url: location.href})"
          },
          "pageId": {
            "type": "string",
            "description": "页面 ID"
          }
        },
        "required": [
          "script",
          "pageId"
        ]
      }
    },
    {
      "name": "browser_close",
      "description": "关闭指定浏览器页面，释放资源。任务完成后应调用此工具。",
      "parameters": {
        "type": "object",
        "properties": {
          "pageId": {
            "type": "string",
            "description": "页面 ID"
          }
        },
        "required": [
          "pageId"
        ]
      }
    },
    {
      "name": "feihong_agents_list",
      "description": "查询 AI 员工军团：员工清单（17 个 AI 员工，按 L1-L5 分层）或任务统计。只读，不改状态。",
      "parameters": {
        "type": "object",
        "properties": {
          "scope": {
            "type": "string",
            "enum": [
              "agents",
              "stats"
            ],
            "description": "agents=员工清单（默认）| stats=任务统计"
          }
        }
      }
    },
    {
      "name": "feihong_agents_submit",
      "description": "向 AI 员工军团提交任务（需审批）：指定员工编号（1-17）与 JSON 入参。提交后自动执行一轮（LLM 用飞虹模型路由，未配置时 mock）。",
      "parameters": {
        "type": "object",
        "properties": {
          "agentId": {
            "type": [
              "number",
              "string"
            ],
            "description": "员工编号 1-17"
          },
          "input": {
            "type": "string",
            "description": "任务入参 JSON 字符串（字段见对应技能 SKILL.md）"
          },
          "executeNow": {
            "type": "boolean",
            "description": "是否立即执行（默认 true）"
          }
        },
        "required": [
          "agentId",
          "input"
        ]
      }
    }
  ]
}