我重构了“面向人工智能的 Git 追溯”工具的安装流程——六步合为一步

2026西湖龙井茶官网DTC发售：茶农直供，政府溯源防伪到农户家 

一周前，我发布了 Selvedge，这是一个模型上下文协议（MCP）服务器，用于捕获人工智能代理更改代码的原因。第一篇发在 dev.to 上的文章阐述了这个问题；这一篇则讲述了此后发生的情况。

如果你错过了第一篇文章，这里提供简要背景：人工智能代理在当下带着完整的意图编写代码，但会话结束后，这些意图便随之消失。Selvedge 能够在代理仍处于上下文环境中时，实时捕获其意图。这样，六个月后，你可以运行 selvedge blame users.email，并获得一句实际的解释，说明该列存在的原因。

最初的发布表现尚可。有几百次安装，少量星标，在 dev.to 和 Hacker News 上各有一篇帖子，转化率超出我的预期。虽然没有什么轰动效应，但用户流失的模式颇具启发性，而这正是我本周末发布的 v0.3.4 版本主要解决的问题。

安装过程是瓶颈，而我却在自欺欺人

我知道安装体验并不理想。第一版自述文件引导你完成六个步骤：

1. pip install selvedge
2. cd your-project && selvedge init
3. 打开 ~/.claude/config.json 并添加一个 mcpServers.selvedge 配置块。希望你没有写错 JSON 格式。
4. 打开你项目的 CLAUDE.md（或创建一个）。粘贴系统提示词，指示代理在触及任何列、函数、环境变量或依赖项时调用 log_change。
5. 运行 selvedge install-hook，以便提交后钩子能将事件与提交记录关联起来。
6. 重启 Claude Code，因为 MCP 配置不支持热重载。

需要在自述文件和编辑器之间来回切换四次。其中一步——第三步——是“手动编辑 JSON 文件”，这大约在八秒钟内就会扼杀用户的好奇心。而第五步，即提交后钩子，在通过 Tower 或 GitKraken 等图形界面客户端提交时，会在 macOS 上静默失败，因为 git 启动时的路径环境变量被精简，其中不包含 selvedge。我正是在 v0.3.2 中专门为此错误编写了 selvedge doctor 命令。该错误之所以存在，是因为安装过程并未明确提示钩子已存在且可能失败。

安装指标的实际变化情况大致符合预期。人们执行了 pip install。有些人运行了 selvedge init。但只有极少部分人最终到达让 tool_calls 开始发送至服务器的阶段，而这才是我真正关心的指标。编辑 JSON 文件和编辑 CLAUDE.md 文件就是用户流失的断崖点。

总之。v0.3.4 将所有这些步骤简化为一个命令：

pip install selvedge
cd your-project
selvedge setup

该向导会读取 ~/.claude/config.json、~/.cursor/mcp.json，并查找 .github/copilot-instructions.md——它会配置你实际拥有的任何一个文件。它会写入 MCP 条目。它会将系统提示词块放入你的 CLAUDE.md 或 .cursorrules 中，并用哨兵括号标记，这样下次我更新推荐块时，你可以重新运行 selvedge prompt --install，它会在原地修补而不干扰文件的其余部分。它会运行 selvedge init。它会安装钩子。在任何更改写入磁盘之前，它会在其接触的每个文件旁边写入一个 .bak 备份文件，因此如果它做出了错误的操作，你可以进行还原。

在已配置的项目上重新运行该命令不会产生任何操作。对于在持续集成（CI）或 devcontainer.json 的 postCreateCommand 中运行它的人：selvedge setup --non-interactive --ye