1. 明确目标
你可以在对话框中描述复杂任务，也可以从常见任务出发（调研、代码辅助、数据清理等），Arcana 会先帮助澄清边界和优先级。
本地安全的 AI 代理桌面应用
Arcana 是一款在本地运行的 AI 代理应用，带有 Web UI 和工具系统。你可以连接不同模型提供商，把密钥安全地加密存放在本地，像启动浏览器一样启动你的个人 AI 代理工作站。
- 本地运行 Web UI，不依赖云端托管服务。
- 支持多家模型提供商，可在界面中切换与配置。
- 密钥经内部加密仓库存储，不写入代码仓库或日志。
目前以 macOS 体验为主；你也可以使用仓库中的 CLI 与 Web UI 相关命令在其他平台上配合使用。
Goal → Plan → Execute
-
设定目标（Goal）
用自然语言告诉 Arcana 你的最终目标，比如“整理一份技术调研报告”或“为项目设计一条自动化工作流”。
-
生成计划（Plan）
Arcana 会根据目标拆解出多步计划，明确需要调用的工具、访问的站点以及中间产物，让过程可见、可修改。
-
自动执行（Execute）
在你的确认下，Arcana 分步调用浏览器、脚本和 API 执行计划，你可以随时中断、调整或接管任意一步。
Arcana 如何工作：从目标到执行
Arcana 将你的自然语言需求转化为可以验证与重复的代理任务流程：先对齐目标，再规划步骤，最后通过工具与模型协同完成执行。
2. 生成结构化计划
代理会把任务拆解为多步计划，每一步注明预计使用的工具、外部资源和中间结果。你可以在执行前审阅、修改甚至新增步骤。
3. 调用工具并执行
Arcana 通过内置工具系统执行计划：访问网页、运行脚本、调用 HTTP API 或读取本地文件。执行过程透明可见，每一步的输入输出都在 UI 中记录下来。
能力模块：为真实工作场景设计
Arcana 不是单一聊天界面，而是由一组可以组合使用的能力模块构成，你可以根据自己的工作方式启用或关闭不同模块。
多模型、多提供商配置
通过配置文件或 UI 配置不同的模型和供应商，例如 OpenAI 等，在任务中按需切换模型类型（推理、生成、嵌入等）。
安全的密钥管理
在 Secrets UI 中绑定如 providers/openai/api_key 之类的密钥，Arcana 会将它们加密存入内部密钥仓库，而不是写入 git 仓库或日志文件。
工具系统与插件
通过工具系统为代理提供浏览网页、执行脚本、访问 HTTP 接口等能力。你可以扩展自定义工具，把现有服务安全地接入到代理工作流中。
记忆与上下文
Arcana 为默认代理维护长期记忆（例如存放在 ~/.arcana/agents/default/MEMORY.md 中），帮助代理跨会话记住关键事实与偏好，减少重复沟通。
本地 Web UI
通过本地 Web UI 与代理交互，不需要把聊天记录交给托管服务。你可以在终端里运行 Web UI 相关命令，然后在浏览器中访问本机端口。
自动化与可观测性
任务执行过程在界面中完整呈现：调用了哪些工具、请求了哪些 URL、生成了哪些中间文件，便于你审计代理行为并进行调试与优化。
典型使用场景
无论你是工程师、产品经理还是个人创作者，都可以把 Arcana 当作“可以主动行动的 AI 搭档”。以下是一些常见的使用方式。
代码研发与重构辅助
让代理帮你阅读仓库、理解模块关系、生成初稿代码与重构建议，再由你进行最终决策和合并，避免“全自动改代码”带来的不可控风险。
技术与市场调研
代理通过浏览器工具访问官方文档、博客和社区讨论，按结构整理出摘要、对比表与下一步建议，省去大量复制粘贴和格式整理工作。
信息整理与知识库建设
把分散在笔记、Issue、文档中的信息交给 Arcana，让代理帮助清洗、分类并转化为统一结构的知识库草稿，再由你审核后落地到团队工具中。
个人效率与自动化脚本
从“每天固定要做的重复操作”入手，让代理为你设计并执行脚本或流程，例如整理下载文件、批量重命名、生成定期报告等。
下载、校验与安装 Arcana
Arcana 为 macOS 提供 .dmg 安装镜像。下面是下载链接与推荐的校验和验证步骤，方便你在本地确认镜像是否被篡改或损坏。
1. 下载 macOS 安装镜像
点击下方主按钮，即可从 /downloads/ 目录获取名为 Arcana-latest.dmg 的安装镜像文件。当前仓库中提供的是占位链接，实际发布时应替换为真实镜像文件。
下载 Arcana-latest.dmg提示：仓库中包含 Arcana-latest.dmg.placeholder.txt 用于占位，实际对外发布时，请用真实的 .dmg 文件替换，并同步更新校验和文件。
2. 使用 SHA-256 校验镜像
- 在浏览器中下载后，确保文件保存在你的下载目录（例如 ~/Downloads）。
-
打开终端，进入下载目录：
cd ~/Downloads shasum -a 256 Arcana-latest.dmg -
打开本仓库中的
site/downloads/Arcana-latest.sha256文件，核对输出的哈希值是否与其中记录的一致。 - 只有当两者一致时，才建议继续安装步骤。如果不一致，请重新下载或联系发布方确认镜像来源。
3. 安装与首次启动
- 双击打开
Arcana-latest.dmg。 - 将 Arcana 应用拖动到
Applications目录。 - 在 Launchpad 或 Spotlight 中搜索 “Arcana” 并打开。
- 如果 macOS 提示来自未验证开发者，你可以在“系统设置 → 隐私与安全性”中允许从当前来源打开，然后再次启动应用。
常见问题
这里整理了一些关于 Arcana 代理、模型配置与安全性的常见问题，帮助你在正式使用前快速了解重要信息。
Arcana 是什么？
Arcana 是一个可以运行在本地的 AI 代理系统，提供命令行与 Web UI 两种使用方式。它专注于“目标→计划→执行”的工作流，而不仅仅是普通聊天机器人。
Arcana 是否免费？
本仓库中的 Arcana 可以免费获取和使用。但你在接入第三方模型提供商（例如 OpenAI）时，仍需遵守各自的计费与使用条款。
我的密钥会被上传到云端吗？
不会。根据项目文档说明，你可以通过 Secrets UI 绑定密钥，Arcana 会将其加密保存在本地内部仓库，不会主动上传到云端服务。你仍然需要按照自己的安全策略管理这些密钥。
Arcana 可以离线使用吗？
Arcana 的 Web UI 和代理逻辑可以在本地运行，但如果所选模型提供商在云端托管，请求模型仍然需要网络连接。你也可以按需接入本地或自部署模型。
和直接用在线聊天产品有什么不同？
在线聊天产品更偏向一次性的对话，而 Arcana 更像“可编排的本地 AI 代理”。你可以把工具、配置和记忆都放在自己的机器上，并以工作流的方式重复使用。
如何在其他平台上使用 Arcana？
虽然这里重点介绍的是桌面体验，你仍然可以通过仓库中的 CLI 命令使用 Arcana，例如运行 node ./bin/arcana.js chat 与 node ./bin/arcana.js web serve 等，具体以文档为准。