【免费下载链接】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 开源仓库的官方发布说明系统拆解 v0.13.0 版本的九大核心改进内置 18 套主题、可直接在 Plan Diff 上做标注、代码评审支持文件级评论、新增 Octarine 笔记集成、Pi 扩展远程会话支持等。通过对照仓库源码与测试读者不仅能掌握每个新特性的使用方式与配置参数还能理解其底层实现机制如diffContext字段、useAnnotationHighlighter钩子、Promise.allSettled并行保存等为升级、排查与二次开发提供一手依据。版本概览一次聚焦协作体验与平台一致性的大版本v0.13.0 的主题是协作体验打磨与多平台能力对齐。官方发布说明指出本版本共合入 14 个 PR其中 6 个来自外部贡献者、3 个为首次贡献主要亮点集中在四个方面内置主题系统UI 内置 18 套主题覆盖深色、浅色与跟随系统三种模式可标注的 Plan Diffcoding agent 被拒绝后重新提交时产生的差异视图现在可以直接在差异内容上打标注文件级评审评论/plannotator-review界面新增针对整个文件的评论能力Pi 扩展平台对齐远程会话支持、统一评审内核Bun Pi、共享反馈模板等一系列重构。下文按功能逐一展开并给出仓库内的源码级佐证。内置主题系统18 套主题与单一颜色事实源功能与使用方式v0.13.0 的 UI 内置 18 套主题覆盖 dark、light 与 system-adaptive跟随系统三种模式风格从高对比度终端风到柔和粉彩风不一而足。使用上在Settings设置中通过主题网格theme grid预览并即时切换选择结果通过cookies跨会话持久化无需每次重新配置。源码级实现原理主题体系的关键改动是颜色令牌color token的集中化所有颜色被统一收敛进 packages/ui/theme.css以CSS 自定义属性CSS custom properties的形式暴露。这意味着计划查看器、代码评审、标注三种 UI 共享同一套颜色变量——一处改动全局生效彻底避免了此前各界面颜色值各自维护导致的漂移问题。从仓库目录可以看到 packages/ui/themes 下的 52 个主题样式文件如dracula.css、nord.css、tokyo-night.css、terminal.css、catppuccin.css、one-dark-pro.css等印证了发布说明中18 套内置主题只是核心精选集合主题系统本身是可扩展的。切换主题时渲染层只需替换生效的 CSS 文件并重新读取theme.css中定义的 CSS 变量即可让计划查看、代码评审、标注三个界面同时换肤。可标注的 Plan Diff让代理精确知道你在批注哪段差异触发场景Plan Diff 视图出现在 coding agent 的提案被拒绝denial后重新提交时——它对比的是新旧两版计划。v0.13.0 之前该视图只能看现在它可以像普通文档一样被标注。交互方式将鼠标悬停在新增added、删除removed或修改modified的差异区块上标注工具栏随即出现每个标注都会携带一个diffContext字段取值分别为added、removed、modified该字段会包含在导出的反馈exported feedback中agent 据此精确知道你的评论针对的是差异中的哪一部分。实现机制从 web-highlighter 到块级悬停发布说明特别强调这是一次重大重构共享标注基础设施被抽出为useAnnotationHighlighter钩子。在 packages/ui/hooks/useAnnotationHighlighter.ts 中可以看到该钩子统一管理 web-highlighter 生命周期、工具栏/弹层/快捷标签状态、标注创建、基于文本的恢复草稿与分享链接、滚动定位等能力并暴露toolbarState、commentPopover、quickLabelPicker等状态与handleAnnotate、handleCommentSubmit、applyAnnotations等操作接口供 Viewer、HTML 查看器、Diagram 等多个宿主复用。Diff 视图改用自己独立的块级悬停系统而非 web-highlighter。在 packages/ui/components/plan-diff/PlanCleanDiffView.tsx 中可以看到完整的实现每个 diff 区块根据类型unchanged/added/removed/modified渲染added与removed区块分别带绿色/删除线样式modified区块在词级差异word-level diff可用时用ins/del内联标记渲染新旧词见InlineModifiedBlock悬停处理handleHover/handleLeave配合 100ms/150ms 的延时与退出缓冲避免工具栏闪烁createDiffAnnotation生成的标注使用diff-block-${index}作为blockId并把diffContext写入标注对象。值得注意的是getBlockContent对modified区块会同时捕获新旧两侧内容以 git-diff 形状- old\n new输出确保你评论被划掉的删除词时导出的反馈仍保留该词而不是只发送新内容。导出链路打通。diffContext作为Annotation的标准字段在 packages/core/external-annotation.ts 等类型定义中可见会随反馈模板一起生成并发送给 agent实现批注-导出-回传的完整闭环。文件级评论超越行级标注的整体性评审反馈功能说明/plannotator-review代码评审界面在原有的行级标注line-level annotations之外新增了文件级评论file-level comments每个文件头部都有一个评论输入框comment composer用于针对整个文件发表反馈文件级评论与行级标注一起显示在Review Panel中两者都会包含在导出的反馈里。该功能适合这个文件应该拆分这里的方案需要重新考虑这类不依附于任何具体代码行的整体性观察。该特性由外部贡献者 sercantor 在 PR #303 中实现同时关闭了其提出的 issue #302。从架构上看这与 v0.13.0 的共享反馈模板改动相辅相成——文件级评论最终同样走统一的反馈导出管线保证 agent 收到的反馈结构一致。Octarine 笔记集成第三个笔记应用 全量自动保存功能说明Octarine 成为继 Obsidian、Bear 之后的第三个笔记应用集成计划快照可以在批准approval或拒绝denial时直接保存到 Octarine三个集成Obsidian / Bear / Octarine现在都支持auto-save 开关在 Settings 中开启一次之后每次计划决策都会自动写入笔记应用无需再次弹窗确认。源码级实现原理在 packages/ui/utils/octarine.ts 中可以找到 Octarine 集成的完整设置模型OctarineSettings接口包含enabled、workspace、folder、autoSave四个字段各设置通过plannotator-octarine-enabled、plannotator-octarine-workspace、plannotator-octarine-folder、plannotator-octarine-autosave四个 storage key 持久化folder的默认值为plannotator未配置时自动落到该目录isOctarineConfigured()的判定条件是enabled为 true 且workspace非空——即启用开关 工作区地址缺一不可集成使用octarine://URI scheme无需做 vault 检测。发布说明还揭示了一个关键工程细节所有集成的保存操作都以Promise.allSettled并行执行。在 packages/server/shared-handlers.ts 中可以看到该调用点——这意味着某个笔记应用保存缓慢或失败时不会阻塞其他应用的保存流程这与Promise.all的一损俱损行为有本质区别。Pi 扩展远程会话支持SSH 与 devcontainer 环境对齐功能说明Pi 扩展现在与 Claude Code hook 使用相同的方式检测远程环境检测依据是PLANNOTATOR_REMOTE、SSH_TTY、SSH_CONNECTION三个环境变量在远程会话中Pi 扩展使用固定端口并返回 URL 供用户在浏览器手动打开而不是尝试自行拉起浏览器。这使得 Pi 在远程开发工作流上达到了与 Claude Code、OpenCode 完全一致的能力水平。该特性由外部贡献者 fink-andreas 在 PR #299 中实现。与相关文档的呼应仓库中 apps/marketing/src/content/docs/reference/environment-variables.md 与 apps/marketing/src/content/docs/guides/remote-and-devcontainers.md 均涉及PLANNOTATOR_REMOTE等环境变量说明远程/开发容器场景是该项目的官方一等公民支持范围。统一评审内核Unified Review CoreBun 与 Pi 共享一套实现问题背景此前评审服务器存在两套实现一套在 Bun 编译的 hook 中一套在 Pi 扩展中。两者随时间推移逐渐分叉导致了一系列 bug——典型例子是 Pi 评审缺少对未跟踪文件untracked files的支持issue #307由 0xbentang 报告。解决方案v0.13.0 抽取出一个运行时无关runtime-agnostic的评审内核Bun 与 Pi 两个平台共同消费差异组装diff assembly文件内容获取file content retrievalworktree 处理worktree handlingstage/unstage 操作全部集中到一处实现并配套回归测试覆盖共享接口面防止两平台再次漂移。该重构在 PR #310 中完成关闭 issue #307。共享反馈模板统一拒绝消息修复版本历史分组问题功能说明此前发送回 agent 的拒绝反馈消息在计划评审、代码评审、标注三种模式下措辞与结构各不相同。v0.13.0 将三者统一到共享模板中。同时模板新增一条指令重新提交时要保留计划的# Title一级标题。这一看似微小的约定修复了一个版本历史 bug——此前标题变化会破坏基于 slug 的计划分组issue #296由 MarceloPrado 报告。意义这保证了 agent 收到的反馈无论来自哪个入口plan review / code review / annotate格式都一致从而让 agent 的响应行为可预期而# Title保留指令则从源头保证了版本历史分组的稳定性。可配置 Bear 标签从硬编码到可定制功能说明Bear 集成此前将标签tag硬编码v0.13.0 允许用户设置自定义标签选择标签是**前置prepend还是后置append**到笔记正文。该 PR#283由 MarceloPrado 提交还顺带修复了一个双标题 bug此前 URL 参数中的标题与笔记正文里的 H1 会同时渲染导致同一篇笔记出现两个标题。其他改进与修复v0.13.0 还包含一系列小而实用的改动改动说明关联 PRFavicon三种服务器模式plan review / code review / annotate统一提供 SVG favicon紫色圆角方块 白色 P 金色高亮条纹#312dgrissen2LGTM 批准修复在代码评审中点击 LGTM 批准后不再向 agent 发送处理所有反馈的指令——既然点了 LGTM 就说明没有反馈要处理#293tobeycodes 报告 #284非阻塞浏览器启动Pi/LinuxexecSync(xdg-open)在 Linux 上会阻塞 Pi 扩展事件循环改为 detachedspawn().unref()#292dvic 报告 #288移动端上下文菜单修复文本选择期间抑制 iOS Safari 原生 callout 与 Android Chrome 上下文菜单避免标注工具栏被遮挡#281grubmanItayTater 吉祥物 z-index 修复移动端兼容 PR 创建的层叠上下文导致吉祥物渲染在计划文档之前已修复#308review-renovate 技能新增 agent 技能.agents/skills/review-renovate/用于对 Renovate 依赖 PR 做自动化供应链审查#306其中execSync改spawn().unref()是一个值得借鉴的 Node.js 并发模式execSync会同步阻塞事件循环直到子进程退出而 detached spawn 加unref()让子进程脱离父进程生命周期并异步完成适用于拉起外部程序但不想阻塞服务的场景。安装与升级指南根据发布说明各平台与各 agent 的升级方式如下。macOS / Linux安装脚本curl -fsSL https://plannotator.ai/install.sh | bashWindowsPowerShellirm https://plannotator.ai/install.ps1 | iexClaude Code 插件在 Claude Code 中运行/plugin找到plannotator点击Update now。OpenCode先清除缓存并重启rm -rf ~/.bun/install/cache/plannotator然后在opencode.json中指定最新版本{ plugin: [plannotator/opencodelatest] }Pi安装或更新扩展pi install npm:plannotator/pi-extension注意上述命令的适用前提是已安装对应运行环境如 bun 缓存路径用于 OpenCode 插件缓存清理。仓库同时提供 scripts/install.sh 与 scripts/install.ps1 的本地副本可对照查看安装脚本的具体行为。社区贡献速览v0.13.0 是社区参与度相当高的一个版本14 个 PR 中 6 个来自外部贡献者其中 3 位是首次贡献者。sercantor实现文件级评论#303并提出了对应的功能请求 #302fink-andreas为 Pi 扩展带来远程会话支持#299MarceloPrado实现可配置 Bear 标签#283并报告了版本历史标题问题#296——该问题直接催生了共享反馈模板重构grubmanItay移动端上下文菜单修复#281是 v0.12.0 移动兼容工作的后续dgrissen2为所有服务器模式添加 favicon#312。同时多位社区成员通过 issue 驱动了本版本的关键改动0xbentang#307Pi 评审缺失未跟踪文件、tobeycodes#284LGTM 仍要求处理反馈、dvic#288Pi 在 Linux 上阻塞浏览器启动、MarceloPrado#296版本历史标题保留、sercantor#302文件级评论请求。总结v0.13.0 是 plannotator 从能标注走向处处可标注、平台处处一致的关键版本内置主题系统统一了三类界面的视觉事实源Plan Diff 可标注配合diffContext让代理精确理解反馈指向文件级评论补全了代码评审的反馈粒度Octarine 集成与全量自动保存提升了计划决策的记录效率而统一评审内核、共享反馈模板与 Pi 远程支持则从架构层面消除了多平台实现漂移的隐患。若你正在使用这些 agent 工作流建议尽快按上文方式升级并重点关注 Plan Diff 标注与文件级评论这两个新交互给团队评审流程带来的效率提升。赞分享【免费下载链接】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 OpenCode 插件实战在 OpenCode 中可视化审阅与标注 Coding Agent 的 PlanPlannotator OpenCode 插件实战在 OpenCode 中可视化审阅与标注 Coding Agent 的 Plan Plannotator 的Plannotator Pi 扩展实战在 Pi 编码代理中实现文件化 Plan Mode 与浏览器可视化评审Plannotator Pi 扩展实战在 Pi 编码代理中实现文件化 Plan Mode 与浏览器可视化评审 Plannotator 的 Pi 扩展 plcc-haha 桌面端 Workspace 使用指南Diff 审查、行级评论与内置浏览器实战cc haha 桌面端 Workspace 使用指南Diff 审查、行级评论与内置浏览器实战 对话记录告诉你说 Claude 说了什么而 Workspace人工智能AI 应用桌面应用代码智能体MCP Clients上一篇Cartography中的Coefficients布局系数计算逻辑下一篇[6.3.0] - 2024-XX-XX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考