排错

按你看到的提示找:是什么原因,下一步怎么做。

这一页按「你看到了什么」来组织。先找到对应的提示,再看原因和做法。

找不到的话,先看日志:「设置 → 关于 → 诊断日志」,点「在访达中显示」。文件是 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 没启动 打开那条会话,自己说一句「说说做到哪了」
没有可选的成员 团队里只有你一个人 先邀请对方加入

定时任务

到点了没跑。 按这个顺序查:

  1. 任务是不是「暂停」或「等你批准」。
  2. Yihee 是不是开着。关了窗口没关系,但彻底退出就不跑了。
  3. 电脑当时是不是睡着了。
  4. 当时有没有网。没网的时候到点的轮次会先等着,联网后再跑。
  5. 有开跑前检查的话,是不是它让这一轮跳过了。历史里会有一行「跳过」。
提示 原因 怎么办
该任务正在运行 上一轮还没结束 等它结束,或者先停止
任务运行中不能改 … 换 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,带上三样东西:你做了什么、看到了什么提示、日志里出错时间前后的几十行。日志里可能有路径和项目名,发之前自己看一眼。