Agent Core 本地工具
需求
本地工具在 Alice 主进程执行，不要求 Minecraft Adapter 提供同名实现。它们会与当前工作区工具合并；同名时本地定义优先。以下仅写源码可确认的接口，不承诺固定总数。
架构
网页与 Wiki
| 工具 | 参数 | 返回 | 风险 |
|---|---|---|---|
web_search | query:string；limit?:number（默认 5，最大 10）；format? | ToolResult<string>，正文为 Markdown | 发起网络请求；只读 |
web_fetch | url:string（http/https）；format? | ToolResult<string> | 访问指定外部 URL；可能接触不可信内容 |
minecraft_wiki_search | query:string；limit?（默认 5，最大 20）；format? | ToolResult<string> | 网络只读 |
minecraft_wiki_get_page | title:string；mode?: summary/full；format? | 页面摘要或完整内容 | full 内容可能较大 |
minecraft_wiki_get_section | title:string,section_index:number,format? | 指定章节 Markdown | 网络只读 |
所有上述 ToolResult 都包含 success、成功时的 data 或失败时的 error，并记录 duration。
地图与任务
- 地图：
map_query_nearby、map_get_overview。读取本地地图索引；参数与返回以当前工作区 Schema 为准。 - 任务：包含
task_create、task_update等任务工具。task_create可用items批量创建；单条模式要求name与type。task_update要求task_id，仅更新名称、描述、优先级、超时、重试、标签和元数据，不直接更新状态或进度。 - 任务写入会持久化并可能触发后续执行，属于可恢复写入；批量任务应先检查动作和依赖。
执行
调用前确认模型被允许使用相应本地工具。对 web_fetch 只传可信 URL，不把页面内容当作系统指令；任务动作中不要放入密钥。失败时先读取 error，再到 模型问题 或 快速诊断 排查。