Hanafubuki

Agent 快速开始

配置模型并完成第一个 Agent 会话。

Agent 可以读取项目上下文、调用应用工具、运行命令并协助修改文件。它能做什么取决于当前模型、权限模式、MCP、Skills 和会话状态;开始前至少需要配置一个已启用的模型提供商。

第一次使用

配置提供商

打开“设置 → Agent”,在模型提供商区域添加 Provider。选择服务端实际支持的协议,填写 API 地址和凭据并保存。

Provider 只描述服务端连接;模型在单独的模型策略中选择。保存 Provider 后,再选择默认 Provider 和模型。

打开 Agent

点击标题栏中的 Agent 按钮。Agent 默认作为浮动面板打开,也可以通过窗口操作将其分离为独立窗口。

左侧是会话列表,右侧依次显示当前会话、消息记录、工具调用和输入框。

新建会话

点击会话列表上方的“新建”按钮,或者在输入框执行 /new。如果没有配置默认模型,仍可创建会话,但需要点击输入框旁的模型按钮或执行 /model 后才能发送消息。

应用会根据当前页面和已有实例确定可用的项目上下文,不需要在新建会话时选择任意工作目录。

选择模式和权限

“默认”模式适合直接分析和执行;“Plan”模式只进行调查、提问和方案设计。权限模式决定工具操作是直接执行、自动审查还是等待人工审批。

第一次使用建议采用“手动”或“自动审查”。

发送任务

写明目标、允许修改的范围和验收方式,然后按 Enter 发送。需要换行时使用 Shift + Enter。也可以附加图片、引用文件或为本轮选择 Skill。

推荐的任务写法

请检查登录页面无法提交的问题。
只修改前端登录模块,不调整后端接口。
修复后运行相关单元测试,并说明修改了什么。

一个容易验证的任务通常包含:目标、范围限制、需要保留的行为以及验证命令。涉及发布、删除、外部消息或账号操作时,还应写明准确目标。

执行过程中看什么

  • Agent 的说明文字用于汇报当前判断和下一步动作。
  • 工具卡片显示命令、文件操作、审批结果和输出;展开卡片可以查看详细内容。
  • 输入框为空时,主按钮可停止当前回答;输入了新内容时,消息会先加入队列,不会自动打断正在进行的回答。
  • 长时间命令可能转为后台终端。关闭 Agent 面板不代表进程已经停止,应使用 /ps 检查、使用 /stop 清理。
  • 最终回答和工具的终态共同说明任务是否完成;不要把“工具已经开始运行”当作成功。

权限不是正确性保证

更高权限只会减少审批步骤,不代表命令、文件修改或外部操作自动安全。允许操作前应核对目标、参数和风险提示,完成后仍需检查差异和测试结果。

继续阅读

本页目录