数据与配置位置
Halo 的配置路径一览：在 macOS、Windows、Linux 上，数据、设置和凭据、日志、技能、Claude 配置目录各放在哪个文件夹，以及怎样从 Halo 里直接打开。
本页列出 Halo 3.0.4 桌面版在本机用到的每个文件夹：Halo 数据文件夹、应用数据文件夹、日志、诊断报告、工作区和记忆、技能，以及 Claude 配置目录。Halo 的数据分两处存放：你的数据（设置、对话、工作区、数字人）在 Halo 数据文件夹；AI 浏览器的登录状态、Claude 配置等运行环境在应用数据文件夹。换电脑时怎么搬，看 换电脑迁移。
位置总览
| 内容 | macOS | Windows | Linux |
|---|---|---|---|
| Halo 数据文件夹 | ~/.halo | %USERPROFILE%\.halo | ~/.halo |
| 应用数据文件夹 | ~/Library/Application Support/halo | %APPDATA%\halo | ~/.config/halo |
| 日志 | ~/Library/Logs/halo | %APPDATA%\halo\logs | ~/.config/halo/logs |
| 导出的诊断报告 | ~/Downloads/halo-diagnostics-<时间戳>.json | 「下载」文件夹 | 「下载」文件夹 |
| Claude 配置目录（默认） | ~/Library/Application Support/halo/claude-config | %APPDATA%\halo\claude-config | ~/.config/halo/claude-config |
| 全局技能（默认） | Claude 配置目录下的 skills/ | 同左 | 同左 |
%USERPROFILE%是C:\Users\<用户名>，%APPDATA%是C:\Users\<用户名>\AppData\Roaming。这两个写法可以直接粘贴到资源管理器的地址栏。- 应用数据和日志的文件夹名是小写的
halo。 ~/.halo以.开头，在 macOS 访达里默认隐藏。在访达按 ⌘ ⇧ G，输入~/.halo就能打开。
说明
公司提供的 Halo 可能用不同的文件夹名：数据文件夹会是 ~/.<名称>，应用数据和日志文件夹也可能不叫 halo。以 日志文件 › 打开文件夹 实际打开的位置为准。
Halo 数据文件夹
Halo 数据文件夹存放你的设置、凭据、对话、工作区、数字人和知识库。macOS 和 Linux 上是 ~/.halo，Windows 上是 %USERPROFILE%\.halo。
| 里面的内容 | 存的是什么 |
|---|---|
config.json | 全部设置，包括 API Key、令牌等凭据 |
halo.db | Halo 的本地数据库 |
spaces/ | 每个工作区的 Halo 数据，见 工作区和记忆的数据 |
spaces-index.json | 工作区列表 |
temp/ | Halo 工作区 的数据：artifacts/ 是 AI 做出的文件，conversations/ 是对话 |
knowledge-bases/ | 知识库 的数据 |
team-work/ | 团队 协作时的中间文件 |
apps/、tunnel/、codex/ 等 | Halo 运行时的其他数据 |
- 没有
settings.json，设置都在config.json。界面语言是例外，它保存在各个客户端自己那里。 - 正式版和预览版共用同一个数据文件夹。
- Halo 里没有「移动数据文件夹」的设置。要换位置，用
HALO_DATA_DIR。 - 在 Windows 上卸载 Halo，数据会保留。
- 开发者从源码直接运行的未打包版本用
~/.halo-dev，和安装的 Halo 互不影响。
注意
公开发行版把 API Key 和令牌以明文存在 config.json 里，界面上只显示为 ***。不要把这个文件发给别人，也不要放进同步盘或代码仓库。详见 安全、隐私与数据流。
应用数据文件夹
应用数据文件夹是 Halo 桌面应用的运行环境，文件夹名是小写的 halo。
| 系统 | 位置 |
|---|---|
| macOS | ~/Library/Application Support/halo |
| Windows | %APPDATA%\halo |
| Linux | ~/.config/halo |
| 里面的内容 | 存的是什么 |
|---|---|
Partitions/browser/ | AI 浏览器 的登录状态和网站数据。设置 › 系统 › 浏览器数据 › 清除浏览器数据 会清掉它们。最外层的 Cookies、Local Storage 等属于 Halo 自己的窗口，不会被清除 |
claude-config/ | 默认的 Claude 配置目录，含全局技能 |
git-bash/ | 仅 Windows：Halo 自动下载安装的 Git Bash |
Crashpad/ | 崩溃转储，见 诊断报告和崩溃报告 |
logs/auth-audit.log | 仅 macOS 放在这里，见 日志 |
日志
| 系统 | 日志文件夹 |
|---|---|
| macOS | ~/Library/Logs/halo |
| Windows | %APPDATA%\halo\logs |
| Linux | ~/.config/halo/logs |
| 文件 | 内容 | 何时写入 | 大小与保留 |
|---|---|---|---|
main.log | Halo 主日志 | 一直写入；打开 开发者模式 后变为调试级别 | 满 10 MB 轮转，保留 5 份编号存档（main.1.log 到 main.5.log） |
halo-sdk.log | Halo SDK 引擎 的运行记录 | 一直写入；开发者模式下变为调试级别 | — |
http-raw.log | 完整的请求和响应 | 只在开发者模式打开时写入 | — |
auth-audit.log | 远程访问 的登录记录：成功、失败、锁定和来源 IP，不记录密码 | 有人登录远程访问时 | 满 5 MB 轮转。macOS 上在 ~/Library/Application Support/halo/logs，Windows 和 Linux 上就在日志文件夹里 |
打开日志文件夹：设置 › 系统 › 日志文件 › 打开文件夹。仅桌面版
警告
开发者模式打开期间，http-raw.log 会原样记录完整的请求头和请求体，里面有你的 API Key 和对话内容。把日志发给别人之前，先关掉 设置 › 高级 › 开发者模式，再删掉 http-raw.log。需要分享时，优先用脱敏过的诊断报告。
诊断报告和崩溃报告
| 内容 | 位置 | 怎么得到 |
|---|---|---|
| 诊断报告 | 「下载」文件夹里的 halo-diagnostics-<时间戳>.json，macOS 上是 ~/Downloads | 设置 › 系统 › 系统诊断 › 运行诊断，再点 导出报告。界面显示「报告已导出至」和完整路径 |
| 崩溃报告 | 应用数据文件夹里的 Crashpad/ | 设置 › 系统 › 崩溃报告 › 打开文件夹 |
- 诊断报告不含密钥本身。错误信息里的 Bearer 令牌、JWT 和部分
sk-开头的 Key 会被遮盖，但 Anthropic（sk-ant-…）和 OpenAI 项目 Key（sk-proj-…）这类格式不会；/Users或/home路径里的用户名会被隐去，Windows 路径里的不会。发出前先通读一遍，详见日志与诊断。 - 崩溃报告只存在本机，不会上传。界面上的说明是「崩溃报告保存在本机。需要时可打开该文件夹，将其发送给支持团队。」
怎样用它们排查问题，看 日志与诊断。
工作区和记忆的数据
每个工作区的 Halo 数据都集中放在 Halo 数据文件夹里，和你的项目文件夹分开。
| 内容 | 位置 |
|---|---|
| 工作区的 Halo 数据（名称、颜色、工作目录、偏好、对话） | ~/.halo/spaces/<工作区 ID>/.halo/，其中 meta.json 是工作区信息，conversations/ 是对话 |
| 工作区记忆 | ~/.halo/spaces/<工作区 ID>/.halo/memory.md 和 memory/ |
| Halo 工作区 的文件、对话和记忆 | ~/.halo/temp/artifacts/、~/.halo/temp/conversations/、~/.halo/temp/.halo/ |
| 数字人记忆 | ~/.halo/spaces/<工作区 ID>/.halo/apps/<数字人 ID>/，详见 记忆文件在哪里 |
<工作区 ID>是随机 ID，不是工作区名称。不要猜路径，用 在文件夹中显示 打开。- 工作区关联了自定义文件夹时，那个文件夹里只有你的文件和 AI 改动的文件。Halo 建工作区时不往里写自己的数据，工作区记忆也不放在那里。工作区技能是例外，见 技能。
- 很早以前建的工作区，项目文件夹里可能还留有
.halo/文件夹。 - 删除关联了项目文件夹的工作区，只删 Halo 数据（对话记录），项目文件保留。详见 工作区。
技能
技能是一个含 SKILL.md 的文件夹，按作用范围放在两个地方。
| 范围 | 位置 | 谁能用 |
|---|---|---|
| 全局技能 | <Claude 配置目录>/skills/<技能文件夹>/ | 所有工作区的对话和数字人 |
| 工作区技能 | <项目文件夹>/.claude/skills/<技能文件夹>/ | 只有这个工作区 |
- 默认设置下，全局技能在应用数据文件夹的
claude-config/skills/。改了 Claude 配置目录，全局技能的位置也跟着变。 - 文件夹名相同时，工作区技能优先于全局技能。
- 手动放进这些文件夹的技能也会被发现。停用或卸载的技能会从磁盘上删除。
怎样添加、导入和管理技能，看 技能。
Claude 配置目录
Claude Code 引擎从 Claude 配置目录读取技能、设置和 MCP 配置，它的会话记录也存在这里。默认目录是应用数据文件夹里的 claude-config，它相当于独立安装的 Claude Code CLI 的 ~/.claude/。
在 设置 › 高级 › Claude CLI 集成 › 配置目录 里选择。仅桌面版
| 选项 | 目录 | 说明 |
|---|---|---|
| Halo 默认（推荐） | 应用数据文件夹里的 claude-config | 默认值。和你单独安装的 Claude CLI 互不影响 |
| Claude CLI 默认 | ~/.claude | 标记 高风险、不推荐，选择时要在对话框里点 使用共享配置 确认。技能和设置与 Claude CLI 共用，CLI 里的改动会影响 Halo；CLI 里配置的 API Key 或地址会盖过你在 Halo 选的模型 |
| 自定义路径 | 你指定的目录 | — |
- 面板上显示当前实际使用的路径。
- 点 应用 后显示「已保存。重启任何活跃的对话以应用。」进行中的对话要重新开始，才会用上新目录。
- 想沿用 Claude CLI 里已有的技能，又不想共用目录，用同一分区的 从 Claude CLI 迁移技能。各选项的细节见 设置参考。
在 Halo 里打开这些文件夹
下面的入口只在桌面版里有效。仅桌面版 在远程网页和安卓端点了不会打开文件夹。
| 想打开 | 在 Halo 里点 |
|---|---|
| 日志文件夹 | 设置 › 系统 › 日志文件 › 打开文件夹 |
| 崩溃报告 | 设置 › 系统 › 崩溃报告 › 打开文件夹 |
| 诊断报告 | 设置 › 系统 › 系统诊断 › 运行诊断 › 导出报告，看显示的路径 |
| 工作区的工作目录 | 管理工作区 页上工作区卡片的 更多 › 在文件夹中显示。Halo 工作区 打开的是 ~/.halo/temp/artifacts |
| 数字人的记忆文件夹 | 数字人的 能力与设置 › 高级 › 应用规格 › 记忆文件 › 在访达中显示。这个链接在 Windows 和 Linux 上也叫这个名字 |
| Claude 配置目录 | 设置 › 高级 › Claude CLI 集成 › 配置目录 显示当前路径，按这个路径在文件管理器里打开 |
工作区记忆没有单独的打开按钮。工作区卡片的 在文件夹中显示 打开的是工作目录，不是记忆所在的位置。
用 HALO_DATA_DIR 换数据文件夹
设置环境变量 HALO_DATA_DIR 后，Halo 用它指定的文件夹代替 ~/.halo 作为数据文件夹。
- 路径开头的
~会展开成你的用户目录。 - 设置后，日志改写到
<HALO_DATA_DIR>/logs。 - 应用数据文件夹（浏览器资料、
claude-config等）不受影响。 - 只能用环境变量设置，Halo 里没有对应的界面。要在启动 Halo 之前设好。
数据库备份和新版本数据保护
需要升级数据库结构时，Halo 会先把 halo.db 备份为 halo.db.<时间戳>.premigrate.bak，放在 Halo 数据文件夹里，只保留最新的 2 份。数据库损坏时，Halo 会把它改名为带 .corrupt.<时间戳> 后缀的文件，再新建一个。
正式版和预览版共用数据文件夹。用较新的版本（例如 预览版）打开过数据后，再用旧版本启动，Halo 会弹出「数据来自更新的版本」对话框，提示「无法打开本地数据」：
- 为避免损坏数据，Halo 停止启动，随后退出。
- 对话框显示数据目录和版本，建议你用较新的版本打开这份数据，或者恢复一份
.premigrate.bak备份。 - 按钮是 打开数据目录 和 退出。对话框的语言跟随系统语言。