install-hunkwise

用途：指导从源码构建并安装 hunkwise VSCode 扩展。该扩展使用私有提案 API editorInsets，因此无法从扩展市场安装，需要特殊设置。

前置条件：Node.js（>=18）与 npm、git、可解析的 code CLI。

主要步骤：

1. 克隆仓库到唯一命名的临时目录，避免冲突（macOS/Linux 用 mktemp，Windows 用时间戳命名）。
2. 安装依赖并编译：npm install、npm run compile；若编译失败应停止并向用户展示 TypeScript 错误。
3. 用 vsce 打包：npx @vscode/vsce package --allow-missing-repository，生成 hunkwise-<version>.vsix。不要使用 --no-dependencies，运行时依赖（ignore、diff）必须打包。 3.5. Linux 稳定版兼容性检查：部分 Linux 发行版（如 CachyOS）的 VS Code 稳定版可能不支持 editorInsets，需提示用户可能需改用 Insiders。
4. 检测已安装的 VSCode 构建（Stable/Insiders），按平台已知 CLI 路径将 .vsix 安装到所有存在的构建，使用 --force。
5. 配置提案 API（每个构建一次性）：在各构建的 argv.json 中合并 "enable-proposed-api": ["molon.hunkwise"]，不要覆盖其他字段；若键已存在则追加而非替换。
6. 清理克隆的临时目录。
7. 提示用户完全退出并重启 VSCode 使扩展与提案 API 设置生效。

限制与说明：package.json 中的 enabledApiProposals: ["editorInsets"] 用于启用 vscode.window.createWebviewTextEditorInset，以在编辑器内嵌每 hunk 的 Accept/Discard 按钮，缺少则按钮不显示。设置存储在工作区的 .vscode/hunkwise/settings.json，而非 VSCode 全局设置。若扩展激活失败，可查看 exthost 日志（macOS 与 Windows 路径见资料）。