mirror of
https://wget.la/https://github.com/leookun/cursor-byok
synced 2026-08-17 19:47:10 +08:00
88 lines
3.7 KiB
Markdown
88 lines
3.7 KiB
Markdown
# 已安装客户端只读核对与验证
|
|
|
|
首要原则：
|
|
|
|
- 不要修改已安装的 Cursor 客户端代码、bundle、签名或 app 副本。
|
|
- 允许且推荐读取、搜索、比对和分析客户端 bundle、日志、端口和 history 状态。
|
|
- 目标是定位差异、收集证据、判断问题归属，而不是 patch 客户端。
|
|
|
|
## 1. 先确认实际运行的 app 副本
|
|
|
|
优先用非交互命令核对：
|
|
|
|
```bash
|
|
pgrep -fal 'Cursor Hooked|Cursor Patched|/Contents/MacOS/Cursor'
|
|
ps -axo pid,ppid,command | rg 'Cursor(.app)?/Contents/MacOS/Cursor|extension-host'
|
|
```
|
|
|
|
不要在没确认实际运行副本前就下结论，也不要修改客户端文件。
|
|
|
|
## 2. 只读定位目标 bundle 与关键文件
|
|
|
|
优先定位并读取这些文件，而不是改写它们：
|
|
|
|
```bash
|
|
ls -l "/absolute/path/Target.app/Contents/Resources/app/extensions"
|
|
shasum -a 256 "/absolute/path/Target.app/Contents/Resources/app/extensions/cursor-always-local/dist/main.js"
|
|
```
|
|
|
|
重点关注：
|
|
|
|
- `out/vs/workbench/workbench.desktop.main.js`
|
|
- `out/vs/workbench/api/node/extensionHostProcess.js`
|
|
- `cursor-always-local/dist/main.js`
|
|
- `cursor-always-local/dist/gitWorker.js`
|
|
- `cursor-agent-exec/dist/main.js`
|
|
- `cursor-agent-exec/dist/*.js`
|
|
- `cursor-agent-worker/dist/main.js`
|
|
|
|
当前安装包里旧路径 `cursor-agent/dist/main.js` 通常不存在；先确认 `extensions/` 里的实际扩展名和 `dist/` 文件，再选择 `workbench` / `cursor-agent-exec` / `cursor-agent-worker` / `cursor-always-local` 对应排查。
|
|
|
|
## 3. 只读读取 bundle 内容
|
|
|
|
常用定位关键词：
|
|
|
|
```bash
|
|
rg -n 'BidiTransport|ExecClientMessage|InteractionResponse|conversation_checkpoint_update' "/absolute/path/Target.app/Contents/Resources/app/extensions/cursor-always-local/dist/main.js"
|
|
rg -n 'CursorAgentProvider|AnthropicProxy|ANTHROPIC_BASE_URL|InteractionUpdate|checkpoint|agent window' "/absolute/path/Target.app/Contents/Resources/app/extensions/cursor-agent-exec/dist/main.js" "/absolute/path/Target.app/Contents/Resources/app/extensions/cursor-agent-exec/dist"/*.js "/absolute/path/Target.app/Contents/Resources/app/extensions/cursor-agent-worker/dist/main.js"
|
|
rg -n 'agent window|open_agent_window|NameAgent|UpdateConversationMetadata|shouldShowAgentWindowTitleHelperText' "/absolute/path/Target.app/Contents/Resources/app/out/vs/workbench/workbench.desktop.main.js" "/absolute/path/Target.app/Contents/Resources/app/extensions/cursor-agent-exec/dist"/*.js
|
|
```
|
|
|
|
读取具体文件内容时，优先用读取工具按需查看相关片段，不要修改 bundle。
|
|
|
|
如果需要和仓库实现对照，优先同时打开：
|
|
|
|
- `proto/agent_v1.proto`
|
|
- `proto/aiserver_v1.proto`
|
|
- `internal/backend/...`
|
|
- `internal/runtime/local_runtime.go`
|
|
|
|
## 4. 验证行为是否命中目标副本
|
|
|
|
至少做其中两项：
|
|
|
|
- 进程路径是否是目标 app
|
|
- 目标扩展 host 是否起来
|
|
- 本地监听端口是否存在
|
|
- `~/.cursor-local-assistant-v2/logs/app.log` 是否更新
|
|
- `~/.cursor-local-assistant-v2/history/<conversationId>/state.json` / `context.json` 是否更新
|
|
- 请求/协议事件是否真的经过你正在分析的 bundle 文件
|
|
|
|
常用验证：
|
|
|
|
```bash
|
|
pgrep -fal '/absolute/path/Target.app/Contents/MacOS/Cursor'
|
|
lsof -nP -iTCP -sTCP:LISTEN | rg 'Cursor|127.0.0.1'
|
|
```
|
|
|
|
## 5. 记录证据并输出归因
|
|
|
|
如果确认“已安装 app 行为”和“仓库代码理解”存在差异，优先记录：
|
|
|
|
1. 实际运行的 app 路径
|
|
2. 命中的 bundle 文件路径与关键符号
|
|
3. 对应日志、端口、`history/state.json`、`history/context.json`、`usage.json` 证据
|
|
4. 仓库里对应实现的位置
|
|
|
|
如果结论指向客户端侧，也停留在分析和归因，不要继续 patch、重签名、替换文件或做写入式验证。
|