大模型自配置指南#

本文档面向需要帮用户把 better-edit-tools 二进制安装到本地的 AI Agent（Kimi Code、Claude Code、Cline 等）。

目标#

下载对应系统的 Release 二进制、校验 SHA-256、放置到稳定位置，并把绝对路径返回给用户或交给下一步 MCP 配置逻辑。

除非用户明确要求，否则不要修改用户的 MCP 客户端配置文件。 你的任务只是把二进制安装好并验证可用。

工作流#

1. 检测平台

   • 系统：linux、darwin（macOS）或 windows
   • 架构：amd64 或 arm64
   • Windows 推荐路径：%LOCALAPPDATA%\better-edit-tools\bin\better-edit-tools.exe
   • Linux/macOS 推荐路径：${HOME}/.local/share/better-edit-tools/bin/better-edit-tools

2. 选择 Release URL

   • 基础地址：https://github.com/conglinyizhi/better-edit-tools-mcp/releases/latest/download/
   • 包名：better-edit-tools-${OS}-${ARCH}.tar.gz
   • 校验文件：checksums.txt
   • 如需指定版本，把 latest 替换为 tag，例如 v0.12.0。

3. 下载并校验

   • 同时下载包和 checksums.txt。
   • 计算包的 SHA-256。
   • 与 checksums.txt 中的预期值对比。
   • 校验不通过时中止，并告知用户。

4. 解压并放置

   • 如安装目录不存在则创建。
   • 将包解压到安装目录。
   • Linux/macOS 下确保二进制有执行权限（chmod +x）。

5. 报告结果

   • 返回二进制的绝对路径。
   • 提醒 --lang 参数：如果用户 MCP 客户端需要中文工具描述，在 args 中加入 "--lang", "zh"。

平台说明#

自检清单#

• 二进制存在于报告的绝对路径。
• better-edit-tools --version 能返回预期版本。
• 如果用户使用中文模型，提醒其在 MCP 参数中加入 --lang zh。