дȫÏîĿÉó²éÎÊÌⲢ·¢²¼ v1.1.9
¸ÄÓñ¾»ú¶ÀÁ¢ CA£¬»ָ´ CLI TLS УÑ飬±£»¤ƾ¾ÝÓëÅäÖò¢·¢±£´档 д Cursor Êý¾ݡ¢»Ự·¾¶¡¢´úÀíÉúÃüÖÜÆڡ¢ģÐÍÇëÇóÓë Skills Îļþ²Ù×÷¡£ Ϊ¶ÀÁ¢ Tab ·þÎñÔö¼ӿͻ§¶˼øȨ£¬Éý¼¶ÒÀÀµÓ빤¾ßÁ´£¬ÍêÉƷ¢²¼ԪÐÅϢͬ²½¡£ Ñé֤£ºÁ½¸ö Go ģ¿éµIJâÊÔ/vet¡¢¹ؼüģ¿é race¡¢ǰ¶˲âÊÔ/Éú²ú¹¹½¨/Éó¼ơ¢ Go ¿ɴ勇´ɨÃèÓë macOS/Linux ¿ÉÐÐģ¿齻²æ±àÒë¾ùͨ¹ý¡£ Windows ¸ôÀëÆô¶¯ͨ¹ý£»δÍê³ɵĵã»÷ðÑ̺ÍԭÉúƽ̨Ñé֤¼ûÉó²鱨¸档
This commit is contained in:
FuDie0915
@@ -3,7 +3,7 @@
|
||||
## 目录布局
|
||||
|
||||
```
|
||||
Local-Curosr/
|
||||
Local-Cursor/
|
||||
├── cmd/ # 独立可执行工具入口
|
||||
│ └── ext-tool/ # proto 提取工具，从 Cursor 扩展源码生成 .proto 定义
|
||||
├── internal/ # 内部业务包（不对外暴露）
|
||||
@@ -39,6 +39,6 @@ Local-Curosr/
|
||||
## 数据流
|
||||
|
||||
```
|
||||
Cursor IDE → MITM(38081) → backend(39091) → 路由 → forwarder → agent/model → 上游模型
|
||||
CLI agent → tls-bypass → HTTPS(39092) → 同一 backend mux → 同上
|
||||
Cursor IDE → MITM(28080) → backend(28090) → 路由 → forwarder → agent/model → 上游模型
|
||||
CLI agent → TLS redirect → HTTPS(39092) → 同一 backend mux → 同上
|
||||
```
|
||||
@@ -1,41 +1,30 @@
|
||||
# Windows 构建环境
|
||||
# 构建与发布环境
|
||||
|
||||
以下路径于 2026-11-03 在当前机器核实。项目发布不依赖额外安装 NSIS；使用下方已缓存的可执行文件。
|
||||
|
||||
| 工具 | 实际路径 |
|
||||
|---|---|
|
||||
| Git | `D:\WorkProgarm\DevTools\Git\cmd\git.exe` |
|
||||
| Go | `D:\WorkProgarm\DevTools\go\bin\go.exe` |
|
||||
| Wails v3 | `D:\WorkProgarm\DevCache\go-path\bin\wails3.exe` |
|
||||
| Task | `C:\Users\FuDie915\AppData\Local\Microsoft\WinGet\Links\task.exe` |
|
||||
| Node.js | `C:\Users\FuDie915\AppData\Local\fnm_multishells\14812_1793715538718\node.exe` |
|
||||
| Yarn | `C:\Users\FuDie915\AppData\Local\fnm_multishells\14812_1793715538718\yarn.ps1` |
|
||||
| protoc | `C:\Users\FuDie915\AppData\Local\Microsoft\WinGet\Packages\Google.Protobuf_Microsoft.Winget.Source_8wekyb3d8bbwe\bin\protoc.exe` |
|
||||
| protoc-gen-go | `D:\WorkProgarm\DevCache\go-path\bin\protoc-gen-go.exe` |
|
||||
| protoc-gen-connect-go | `D:\WorkProgarm\DevCache\go-path\bin\protoc-gen-connect-go.exe` |
|
||||
| NSIS | `C:\Users\FuDie915\AppData\Local\electron-builder\Cache\nsis\nsis-3.0.4.1\Bin\makensis.exe` |
|
||||
| PowerShell / Compress-Archive | `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` |
|
||||
|
||||
Node.js 和 Yarn 路径由 fnm 按会话生成，重新打开终端后应以 `Get-Command node, yarn` 的实际输出为准。NSIS 已验证可执行，版本为 v3.04。
|
||||
|
||||
## 构建前设置
|
||||
|
||||
NSIS 当前未加入全局 `PATH`，在当前 PowerShell 会话中加入后即可使用标准发布任务：
|
||||
工具路径以当前会话为准，不依赖旧的 fnm 会话目录：
|
||||
|
||||
```powershell
|
||||
$env:Path = "C:\Users\FuDie915\AppData\Local\electron-builder\Cache\nsis\nsis-3.0.4.1\Bin;$env:Path"
|
||||
task release:prepare
|
||||
Get-Command git, go, node, yarn, wails3, task, 7z
|
||||
go version
|
||||
go env GOROOT
|
||||
```
|
||||
|
||||
## 标准 Windows 输出
|
||||
- Go 使用项目固定的 1.26.10 工具链；Node.js 需满足 Vite 的引擎要求（本次验证为 Node 24）。
|
||||
- 前端依赖通过 yarn.lock 和 security resolutions 固定，使用 `yarn --cwd frontend install --frozen-lockfile`。
|
||||
- 修改 build/config.yml 版本后执行 `go run ./scripts/release sync-metadata`，仅同步版本字段，保留定制构建任务。
|
||||
- `task release:prepare` 会构建平台资源；本次 Gitea 发布只上传压缩后的 Windows x64 便携 ZIP，避免同时保存 EXE、安装包和重复 ZIP。
|
||||
- `bin/`、生成的 bindings/proto、node_modules 和运行数据不提交到 Git。
|
||||
|
||||
以 v1.1.8 为例，产物写入 `bin/release/v1.1.8/`：
|
||||
验证命令：
|
||||
|
||||
```text
|
||||
Local-Cursor.exe
|
||||
Local-Cursor-amd64-installer.exe
|
||||
local-cursor-v1.1.8-installer.zip
|
||||
local-cursor-v1.1.8-windows-x64-portable.zip
|
||||
```powershell
|
||||
go test ./...
|
||||
go vet ./...
|
||||
go test -race ./internal/backend/... ./internal/client/... ./internal/certs/... ./internal/skills/...
|
||||
govulncheck ./...
|
||||
yarn --cwd frontend test
|
||||
yarn --cwd frontend audit --summary
|
||||
yarn --cwd frontend build
|
||||
```
|
||||
|
||||
其中 portable ZIP 内的程序名为 `windows-64.exe`，installer ZIP 内的安装包名为 `Local-Cursor-amd64-installer.exe`。
|
||||
Tab 服务是独立 Go 模块，需在 cursor-tab-server 下单独运行测试和扫描。
|
||||
实际数据修改、证书迁移测试使用临时用户目录和模拟信任存储。Windows UI 诊断可使用 `Local-Cursor.exe --no-auto-start`；该选项不自动启用代理、安装根证书或注册快捷方式。
|
||||
|
||||
65
docs/review-v1.1.9.md
Normal file
65
docs/review-v1.1.9.md
Normal file
@@ -0,0 +1,65 @@
|
||||
# v1.1.9 项目审查
|
||||
|
||||
审查日期：2026-11-10。范围包括应用与 Wails 桥接、配置与前端、Cursor/CLI 集成、代理与 HTTP 服务、模型适配和流式协议、会话与用量存储、Skills、独立 Tab 服务、构建及发布脚本。
|
||||
|
||||
## 修复清单
|
||||
|
||||
| 类别 | 问题与处理 | 回归依据 |
|
||||
|---|---|---|
|
||||
| 证书 | 从运行代码和当前源码树移除共享 CA 私钥；每个本机用户数据目录持久保存独立私有 CA，私钥权限受保护，损坏时拒绝静默轮换 | 独立性、复用、损坏文件和密钥匹配测试 |
|
||||
| 证书迁移 | 安装并验证新 CA 后按旧证书指纹清理信任；管理员与当前用户存储分别处理，取消或失败阻止启动 | 取消、重试、幂等和迁移脚本语法测试 |
|
||||
| CLI | 恢复 TLS 验证，仅重定向 Cursor API，保留 SNI；兼容中文、空格、引号路径和原有附加 CA；移除继承的旧 bypass 配置 | Node HTTP/2、错误 CA、无效主机名及 Windows 启动器实测 |
|
||||
| 凭据 | 前端日志不输出配置正文；旧敏感缓存迁移为偏好白名单；后端统一脱敏并保护日志文件 | 日志和缓存哨兵测试 |
|
||||
| 配置 | 补齐 CLI HTTPS 端口的界面往返；通信 revision 做原子比较，冲突保留草稿；后端模型使用记录不被界面回写覆盖 | 后端 CAS、并发竞争及真实前端状态模块测试 |
|
||||
| Cursor 数据 | 损坏设置原样保留；注入前备份受影响键，停止时只恢复仍由本应用占用的键 | 损坏文件、重复注入、用户并发修改测试 |
|
||||
| 最近项目 | 保留顶层元数据、文件/工作区条目及未知字段；数据库更新失败时不删除聊天目录 | 数据库与 workspaceStorage 临时夹具测试 |
|
||||
| 会话存储 | 拒绝点目录、分隔符、控制字符、NTFS 流及 Windows 保留名称 | 跨平台路径案例测试 |
|
||||
| 生命周期 | HTTP/HTTPS 启动失败回滚；关闭超时后关闭连接、释放端口；串行化启停，保护初始化期间状态读取 | 端口重绑定、连接取消和 race 测试 |
|
||||
| 协议 | 修复两处 Protobuf 锁复制；完整传递模型自定义头、Anthropic 扩展参数；处理特殊 Host 头 | go vet、模型本地 HTTP/SSE 集成测试 |
|
||||
| 用量 | 测试夹具改用独立 filler ID，保留跨 500 个事件的去重验证 | 原失败测试恢复通过 |
|
||||
| Tab 服务 | 客户端令牌与上游令牌分离；401、64 MiB 请求上限、取消和流式错误收口；配置变更与 URL 前缀正确生效 | 独立模块与应用转发集成测试 |
|
||||
| 浏览器访问 | 本地 RPC/CORS 拒绝无关网站 Origin，允许原生请求和 Cursor/Wails 来源 | Origin 欺骗及本地请求测试 |
|
||||
| 重定向 | 认证请求不向其他 origin 转发头和正文，保留同源重定向及取消语义 | 本地双服务器测试 |
|
||||
| Skills | 拒绝卸载未知技能及穿过符号链接修改；保留自建文件、修改过的命令；覆盖前在本机私有数据目录备份 | 自建技能、命令保留及现有安装/刷新测试 |
|
||||
| Windows 启动 | 快捷方式路径转义；增加 `--version` 和 `--no-auto-start`，支持隔离的只打开界面诊断 | 版本命令、隔离启动检查 |
|
||||
| 构建 | 版本资源同步只修改版本字段，避免发布时重新生成并覆盖定制 Wails 模板 | 元信息同步和自定义构建文件保留测试 |
|
||||
|
||||
## 依赖与兼容
|
||||
|
||||
- Go 工具链固定为 1.26.10，语言基线 1.26.0；升级 x/net、x/text、go-git、go-billy 及必要传递依赖。
|
||||
- Vue、Vite、PostCSS 及存在安全公告的传递依赖升级到修复版本，Wails JS runtime 固定为原已使用的 3.0.0-alpha.79。
|
||||
- `uuid` 对 vite-plugin-top-level-await 的传递依赖覆盖为兼容其 v4/v5 调用 API 的 11.1.1；生产构建验证该兼容性。
|
||||
- 修复版 esbuild 无法生成原 Safari 13 目标的解构语法降级，前端构建基线调整为 Safari 14.1。Windows WebView2 不受影响；本版不承诺旧版 Safari 内核。
|
||||
|
||||
## 验证记录
|
||||
|
||||
| 检查 | 结果 |
|
||||
|---|---|
|
||||
| 根 Go 模块 | `go test ./...` 与 `go vet ./...` 均通过 |
|
||||
| 独立 Tab 模块 | 测试、`go vet` 与 `govulncheck` 均通过 |
|
||||
| 并发检查 | 配置、backend、client、certs、skills 的 `go test -race` 通过，含启动状态轮询与关闭超时 |
|
||||
| Go 漏洞扫描 | 0 条可达漏洞、0 条导入包漏洞；根模块有 4 条所需模块中未被本项目调用的公告，不能视为所有传递模块均无公告 |
|
||||
| 前端 | 4 项 Node 测试通过；生产构建通过；Yarn audit 成功完成，286 项依赖、0 条漏洞 |
|
||||
| macOS/Linux | `CGO_ENABLED=0`、amd64 下 certs、cursor、skills、netproxy、backend 模块编译通过；补齐仅 Windows 使用的安装路径扫描函数在其他平台的空实现 |
|
||||
| Windows 启动 | 最终二进制以 `--no-auto-start` 在临时用户目录启动，窗口正常响应，WebView2 初始化成功，复用该隔离目录的本机 CA |
|
||||
| 二进制 | Go 1.26.10、windows/amd64、production、CGO 关闭；`--version`、PE FileVersion 与 ProductVersion 均为 1.1.9 |
|
||||
| 便携包 | ZIP 完整性检查通过，仅含 `windows-64.exe`；压缩包 19,780,599 字节，程序 53,621,248 字节 |
|
||||
|
||||
便携 ZIP：`local-cursor-v1.1.9-windows-x64-portable.zip`。SHA-256：
|
||||
|
||||
```text
|
||||
8b7898f139983a7caad0bef45ae52d9c0a4789ebb41771682be92d455fb4e150
|
||||
```
|
||||
|
||||
重点回归包含私有 CA/Node TLS/HTTP2、Windows PowerShell 路径和参数、多窗口保存竞争、异常关闭后端口重绑定、模型认证/SSE/取消、Tab 鉴权/超限/转发、未知数据字段保留、真实前端状态模块与凭据缓存。生产构建存在单个 JS chunk 超过 500 kB 的体积提示，不影响构建成功。
|
||||
|
||||
平台限制：本机为 Windows。Windows 窗口点击冒烟因 Computer Use 本地管道不可用未完成；已完成进程响应、日志和 WebView2 初始化检查，不能据此声称已人工确认所有界面交互。macOS/Linux 未运行原生 GUI、完整桌面打包或真实证书存储操作。自动化证书迁移测试使用模拟信任存储和脚本解析，不向本机系统信任库安装测试 CA；涉及 Cursor 数据的破坏性测试使用临时目录与测试数据库。
|
||||
|
||||
## 升级说明
|
||||
|
||||
1. 首次启动需要信任本机新证书并移除旧共享根证书，Windows 可能要求一次管理员授权。失败时可重试，模型配置和历史数据继续保留。
|
||||
2. 本机 CA 私有文件为用户数据目录下的 `data/local-ca.pem`。不要将它放入仓库、发布包或共享给其他机器。旧私钥已经公开，删除旧发布页不能撤回公开过的内容；升级以移除旧根信任为准。
|
||||
3. 远程 Tab 服务新增必填 `clientToken`，必须与上游 `token` 不同；应用配置的 `tabServerToken` 填对应客户端令牌。本机未启用 Tab 服务的用户不需要修改。
|
||||
4. 被覆盖的 Skills 文件备份保存在本机数据目录的 `data/skill-backups/`；含自建文件的技能不会被无提示整体删除。
|
||||
5. 多窗口配置冲突时保留编辑草稿，核对并刷新版本后重新保存。若目标模型已被其他窗口修改或删除，则不会把草稿写入其他模型。
|
||||
6. 发布仅提供 Windows x64 便携 ZIP。旧发布页及附件会移除，旧标签和 Git 提交继续保留。
|
||||
Reference in New Issue
Block a user