> ## 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.

# 故障排除

> 应用或 CLI 连不上主机、登录过期、MCP 服务器出错、插件被关闭或收不到通知时该怎么办。

从这里开始：

```bash theme={null}
archetype --doctor          # config, model, keys and records, without calling a model
archetype daemon status     # whether the background service runs, for each folder
archetype --version
```

## 应用连不上主机

桌面应用运行它自己的主机。如果主机在就绪后停止，应用会重启它，五分钟内最多三次。如果主机在启动过程中停止，应用会说明原因，并提供 **Try Again** 和 **Show Log**。

* 用“文件 → 重启 Archetype”手动重启。
* 如果应用显示**主机已重启。请重新打开 Archetype 以重新连接。**，请关闭应用再打开。
* **服务器上的主机：**应用用你系统的 `ssh` 连接，它必须能在终端中无需输入密码就连上。使用**重新连接**（在“文件”中，或“管理 → 设置 → 服务器”中）。较旧的服务器会提供**更新并重新连接**。如果仍然连不上，**使用这台电脑**会改为打开本地主机。
* **手机：**如果显示**无法连接到**你的电脑，请检查电脑是否开着，以及应用或它的主机是否在那里运行。如果 Archetype 提示端口被占用，在配置文件中把 `phones.port` 设为其他端口。见[设备](https://docs.archetype.ing/zh/use/devices.md)。

## 聊天、定时任务或触发器没有回应

它们在后台服务中运行，应用关闭时也一样。

```bash theme={null}
archetype daemon status                # exits 0 only while it runs
archetype daemon logs -n 100 --follow  # its log
archetype daemon restart               # start it again with the config as it is now
archetype daemon install               # install it again if it is missing
```

如果应用显示**后台服务已安装但未运行，因此聊天不会得到回复。**，请按**重启**。

后台服务不会获得你 shell 的环境。把密钥和令牌写在 `~/.config/archetype/env` 中，每行一个 `NAME=value`，并且只有你可以读取（`chmod 600`）：如果其他人可以读取，服务会拒绝启动。

## 登录过期

| 位置 | 你看到的 | 怎么做 |
| - | - | - |
| 模型或引擎 | **登录已过期。请重新登录。** | 在提示的地方重新登录。见[引擎](https://docs.archetype.ing/zh/use/engines.md)。 |
| 团队 | **登录 … 后才能打开** | 在侧边栏中登录公司。 |
| 应用（Gmail、Notion、Linear…） | **需要重新连接** | 打开“管理 → 连接 → 应用”，重新连接它。 |
| 通讯应用账号 | **重新连接** | 在那个账号上按它。见[账号](https://docs.archetype.ing/zh/use/accounts.md)。 |

## MCP 服务器出错

```bash theme={null}
archetype mcp list          # the servers, and the plugins' own
archetype mcp check NAME    # start it and list its tools
archetype mcp login NAME    # sign in, for a server that asks
```

某一轮中连不上的服务器会在这一轮中被跳过，其余的继续运行。设置了 `"disabled": true` 的服务器不会运行。见 [MCP 服务器](https://docs.archetype.ing/zh/extend/mcp.md)。

## 插件被关闭或找不到

* 检查“管理 → 插件”。**草稿**和**用餐**在你开启之前是关闭的。
* 在 `~/.config/archetype/config.json` 中关闭的插件（`"plugins": { "name": false }`）会保持关闭。
* 在公司的主机上，由管理员选择哪些角色能看到插件、能使用它的工具。如果你的角色不能，请联系管理员。见[托管公司](https://docs.archetype.ing/zh/teams/hosting.md)。
* **音乐**仅支持 Mac，并且需要 macOS 允许 Archetype 控制对应的应用。见[音乐](https://docs.archetype.ing/zh/plugins/music.md)。

## 收不到通知

* 打开“管理 → 我的设置 → 通知设置”。每台设备都会显示是否能收到通知：**已在系统设置中关闭**、**已在此浏览器中关闭**、**已被此浏览器阻止**或**无法连接**说明了收不到的原因。
* 在系统设置中为 Archetype 开启通知，然后再检查一次。
* **免打扰时段**会暂缓通知，**已静音的会话**收不到通知。
* 对话正显示在当前聚焦的窗口中时，不会显示它的通知。
* 团队中的提及、回复和决定遵循该团队自己的偏好设置。

## 日志在哪里

| 内容 | 位置 |
| - | - |
| 桌面应用的主机 | “帮助 → 显示日志”，或“帮助 → 显示日志文件夹” |
| 后台服务 | `archetype daemon logs`，或文件夹记录中的 `daemon/daemon.log` |
| 你自己运行的公司主机 | `docker compose logs -f archetype` |

日志中不包含访问令牌。发送日志前，请检查其中是否有私人信息。

## 报告问题

发邮件至 [help@archetype.ing](mailto:help@archetype.ing)，附上：

* 你做了什么、期望发生什么、实际发生了什么；
* 电脑和系统，以及 `archetype --version` 的输出；
* `archetype --doctor` 的输出，以及日志中问题前后的几行；
* 如果涉及连接的应用或插件，写明它的名称。


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