# 源码交付：暂撤 Mac 客户端

原记录日期：2026-09-09。源码版本：v1.2.0。下方撤回阶段的验证记录保留原范围。

2026-09-10 更新：v1.2.0 源码 Release 已发布；官网 Mac 下载入口已撤。维护者随后单独授权撤下 v1.1.0 DMG，GitHub 安装包已移除，旧版本记录、源码归档及历史说明/校验文本保留。此次 README 整理不改变产品版本；维护者已授权本地提交，尚未授权推送。

## 基线与范围

本次开始时核对公开 main、latest Release v1.1.0 与本地 HEAD：均对应
`f15ab898dc5d9a900d5f78ac864e7730f2f114bc`。从这份已公开源码继续，放弃本地 M41 动态板块改造。
板块中心仍为原发布版本，不引入动态板块、新建行业研究等未发布功能。

暂撤原因：让使用者的开发 Agent 直接修改项目源码，避免围绕封装后的 Mac App 改造。
撤客户端不会自动赋予产品内置研究 Agent 修改源码的权限；开发改造仍由使用者自己的开发工具完成。

移除范围：Mac 原生窗口、图标打包资产、Python 打包锁、构建和签名/公证脚本、
Mac 专属后端启动入口与静态页面网关，以及只针对这些产物的测试。
通用的受控研究执行模式和 Python 不生成字节码的回归测试保留。

保留范围：`desktop/` React + Vite 浏览器 UI、`orchestrator/` 后端、Codex SDK/引擎 0.153.4、
Claude Code / WorkBuddy / API 接入、首页对话、Agent 默认关闭、原侧栏和所有 v1.1.0 研究功能。
`desktop` 只是现有前端目录名，不是残留的 Mac 原生客户端。

## 运行与开发

先安装 Git、Node.js ≥ 22.18（推荐 24 LTS）与 Python ≥ 3.11（推荐 3.12）。
macOS / Linux 在仓库根运行 `scripts/setup`，然后运行 `scripts/start`；
Windows 运行 `scripts\setup-windows.cmd` 和 `scripts\start.cmd`。
默认浏览器地址 `http://127.0.0.1:5930`，后端回环端口 8765。
这些是默认地址，不代表当前已有服务正在运行；端口占用时先确认所属项目，不终止其他服务。

把克隆的项目文件夹交给自己的开发 Agent，修改前阅读项目说明与相关模块，修改后运行 README 中的测试。
初始化会安装依赖、建立私有数据区；不需要单独安装全局 Codex，但仍需连接自己的 AI。

## 旧客户端用户与历史附件

本次不卸载任何已安装 App，不删除 `~/.vibe-research-desktop`，不动用户研报、台账和登录态。
源码默认使用项目 `.local/`，不会自动导入旧客户端的数据与浏览器设置。
需要迁移时先完整备份，单独确认迁移范围；不要复制账号 token，不要将数据提交到 Git。

GitHub v1.1.0 的 DMG 已于 2026-09-10 撤下，Release 正文已标明不再提供安装包，并引导使用 v1.2.0 源码版。历史说明与校验文本不代表安装包仍可下载。官网入口也已改为源码；本地删除客户端代码、远程撤包与官网更新是分别授权完成的操作。
历史 Mac 实现可在 [v1.1.0 标签](https://github.com/simonlin1212/Vibe-Research/tree/v1.1.0/packaging/macos) 查阅；旧签名、公证和验收日志保留作历史证据。

## 客户端撤回阶段验证（Issue / PR 修复前）

- 后端 Node 26 串行回归：850 项，849 通过，1 项 Windows ACL 专项在 macOS 跳过；后端类型检查通过。
- 前端 82/82，类型检查和生产构建通过；保留原有超过 500 kB 的构建体积警告。重新构建产物不再包含 M41。
- Python 计算库、回测和数据脚本：754/754。仓库内 venv 未装 pytest，改用已有的父项目开发 venv 实跑；没有更改用户运行环境。
- 浏览器功能检查 12/12：首页、订阅选项、Agent OFF、输入框、关闭引导、真实 API 代理健康、页脚、无横向溢出、原版两板块、详情跳转、设置与未接入时的页面聊天引导。
- 测试使用空白数据区、API 8765 与 Vite 5944。默认 5930 属于另一项目，未终止它；因此本轮没有完整执行占用该默认端口的 `scripts/start`，分别启动并验证了源码 API 与 Vite。启动脚本保持发布版原样且其自动化回归已通过。测试服务验证后关闭。
- 新增源码交付检查先失败，再在撤回后通过；保留两项通用运行环境测试，移除 Mac 专属检查。5 份当前文档的本地链接均可解析，`git diff --check` 通过。
- Codex CLI / GPT-5.6 Sol 独立静态审查：无可操作 P1/P2，覆盖删除依赖、入口、TypeScript、文档和数据边界。不以此声称全产品无缺陷。
- 对照 v1.1.0，前端源码、原有 API/研究服务、订阅注册、源码启动脚本、Vite 配置和引擎版本均无差异。

未重跑真实模型、联网研究、干净机器安装或跨平台 CI；没有消耗 WorkBuddy 对话额度。
以上只验证客户端撤回，不把历史安装版或模型实跑当作当前源码版的全平台发布验收。
后续 v1.2.0 版本号及 Issue / PR 增量修复的验证见 [处理记录](issue-pr-triage-v1.2.0.md)。