> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 文件和文件夹

> Archetype 在哪里保存设置、密钥、记录、日志和工作树，以及可以改变这些位置的环境变量。

路径适用于 macOS 和 Linux。设置了 `$XDG_CONFIG_HOME` 时，`~/.config` 就是它；`~/.local/share` 对应 `$XDG_DATA_HOME`。

## 设置

你的设置、项目的设置、env 文件、指令、技能和命名智能体：见[配置](https://docs.archetype.ing/zh/reference/config.md)。`~/.config/archetype/` 中还有：

| 内容 | 位置 |
| - | - |
| 应用的文件夹列表 | `workspaces.json` |
| 键盘快捷键 | `shortcuts.json` |
| 你自己的模型提供商 | `providers/*.json` |

命令行参数优先于项目的设置，项目的设置优先于你的设置。项目的配置只能收窄智能体可以做的事，不能放宽：它不能设置提供商或模型、允许编辑或命令、添加钩子或设置沙盒。

## 数据

在 `~/.local/share/archetype/` 中：

| 内容 | 位置 |
| - | - |
| 每个文件夹的对话和记录 | `projects/<folder>-<id>/` |
| 聊天频道的对话 | `chat/` |
| 会话和子智能体的工作树 | `worktrees/<folder>/<session>/` |
| 记忆 | `memory/` |
| 你的权限模式和“始终允许” | `permissions.json` |
| 智能体向你索取的密钥 | `secrets/` |
| Archetype 的 ChatGPT 登录信息 | `auth/chatgpt.json` |
| 引擎的其他账号 | `engine-accounts/` |
| 插件的数据 | `plugin-data/<plugin>/` |

会话的工作树位于分支 `archetype/<session>` 上。记录会一直保留，直到你删除；在用户配置中设置 `"keepRecordsDays": 90`，会删除超过这个天数的已结束记录。

## 日志

| 内容 | 位置 |
| - | - |
| 后台服务 | `~/.local/share/archetype/daemon/daemon.log`，或 `archetype daemon logs -n 100 --follow` |
| 它的服务定义 | macOS：`~/Library/LaunchAgents/ai.pairful.archetype.daemon.plist`；Linux：`~/.config/systemd/user/archetype-daemon.service` |

`archetype --doctor` 检查配置、模型、密钥和记录文件夹，不调用模型。

## 环境变量

| 变量 | 作用 |
| - | - |
| `XDG_CONFIG_HOME` | 移动 `~/.config` |
| `XDG_DATA_HOME` | 移动 `~/.local/share` |
| `ARCHETYPE_NO_CONFIG=1` | 不读取任何配置文件，只使用内置智能体 |
| `ARCHETYPE_NO_NETWORK=1` | 跳过更新检查和在线模型列表 |
| `ARCHETYPE_NO_BROWSER=1` | 登录 MCP 服务器时不打开浏览器 |
| `ARCHETYPE_INSTALL_DIR` | 安装脚本放置 `archetype` 的位置（默认 `~/.local/bin`） |
| `ARCHETYPE_WORK_NICE` | 智能体的命令在多大程度上让位于应用（1–19，默认 10；`off` 表示关闭） |
| `ARCHETYPE_PLAIN=1` | 终端逐行输出，而不是全屏显示 |
| `ARCHETYPE_INLINE=1` | 终端把输出保留在回滚缓冲区中，而不是全屏显示 |
| `ARCHETYPE_MOUSE=0` | 终端把鼠标滚轮和选择交给你的终端处理 |
| `NO_COLOR` | 终端不显示颜色 |

API 密钥也是环境变量；见[账号和密钥](https://docs.archetype.ing/zh/use/accounts.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.