【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载Plannotator 是一款本地浏览器端的 AI 编码代理计划评审工具支持对 plans、代码 diff 和 PR 做可视化标注并把反馈一键发送回 agent。本文从 100 个进阶问题中精选最高频的实战要点聚焦三大主题Vim 控制全键盘驱动标注、Agent Skill 自定义 Review让 skill 成为评审规则、Call Flow 调用链分析基于 CallDiff 的调用路径推断帮你把 Plannotator 从能用用到顺手。一、Vim 控制全键盘驱动的标注方式 Vim 模式是什么Vim 控制是 Plannotator 的可选全键盘标注模式覆盖 Select划选和 Pinpoint精确定位两种交互。它默认关闭开启后不影响任何鼠标操作且键盘生成的标注与鼠标生成的走同一条标注管线——数据结构和高亮效果完全一致。官方设计文档docs/vim-controls.md一键开启 Vim 模式在Settings → Vim面板中有两个独立开关均通过 cookie 持久化开关作用默认值Vim mode启用键盘导航与标注关闭Vim HUD紫色四角准星 右下角按键显示可视化已处理的命令关闭Key panel右下角按键面板HUD 的一部分开启 小技巧开启 HUD 后按?可展开完整键位表按当前导航层级高亮分组——新手能一眼分辨j/k此刻是按块移动还是按行移动。导航模型与核心按键Vim 模式按语义结构导航而不是 DOM 焦点DOCUMENT → BLOCK → INLINE TARGET → TEXT → VISUAL SELECTION按键功能j/k下一块 / 上一块已细化后在兄弟节点间移动如表格行gg/G跳到第一块 / 最后一块l深入子目标在最深层进入文本h返回父容器v/V字符级 Visual 选择 / 整块选择j/k按整块扩展w/b/e/0/$文本态光标精调词边界、行首行尾o交换选区两端Escape只回退一层状态标注动作按键速查按键动作Enter使用当前激活的 Markup / Comment / Redline / Label 模式Space打开标注工具栏c/d/m/t评论 / 红线删除 / 标记 / 标签y复制选区内容⚠️ 三个安全边界输入框、评论编辑器等获得焦点时 Vim 键不生效Tab/ShiftTab保留原生焦点导航NORMAL 文本态下折叠光标不会被静默提升为整块选区需先用v建立选区。二、Agent Skill 自定义 Review让 skill 成为评审规则 ️自定义 Review 是什么一句话A custom review is an Agent Skill。把 Plannotator 指向某个 skill评审就按该 skill 的指令执行——skill 本身成为评审。默认的评审指令会被完全移除findings 的返回方式不变。官方文档docs/custom-reviews.md三步开启自定义 Review第 1 步把 skill 放在全局 skill 目录~/.claude/skills、~/.codex/skills、~/.agents/skills等。第 2 步在~/.plannotator/review-skills.json中声明要用作评审的 skill名称即 skill 文件夹名{ version: 1, enabled: [security-review, api-contracts] }第 3 步运行代码评审时选择该 skill 即可。工作机制与常见疑问实时读取Plannotator 在启动时读取 skill 的SKILL.md正文作为评审 prompt自动剥离 frontmatter不拷贝任何内容——按常规方式编辑 skill下一次评审即刻生效。带资源的 skill若 skill 含references/、scripts/、assets/Plannotator 会告知 agent skill 目录位置agent 按需自行打开。只认全局 skill提交在仓库里的 skill 会被忽略——否则一个 fork PR 就能把指令直接注入你的评审器。从旧 JSON profile 迁移旧的~/.plannotator/reviews/*.json已废弃把指令文本写进全局 skill 的SKILL.md再登记即可。没有review-skills.json一切照旧走默认评审。相关源码skill 加载器 packages/server/review-skill-loader.ts内置 skill 目录 apps/skills/core/。三、Call Flow 调用链分析看清哪条调用路径被改动了 Call Flow 能做什么Call Flow 是 Plannotator 代码评审中与 Semantic changes相互独立的可选分析默认关闭由 CallDiff 引擎驱动比较两个 Git 提交的完整源码树基于 Tree-sitter 语法解析提取命名可调用单元和有序的调用/分支步骤推断受改动调用影响的入口路径递归展开有界调用树将节点标记为same、added、removed并给出定义与调用点的源码位置。注意CallDiff 是语法证据而非运行时追踪——没有类型解析、数据流或动态分发证明因此界面统一使用推断入口路径inferred entry paths的措辞。如何开启 Call Flow评审首次打开时的欢迎对话框会把Semantic changes与Call flow并排呈现开关与Settings → Analysis写入同一份reviewAnalysis设置互不覆盖开启即同意安装对话框会标明当前 patch 的语言家族、仓库占用体积估计、Node.js 22 要求首次分析时后台自动安装核心 本次评审缺失的语法包进度在 Dock 中分阶段展示后续评审对已装语言立即可用也可无头安装plannotator install-runtime call-flow。运行时受管安装于~/.plannotator/vendor/call-flow/calldiff-0.4.1安装严格校验 SHA-512 完整性评审期间零网络访问npm 离线模式。完整设计见规格文档adr/specs/calldiff-call-flow-integration-20260811.md。结果怎么读两个视图 一个 Lens视图内容Call flow Dock评审级报告变更步骤数与受影响文件数提供 Paths / Raw 两个子视图Paths可折叠的推断入口树节点可点击跳转到源码RawCallDiff 原始 ASCII 树输出等宽字体、可整段复制flow NLens文件级文件头部显示该文件的变更步骤数 N打开后展示包含变更节点的完整入口树不裁剪变更节点可就地发起行级 Comment几个实用细节部分语言未安装时结果仍成功返回附带skippedLanguages元数据自动安装完成后同一快照自动重跑无需手动刷新评审期间仓库发生变动会得到结构化stale状态HTTP 409提示文件已变化请刷新重跑每次 diff / base / 范围切换都会取消旧快照的任务并重建结果始终与当前视图严格一致。四、100 问精选高频问答速查表 ⚡Vim 控制#问题一句话答案1Vim 模式会影响鼠标操作吗不会指针 Select / Pinpoint / Alt 键全部保留2输入评论时按c会触发红线吗不会输入区获得焦点时 Vim 键完全失效3j/k到底按块还是按行移动BLOCK 层按块进入文本层后按行开 HUD 可直观分辨4键盘标注和鼠标标注结果一样吗完全一样走同一条fromRange()高亮管线5忘了快捷键怎么办按?展开完整键位图当前层级自动高亮Agent Skill 自定义 Review#问题一句话答案6自定义 Review 需要写代码吗不用一个SKILL.md 一行 JSON 配置7改完 skill 要重启吗不用启动时实时读取下次评审立即生效8仓库里的 skill 能用吗不能只用全局 skill防止 PR 注入指令9skill 的 frontmatter 会被读取吗不会只有正文作为评审 prompt10不配置 review-skills.json 会怎样一切照旧使用默认评审Call Flow 调用链分析#问题一句话答案11Call Flow 是运行时追踪吗不是是基于 Tree-sitter 的静态语法推断12支持哪些语言22 种提取模式19 个可按需安装的语法包13开启后要下载什么仅当前 patch 缺失的语法包大小在对话框中预估14分析期间会联网吗不会评审运行时强制 npm 离线15分析一半改代码了会怎样旧结果标记 stale409刷新后重跑16flow N里的 N 是什么该文件中的唯一变更步骤数17能在调用树上加注释吗有源码位置的变更节点可直接发起行级 Comment18Semantic changes 能单独关掉吗可以两个分析开关完全独立持久化五、模块路径速查 主题路径Vim 控制文档docs/vim-controls.md自定义 Review 文档docs/custom-reviews.mdVim 模式 UI 实现packages/ui/components/VimModeOverlay.tsxVim 选择逻辑packages/ui/hooks/useVimSelection.tsHUD 键位显示packages/ui/components/VimKeyHud.tsxReview skill 加载器packages/server/review-skill-loader.tsCall Flow 安装与运行时packages/shared/call-flow.ts语言包定义packages/shared/call-flow-languages.tsCallDiff 集成规格adr/specs/calldiff-call-flow-integration-20260811.md项目总览README.md写在最后Plannotator 的进阶体验可以概括为一条主线标注更顺Vim 控制、规则更准Skill 自定义 Review、视角更深Call Flow 调用链。三者相互独立、均可单独启用——按需开启即可在看得见改动的基础上进一步做到读得懂上下文、审得出关键点把评审反馈一键送回 agent形成完整的迭代闭环。赞分享【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载相关推荐Plannotator 自定义 Review把 Agent Skill 变成代码审查配置Plannotator 自定义 Review把 Agent Skill 变成代码审查配置 Plannotator 的自定义 Reviewcustom revandrej-karpathy-skills 上手指南用一个 CLAUDE.md 文件让 AI 编码助手不再跑偏andrej karpathy skills 上手指南用一个 CLAUDE.md 文件让 AI 编码助手不再跑偏 给 AI 助手说加一个计算订单折扣的功能AI 技能提示工程Plannotator 的 plannotator-review Skill把“启动评审 → 浏览器批注 → Agent 处置反馈”闭环装进编码 AgentPlannotator 的 plannotator review Skill把“启动评审 → 浏览器批注 → Agent 处置反馈”闭环装进编码 Agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考