Toolset 工具组
看到工具名之前，先分清两层选择：Profile／会话工具组和父任务限制决定哪些工具有资格进入库存；Session 再从当前库存选择直接声明和可调用工具。历史保存的名称或 Schema 是证据，不是第二套阻止新工具注册的权限门槛。
查看当前库存
Dashboard → Tools → Built-in 可以查看来源、Toolset、定义、超时与结果预算。这里不是当前 Session 活动声明清单，定义也不可直接编辑。Dashboard 没有通用的“每个默认组任意开关”编辑器；可选能力在对应入口配置，MCP 另外管理。
默认有资格的主要工具组如下：
| 组 | 能力 |
|---|---|
file、terminal | 文件和命令／进程 |
web | 公开网页检索与获取 |
artifact | 会话文件的查看、Pin 与导出 |
sessions、memory | 历史会话搜索与长期记忆 |
tasks、automation | 个人任务和计划工作 |
clarify | 结构化补充输入 |
messaging | 当前渠道范围内的投递 |
skills | 托管 Skill 库写入；读取依靠 read／bash |
subagents | 委派、后台工作和子会话控制 |
tts | 配置路由后的语音合成 |
有资格不等于每项都默认活动。可移植工具的默认活动名称是 read、bash、edit、write，产品工具另有默认活动条目。实际可用性还取决于凭据和后端。
用参数选择会话工具
anyy --tools '+codemode,+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "只检查项目"
纯名称清单替换默认选择；+name／-name 在 Profile 默认集合上增减，不是在恢复会话当前活动集合上增减，不能与纯名称选择混用。显式空清单表示真正的空选择。名称、通配符及禁用选项详见对话工具选择。
已有会话必须空闲且没有待处理输入，才能通过显式附加改变选择；不带覆盖参数时，热会话保留当前状态。参数规则保留在常驻 Session 中，不写 config.yaml，也不跨 Gateway 重启保存。分支中记录的活动名称可以恢复，再按当前 Profile 规则筛选；需要同一显式规则时应重新在空闲时附加。
Codemode 与工具搜索
两个内置工具默认都不活动。显式选择或适用 MCP 自动激活规则可启用；两者独立，切换 Codemode 不改变 tool_search 或 Role。
Profile 配置示例：
default_tools:
- "+codemode"
- "+tool_search"
codemode:
mode: on
inline_budget: 3000
mode 不是启用开关。on 保留直接声明，only 隐藏可经脚本调用的直接声明，句柄仍可调用，canonical 声明仍保存。inline_budget 限制脚本内联工具说明，不是整个会话上下文大小。没有专用 Codemode CLI flag 或 Role 字段。
推荐通过 Tools → Built-in → codemode 保存默认值，并对选定的空闲会话另做 Apply to Session。Profile Save 不重选已有会话；会话 Apply 只切换 Codemode，不扩大该会话允许清单。手改文件后要明确保存或重启，Provider reload 不发布工具设置。页面说明列出状态区别。
脚本在独立 VM 中执行，首次加载也计入时限；无需 Node.js。成功 store 属于所选会话分支并可在数据库重开后读取；超时／失败保留部分输出但丢弃该脚本未提交 store，已发生的工具效果不回滚。完整 API 见 Codemode，搜索激活见工具搜索。
暴露方式与范围
| Exposure | 作用 |
|---|---|
direct | 活动时通常直接声明并可调用 |
codemode、deferred | 从注册库存间接调用，不要求先有直接声明 |
model-only | 可声明给模型，脚本不能调用 |
hidden | 不声明，也不可调用 |
MCP 使用 Server exposure 和有序 toolExposure，不生成 mcp-NAME 个人工具组。适用配置可自动启用发现工具，但显式排除和父任务限制优先；停用 Codemode 后，允许的活动工具搜索仍可能找到间接 MCP 工具。
活动 Skill 仅在 Session 仍用 Profile 默认工具组时可请求附加组；显式轮次选择或已收窄 Session 选择优先。附件轮次可加入作用域内的 artifact。子会话不能扩大父会话范围，Role 本身不负责工具权限。
若工具缺失，依次核对产品组资格、Exposure、Session 选择与父任务限制；MCP 还要检查 Server 就绪和 offering。可见工具执行失败则看凭据、输入校验、操作系统权限和后端结果。工具组组织暴露与上下文开销，不授予系统权限。