介绍 — PinEdit

PinEdit 是装在浏览器里的标注工具。通过将用户界面注释转化为结构化上下文，让 AI 工具能够理解并以此执行。

你在正在看的页面上点中任何元素，或者拖出一块区域，写下要修改建议。然后粘贴给任何 AI 工具中，所有的意见内容只会留在这一页上。

localhost:3000

会员方案2

开通1

button#buy

取消Pin

标注 2

1

加宽到 160

120×40已交给 AI

2

改成两行

标题已交给 AI

PinEdit

解决一个核心问题

跟 AI 工具改界面时，「增加一点高度」「往上移动一点」这种话太模糊，AI 经常改错地方。工具主要解决的是更准确的内容描述方式。

如何使用

安装浏览器插件，点击浏览器插件触发标注工具栏。
鼠标悬停在元素上，选择元素范围。
点击任意元素即可添加修改内容，按 Pin 即可在元素上进行标记。圈选一段文字，也会弹出标记窗口。
点击复制可以把修改内容贴进任意 AI 工具对话框。也可以通过 MCP 将内容传给 AI 工具。

按钮本身不会改页面上的字。它记下元素、位置、现在的尺寸和你的意见，交给对话里的 AI 去改。

PinEdit 是浏览器插件。装上之后，打开要改的页面，点浏览器工具栏里的图标，右下角会出现标注工具条。

安装方式

可以通过 Edge 商店下载，也可以先下载安装包，按下面的步骤在本机加载。

Edge 商店安装下载本地安装包

Edge 打开 edge://extensions，打开开发人员模式。
Chrome 用 chrome://extensions。
把安装包解压。选择「加载解压缩的扩展」，指向解压出来的文件夹。
打开要改的页面，点浏览器工具栏里的 PinEdit。右下角出现工具条。

本地 html 要在扩展详情里允许访问文件网址。插件有更新时，在扩展管理页重新加载，并刷新页面。

点击下面的标签，查看每种标注。

localhost:3000/blog

“简单比复杂更难。你必须努力让思维变得清晰，才能变得简单。但最终是值得的，因为一旦你到了那里「那里」32×20 取消Pin ，你就能移山。”

—— 史蒂夫·乔布斯

会员方案

开通1

button#buy120×40

取消Pin

正在同步

循环动画会停在当前这一帧。

区域220×72

这里加一条提示

取消Pin

标注 2

1

加宽到 160120×40

2

改成两行标题

PinEdit

按住拖过一段文字，弹出标记窗口。引用的原文会写进输出。

工具栏

通过浏览器插件方式自动识别元素，能够轻松地查看任意元素计算出的 CSS 样式。

暂停暂停页面上正在循环的可见动画，方便对着这一帧写意见。没有这种动画时是灰的。
显示隐藏或显示这一页上的编号和选区。没有标注时是灰的。
列表展开已经记下的标注。可以逐条删除，也可以一次清空。
复制把这一轮复制成整份文字，贴进任意对话。不需要先接 MCP。
选区拖出一块页面上还没有的区域，用来说明这里要新加一块。
PinEdit本机服务连上时才出现。把还没交过的标注送出去，剪贴板里留下「按 PinEdit 的标注改」。
设置颜色、亮色或暗色、右键是否关闭弹窗，以及 MCP 配置。
收起收成右下角的圆点。页面上的编号和选区会先藏起来。

设置

点工具条上的齿轮，会弹出下面这块。颜色、外观、右键关闭，以及 MCP 配置都在这里。

颜色

外观

操作

右键关闭标注弹窗

MCP已连接

{
  "mcpServers": {
    "pinedit": {
      "command": "npx",
      "args": ["-y", "pinedit-mcp"]
    }
  }
}

换一台机器时，用上面这段配置。

MCP 让开发环境自己来取标注。插件、本机服务、对话里的 AI 都在你这台电脑上，不经过 PinEdit 的服务器。

数据怎么走

浏览器在页面上标好，点 PinEdit。
本机服务插件把这一批发到 127.0.0.1:4737。只有你点过 PinEdit 的那一批才会发出去。
队列写进 ~/.pinedit/pending.json。同一时间只留一批，新的一批会换掉还没取走的。
开发环境把那句话贴进对话再发送。AI 通过 MCP 读走这一批，改代码之前把队列取走，避免下一次又执行同一批。

接到开发环境

拉起的都是同一个命令：npx -y pinedit-mcp。不用为每个环境再装一个服务。下面切换的是配置放在哪，格式不一样。

放进 ~/.cursor/mcp.json，或当前项目的 .cursor/mcp.json。保存后在 Cursor 里把这个 MCP 重连一次。

{
  "mcpServers": {
    "pinedit": {
      "command": "npx",
      "args": ["-y", "pinedit-mcp"]
    }
  }
}

Claude Code 在终端执行下面这句，然后重开一次会话。

claude mcp add pinedit -- npx -y pinedit-mcp

Claude 桌面版用和 Cursor 相同的 JSON，放进它的配置文件。macOS 上一般是 ~/Library/Application Support/Claude/claude_desktop_config.json。

放进 ~/.codex/config.toml。已经有别的 MCP 时，把这一段加进去，不要覆盖整个文件。

[mcp_servers.pinedit]
command = "npx"
args = ["-y", "pinedit-mcp"]

确认完修改的内容后，可以点击复制，会得到结构化的标记，代理可以解析并据此操作。交给 AI 的每一条，都写清是哪一个元素、它现在多大、你要改什么。

输出的格式内容

## PinEdit
**页面:** PinEdit
**地址:** 这一页
**视口:** 1280×800

### 1. button：「开通」
**位置:** `#buy`
**尺寸:** 120×40
**意见:** 加宽到 160

按「意见」改这个元素。尺寸只用来对照现在的大小。

复制和 MCP

两条路生成的是同一份标注。复制适合「把完整上下文一次性交给任意 AI」；MCP 适合「已经在开发环境里改代码，不想在对话里反复贴长文」。

	复制	MCP
典型场景	网页版对话、还没配本机服务、要把标注发给同事或另一个 AI	Cursor、Claude Code、Codex 等已接上 `pinedit-mcp`，在同一项目里继续改
主要价值	零配置，贴进去就能用；同一份可反复复制，适合试不同模型或多人协作	对话保持简短，标注由工具从本机读取；标注多、多轮改页面时更顺手
怎么交出去	剪贴板里是整份结构化标记，由你粘贴发送	剪贴板里只有一句提示，正文留在本机，由 MCP 读取
再发一次	可以反复粘贴，页面上的状态不变	读取后会取走队列，避免同一批被重复执行

标注先留在你正在看的这个标签页里。只有点了 PinEdit，这一批才会发到你电脑上的 127.0.0.1:4737，写进 ~/.pinedit/pending.json。编码工具读走之后，这个文件会被删掉。

PinEdit 没有账号，也没有自己的服务器。

不向 PinEdit 或任何第三方上传。
不在后台扫描你没打开标注的网页。
不读取浏览历史、密码或 Cookie。

之后交给哪个开发环境、会不会发到模型，由那个工具自己的设置决定，不经过 PinEdit。