Craft Agents：连接文件、工具与浏览器的 AI 智能体

通俗解释：Craft Agents 这个网站是干什么用的？

Craft Agents 是一个开源 AI 智能体桌面应用。你用自然语言说明想完成的事情，再把需要的文件、网站或业务系统连接进去，AI 就能读取资料、分析任务、制定步骤，并在相应权限下执行操作。官网主要提供软件下载、使用文档和开源代码入口，日常工作则在安装后的桌面应用中进行。

举个例子：你想把项目工单和本地会议记录整理成周报，可以让 Craft Agents 读取指定来源，区分已完成事项与阻塞问题，先给出草稿，再按你的要求修改文档。它的价值在于把“获取信息、整理内容、调用工具、检查结果”放进同一段工作过程，适合经常在多个系统之间处理资料的运营人员、知识工作者和开发者。

连接 MCP、API 和本地文件，把分散的信息用起来

Craft Agents 将数据连接称为 Sources，支持 MCP 服务器、REST API 和本地文件夹。你可以直接描述要连接哪个服务，提供 API 文档、接口地址或已有的 MCP 配置，再完成账号授权。配置是否成功仍取决于凭据、服务权限和网络可达性；不能把官网的自动配置演示理解成任何账号都能直接访问所有系统。

对于只涉及一个本地目录的任务，可以设置工作目录，不必先搭建 MCP 服务。经常重复的跨系统流程，则适合使用稳定的 API 或 MCP 来源。例如，读取项目工单后生成待办摘要，再结合本地参考材料补充背景。这里的输入是你授权的真实数据，输出可以是分析结果、文档草稿或经过允许的修改。

应用还支持拖入图片、PDF 和 Office 文档，官方仓库说明会进行相应转换。不过，自定义模型端点默认按纯文本处理；如果需要让模型理解图片，还必须选择支持图像的模型并启用图像输入，不能仅凭附件出现在对话中就判断模型已经读到了图片内容。

没有现成接口时，用内置浏览器完成网页任务

内置 Chromium 浏览器能打开网页、点击按钮、填写表单、提取页面数据和截图。你可以先登录相应网站，再让智能体继续处理授权范围内的任务。它适合一次性的网页整理、需要通过界面完成的流程，以及暂时没有合适 API 的场景。

官网文档建议：经常重复、需要稳定程序化访问的工作，优先考虑来源连接；依赖网页界面的任务，再使用浏览器。一个可行的工作方式是先从页面提取表格，再要求智能体保留来源、解释整理规则，并抽查原页面与结果是否一致。页面改版、登录失效或权限不足，都可能让任务中断，仍需要查看实际执行结果。

第一次使用：从一个能核对结果的小任务开始

1. 按官方安装说明下载对应版本。目前支持 macOS 11 及以上的 Apple Silicon、Windows 10 及以上的 x64，以及需要 FUSE 的 Linux x64 AppImage。Intel Mac 最后支持版本是 v0.10.0，新版本不再提供 Intel 构建。
2. 打开应用，配置模型连接和工作区。只使用本地文件或其他来源时，可以跳过 Craft 账号连接。
3. 添加一个需要使用的来源，完成认证并检查连接状态。第一次可以只选择一个项目或文件夹，减少无关数据。
4. 用 Explore 模式先做分析，明确输入范围和交付要求。例如：“整理这些项目记录，列出完成事项、风险和待确认问题，先给我草稿。”
5. 检查方案后，在 Ask to Edit 模式下审批需要的修改。完成后核对文档内容、原始记录和工具执行结果，再决定是否进入下一步。

快速入门文档说明了初次配置与模式切换。上面的周报流程是基于已验证能力设计的使用示例，不代表未连接的项目管理平台会自动变成可用来源。

用 Skills、项目与自动化复用工作方式

Skills 用 SKILL.md 保存可复用的操作说明。你可以让智能体创建技能，也可以导入兼容的已有技能，再通过 @ 提及调用。技能负责描述做事方式；它依赖的 Sources 仍需提前配置和认证，不能用一份提示词替代账号权限。

项目可以把相关会话绑定到工作目录和共享背景；收件箱、状态与后台任务则帮助管理多条进行中的工作。对于固定格式的项目报告，可以先把整理要求做成技能，再使用自动化按计划启动相关会话。

自动化支持计划或事件触发，官方界面提供测试和执行历史。建立例行简报后，应先运行一次测试，检查使用的来源、时间设置和结果，再观察后续执行是否成功。定时执行仍会受到模型额度、来源连接及运行环境的影响。

免费开源不等于模型调用没有成本

截至 2026 年 10 月 19 日核实，Craft Agents 代码采用 Apache 2.0 许可，软件本身没有开源许可费用。没有查到适用于所有用户、统一包含模型额度的固定付费套餐，因此不将第三方模型费用拼成一个所谓的 Craft Agents 月费。

官方资料列出了 Anthropic、OpenAI、Google Gemini、GitHub Copilot、OpenRouter 等兼容网关和本地模型连接。实际费用、订阅资格、速率限制与地区可用性，以你选择的模型服务商为准。每个会话在首条消息后会绑定当前连接，更换连接需要新建会话，详见模型连接设置。

如果希望使用本地模型，可以考虑 Ollama。官方记录的 Anthropic 兼容接入方式要求 Ollama 0.14 或更高版本，并已在本机下载模型。即使推理在本机完成，硬件仍需满足运行要求；调用远程业务系统或访问网站时，相关操作依然需要网络。

权限、隐私和分享链接有哪些边界？

Explore 用于探索分析，Ask to Edit 对相关修改请求审批，Execute 则允许智能体无需逐次提示执行操作。权限规则可以调整，浏览器工具也能在各个模式下使用。因此，不应把某个模式名称当成对所有网页操作都有效的隔离保证；涉及外部系统变更时，应明确允许的范围并检查操作结果。

官方资料说明凭据在本地加密保存，会话历史也保存在磁盘上。但使用云端模型时，请求仍会经过相应服务商的基础设施。不能由“本地桌面应用”推出“所有数据永不离开电脑”，也不能替所有模型服务商承诺统一的数据留存或训练政策。

Share Online 会把会话上传成只读网页，消息与工具结果可能包含在内，持有链接的人无需登录或密码即可访问。文档规定单个分享会话上限为 5 MB，附件不包含在分享中；Stop Sharing 可以删除线上副本。分享前应检查敏感内容，具体范围见会话分享说明。

常见问题

Craft Agents 和普通聊天工具有什么区别？

它把模型与文件、API、MCP、浏览器等操作能力连接起来，可以在对话中完成多步骤任务并展示执行过程。能执行什么，取决于已配置的来源、模型能力和允许的权限范围。

第一次使用必须连接 Craft 账号吗？

不必须。官方快速入门允许跳过 Craft 登录，使用本地文件、GitHub、其他 API 或来源。连接 Craft 文档只是其中一种使用方式。

只能使用 Claude 吗？

不是。官方列出了多种模型连接与本地端点。不同连接的认证方式、支持能力和费用条件可能不同；切换连接需要开启新会话。

官方资源与开发者社区

• 开源仓库与许可：查看源码、版本更新和许可条件。
• Sources 连接指南：配置 MCP、API 与文件夹来源。
• GitHub 问题反馈：官网 Contact 指向的反馈入口。
• 官方 Discord 社区：由官方仓库链接的使用交流社区。