入门指南

FuyaoAgent 简介

FuyaoAgent 是一款面向 Windows 的本地 AI 智能体。你可以用自然语言交代任务，它会在已授权范围内读取文件、调用工具、执行多步骤工作，并把过程和结果显示在同一个任务中。

核心能力

适用场景

• 开发网站、脚本和本地项目，并运行测试。
• 分析 Word、Excel、PowerPoint、PDF、文本和图片附件。
• 整理资料、生成报告、方案、文案和项目文件。
• 在可信软件目录中查找、核验并安装 Windows 软件。
• 创建定时任务，或通过配置好的社交平台接收消息。

与普通 AI 对话的区别

入门指南

快速开始

完成模型、工作区和权限三项设置后，就可以开始第一个任务。

第一步：打开程序

双击桌面的 fuyaoagent 图标。窗口左上角会显示程序图标与名称。

第二步：选择模型

在输入框右下方选择模型。模型不可用时，到 设置 → 供应商 检查地址、模型名称和密钥。

第三步：选择当前任务目录

点击输入框下方的 当前任务目录，选择智能体可以工作的文件夹。开发、写文件和读取项目内容都会以这个目录为边界。

第四步：选择权限

在输入框左下方选择“请求批准”“帮我批准”或“完全访问”。第一次使用建议保留默认的 请求批准。

第五步：发送任务

请分析当前目录中的项目，告诉我它如何启动、有哪些主要功能，并运行现有测试。

发送后，界面会自动跟随最新内容。智能体执行工具时会显示当前步骤和耗时；你可以继续追加消息、排队提示或停止任务。

入门指南

完整使用教程

FuyaoAgent 的基本使用方式是：明确目标，准备工作区和材料，选择权限，观察执行过程，最后核验交付结果。下面的流程适用于开发、文件分析、资料整理和软件安装。

一、先准备一个任务

1. 点击左侧对话栏的 + 新建任务。
2. 在输入框下方设置当前任务目录。开发和文件修改任务建议为每个项目单独建立目录。
3. 选择模型。模型不稳定或中断时，先到设置检查供应商、模型名称、Base URL 和密钥。
4. 选择权限。第一次执行建议使用“请求批准”，确认任务稳定后再按需要提高权限。

二、把材料交给智能体

可以把文件直接拖到输入框，也可以点击 + 选择文件。看到附件名称出现在输入区后，再发送任务；如果没有出现附件名称，先不要发送，检查文件是否超出大小限制或当前任务是否已经切换。

三、用一个清楚的指令开始

一条好指令至少包含四项：要做什么、使用哪些材料、输出到哪里、完成后如何验证。可直接套用下面的模板：

目标：请完成……
材料：使用当前任务目录和我添加的附件……
输出：把结果写入……，同时在对话中总结……
限制：不要覆盖源文件；涉及安装、联网或删除文件时先请求批准。
验证：完成后运行……，并报告实际结果。

四、执行过程中怎么操作

• “思考中”表示智能体正在规划或等待模型响应。
• 工具执行会显示搜索、读取、写入、命令和检查等过程；命令旁的计时表示该命令已经运行的时间。
• 你可以继续输入内容，消息会进入队列；需要改变下一步时，可把队列中的消息提升后再发送。
• 需要停止时点击停止按钮。停止后检查工作区是否留下了部分文件，再决定继续、回退或新建任务。
• 阅读历史内容时自动跟随会暂停，点击回到底部即可回到最新进度。

五、遇到审批请求怎么办

涉及写文件、安装程序、联网、启动本地服务、访问外部账号或使用高权限时，FuyaoAgent 可能暂停等待确认。先查看操作对象、命令和目标路径，再选择批准或拒绝；不清楚用途时不要批准，可以要求智能体先解释。

六、完成后检查交付结果

不要只看“已完成”字样。检查智能体是否给出实际证据：

• 创建了哪些文件，修改了哪些文件。
• 运行了哪些命令，退出码和关键输出是什么。
• 测试、构建、HTTP 检查或启动检查是否真正通过。
• 本地服务的访问地址、端口和启动方式是什么。
• 哪些能力因为没有账号、网络、驱动或外部服务而没有验证。

案例一：分析附件并生成报告

请读取我添加的招标清单和当前目录中的相关资料。
先判断项目背景、我的角色、方案侧重点和是否缺少完整招标文件。
如果信息不足，先用选项让我选择；需要补充时提供“其他”输入框。
确认后生成一份中文分析报告，保存为 report.md，并列出引用的文件名。

发送前确认附件已显示。完成后打开工作台检查 report.md，再要求智能体根据报告继续生成 Word 或 HTML 版本。

案例二：开发 Node.js 网站

请在当前任务目录开发一个 Node.js 网站，包含会员端和后台端。
先给出实施方案、目录结构和需要我确认的业务问题；确认后再创建文件。
自动检查 Node.js 环境，安装必要依赖，完成页面、接口和数据库初始化。
最后运行测试和启动检查，报告创建/修改的文件、启动命令和可访问地址。

如果需求还不完整，先回答智能体提出的选项。开发过程中保持“请求批准”，确认依赖安装和写入路径后再批准。

案例三：安装 Windows 软件

请帮我安装 QQ。先搜索可信来源和可用安装包，核对发布者与文件类型。
如果能自动安装，显示下载、校验和安装进度；如果需要人工确认，下载到当前任务目录的 downloads 文件夹，告诉我完整路径并提示双击安装。
安装后检查程序是否已安装并报告版本。

软件安装可能受网络、管理员权限、厂商安装器或软件源限制。智能体不能确认安装成功时，应该明确显示失败原因或交付安装包路径，不应一直停留在“正在安装”。

案例四：搜索资料并做报告

请搜索“中国福建 OPC 社区”，整理成一份带来源的中文报告。
默认在 FuyaoAgent 内部完成搜索，不要打开可见浏览器窗口；只有我明确要求查看网页时才显示浏览器。
报告包含摘要、时间线、关键组织、来源链接和待核实信息。

外部搜索是否可用取决于网络和连接器配置。完成后核对来源链接能否打开，并把不确定的内容单独标注。

七、任务失败时的处理顺序

1. 先看最后一条错误，而不是反复点击重试。
2. 确认当前任务目录、附件、模型和权限没有被切换。
3. 让智能体解释失败原因并给出下一步，不要让它重复同一个超时操作。
4. 修复环境或调整指令后继续；若工作区已经混入半成品，先让智能体列出变更再操作。

入门指南

界面结构

顶部栏

• 左侧：FuyaoAgent 品牌和对话栏开关。
• 中间：聊天与频道模式切换。
• 右侧：工作台开关和窗口控制。

左侧对话栏

用于新建对话、打开设置、进入社交平台、助手活动、任务计划和技能，以及搜索、重命名、置顶、归档或删除历史任务。

中间任务区

显示你发送的内容、智能体回复、工具进度、审批状态、错误提示和最终总结。用户消息在右侧，助手消息在左侧，每条消息支持复制。

右侧工作台

包含 对话文件 与 工作台 两个视图，可以查看附件、浏览目录树、搜索文件、预览 Markdown/文本，并使用本地“笺”记录临时内容。

输入区

• +：添加文件。
• 权限选择：控制工具批准策略。
• 思考模式：控制模型推理方式。
• 模型选择：切换当前任务使用的模型。
• 发送/停止：提交消息或中止当前执行。

入门指南

创建任务与对话

新建任务

点击左侧栏标题旁的 +。新任务在发送第一条消息前只是草稿，不会产生空的历史记录。

如何描述任务

建议同时写清目标、材料、输出格式和限制。例如：

请读取工作区里的产品资料，写一份面向客户的中文方案。
输出 Word 文档和 HTML 预览，保留原始数据，不要覆盖源文件。

直接选择澄清项

任务条件不完整时，FuyaoAgent 可以显示可选问答。直接点击选项，必要时在补充框输入其他要求，然后提交。

任务运行期间

• 继续输入的消息会进入队列。
• 可以把排队消息提升为下一条执行指令。
• 点击停止按钮可以取消当前任务。
• 向上滚动阅读旧内容时，自动跟随会暂停；点击向下按钮返回最新内容。

任务管理

在会话右侧菜单中可以生成摘要、复制 Session ID、置顶、重命名和归档。归档任务可以在归档窗口恢复。

核心功能

工作区与文件

工作区是什么

工作区是当前任务允许访问的本地目录。开发工具使用相对路径，不能越过工作区边界；符号链接、路径穿越和部分生成目录会被拦截。

添加附件

1. 把文件拖到输入框，或点击 + 选择文件。
2. 确认附件芯片已经显示在输入框上方。
3. 输入要对文件执行的任务并发送。

支持的常用格式

文件预览与“笺”

右侧工作台可折叠目录、搜索、排序、刷新、打开文件或在资源管理器中显示。Markdown 和文本文件可在应用内预览；“笺”会自动保存本地临时笔记。

核心功能

权限与安全

权限决定智能体是否可以直接操作文件、运行命令、联网或安装软件。权限越高，自动化越顺畅，风险也越高。

三种权限模式

沙盒、联网和备份

• 安全沙盒：限制开发工具的路径和可执行程序范围。
• 沙盒联网：决定沙盒任务能否访问网络。
• 文件备份：在覆盖已有文件前保留恢复副本。
• 审批记录：工具运行状态与批准来源会保留在活动记录中。

核心功能

模型与供应商

供应商与模型的关系

供应商保存 API 地址、协议和密钥；模型保存实际调用名称。一个供应商可以配置多个模型，每个助手可以绑定自己的默认模型。

配置步骤

1. 打开 设置 → 供应商。
2. 添加供应商名称、Base URL、协议和 API Key。
3. 添加模型名称并测试连接。
4. 在 设置 → 助手 绑定默认供应商，或在输入框临时切换。

密钥保存

供应商密钥通过 Electron 安全存储加密后写入本机。设置页只显示掩码，不应把密钥写进工作区、技能或普通文档。

模型选择建议

• 开发和复杂工具任务：选择工具调用稳定、上下文较长的模型。
• 日常问答和文案：选择速度更快、费用更低的模型。
• 图片、语音、视频：需要在“多媒体”中配置对应能力的模型。

核心功能

助手、身份与记忆

创建和编辑助手

在 设置 → 助手 中管理名称、头像、简介、行为指令、默认供应商和可使用的工具。不同助手拥有独立会话和配置。

“我”的资料

在 设置 → 我 中配置显示名称、头像和个人说明。必要信息会加入模型上下文，帮助助手理解你的角色和偏好。

记忆

• 自动记忆：从明确的用户事实中提取可复用信息。
• 经验：从已完成的助手结果中提取执行经验。
• 置顶记忆：手动保存、编辑长期需要的信息。
• 关闭记忆：关闭后不读取或写入对应记忆。

核心功能

技能与插件

技能

技能是一组可复用的说明和工作流程。可以从本地目录或 ZIP 安装，也可以在工作区的 .agents/skills 中放置项目技能。安装前会检查路径、体积和潜在提示注入。

安装技能

1. 打开 设置 → 技能。
2. 拖入技能目录或 ZIP，或选择本地包。
3. 阅读安全审查结果。
4. 选择允许使用该技能的助手。

插件

插件可以注册新的工具。FuyaoAgent 插件包含 fuyao-plugin.json，并声明所需权限：network、workspace:read、workspace:write、shell 或 full-access。

核心功能

连接器与 MCP

连接器让 FuyaoAgent 调用外部 MCP 服务、企业工具或本地命令适配器。

远程连接器

填写 MCP 服务的 HTTPS 地址和请求头。支持 Streamable HTTP，以及兼容的 HTTP + SSE 方式。连接成功后可以发现工具、资源、提示和任务。

本地命令连接器

填写程序路径、参数、工作目录和环境变量。FuyaoAgent 不通过 shell 拼接命令，敏感环境变量会加密保存。

使用连接器

1. 在 设置 → 连接器 新建连接。
2. 点击测试，确认可以发现能力。
3. 启用连接器并绑定到助手。
4. 在对话中直接描述任务，工具调用会按权限策略审批。

Picset AI 电商图片

当前本机已配置 Picset 本地 MCP 适配器，可检查连接、预估图片任务和提交生成。图片生成可能消耗 Picset 积分，必须明确确认后才能执行。

核心功能

任务计划与活动

创建任务计划

1. 点击左侧 任务计划。
2. 输入任务内容并选择助手。
3. 设置单次、每天或其他可用计划。
4. 保存并启用。

运行记录

活动窗口显示开始时间、持续时间、状态和结果。程序重启后会恢复中断记录，并按设置处理错过的计划。

停止和重试

运行中的计划可以取消；失败任务会保存错误信息。修复模型、网络或权限问题后再手动重试。

任务场景

安装与启动软件

如何发出指令

帮我安装 QQ。
帮我安装 WPS，并在安装后确认版本。
帮我安装指定的 Office 2020；如果找不到完全匹配的版本，不要安装其他版本。

执行流程

1. 解析软件名称和版本要求。
2. 搜索可信 Windows 软件目录。
3. 核对包名、发布者、架构、下载地址和哈希。
4. 根据权限模式请求批准。
5. 下载安装并检测结果；必要时启动程序确认窗口。

版本保护

当你指定版本时，FuyaoAgent 不应把其他产品或订阅版本当作替代品。例如“Office 2020”不会自动替换为 Microsoft 365。

任务场景

浏览器与资料研究

无感搜索

当任务只需要搜索、读取和整理公开资料时，受控浏览器默认可以在后台运行，不遮挡主界面。工具进度会在对话中显示。

显示浏览器

只有当你明确要求“打开网页”“让我看看页面”或任务需要人工交互时，才应显示浏览器窗口。

资料报告示例

请搜索中国福建 OPC 社区的公开资料，区分公司、社区和项目，列出来源日期，最后生成一份 HTML 报告。

可信度建议

• 说明具体对象，避免同名词混淆。
• 要求列出来源和发布日期。
• 对政策、价格、版本等易变化信息要求联网核验。
• 不要在不可信网页中输入密钥或本地隐私文件。

任务场景

图片、音频与视频

图片

可以添加图片附件进行分析，也可以调用配置好的图片模型或 Picset 连接器生成电商图片。生成前确认尺寸、数量、用途和积分消耗。

音频

支持本地预览、语音转文字和文字转语音。具体格式、时长与语言取决于所配置的供应商。

视频

支持异步创建、查询进度、取消和下载。长任务关闭软件前应先确认服务端任务 ID 已保存。

任务场景

社交平台接入

支持的适配器

设置界面提供 Telegram、飞书、钉钉、QQ、微信/企微相关配置。各平台必须使用官方允许的机器人、应用或合规适配器。

通用接入步骤

1. 在对应平台创建机器人或应用，获取必要凭据。
2. 打开 设置 → 社交平台，填写凭据并测试运行状态。
3. 完成主人身份配对，限制允许发送指令的账号。
4. 绑定助手并选择只读、自动审核或完整权限。

任务场景

多助手频道

开启频道

顶部切换到 频道。首次启用会显示风险说明，因为多个助手可能连续调用模型并产生更多费用。

创建频道

1. 输入频道名称和讨论说明。
2. 选择至少两个助手。
3. 提交主题并开始讨论。
4. 需要时点击停止，结束当前轮次。

适合的场景

• 让开发、测试和产品三个角色评审方案。
• 让不同模型交叉检查报告。
• 对同一个决策给出多个独立意见。

任务场景

手机与局域网访问

本机访问

默认服务只绑定回环地址，只能在当前电脑访问。可在 设置 → 访问与设备 查看状态和配对信息。

局域网访问

开启局域网后，同一网络中的手机可以通过显示的地址访问。首次连接需要短期配对令牌。

移动端限制

移动端适合文字对话和查看任务，不开放本机 Provider 密钥，也不允许远程绕过桌面工具审批。

配置与支持

系统设置索引

配置与支持

故障排查

消息发不出去

1. 确认已经选择模型。
2. 检查供应商连接测试。
3. 确认 API Key、余额和网络。
4. 新建任务重试，排除旧任务卡死。

任务一直“思考中”

1. 查看最后一条工具进度和命令耗时。
2. 点击停止，确认任务确实结束。
3. 检查是否有被遮挡的审批窗口。
4. 切换到稳定模型后重试。

附件无法读取

1. 确认附件已经随消息发送，而不只是停留在输入框。
2. 检查文件大小和格式。
3. 旧版 Office 文件先另存为 .docx、.xlsx 或 .pptx。
4. 受密码保护的文件先解除保护。

软件安装超时

1. 查看是否已经下载到 Downloads。
2. 确认软件版本与架构完全匹配。
3. 检查签名、哈希和网络。
4. 安装器不支持静默模式时，按提示手动双击。

界面没有显示最新改动

彻底退出 FuyaoAgent 后，从桌面快捷方式重新打开。当前正式运行目录为：

D:\FuyaoAgent-dev\fuyaoagent\release\win-unpacked\fuyaoagent.exe

配置与支持

常见问题

FuyaoAgent 会自动修改所有电脑文件吗？

不会。开发和文件工具受工作区边界、权限模式、安全策略和路径检查控制。

关闭软件后任务还会继续吗？

本地工具通常会停止；服务端媒体任务可能继续。任务计划会在下次启动时按恢复策略处理。

为什么总结里没有“修改文件”或“访问地址”？

新版只显示有真实结果的栏目。没有修改文件或没有通过验证的网址时，栏目会被省略。

能不能安装市面上的任意软件？

不能保证。当前优先使用可信软件清单和经过核验的官方安装地址，不会为了完成任务而下载来源不明的程序。

为什么某个社交平台显示可配置但收不到消息？

还需要该平台的真实机器人凭据、主人账号配对和一次实际消息往返测试。

MCP Key 在哪里申请？

由对应 MCP/Agent 服务商的网站签发。Key 与服务地址是两项信息；保存后应通过连接测试确认鉴权。

配置与支持

功能状态说明

以下状态基于当前 FuyaoAgent 0.99.0 的本机开发与验收记录，不把“已有界面”当作“真实场景已经通过”。