hanafubuki-agent

概览

hanafubuki-agent 是什么、能做什么,以及独立运行和嵌入运行的区别。

hanafubuki-agent 是一个在终端里工作的编程与运维 Agent。你用自然语言描述任务,它会阅读代码、运行命令、修改文件、搜索网页,并在需要时先征求你的同意。

它有两种运行方式:作为 hanafubuki-agent 命令独立运行,提供终端界面和无界面的 exec;或者作为 Rust 库嵌入到其他应用中,例如桌面应用 Hanafubuki。

它能做什么

  • 运行命令和终端:在工作区里执行 Shell 命令,与长时间运行的进程交互,并读取输出。
  • 读写文件:读取文件,以补丁的形式修改代码,修改前可以预览差异。
  • 搜索和抓取网页:通过 DuckDuckGo 或自建的 SearXNG 搜索,并抓取网页正文。
  • 连接 MCP 服务器:把本地程序或远程服务提供的工具交给模型使用。
  • 使用 Skill:按需加载可复用的工作流程和参考资料。
  • 记忆:可选地从过去的会话中提炼经验,在以后的会话里使用。
  • 计划模式:只读地探索代码,最后给出一份可执行的计划。
  • 会话:每次对话都保存在本地历史中,可以随时列出、查看和恢复。

模型来自你配置的 Provider,支持 OpenAI Responses、Chat Completions 和 Anthropic Messages 三种协议,因此既可以连接云服务,也可以连接本地推理服务。

两种运行方式

独立运行嵌入运行
入口hanafubuki-agent 命令:终端界面、exec 和管理命令宿主应用通过 hanafubuki-agent 库启动 Agent
配置自己的配置目录,支持分层、配置档和 -c 覆盖由宿主指定配置目录,并通常提供自己的设置页面
界面终端界面,或以文本、JSON 输出的单次运行宿主自己的界面
额外能力内置的工具、MCP、Skill、已安装的插件和记忆宿主还可以通过插件提供自己的工具和上下文

本文档的大部分内容面向独立运行的命令行。要把 Agent 嵌入自己的应用,请阅读嵌入。

从这里开始

本页目录