Plannotator Ask AI 为什么不是当前会话？版本与异步审查排查

先确认你需要的是哪一种 Ask AI

如果希望审查问题由正在写代码的 Agent 回答，先找 Ask this session 标签及 Claude Code、Pi 或 OpenCode 名称。这个模式沿用发起审查的会话上下文。仍显示独立提供商或模型选择器时，先核对连接条件；不要把能打开审查页面当作已经连上原会话。

0.28.0 在 2026 年 10 月 5 日 00:50 UTC 正式发布；同日 04:11 UTC 发布 0.28.1，07:19 UTC 又发布正式补丁 0.28.2。中文讨论帖出现得更晚，不代表帖中版本仍是最新版。本文按当日官方说明解释条件，不把发布说明当成读者机器已更新的证明。

安装后先分别核对命令和插件

新用户从文末官方安装文档选择自己的系统。完整安装会配置检测到的 Agent；minimal 只装二进制，不能据此期待插件、hooks 和命令全部就绪。安装完成后打开新终端，运行 plannotator --version 和 plannotator --help，确认实际执行的版本与可用命令。

Claude Code 还需在会话中依次运行 /plugin marketplace add backnotprop/plannotator 和 /plugin install plannotator@plannotator，然后重启。已有插件用户在外部终端依次运行 claude plugin marketplace update plannotator、claude plugin update plannotator@plannotator；同时按官方安装文档更新二进制，随后重启 Claude Code。仅刷新 marketplace 不等于插件已更新。

为什么 Claude Code 仍在等待审查

Plannotator 的 Claude mod 路径要求 Claude Code 2.1.287 或更高版本，并在交互终端启用。先运行 claude --version，再检查插件是否启用，以及是否曾设置 PLANNOTATOR_CLAUDE_MOD=0 或 claudeCodeMod 为 false。组织策略限制应交由管理员处理，不能用关闭策略作为通用排错步骤。

原生 Windows、旧版 Claude Code、claude -p 与 SDK 会话沿用经典流程。远程模式、--tailscale、OpenCode 1，或在 Agent 会话之外直接运行 plannotator，也不能套用当前会话连接的结论。旧二进制可使计划审查退回阻塞模式并提示更新；这些环境差异不等于插件安装失败。

做一次最小检查，确认问题确实回到原会话

在支持的 Claude Code 交互会话运行 /plannotator-last，审查上一条回复；也可用 /plannotator-review 打开当前代码差异。在代码审查中选一小段差异，从标注工具栏选择 Ask AI；一般问题可从 AI 页签发起。先核对当前会话标签，再问与眼前内容有关的小问题。按官方连接流程，问题应出现在 Agent 聊天里，回答流回审查面板。

Agent 正忙时，可选择等当前回合结束再问，或主动中断后提问。停止这次问题只取消该问题。若原会话已关闭或无法连接，页面会说明无法到达，不能期待它自动改用另一家 AI；先检查发起审查的会话是否还在运行，再重开对应审查。

异步返回不等于计划已经批准

先进入计划模式，让 Claude 拟定计划；它调用 ExitPlanMode 时自动打开审查，不需要另找计划审查命令。mod 会交还控制权，但计划模式继续保持，Agent 被告知尚未获批。作出决定后，反馈作为插件消息回到会话。审查期间不要手动离开计划模式：官方说明手动离开后 Claude 可能开始编辑。终端不再阻塞不能用作已获批准的确认。

审查期间 Agent 修订计划时，同一页面更新并保留评论；针对旧版本作出的决定会被拒绝，需要审查新版本。批准后，Claude 再次调用 ExitPlanMode，按批准文本和所选权限模式继续。若要回到经典流程，可设置 PLANNOTATOR_CLAUDE_MOD=0，或在现有配置中把 claudeCodeMod 设为 false，下一次启动 Claude Code 生效。

Pi、OpenCode 和 0.28 系列的范围怎么分

Pi 的计划决定也会稍后作为会话消息返回，审批前仍有规划限制。OpenCode 2 的代码审查、annotate 和 last 可向会话发起完整回合；计划审查中它仍在等待 submit_plan，Ask AI 只给基于上下文的快速回答，不调用工具、不写入聊天记录。看到这个标签时，按快速解释用途使用即可。

0.28.1 修复文件夹标注反馈重复导出，并为图表评论加入 Ask AI；输入问题后按钮才可用，Enter 仍提交评论。它还修复部分 OpenCode 的链接显示、重复回复和通知顺序问题。补丁有具体适用场景，不能据此推断所有宿主、所有远程连接或所有审查故障都已解决。

空标注点 Done 仍发反馈？先看 0.28.2 更新路径

0.28.2 修复的是 annotate 会话没有标注时点击 Done，以及 /plannotator-last 的相同关闭路径。官方说明中，Claude Code mod、Pi、OpenCode、Amp 和 Droid 不再额外向 Agent 发送要求处理反馈的提示，而是记录会话关闭、没有反馈。这不等于计划获批，也不是代码审查中空白 Approve 的行为。

使用 Claude Code mod、OpenCode CLI bridge、Amp 或 Droid 时，需更新 Plannotator 二进制；0.28.0 和 0.28.1 的二进制不发送新信号，仅更新宿主插件仍可能保留旧行为。Pi 和 OpenCode 嵌入式运行时自带服务器，这项修复随插件更新取得。Pi 按官方步骤运行 pi update --extensions；OpenCode 重跑官方安装脚本，该脚本也会清理 OpenCode 2 插件缓存。Claude Code 的二进制和 marketplace 插件仍需分别更新。

通过 skill 运行的 Codex、Gemini，以及关闭 mod 的 Claude Code，仍会读取原来的无反馈纯文本句子。PR1701 还说明：OpenCode 1 嵌入式命令自身仍会运行一个空回合，只是不再追加第二个反馈回合。因此不要把补丁理解成所有宿主都没有回合，或保证不消耗任何额度；应先确认自己的运行路径。

仍不生效时，保留哪些信息再求助

按二进制版本、插件版本、Claude Code 版本、交互或非交互启动方式、本地或远程模式、面板标签的顺序记录结果。用一份不含敏感内容的示例回复或差异重试，并保存具体错误文字。不要立即清空全部 Agent 配置；先确认问题是连接条件、版本组合还是特定文档审查。

Ask this session 会把问题及回答带入原 Agent 对话；独立提供商模式则按所选提供商处理相关上下文。使用无密钥、无客户资料的示例，并按现有服务的用量规则核对调用，不能把插件连接功能理解成新增免费额度。Review Agents、Code Tour 和 Guided Review 的模型设置另行管理。