Melty：每条聊天都是一次 git 提交的开源 AI 代码编辑器｜部署与使用全指南
适用读者：想尝鲜"AI 改一行代码就自动 commit、可随时回滚/分支/squash 对话"这种编辑器范式的开发者；愿意从源码自行构建一个 VS Code 分支版本的极客。本文所有版本号、脚本名、设置项均来自 meltylabs/melty 官方仓库 README 与 package.json / CONTRIBUTING.md。重要前置说明：该仓库自 2024 年 11 月后无公开代码更新，也未在 Releases 提供可下载安装包，本文按"从源码构建"流程记录，请勿当作活跃维护项目期待。
一、Melty 是什么
Melty 是一个开源 AI 代码编辑器，核心卖点是 "每一条聊天消息都是一次 git 提交"：你在编辑器里和 AI 对话，AI 改完代码就自动生成一次 commit，于是你可以像在 git 历史里一样 revert、branch、reset、squash 任何一段对话——不用再为同一件事同时开十个聊天窗口、复制粘贴来回倒腾。
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/meltylabs/melty |
| 官网 | https://melty.sh |
| 团队联系 | humans@melty.sh |
| 许可证 | MIT（见 package.json license 字段） |
| 代码底座 | VS Code 分支（package.json
name=melty-dev、version=1.94.0、distro
字段、Electron 30.3.1） |
| 桌面 appId | sh.melty.app（见 package.json
build.appId） |
| 当前模型 | Claude（通过 melty.anthropicApiKey 设置项注入） |
| 项目状态 | README 自 2024 年 8 月起处于 waitlist 阶段；仓库最后一次公开提交为 2024-11-14（Update README.md），之后无公开代码更新；无公开 Releases 安装包 |
适用场景：对"对话即版本"这种交互范式感兴趣、愿意从源码编译一个 VS Code 分支体验；想在自己机器上研究 AI 编辑器如何把 chat 历史映射成 git 历史。
关于团队与出身（README 原文）：Melty 由 Charlie Holtz 与 Jackson DeCampos 两人在 Brown 大学打极限飞球时认识后创立。Charlie 来自 Replicate，在那里发起了 Hacker in Residence 团队；Jackson 来自 Netflix，做过选封面图的机器学习基础设施。两人在 README 里吐槽过当时主流 AI 编程工具的痛点：经常要复制粘贴代码、为同一件事开十个聊天窗口、把有 bug 的代码提交进去事后返工——Melty 就是冲着这三个痛点做的。
能力边界（来自官方 README 的自我定位）：
- README 原文是 "Melty 0.2 is almost ready. We'll start sending it out to people on the waitlist within the next few days and weeks"，这是 2024 年夏天的语气；
- 公开仓库里
package.json的build.publish指向一个私有 GitHub 仓库meltylabs/code，意味着官方发布产物并不在本仓库 Releases 里； - CONTRIBUTING.md 明确写："We're working hard to get the Melty code into a stable state where it's easy to accept contributions. If you're interested, please reach out first"——即外部 PR 并未开放。
二、功能特性
按官方 README 自报的能力：
- 大跨度多文件重构：让 AI 一次改多个文件，而不是只在当前函数里补全；
- 从零生成 Web 应用：用自然语言起一个新项目；
- 在大型代码库里导航：AI 帮你在陌生仓库里找路；
- 自己写 commit：每条聊天对应一次 git 提交，可 revert / branch / reset / squash 任意一段对话；
- 像结对程序员一样跟着你：观察你的每一次编辑，不需要你反复解释上下文；
- 与编译器、终端、调试器以及 Linear、GitHub 等工具集成（README 设计目标，实际完成度以源码为准）。
官方给出的设计原则四条：帮你更好而不是更差地理解代码；像结对程序员一样盯着你的每次改动；学习并适应你的代码库；与编译器、终端、调试器以及 Linear / GitHub 打通。
三、官方界面预览
公开仓库里唯一与产品形态直接相关的配图就是开头那张提交卡片：一条
GitHub 风格的 commit 记录，作者是 melty，提交信息形如
refactor: Extract Header component from ConversationView，时间戳显示"12
minutes ago"——直观说明"每次对话 = 一次 commit"这一核心隐喻。README
中其余素材是两位创始人照片和几段未内嵌封面的演示视频链接，不属于界面截图，本文不收录。
四、官方链接汇总
| 资源 | 地址 |
|---|---|
| 仓库 | https://github.com/meltylabs/melty |
| 官网（waitlist 落地页） | https://melty.sh |
| 早期试用申请（Google Form） | README 内 "Get Early Access" 链接 |
| 反馈邮箱 | humans@melty.sh |
| CONTRIBUTING | https://github.com/meltylabs/melty/blob/main/CONTRIBUTING.md |
五、前置要求
由于官方没有提供预编译安装包，所谓"部署"实际上是从源码构建 VS Code 分支：
- 操作系统：macOS / Linux / Windows 桌面端（Electron 应用）；不是服务器端服务，没有端口、没有 docker-compose。
- Node.js 与 Yarn：CONTRIBUTING.md 直接用
yarn run ...，需自行准备兼容版本（package.json 里@types/node为 20.x、typescript为 5.6.0-dev.20240812、Electron 为 30.3.1，建议以 Node 20 LTS 起步，具体以仓库.nvmrc或最新 CONTRIBUTING 为准）。 - Python / 构建工具链：VS Code 上游构建需要
Python（用于 node-gyp 等原生模块，如
@vscode/sqlite3、node-pty、kerberos），按 VS Code 官方 "How to Contribute" 文档准备对应平台工具链（Windows 需要 Build Tools，macOS 需要 Xcode CLT，Linux 需要 build-essential）。 - 磁盘与内存：VS Code 全量编译官方建议至少约 10GB
磁盘、16GB 内存（
compile脚本里--max-old-space-size=4095，即 Node 堆上限 4GB）。 - Claude API Key：Melty 默认接 Anthropic
Claude，需要自己申请并在设置里填
melty.anthropicApiKey。 - 显卡：不强制，模型跑在 Anthropic 云端。
- Git 仓库：Melty
的核心交互是"对话即提交"，请在一个已经
git init的仓库里打开它，否则所有自动 commit 无从落盘。
六、安装部署（从源码构建）
官方 CONTRIBUTING.md 给出的最小流程如下，命令照抄：
# 1. 克隆仓库
git clone https://github.com/meltylabs/melty.git
cd melty
# 2. 安装依赖（脚本位于 scripts/melty_install_deps.sh）
yarn run melty:install
# 3. 监听并自动构建 extensions/spectacular 扩展源码
yarn run melty:extension-dev然后用 VS Code 或 Melty 自身打开本仓库，按 F5
选择默认的 "Launch Melty" 调试配置启动开发版。开发模式下，你改动
./extensions/spectacular/ 目录会被自动 watch
并重编译，改完按 Cmd+R（macOS）或
Ctrl+R（Linux/Windows）重载窗口即可看到效果。
package.json 里还登记了其他常用脚本，按需选用：
| 脚本 | 作用 |
|---|---|
yarn run melty:code |
跑 ./scripts/code.sh，以开发模式启动编辑器 |
yarn run compile |
一次性全量编译（gulp compile，Node 堆上限 4095MB） |
yarn run watch |
同时 watch 客户端与扩展 |
yarn run dist |
electron-builder 打包（产物发布到私有仓库 meltylabs/code，本地仅产出安装包） |
yarn run test-node |
Mocha 跑 node 侧单测 |
yarn run test-browser |
Playwright 跑浏览器侧测试（会先
npx playwright install） |
提醒：这是一个 VS Code 上游分支，完整编译时间与磁盘占用都不小；如果只是想看产品形态而非参与开发，性价比不高。
七、配置项说明
构建起来后，唯一需要在编辑器里配置的官方项是 Claude API Key：
- 打开偏好设置：
Cmd+,（macOS）或Ctrl+,（Linux/Windows）； - 搜索
melty.anthropicApiKey； - 填入你自己的 Anthropic API Key。
官方 README 与 CONTRIBUTING.md
没有公开其他环境变量、端口或配置文件路径——它是一个桌面 Electron
应用，不监听 HTTP 端口，也不需要
docker-compose。其余行为沿用 VS Code
上游设置体系（settings.json、键位、扩展目录等）。
关于扩展：Melty 自己的 AI 能力放在
extensions/spectacular/ 这个 VS Code 扩展里，开发模式下
yarn run melty:extension-dev 会 watch
这个目录并自动重编译；改完按 Cmd+R / Ctrl+R
重载窗口即可。这意味着如果你想魔改 Melty 的 AI
行为，主要改的就是这个扩展，而不是编辑器本体。
八、使用流程
- 按上一节从源码编译并启动开发版；
- 在设置里填好
melty.anthropicApiKey（Cmd+,/Ctrl+,搜索这个键名）； - 用 Melty 打开你自己的一个 git 仓库（务必是 git 仓库，否则"对话即提交"无从谈起）；
- 在聊天面板里下指令，例如"把 ConversationView 里的 Header 抽成独立组件"；
- AI 改完后，去
git log里看，会看到一条由melty作者提交的 commit，提交信息形如refactor: ...； - 对结果不满意：直接
git revert <hash>、或者git reset到对话之前、或者把那段对话git branch成一个实验分支、再git squash合并——这就是 Melty 想让你用的"版本化对话"工作流； - 想看 AI 为什么这么改，
git show <hash>即可看到完整 diff；想让 AI 继续上次的思路，回到那条 commit 对应的聊天继续聊。
九、常用运维 / 更新命令
| 操作 | 命令 |
|---|---|
| 拉取上游最新源码 | git pull origin main |
| 重装依赖 | yarn run melty:install |
| 重新编译 | yarn run compile 或 yarn run watch |
| 清理产物 | git clean -xdf node_modules（参考根 package.json
clean 脚本） |
| 查看版本 | 编辑器菜单 About → Melty；或读根 package.json 的
version 字段（当前为 1.94.0，跟随 VS Code
1.94） |
由于官方没有自更新机制（electron-updater
依赖私有发布仓库），本地构建版要拿新代码只能重新 git pull +
重编译。
关于版本号怎么读：根 package.json 里
version 是 1.94.0，这是跟着 VS Code
上游版本号走的（VS Code 1.94 发布于 2024 年 10
月前后）；distro 字段是 VS Code
上游的发行版哈希，用来对齐内置扩展与本地化资源。看到 1.94.0
就知道这份 Melty 是基于 2024 年秋的 VS Code 切出来的，不要期待它有 2025
年之后 VS Code 才有的新功能。
十、常见故障排查
| 现象 | 处理 |
|---|---|
yarn run melty:install 卡在原生模块编译 |
这是 VS Code 上游常见问题；按 VS Code 官方 "How to Contribute" 文档装好 Python、C++ 工具链、node-gyp 前置后重试 |
| 启动后聊天不工作 | 先确认 melty.anthropicApiKey 已填；再看 Help → Toggle
Developer Tools 里的控制台报错 |
| 想报 bug | 按 CONTRIBUTING.md：菜单 About → Melty 拿版本号、写清操作系统、贴 DevTools 控制台错误，发到 humans@melty.sh 或开 Issue |
| 找不到下载安装包 | 公开仓库确实没有 Releases；package.json 的
build.publish 指向私有仓库
meltylabs/code，外部拿不到 |
| 想看产品视频 | README 里有几段 github.com/user-attachments
演示视频（Refactor / Create web apps / Navigate large codebases / Write
its own commits），在仓库主页直接看 |
yarn run melty:extension-dev 起不来 |
这个脚本是
cd extensions/spectacular && npm run watch:all，先单独进
extensions/spectacular 跑一次 npm install
再试 |
| 编译到一半 OOM | compile 脚本写死
--max-old-space-size=4095，机器内存小于 8GB 时建议关掉其他
IDE 与浏览器再编 |
十一、风险与责任使用声明
- 项目状态必须如实看待：meltylabs/melty 公开仓库最后一次代码提交为 2024-11-14（"Update README.md"），README 本身仍是 2024 年夏天的 waitlist 公告语气；官方未承诺公开时间表，也未提供可直接安装的二进制。本文不把它包装成活跃维护项目。
- 从源码构建一个 VS Code 分支本身有风险：你会跑上游
VS Code 的全套构建脚本与 native
模块编译；请在隔离的开发机或容器里操作，不要直接
sudo一把梭。 - API Key 风险：
melty.anthropicApiKey是你的 Anthropic 凭证，Melty 作为桌面应用会把它保存在本机 VS Code 用户设置目录；本文不收集、不代存。 - git 历史会被 AI 写入：Melty 的核心行为就是替你
commit，建议先在你自己的实验分支上玩，不要直接在
main或受保护分支里让 AI 自由提交；配合git reflog与分支保护使用。 - 许可证为 MIT，可自由自用与二次开发；请同时遵守 VS Code 上游的 MIT 许可证条款与 Anthropic API 服务条款。
最后再说一次项目状态：如果你只是想找一个今天就能装、今天就能用、还在 actively 发版的 AI 代码编辑器，Melty 不是那个选择——它公开仓库自 2024 年 11 月后没有新代码，官网仍是 waitlist 状态。这篇文章的价值在于把"对话即 git commit"这个交互范式的开源参考实现完整记录下来，供研究者、想自己做类似编辑器的工程师参考源码，而不是推荐你把它当主力 IDE。