Navigator 8.1.0 怎么升级？/nav 判断记录与标注用法

8.1.0 让判断可回看，保留此前修复

Navigator 是用于项目上下文和任务管理的第三方 Claude Code 插件，当前官方仓库为 qf-studio/navigator，维护者为 Aleks Petrov。它可随插件提供技能和 Mod，不能把插件版本号当成 Claude Code 版本，也不能视为 Anthropic 对它的功能或效果作出保证。

按 UTC，8.0.0 于 2026 年 10 月 3 日 12:51 发布，加入在 Claude Code 内执行的 Mod 与 /nav 面板；8.0.1 于当天 18:29 修补只读回合被要求继续的问题。20:14 发布的 8.1.0 再加入 Judge 判断记录与标注，并把当前安装和更新入口统一到 qf-studio。准备升级时，应核对完整版本号，不只看“8”。

已有用户先升级，新用户再添加来源

已有安装时，在终端执行 claude plugin update navigator@navigator-marketplace，然后重启 Claude Code。作者的新运行逻辑会提示可用更新，但不会从 hook 自动更新自身；出现升级通知不等于本机安装已经改变。建议先记录现有版本，并保留项目任务文档和配置的备份。

新用户按 8.1.0 README 在 Claude Code 会话中执行 /plugin marketplace add qf-studio/navigator，再执行 /plugin install navigator。marketplace 名仍为 navigator-marketplace。作者说明旧的 alekspetrov/navigator 路径会重定向，已有安装仍可更新，无需只因名称调整而卸载。重启后，在目标项目输入 Initialize Navigator in this project，再输入 Start my Navigator session；先检查初始化产生的文件再继续任务。

确认宿主、插件和 /nav 三层状态

先运行 claude --version，Mod 路径需要 2.1.287 或更高版本。进入交互终端后打开 /plugin，确认 Navigator 已启用、版本正确，并查看活动 Mod 名单；然后输入 /nav，检查是否出现项目任务和上下文信息。安装成功、Mod 已加载、面板数据正确是三个不同的检查点。

首次排查优先用终端。Claude 官方说明，VS Code 扩展的聊天面板可以运行 Mod hooks，却不绘制其面板；无界面会话也不能靠窗口来验收。通用客户端与加载规则可参看资料来源中的《Claude Code Mods 怎么用？默认开启、安装与不生效排查》，再回到 Navigator 核对具体行为。

Next 会提交任务，Park 会留下文件

Context 卡片显示上下文占用与压缩时机提示；Next 显示目标和当前步骤。在该面板按 n 或 Enter 会把下一步作为提示词提交，可能启动后续工作。建议点击前读清任务标题和步骤，确认它们与当前目标一致；不要把快捷键当成只展开详情。

偏离目标提示出现时，Park 会把支线写成任务记录，Back 返回原路线，Switch 切换目标。提交前应想清楚要暂存问题还是正式换题。任务和阅读统计的部分内容在 d 后展开；并非所有卡片始终显示。没有配置本地 Prometheus，也可先使用 Claude Code 自带的用量信息，不必为打开面板先搭监控。

按 j 回看判断，先分清 y 与 x

8.1.0 的 /nav 面板可用 j 展开 Judge 记录，显示最近八条已判断的提示词及时间、类型、复杂程度和歧义结果。先读原提示词与判断，再决定是否标注；这段记录不是所有会话的完整聊天历史。

只有最新判断尚未标注时，面板才提供 y 和 x。y 将当前判断确认成标签，x 将它记为有异议；不是选择任意一条历史记录来打分，也不是用 x 关闭窗口。标注按提示词文本去重，文件默认保存到个人配置目录下的 ~/.config/navigator/judge-labels.json，使用自定义配置目录时应核对实际路径。

提出异议后，条目的 tier 为 null，仍需要后续人工补上真实分类；它不代表模型已经修正或重新完成任务。成功写入时应同时看到提示、标注符号与文件中的对应条目；如果出现 could not write 和路径，应先排查该路径的写入权限，不要认为已经保存。

需要核对标注数量时，可在插件根目录的普通终端运行 python3 scripts/judge_label.py status --fixture ~/.config/navigator/judge-labels.json；补齐有异议的条目则把 status 换成 label，按提示人工选择。若配置过 NAVIGATOR_CONFIG_HOME 或 XDG_CONFIG_HOME，要换成实际文件路径。标注文件包含提示词内容，分享前仍应检查业务资料，不能假定秘密模式替换已处理所有敏感内容；本指南没有在本机执行第三方插件。

只读回合停不下来，先核对补丁与触发条件

8.0.1 的明确修复场景是：两个会话共享一个仓库，另一个会话的事件影响了停止检查保存的工作区摘要，使只读回合也可能被要求继续。补丁按会话保存相关摘要，并调整只读命令识别；Mod 路径还会利用 Claude Code 对 Bash 调用的只读判定。它不是让所有停止检查都失效。

升级后可在已有问题的项目中，用一个明确只读的小任务复核，例如要求说明某段配置而不修改文件。记录是否仍被强制继续，以及当时是否另有会话使用同一仓库。若仍能复现，保留版本、操作顺序和错误文字给作者；不要先删除 .agent 下的运行状态、任务或记忆来掩盖触发条件。

Mod 没加载，不代表可以移除 Python

作者保留了经典 Python hooks 作为另一条运行路径；已发布清单仍调用 python3，面板相关源码也使用 Python 图谱工具。因此“逻辑移入 Mod”不能写成“彻底去掉 Python”。看到解释器或脚本路径报错时，应先核对错误指向的组件，不要因为升级到 8 就直接卸载原有依赖。

旧宿主或 Mod 未运行时，能否继续使用经典 hooks 还取决于宿主设置。尤其 disableAllHooks 会同时停止个人 settings hooks，不能保证此时自动回退到 Python。组织限制也须分别核对，不能靠修改一个开关绕过；先查 /plugin 状态和加载日志，再决定是版本、依赖还是策略问题。

Judge 可选，先弄清提示词会去哪里

Judge 是已有的可选 TypeSafe 判断功能，需要相应密钥和启用配置，会将提示词发送到外部 API；它不是安装 Navigator 或使用 /nav 的必需步骤。8.1.0 增加记录与标注，也不等于替用户开启 Judge。相关卡片要在发生判断后才出现，看不到记录时先区分尚未启用、尚未产生判断和插件未加载。

建议初次确认保持简单：先核对任务、上下文和只读行为，再决定是否需要额外判断服务。处理客户代码或组织资料前，应确认允许发送的内容及账户计费。官方发行说明还提到非必要流量开关下的不同请求路径，不能仅凭该开关推断已启用的 Judge 一定没有外发请求。

用小任务验收，再继续原来的工作

建议把验收分成一次读取、一次主动确认后的下一步任务：先看 /nav 是否对应正确项目，再确认 Next 提交的内容；需要暂存支线时，检查 Park 生成的任务记录。面板数据能刷新不等于代码已经正确完成，仍应检查实际文件和项目自己的验证结果。

如需临时停用，可在 /plugin 禁用 Navigator，但要知道同一插件中的其他组件也会受到影响。保存任务文件与原始配置，向作者提交最小复现，日志中去掉密钥和不必要的业务内容。恢复使用后重新核对当前任务，避免把旧面板里的下一步直接当成新的执行授权。