内置工具
模型通过一个 45 个内置工具的注册表干活,外加每个已连接 MCP 服务器的工具(以 mcp__<server>__<tool> 暴露)。任何智能体都可被限制到子集 —— 画像里的 allowed_tools、Agent 工具调用参数、或全局 --allowed-tools / --disallowed-tools。
只读工具直接运行;有副作用的工具经过权限引擎。
文件
规范名与 Claude Code 对齐(Read / Write / Edit)。旧名 FileRead / FileWrite / FileEdit 仍可通过别名解析。
| 工具 | 作用 |
|---|---|
Read | 读文件(大文件可按行区间;图片等二进制原生处理) |
Write | 创建或覆盖文件 |
Edit | 精确字符串替换,呈现为词级结构化 diff |
ApplyPatch | 多 hunk 补丁应用(Codex 风格),可跨多个文件 |
NotebookEdit | Jupyter notebook 单元的替换 / 插入 / 删除 |
访问工作区外(cwd + --add-dir 根)先询问(confirmOutsideWorkspace)。
Shell
| 工具 | 作用 |
|---|---|
Bash | 执行 shell 命令(Unix)。内置分类器区分只读与改状态:只读放行,改状态询问(bashPromptForWrites)。毁灭性模式(rm -rf /、保护分支强推…)硬阻断。可选 OS 沙箱。 |
PowerShell | 在 Windows 上代替 Bash 注册 |
exec_command | 在持久化 PTY 会话里启动交互式命令 —— REPL、调试器、安装器、开发服务器。yield_time_ms 内没结束就返回 session_id,用 write_stdin 继续。与 Bash 共用只读分类器和沙箱;Default/AcceptEdits 模式下同样按命令询问。会话配额可用 HIPMMCODE_PTY_PER_AGENT / _PER_THREAD / _PER_WORKSPACE / _PER_TENANT / HIPMMCODE_MAX_PTY_SESSIONS 调整。 |
write_stdin | 向 exec_command 会话写入输入(如 "\u0003" 表示 Ctrl-C),只收集上次调用之后的新输出;还能调整终端尺寸(rows/cols)和终止会话(terminate: true)。chars 留空 = 只轮询不写入。 |
搜索
| 工具 | 作用 |
|---|---|
Grep | 正则内容搜索(ripgrep 风格,过滤器、上下文行) |
Glob | 文件名模式匹配(**/*.rs),按 mtime 排序 |
ToolSearch | 按关键词查找延迟/小众工具(完整目录过大时不全量暴露) |
联网
| 工具 | 作用 |
|---|---|
WebSearch | 实时搜索 —— Anthropic / DeepSeek-Anthropic / Gemini 原生;Grok 上 xAI Responses web_search;其余 AnySearch。统一 Sources: 脚注。见联网搜索 |
WebFetch | 抓取 URL 并作为文本阅读 |
图像生成
| 工具 | 作用 |
|---|---|
GenerateImage | 在当前渠道上用文本生成图片并保存到 output_path(默认 cwd)。OpenAI / openai-codex: /images/generations 的 size / quality。xAI / xai-oauth: xAI Imagine(grok-imagine-image*)—— OpenAI 的 size/quality 会被映射或忽略;实际请求使用 Imagine 的 aspect_ratio + b64_json(不要直接传 xAI 会 400 的 OpenAI 专有枚举)。 |
视频生成
| 工具 | 作用 |
|---|---|
GenerateVideo | qwen-token-plan / qwen-token-plan-anthropic 上的千问 Token Plan 原生视频生成工具，不是 Skill。它复用已配置的 sk-sp-...，支持当前个人版/团队版均列出的 happyhorse-1.1-t2v（纯文本）、happyhorse-1.1-i2v（恰好一张公开 URL/数据 URL 首帧）和 happyhorse-1.1-r2v（1–9 张公开 URL/数据 URL 参考图）；参数包括 resolution（720P/1080P）、ratio、duration（3–15 秒）和 output_path。新付费任务提交前会经过权限门禁，并预留全新的固定输出目标。HiPMMCode 私密保存 task_id、轮询并立即下载短期结果；传 task_id 可恢复同一任务而不再次 POST，平台会话还须显式传 output_path。极少数“提交成功但私密回执保存失败”场景可使用返回的作用域绑定 recovery_token 恢复。包括空文件在内的任何已有目录项都不会被覆盖。 |
语音合成
| 工具 | 作用 |
|---|---|
GenerateSpeech | 两个直连 Token Plan 聊天渠道上的原生语音合成，也不是 Skill。它复用已配置的 sk-sp-...，通过官方 WebSocket 调用个人版/团队版均支持的 qwen-audio-3.0-tts-plus。默认使用 Plus 兼容音色 longanlingxin、输出 MP3 22050 Hz；支持兼容音色、MP3/WAV/Opus/PCM、音量/语速/音高、一个语言提示及模型自身的指令控制（最多 100 加权单位）。调用在消耗 Credits 前请求确认，完整接收并校验音频流，再以 capability 原子保存到新预留的本地路径；包括空文件在内的任何现有目录项都不会被覆盖。 |
多智能体
| 工具 | 关键参数 |
|---|---|
Agent | 派生队友:name、prompt、agent(画像)、provider/model(任意渠道)、background(立即返回 id)、allowed_tools、isolation: "worktree"(独立 git worktree)、effort。非空 name 会创建当前会话隐式团队中的可寻址常驻队友；模型无需创建/删除团队。 |
SendMessage | 按名给另一个智能体(或 lead)发消息 |
ListPeers | 列出当前会话隐式团队的成员 |
Advisor | 决策点向更强模型要第二意见(advisorModel) |
任务管理
| 工具 | 作用 |
|---|---|
TaskCreate | 往共享列表加任务(主题、描述、元数据) |
TaskList / TaskGet | 列任务 / 读单个 |
TaskUpdate | 更新状态/负责人/依赖(blocks / blockedBy) |
TaskOutput | 读后台队友输出(block_ms 阻塞轮询) |
TaskStop | 停止后台队友 |
计划与流程
| 工具 | 作用 |
|---|---|
EnterPlanMode / ExitPlanMode | 只读规划阶段 → 呈交计划待批,批准前不碰任何东西 |
TodoWrite | 智能体自己的可见 todo 列表(实时画进任务树) |
AskUserQuestion | 向你提结构化选择题(支持无头 webhook 路由) |
Sleep | 暂停 N 毫秒(等后台工作) |
调度与监控
| 工具 | 作用 |
|---|---|
CronCreate / CronList / CronDelete | 定时(cron 语法)循环或一次性提示;经原生 .hipmmcode/scheduled_tasks.json + hipmmcode cron daemon 可持久；只有原生文件不存在时才读取旧 .claude 文件 |
ScheduleWakeup | /loop 动态模式的自定节奏唤醒 |
Monitor / MonitorList / MonitorStop | 监听长命令的输出流,按匹配行通知。v0.11.0+：现在在所有渠道都可达（延迟工具门控已修复） |
PushNotification | 发终端/桌面通知 |
Monitor 工具可用性（v0.11.0+）
Monitor 工具现在在所有渠道都可调用。之前在 OpenAI/codex 路径上被隐藏。延迟工具门控现在只在延迟池真的很大时（≥ 上下文窗口 10%）才启用。
工作区隔离
| 工具 | 作用 |
|---|---|
EnterWorktree / ExitWorktree | 把会话切进隔离 git worktree(以及退出,保留或删除)。也可每智能体 Agent(isolation: "worktree"),或手动 /worktree |
知识与代码智能
| 工具 | 作用 |
|---|---|
Skill | 按需加载技能剧本(渐进披露 —— 见技能) |
SaveMemory | 写持久记忆文件(见会话与记忆) |
LSP | 语言服务器操作:定义、引用、悬停、符号、诊断(别名 Lsp) |
CodebaseGraph | 基于 tree-sitter 的代码智能,无需安装 rust-analyzer/tsserver:goToDefinition、findReferences、documentSymbol、workspaceSymbol(Rust / TS / JS / Python / Go) |
Artifact | 发布 / 更新 / 列表 / 可见性 / 删除托管 HTML Artifact(与 /publish 同一套能力;见发布 Artifact) |
McpConfig | 让智能体自己增删查 MCP 服务器("接一下 Notion MCP")—— 变更操作过权限门 |
MCP(动态)
| 工具 | 作用 |
|---|---|
mcp__<server>__<tool> | 每个已连接 MCP 服务器的全部工具,命名空间化 |
ListMcpResources / ReadMcpResource | 枚举 / 读取 MCP 资源 |
多模态输入
不算工具但同属一条管线:拖拽、@ 提及、/paste 的文件附加到你的消息。图片在具视觉能力的模型上分析;视频在具视频能力的渠道(Gemini、Kimi/Moonshot…)上分析 —— 模型看真实画面,不是文件名。内联上限 32 MB(HIPMMCODE_VIDEO_MAX_MB)。不支持的模型收到优雅的文字占位,并注明哪些模型能看。
工具结果截断（v0.11.0+）
超大工具结果现在在 dispatch 层自动钳制,防止上下文溢出：
| 工具类别 | 截断限制 |
|---|---|
| MCP 工具 | 50,000 字符 |
| Bash / PowerShell | 30,000 字符 |
| Grep / Glob / ToolSearch | 20,000 字符 |
| 其他（默认） | 100,000 字符 |
结果超限时,溢出部分落盘,工具结果包含指向落盘文件的指针,可用 Read 工具读取。这防止单个巨大的 MCP 结果或 shell 输出撑爆上下文窗口。
已自带截断的工具（如 Read 的行区间）不受影响。