Axon 用户手册

零基础也能上手的 AI 助手 — 从安装到精通

一、Axon 是什么？

用一句话解释：Axon 是一个装在你电脑里的 AI 助手，它不只会聊天，还能真正帮你操作电脑。

它能做什么？

• 帮你写代码、改代码、找 Bug — 不需要你自己写一行
• 读取和修改你的文件 — 你说"把第 3 行改成 xxx"，它就改
• 运行命令 — 你说"帮我跑一下测试"，它就执行
• 搜索你的项目 — 你说"找到所有包含 TODO 的地方"，它就搜
• 操作浏览器 — 你说"打开这个网页截个图"，它就做
• 处理 Office 文档 — 读取和编辑 Word、Excel、PPT、PDF
• 连接数据库 — MySQL、PostgreSQL、MongoDB、Redis、SQLite
• 生成图片 — 用自然语言描述，AI 帮你生成或修改图片
• 连接各种服务 — GitHub、Slack、飞书、Telegram、Discord 等
• 多个 AI 一起干活 — 大任务自动拆分给多个 AI 并行处理
• 自主完成持续目标 — 设定长期目标，AI 在后台持续推进
• 记忆与学习 — AI 记住你的偏好和项目知识，越用越懂你

谁适合用？

二、安装 Axon

Windows 电脑安装

方式一：一键安装脚本（最简单）

方式二：下载安装包

如果你的网络环境不方便运行脚本，可以从 下载页面 下载预编译的安装包。

macOS / Linux 安装

打开终端（Terminal），粘贴以下命令并回车：

curl -fsSL https://www.chatbi.site/assets/scripts/install.sh | bash

国内用户使用加速镜像：

curl -fsSL https://gitee.com/lubanbbs/axon/raw/private_web_ui/install.sh | bash

脚本会自动检测你的系统环境，安装所需依赖，构建并启动。

Docker 安装（服务器部署）

适合部署到服务器上，让团队成员通过浏览器远程访问：

# 直接使用预构建镜像
docker run -d \
  -p 3456:3456 \
  -v /你的项目路径:/workspace \
  wbj66/axon node /app/dist/web-cli.js --host 0.0.0.0

国内服务器加速构建：

docker build --build-arg REGISTRY=docker.1ms.run -t axon .

然后在浏览器访问 http://你的服务器IP:3456。

三、首次使用：配置你的 API 密钥

什么是 API 密钥？

Axon 需要连接 Claude AI 的服务才能工作。API 密钥就是你访问这个服务的"通行证"。

第一步：获取密钥

方式一：官方 Anthropic 密钥（最常见）

方式二：使用 OAuth 登录（无需密钥）

如果你有 claude.ai 的账号，也可以通过 OAuth 方式登录，不需要单独获取 API 密钥：

1. 打开 Axon 的 Web UI
2. 在登录页面选择 "OAuth 登录"
3. 选择账户类型（claude.ai 或 console）
4. 按照提示在浏览器中完成授权
5. 将授权码粘贴回 Axon

第二步：填入密钥

打开 Axon 后，有 3 种方式配置 API 密钥，选一种你觉得方便的即可：

方式一：在界面上填写（最推荐）

这是最简单、最直观的方式：

方式二：通过环境变量

如果你习惯用命令行，可以设置环境变量：

Windows（PowerShell）：

$env:ANTHROPIC_API_KEY="sk-ant-你的密钥粘贴在这里"

Windows（CMD）：

set ANTHROPIC_API_KEY=sk-ant-你的密钥粘贴在这里

macOS / Linux（终端）：

export ANTHROPIC_API_KEY=sk-ant-你的密钥粘贴在这里

方式三：通过配置文件

用文本编辑器打开或创建以下文件：

• Windows：C:\Users\你的用户名\.axon\settings.json
• macOS / Linux：~/.axon/settings.json

写入以下内容：

{
  "apiKey": "sk-ant-你的密钥粘贴在这里"
}

保存文件，重启 Axon 即可。

使用第三方 API / 中转服务

如果你不方便直接访问 Anthropic 官方 API（比如国内网络不通），可以使用第三方中转服务。

在界面上配置

通过环境变量配置

# 设置中转地址
export ANTHROPIC_BASE_URL=https://your-proxy.example.com/v1

# 设置中转服务的密钥
export ANTHROPIC_API_KEY=你的中转服务密钥

通过配置文件配置

{
  "apiKey": "你的中转服务密钥",
  "apiBaseUrl": "https://your-proxy.example.com/v1"
}

第三步：选择 AI 模型

配置好密钥后，你需要选择一个 AI 模型。在界面底部的输入框旁边有一个模型选择下拉菜单：

四、认识界面

主界面布局

打开 Axon 后，你会看到这样的界面：

顶部导航栏

功能标签页

底部工具栏

五、开始对话

发送第一条消息

在底部输入框输入你的问题，按回车或点发送。AI 会实时输出回复。

试试这些指令

当 AI 需要操作你的电脑时，你会看到类似这样的提示：

🔧 Read — 读取 README.md
   ✅ 成功读取 45 行

🔧 Bash — 运行 npm test
   ✅ 全部 12 个测试通过

上传文件和图片

点击底部的 📎 图标，可以上传文件给 AI 分析：

• 上传图片 — AI 能"看懂"图片内容，比如截图、设计稿、流程图
• 上传代码文件 — AI 能分析代码并给出建议
• 上传文档 — AI 能阅读并总结文档内容

语音输入

点击底部的 🎤 图标开启语音识别。对着麦克风说出你的需求，Axon 会自动将语音转换为文字。

对话管理

• 新建对话：点击顶部 ＋ 按钮
• 切换对话：点击顶部的会话选择下拉菜单
• 搜索历史对话：点击 🔍 或按 Ctrl+K
• 导出对话：在输入框输入 /export 可以导出为 JSON 或 Markdown 格式

六、权限模式 — 控制 AI 的操作权限

这是一个重要概念。AI 可以操作你的文件和电脑，你需要决定给它多大的权限。

在底部工具栏的权限下拉菜单中选择：

七、核心功能

7.1 代码视图

点击右上角的 代码视图按钮（</>），界面会变成类似 VS Code 的三栏布局：

• 在左侧文件树中浏览项目文件
• 在中间的代码编辑器中查看和编辑代码（支持语法高亮）
• 选中一段代码后，在右侧对话面板中让 AI 解释或修改
• 右键点击代码，选择 "Ask AI" 让 AI 分析

7.2 蓝图系统 — 让 AI 分析项目全貌

什么是蓝图？

把一个项目比作一栋大楼，蓝图就是这栋大楼的建筑图纸。AI 会扫描你整个项目的代码，告诉你项目有哪些模块、各个模块之间的关系、核心业务流程。

怎么用？

方式一：在聊天中说 帮我分析一下当前项目，生成蓝图

方式二：点击 "蓝图" 标签页，查看已生成的蓝图。

适合的场景：

• 刚加入一个新项目，想快速了解项目结构
• 要做大的改动前，先理清楚各个模块的依赖
• 给团队成员介绍项目架构

7.3 蜂群协作 — 多个 AI 同时干活

什么是蜂群？

就像蜜蜂一样，一个复杂的大任务会被拆分给多个 AI "工蜂"同时去做：

1. 规划者（Planner） 把大任务拆成小任务
2. 队长（Lead Agent） 把小任务分配给各个工蜂
3. 多个工蜂（Worker） 同时干活
4. 审查员（Reviewer） 检查每个工蜂的工作质量

怎么触发？

在聊天中描述一个比较大的任务，比如：帮我从零搭建一个博客系统，包含文章管理、用户登录、评论功能

AI 会自动判断这个任务需要蜂群模式。你也可以主动要求：用蓝图系统帮我实现这个功能

点击 "蜂群" 标签页可以实时查看多个 AI 的工作进度。

7.4 定时任务

让 AI 按照你设定的时间自动执行任务。

创建方式：

方式一：直接在聊天中说 帮我创建一个定时任务，每天上午10点检查 Git 仓库状态

方式二：点击 "定时任务" 标签页，手动创建。

7.5 目标管理 — AI 帮你持续推进长期目标

什么是目标管理？

定时任务适合简单的重复操作，但如果你有一个复杂的长期目标（比如"让我的开源项目获得 500 个 Star"），就需要目标管理。

AI 会：

1. 帮你把大目标拆解为具体的策略和步骤
2. 定义可衡量的指标来跟踪进度
3. 在后台持续自动推进各个步骤
4. 需要你操作的时候发通知提醒你

怎么用？

在聊天中说 帮我创建一个目标：让项目获得 500 个 GitHub Star，AI 会自动规划策略、设置指标并开始执行。

7.6 创建作品 — 让 AI 帮你从零搭建项目

点击 "作品" 标签页，可以让 AI 帮你创建全新的应用程序：

创建完成后，你可以在作品列表中看到之前所有的项目和文件操作历史。

7.8 知识库 — 让 AI 帮你整理知识

什么是知识库？

想象一个由 AI 自动整理的 Notion 笔记本。你把网页、文档丢进去，AI 帮你编译成结构化的 Wiki 文章，自动提取要点、打标签、建立文章间的关联。再也不用手动整理收藏夹里吃灰的链接了。

点击左侧导航栏的 "知识库" 进入，里面有四个子页面：

怎么往知识库里添加内容？

支持的文件格式：

AI 编译是怎么工作的？

导入的原始内容不会直接变成文章，需要经过 AI "编译"处理：

• 短文档：AI 直接将原始内容转化为结构化文章，提取标题、要点、标签
• 长文档：AI 先分块摘要每个部分，再合并为一篇完整的文章
• 编译过程中会自动提取分类和标签，方便后续查找
• AI 会自动检测新文章与已有文章的关联，建立反向链接

你可以逐篇点击 "编译" 按钮处理，也可以点击 "编译全部" 一键处理所有待编译的原始内容。

7.10 AI 智能编辑 — 让编辑器自己会思考

代码视图（点击右上角 </>）内置了一系列 AI 驱动的编辑增强功能，让你的编辑器像 VS Code + Copilot 一样智能。

7.11 时光回溯 — AI 改坏了代码？一键回到从前

什么是时光回溯？

你让 AI 修改代码时，难免会遇到改坏的情况。时光回溯就是你的"后悔药"：AI 每次修改文件前，系统都会自动保存一份快照，你可以随时回到任意一个快照点。

7.12 斜杠命令

在输入框输入 / 会弹出命令列表，这些是快捷操作：

八、扩展功能

以下功能在左侧导航栏的 "自定义" 页面中管理。

8.1 技能与插件

技能（Skills）是预先写好的工作流程，一键就能触发。

在聊天中输入 / 加技能名称即可使用：

插件（Plugins）是更强大的扩展，可以给 AI 增加全新的能力。在自定义页面的 "技能与插件" 面板中管理。

8.2 MCP 工具扩展

MCP（Model Context Protocol）是一种标准协议，让 AI 能连接各种外部工具和服务。

在界面上配置 MCP：

1. 打开自定义页面 > "MCP" 面板
2. 点击添加服务器
3. 选择类型（本地程序、网络服务等）
4. 填入配置信息

常用 MCP 服务器：

• GitHub — 管理代码仓库
• 文件系统 — 扩展文件访问能力
• 数据库 — 连接 PostgreSQL、SQLite 等数据库

8.3 Office 文档处理

Axon 可以直接读取和编辑多种办公文档，无需安装 Office 软件：

使用方式：直接在聊天中说 帮我读取 report.pdf 或 把 presentation.pptx 第 3 页的标题改成 xxx，也可以使用技能 /pdf、/xlsx、/pptx、/docx。

8.4 数据库工具

AI 可以直接连接你的数据库进行查询和管理：

使用方式：在聊天中说 连接我的 PostgreSQL 数据库 postgresql://user:pass@localhost:5432/mydb，AI 会自动连接并可以执行查询、查看表结构等操作。支持只读模式保护数据安全。

8.5 图片生成

AI 可以帮你生成或修改图片：

• 文生图 — 用文字描述生成全新图片，例如 帮我生成一个现代简约风格的 Logo
• 图生图 — 上传一张图片并描述修改需求，例如 把这张图片的背景改成蓝色

8.6 消息通道 — 连接 IM 软件

你可以把 Axon 连接到你常用的聊天软件，随时随地给 AI 发消息：

配置方法：打开自定义页面 > "消息通道" 面板，按照提示配置对应平台的 Bot Token。

8.7 连接器 — 对接第三方服务

连接器让 AI 能直接操作你的第三方服务：

配置方法：打开自定义页面 > "连接器" 面板，点击对应服务进行授权。

8.8 感知系统 — 让 AI 看到和听到

Axon 有三个感知能力：

8.9 API 代理 — 多设备共享密钥

如果你想在多台设备上使用同一个 API 密钥（比如手机上也想用），可以开启 API 代理服务器。

配置方法：

1. 打开自定义页面 > "代理" 面板
2. 设置代理端口和安全选项
3. 启动代理服务
4. 其他设备使用代理地址和生成的代理密钥来连接

安全特性：

• 自动生成代理密钥（不暴露真实密钥）
• 支持 IP 白名单
• 支持请求限流
• 支持每日调用限制

8.10 语音朗读

AI 回复时可以自动朗读内容。在自定义页面 > "感知" 面板中开启。

• AI 回复时自动朗读
• 代码块会自动跳过不读
• 说话时自动暂停麦克风（防回声）
• 朗读结束后自动恢复麦克风

8.11 Agent 网络 — 多个 AI 实例协作

如果你同时运行了多个 Axon 实例（比如在不同项目或不同电脑上），它们可以互相发现和协作：

• 自动发现 — 局域网内的 Axon 实例通过 mDNS 自动发现彼此
• 远程工具调用 — 一个 AI 可以调用另一个 AI 的工具
• 任务委派 — 把任务分配给其他 Agent 执行
• 信任管理 — 控制哪些 Agent 可以访问你的工具

配置方法：打开自定义页面 > "Agent 网络" 面板，启用网络功能并配置端口。

8.12 记忆系统 — AI 越用越懂你

Axon 拥有持久化记忆能力，不会像普通聊天机器人那样"忘记一切"。它会自动记住你的偏好、项目知识和过往经验，越用越聪明：

你不需要做任何配置，记忆系统（包括自动记忆）默认启用。如果想要更精准的语义搜索，可以在设置中配置 Embedding API。

8.13 自我进化 — AI 改进自己

这是 Axon 最独特的功能之一：AI 可以修改自己的源代码来获得新能力。

工作原理：

1. 你描述一个 AI 目前做不到的事情
2. AI 分析自己的源代码，找到需要修改的地方
3. AI 修改代码并自动重启
4. 重启后新能力立即生效

8.14 数据采集 — 从 78+ 网站提取结构化数据

Axon 内置了 OpenCLI 技能，可以从全球 78+ 主流网站中提取结构化数据。你只需要用自然语言描述想要的内容，AI 会自动判断是否需要调用 OpenCLI，并为你整理好结果。

支持的平台一览：

怎么用？直接在聊天框用自然语言说就行，不需要记任何命令：

典型应用场景：

• 市场调研 — 快速收集竞品在各平台上的口碑和讨论
• 技术趋势监控 — 追踪 HackerNews、Reddit 上的热门技术话题
• 学术论文追踪 — 定期获取 arXiv 上特定领域的最新论文
• 社交媒体热点分析 — 了解微博、知乎上的舆论趋势

8.15 扩展思考 — 让 AI 深度思考再回答

面对复杂问题（数学推理、架构设计、多步骤分析），普通的即时回答可能不够准确。开启扩展思考后，AI 会先在内部进行一轮深度思考，再给出更精准的回答。

如何开启：

1. 点击右上角 ⚙️ 打开设置面板
2. 找到 "思考模式" 选项
3. 选择一个档位即可生效

8.16 桌面应用自动更新

Axon 桌面端（Electron 版本）内置了自动更新功能，保持应用始终最新，无需手动下载安装包。

更新流程：

1. 启动桌面应用时，自动检测是否有新版本
2. 如果有新版本，后台静默下载更新包（不影响你正常使用）
3. 下载完成后，状态栏会出现提示
4. 点击 "重启更新"，应用重启后即完成升级

8.17 Notebook & REPL — 交互式代码执行

Axon 不只能帮你写代码文件，还能直接编辑 Jupyter Notebook 和在交互式环境中运行代码。

Jupyter Notebook 编辑

AI 可以直接操作 .ipynb 文件中的单元格：替换、插入、删除。代码单元格被修改后，旧的运行结果会自动清除。

REPL 交互式执行

支持 Python 3 和 Node.js，会话内状态持久化——变量、导入都会保留。

8.18 提示词片段 — 让常用指令自动生效

每次都要告诉 AI "用中文回复"？提示词片段帮你把常用规则固定下来，启用后每次发消息都会自动附带。

在自定义页面的 "提示词" 面板中管理。每个片段可设置名称、内容、是否启用、位置（前置/后置）、标签。

8.19 远程协作 — 跨设备、跨网络使用 Axon

Teleport 远程会话

通过 WebSocket 连接到另一台机器上运行的 Axon 实例，支持跨设备工作、多人结对编程、远程调试。

Cloudflare Tunnel 公网分享

一键将 Web UI 暴露到公网，无需公网 IP 和域名。在设置中开启 Tunnel 即可生成临时 URL。

8.20 自定义工具与 Agent — 让 AI 学会新技能

自定义工具（CreateTool）

直接在聊天中告诉 AI 你需要什么工具，AI 会动态创建并保存到 ~/.axon/custom-tools/，支持热重载。

自定义 Agent（CreateAgent）

在自定义页面的 "Agent" 面板中创建 AI 角色，配置名称、模型、工具、权限、系统提示词。用 /agent 名字 切换。

8.21 Vim 模式与浏览器扩展

Vim 模式

代码编辑器支持完整 Vim 键绑定（Normal/Insert/Visual 模式、motion、operator、text objects、宏录制）。在设置面板 > 编辑器中开启。

浏览器扩展（Chrome Extension）

安装后可在任何网页上选中文字，右键 "Ask Axon" 发送给 AI 分析。

安装：Chrome 开发者模式加载 src/browser/extension/ 目录。

8.22 向量数据库管理

在自定义页面的 "文档" 面板中查看向量数据库状态（已索引文件数、Chunk 数量、同步状态）。支持手动同步和 Chunk 预览。

8.23 高级工具集

面向进阶用户的工具，能显著提升开发效率和自动化程度。

九、设置面板详解

点击右上角 ⚙️ 打开设置面板，有以下选项卡：

十、常见问题

密钥相关

Q: 填入 API Key 后提示 "Invalid API Key"

排查步骤：

1. 确认密钥是完整的，以 sk-ant- 开头
2. 检查复制时有没有多带了空格或换行符
3. 去 console.anthropic.com 检查账户是否有余额
4. 如果使用中转服务，确认 API Base URL 填写正确

Q: 不想花钱，有免费方式吗？

• Anthropic 新用户通常有免费额度
• 使用 OAuth 登录 claude.ai 账号，可以使用你的 claude.ai 订阅额度
• Haiku 模型最便宜，简单任务够用

Q: 密钥安全吗？会不会泄露？

• 通过 Web UI 设置的密钥存储在本地配置文件中
• 密钥只发送给 Anthropic 官方 API（或你配置的中转服务）
• 不会上传到任何第三方服务器

安装相关

Q: 安装时报错

常见原因：

• Node.js 版本太低：需要 18 或更高版本，运行 node -v 检查
• 网络问题：国内用户设置 npm 镜像：npm config set registry https://registry.npmmirror.com
• 磁盘空间不足：至少需要 1GB 可用空间

Q: 打开后是空白页

原因通常是前端没有构建成功：

1. 检查终端有无红色错误信息
2. 尝试手动构建前端：进入 src/web/client 目录，运行 npm run build
3. 重启 Axon

使用相关

Q: AI 回复很慢

• 切换到 Haiku 模型（最快）
• 输入 /compact 压缩对话历史
• 检查网络连接，必要时在设置中配置网络代理

Q: AI 改了不该改的文件怎么办？

• 切换到 "询问" 权限模式，每次操作前确认
• 用 Git 管理项目，随时可以回滚：git checkout -- .
• 在项目根目录创建 AXON.md 文件，写上"禁止修改 xxx"

Q: 怎么让 AI 记住我的偏好？

在项目根目录创建 AXON.md 文件，写入你的规则。AI 每次打开这个项目都会自动读取。例如：

## 我的偏好
- 回复用中文
- 代码缩进用 2 个空格
- 不要修改 package.json
- 提交信息用中文

Q: 支持哪些编程语言？

AI 本身支持几乎所有主流编程语言。Axon 的代码分析功能对 JavaScript、TypeScript、Python、Java、Go、Rust、C/C++、Ruby、PHP、Swift、Kotlin 等有语法高亮和智能分析支持。

Q: 知识库收藏的内容存在哪里？

存在本地 ~/.axon/knowledge/ 目录下。原始内容在 raw/ 子目录，编译后的文章在 wiki/ 子目录。不会上传到任何云端服务。

Q: 怎么在浏览器中一键收藏网页到知识库？

在知识库页面底部有一个"书签小工具"链接，将它拖到浏览器书签栏。之后在任何网页上点击这个书签就能一键保存到 Axon 知识库。

Q: 扩展思考模式有什么用？

扩展思考让 AI 在回答前先进行深度推理，适合复杂的数学、逻辑、架构设计问题。会增加响应时间和费用，日常简单问题不建议开启。

十一、获取帮助