图钉、评论和颜色
把带编号的图钉当作截图、文字和结构化上下文之间的稳定引用。
4 分钟本指南内容
同一次共享捕获
截图上的每个编号徽章都对应一条评论和一条图钉记录。轮换色板把邻近标记区分开,但不会改变它们的身份。
保持关联
把数据包交给其他工具时,不要改写 captureId 或 pinId。这些字段让工作区、查看器、智能体结果和审阅历史指向同一次捕获。
编号和身份如何分配
只有在评论去空白且非空之后,图钉才会保存。新图钉会获得一个 UUID、按其在捕获中的顺序从 1 开始的编号,以及该编号对应的十一色色板中的颜色。因此邻近徽章在视觉上不同,但身份不变。
结构化上下文会沿用现有 pinId 或 id 中的 pinId。若这些字段缺失,解析器会从捕获身份和图钉编号合成 captureId:pN。下游工具随后可以指向同一截图、评论和审阅行。
- 空的撰写框无法复制;焦点会留在该字段,直到存在评论。
- 悬停标记会在实时页面上预览其编号、评论和当前定位器置信度。
- 编辑已有图钉只会更新评论;存储的 id 保持不变。
结构与技术证据
每个元素图钉还会保存它所指向内容的快照:元素的 HTML 树、与浏览器默认值不同的计算样式、所用的字体和图标,以及它的父级和兄弟元素。预览渲染与图钉一起保存的定位器和证据,而完整快照保留在已保存的捕获和完整交接负载中。过大的元素会被裁剪以保持在捕获上限之内,会话 Markdown 会以截断的节点数说明这一点。
「技术证据」列出扩展在您添加图钉时于页面上观察到的事实:控制台错误、失败的请求,以及环境(浏览器、视口、语言)。每一项在发生于您最后一次点击或按键之后时标为「交互之后」,仅与该页面相关时标为「同一页面」。不做任何推断,也不消耗 AI 积分;如果某项无关,请在分享前将其移除。
- 区域图钉没有结构;当智能体需要 DOM 上下文和稳健定位器时,请使用元素图钉。
- 默认紧凑提示保留定位器、评论和紧凑证据;元素快照随完整负载的 pinar-visual-context 块和会话 Markdown 一起提供,可通过完整上下文链接获取。
在查看器中编辑笔记和评论
查看器中的图钉讨论允许编辑原始笔记和已保存的线程评论。本地工作区和 Pinar Cloud 的规则不同。
本地工作区没有登录,因此可以在查看器中编辑任何笔记和已保存评论。在 Pinar Cloud 中,会话所有者编辑笔记,人类评论只能由撰写者编辑。智能体评论在查看器中永远不可编辑。
- 编辑会覆盖已保存的文本,并保留消息的身份、作者和时间戳。