排错
按你看到的提示找:是什么原因,下一步怎么做。
这一页按「你看到了什么」来组织。先找到对应的提示,再看原因和做法。
找不到的话,先看日志:「设置 → 关于 → 诊断日志」,点「在访达中显示」。文件是 yihee.log。
装好了但 agent 用不了
欢迎页或设置里显示「没装」,但我明明装了。
Yihee 是按你登录终端时的环境去找命令的。刚装完的话,回到 Yihee 点「重新检查」。还是找不到,在终端里运行 which claude(或对应的命令)确认它在不在。
「已找到 … 但无法运行」。 命令在,但跑不起来。常见原因是它依赖的 Node 版本不对。在终端里直接运行一次那个 agent,看它报什么。
「未登录」,或者一发消息就失败。 Yihee 只检查装没装,不检查登没登录。在终端里登录一次:
| agent | 登录 |
|---|---|
| Claude Code | 运行 claude,输入 /login |
| Codex | codex login |
| Grok | grok login |
| OpenCode | opencode auth login |
| Pi | 运行 pi,输入 /login |
Pal 旁边显示「运行时离线」。 这个 Pal 用的 agent 现在用不了。去「设置 → 运行环境」点「重新检查」。
加入或新建团队
| 提示 | 原因 | 怎么办 |
|---|---|---|
| 邀请码是 TS- 加 10 位字母数字 | 格式不对 | 把管理员发的那段整段粘贴,不要手打 |
invite not found |
邀请码不存在或被删了 | 请管理员发一个新的 |
invite expired |
邀请码过期了 | 同上 |
| 操作太频繁,请稍后再试 | 同一个网络地址一小时内试得太多 | 等一会儿。自己部署的话检查 CLIENT_IP_HEADER |
| 该工作区名称已被占用,换一个 | 这台服务器上有同名的团队 | 换个名字 |
| 网络错误 | 连不上服务器 | 检查网络。连的是自己的服务器时,点「修改」核对地址 |
对话和 Pal
「原生会话已失效,已重置为新会话。请重发一次。」 agent 那边把这条会话清掉了。Claude Code 默认只保留 30 天,升级 CLI、换电脑、在 Sessions 里归档那条会话也会这样。Pal 的职责、记忆和 Yihee 里的对话记录都还在。照提示重发一次就行。
「Agent 正在运行,请先停止当前任务后再发送」。 它还在做上一件事。等它做完,或者点停止。平时在它忙的时候直接回车会自动排队,不会出这个提示。
「Agent 已被定时任务预留,请稍后重试」。 这个 Pal 的一件例行的事正要开始。稍等一会儿。
顶上出现「疑似卡死」。 它已经 45 秒没有任何动静了。可能只是在等一个很慢的命令。等一会儿,或者点停止后重发。
「额度用完了」。 见 账号与额度。默认会等恢复后自己接着做。
「目前只有用 Claude / Codex 的 Pal 能改了再发」。 其他 agent 不支持退回到某一句。复制那句话,改了重新发一条。
我让它做的事,它说没权限。 看输入框下面的运行权限选的是哪一档。各档的含义见 各 agent 对照。
Sessions
| 提示 | 原因 | 怎么办 |
|---|---|---|
| 这条会话的目录不在本机 | 当时的工作目录被移走或删了 | 把目录放回原处;或「转到其他工具」后在新目录继续 |
| 这条会话正在被 Pal 或定时任务使用 | 同一条会话不能两边同时跑 | 等那边跑完 |
| 已归档的会话要先恢复才能继续 | — | 在菜单里恢复 |
| 会话仍被原工具占用,请关闭该会话后重试 | 你在终端里还开着它 | 关掉终端里的那个会话 |
| 没开成 / 工具没把会话建起来 | agent 没能启动 | 多半是没登录,见本页最上面 |
| 列表是空的 | 没读到会话目录 | 「设置 → 运行环境 → 各工具存会话的目录」里核对 |
搜不到我记得聊过的内容。 默认只搜标题和首尾两句。在列表选项里打开「搜索消息正文」。OpenCode 的会话不在正文搜索里。
转到其他工具后提示「只带过去一份摘要」。 完整转换没通过校验,改成了带一份摘要。提示里会写原因。原来的会话没动,还在原来的 agent 里。
交接
| 提示 | 原因 | 怎么办 |
|---|---|---|
| 超过单个 95MB 上限 | 这条会话的包太大 | 把没入库的大文件加进 .gitignore,或先提交 |
| 已发送,N 个没发出去 | 一起交的几条里有的失败了 | 看提示里写的原因,单独重发那几条 |
| 这份交接放得太久,内容已经清理了 | 超过 14 天没接,或接手后超过 7 天 | 请对方重新发一次 |
| N 个会话没搬过来 | 导入时有的失败了 | 其余的已经可用。请对方单独重发失败的 |
| 会话已经搬过来,但第一句没问出去 | 东西都到了,只是 agent 没启动 | 打开那条会话,自己说一句「说说做到哪了」 |
| 没有可选的成员 | 团队里只有你一个人 | 先邀请对方加入 |
定时任务
到点了没跑。 按这个顺序查:
- 任务是不是「暂停」或「等你批准」。
- Yihee 是不是开着。关了窗口没关系,但彻底退出就不跑了。
- 电脑当时是不是睡着了。
- 当时有没有网。没网的时候到点的轮次会先等着,联网后再跑。
- 有开跑前检查的话,是不是它让这一轮跳过了。历史里会有一行「跳过」。
| 提示 | 原因 | 怎么办 |
|---|---|---|
| 该任务正在运行 | 上一轮还没结束 | 等它结束,或者先停止 |
| 任务运行中不能改 … | 换 agent、模型会打断正在跑的这一轮 | 先停止,或等这一轮结束再改 |
| 全部 runtime 失败 | 你选的每个 agent 都试过了,都没成 | 看后面跟着的原话。多半是登录失效 |
| 单轮总时长已用尽 | 超过了你设的「每轮最长」 | 把上限调大,或者把任务拆小 |
| 开跑前检查失败 / 超时 | 检查脚本出错了,或 30 秒没跑完 | 在任务设置里点「试跑一次」看输出 |
| 已达轮次上限 | 跑满了「最多跑几轮」 | 调高上限再恢复 |
| 这个计划不会再命中 | Cron 表达式两年内没有匹配的时间 | 检查表达式 |
| Yihee 上次在本轮完成前退出 | 跑到一半应用退出了 | 那一轮不会自动重跑,需要的话点「现在跑一轮」 |
团队任务:「连不上团队服务器,这一轮先不运行」。 团队任务每一轮开跑前要向服务器登记,这是为了保证不会两台电脑同时跑。连不上就先不跑,连上后自动补。超过 30 分钟还连不上,这一轮记为跳过。
团队任务:「运行者还在团队里,请他转交给你」。 只有运行者已经离开团队,别人才能直接接手。他还在的话,请他点转交。
团队任务变成了「暂停的私人任务」。 你已经不在那个团队里了,或者任务在团队里被删了。它留在你本机,不再和团队同步。
项目同步
| 状态 | 意思 | 怎么办 |
|---|---|---|
| 分叉 | 本地和远端各有对方没有的提交 | 自己合并或变基 |
| 游离 HEAD | 不在任何分支上 | 切回一个分支 |
| 同步冲突 | 有没解决的冲突 | 解决冲突 |
| 出错 | Git 命令失败了 | 看这一行写的具体错误 |
| gh / glab 没登录 | 私有仓库拉不下来 | 终端里 gh auth login 或 glab auth login |
这几种情况同步都会跳过那个仓库,不会动你的文件。页面上有「让 agent 排查」按钮,可以直接交给 agent 处理。
「还没选同步目录」。 在「设置 → 同步」里选一个。
Skill
| 提示 | 原因 | 怎么办 |
|---|---|---|
| 管理员尚未设置 skill 源仓库 | 团队还没配 | 请管理员在「团队管理」里填 |
| 源仓库没拉下来,显示的是上次的内容 | 没连上或没权限 | 点重试。先确认终端里能 git clone 那个仓库 |
| 内容不一致 | 某个 agent 上是你自己的版本 | 想跟团队走就点「换成团队的」 |
账号
| 状态 | 怎么办 |
|---|---|
| 登录失效 | 点「重新登录」 |
| 已封禁 | 账号被服务方封了,Yihee 这边处理不了。自动切换会跳过它 |
| 令牌失效 / 令牌过期 | 中转的令牌不能用了,点「换令牌」 |
| 余额用完 | 给中转充值 |
| 所有账号额度都已用完 | 等恢复。提示里会写预计几点有账号能用 |
| 登录回调端口被其他程序占用 | 终端里有一个没完成的登录。关掉它再试 |
我在 Yihee 里换了账号,终端里的也变了。 这是预期行为,见 账号与额度里「换号时终端里的登录也会变」。
命令行
| 提示 | 怎么办 |
|---|---|
| yihee 桌面 App 未运行 | task 和 handoff 需要桌面应用开着。打开 Yihee |
| 等待 yihee 桌面 App 响应超时 | 应用正忙。稍后重试 |
| 这是团队任务,要先向团队认领这一轮 | 团队任务不能从命令行触发,在应用里点「现在跑一轮」 |
应用本身
「应用出错了」。 点「重新加载」通常能恢复。反复出现的话点「复制错误」,连同日志一起发给我们。
下载后打不开,系统提示「已损坏」或「无法验证开发者」。 在访达里右键点应用,选「打开」;或者去「系统设置 → 隐私与安全性」里放行。
还是解决不了
在 GitHub 上提一个 issue,带上三样东西:你做了什么、看到了什么提示、日志里出错时间前后的几十行。日志里可能有路径和项目名,发之前自己看一眼。