Hunk 0.3 发布说明解读：预编译 npm 分发、版本命令与实验性 MCP Daemon

开发工具代码评审CLIAI 应用【免费下载链接】hunkReview-first terminal diff viewer for agentic coders项目地址https://gitcode.com/gh_mirrors/hu/hunk点击查看免费下载Hunk 是一个面向 Agent 编码场景的Review-first终端 Diff 查看器。0.3 是 Hunk 早期发布序列中的一个关键节点共 1 个 release发布于 2026 年 3 月 22 日它一次性补齐了安装分发、版本自检与实时会话接入三条基础设施预编译 npm 二进制发布管线、顶层hunk --version命令以及实验性的 MCP daemon。读完本文你将理解 Hunk 0.3 的 8 项变更分别解决了什么问题、在源码中的对应实现以及如何升级、验证安装与启用实验能力。版本说明Hunk 0.3 已不是当前版本。最新版本与全部安装方式请参阅 最新发布 与 安装文档本文按 0.3 当时的状态展开。快速安装与升级0.3.0 安装/升级命令npm i -g hunkdiff0.3.0注意包名为hunkdiffnpm 全局包名不是命令名hunk。0.3 引入的预编译发布管线保证npm i -g拿到的是与当前平台匹配的预编译二进制而不是要求用户在本地完成源码编译。Releases in this series本系列只有 0.3.0 一个版本版本日期类型0.3.02026-03-22当前系列唯一 release0.3.0 变更详解Added新增1. 预编译 npm 二进制打包与自动化发布含 beta tag 支持对应 PR #12、#14、#15。这是 0.3 最核心的基础设施变更Hunk 从发布源码包转向为各平台发布预编译二进制并自动化 npm release 流程同时支持 beta 预发布 tag对应0.x.0-beta.n这类版本。实现事实仓库scripts/packaging/目录下保存着整套发布工具链stage-prebuilt-npm.ts读取构建产物、按平台生成 optionalDependencies 映射与平台包 manifest把二进制 staging 到 npm 发布目录publish-prebuilt-npm.ts执行 npm 发布含 beta tagprebuilt-package-helpers.ts平台包规格、二进制文件名、运行时依赖等公共逻辑check-prebuilt-pack.ts 与 check-pack.ts发布前校验包内容。辅助函数getHostPlatformPackageSpec/getPlatformPackageSpecByName说明发布是按平台拆分为多个 optional 依赖包平台包模式安装时 npm 只拉取当前主机平台的预编译二进制这也是 0.3 之后一键安装、零编译体验的来源。2. 顶层hunk --version命令对应 PR #19。源码实现CLI 解析在 cli.ts 中if (commandName --version || commandName -v || commandName version) { return { kind: help, text: renderCliVersion() }; }即hunk --version、hunk -v、hunk version三种写法等价均输出一行纯文本版本号。版本号来自 version.tsexport function resolveCliVersion(): string { if (typeof PACKAGE_CLI_VERSION ! string || PACKAGE_CLI_VERSION.length 0) { return UNKNOWN_CLI_VERSION; // 0.0.0-unknown } return PACKAGE_CLI_VERSION; }版本字符串直接取自package.json的version字段若缺失则回退为0.0.0-unknown。同一个模块还提供了isStableVersion/isPrereleaseVersion/isNewerVersion等语义化版本判断工具基于 Bun 内置Bun.semver.order这些函数正是 0.3 新增的版本自检能力的基础也为后续hunk update的版本比较逻辑服务。启动优化--version连同--help、daemon serve、markup 与 extension 管理命令在启动计划阶段startup.ts不需要加载完整的 VCS catalog后者会连锁加载 VCS 适配器、changeset 构建与 diff 引擎及语法 grammar因此按需懒加载避免每个命令都付出全量启动代价。测试覆盖见 cli.test.ts 的prints the package version for --version and version。3. 实验性 MCP daemon用于实时 Hunk 会话对应 PR #22。0.3 引入实验性的 MCPModel Context Protocoldaemon用于把正在进行的实时 Hunk 会话暴露给外部 Agent。这是 Hunk 面向 agentic 编码的核心能力Agent 不是事后读 diff 快照而是可以接入一个正在运行的 Hunk 会话。现状提示该功能在 0.3 中标为 experimental。当前仓库中 MCP 相关实现已演化到 session broker 体系——见 broker 目录brokerConfig、brokerLauncher、credentials 等以及 session broker 相关包。也就是说MCP daemon 从 0.3 的实验形态演进为更完整的本地 session daemon broker架构hunk daemon serve命令见 CLI 帮助即运行本地 Hunk 会话 daemon。在 0.3 时间点上它仍属实验特性使用时需自行承担稳定性风险。Changed变更1. 始终显示 diff rail同时调暗非活动 hunks对应 PR #16。0.3 之后 diff 界面左侧的 rail变更标记列在浏览过程中始终显示不再随焦点/活动 hunk 变化而消失非活动不在当前焦点的 hunks 会被调暗显示以弱化视觉干扰、强化当前 hunk 的位置感。这是一项纯渲染层改进服务于快速扫读大型变更的场景。2. Sidebar 可见性与布局切换解耦对应 PR #18。此前 sidebar 的显隐与布局layout开关绑定切换布局会连带改变 sidebar 状态。0.3 将二者解耦sidebar 可见性成为独立状态不再随布局 toggles 联动。解耦后的行为与当前文档 layout-and-display 的描述方向一致布局模式--mode auto|split|unified见 CLI 选项与面板显隐各自独立控制。3. 停止自动保存视图偏好到配置文件对应 PR #13。0.3 之前用户在会话中调整的视图偏好布局、sidebar、行号等会被自动写回配置文件。0.3 起不再自动保存避免配置文件被会话内的临时调整意外污染。偏好保留为会话级/命令行参数级状态如--mode、--line-numbers / --no-line-numbers、--file-gap、--hunk-gap等见 CLI 帮助需要持久化时由用户显式在配置文件中设置。这一改动与当前 configuration 文档 的显式配置哲学一致。Fixed修复1. 预编译 release 构建改用受支持的 Intel macOS runner对应 PR #17。修复 CI 中 Intelx64macOS 构建使用不受支持的 runner 的问题——这是 0.3 新增 macOS 预编译产物的直接配套修复保证 Intel Mac 用户也能拿到官方预编译二进制。2. 安装后保留预编译二进制的可执行权限修复预编译二进制在安装后丢失x可执行位的问题。发布脚本 stage-prebuilt-npm.ts 在 staging 阶段通过 Node 的chmodSync显式设置可执行权限配合 smoke 测试 smoke-prebuilt-install.ts 与安装脚本测试 install-sh.test.ts 验证安装后可正常执行确保npm i -g hunkdiff0.3.0后直接敲hunk可用。升级后的验证清单安装或升级到 0.3.0 后建议依次验证# 1. 版本自检0.3 新增 hunk --version # 或 hunk -v / hunk version应输出 0.3.0 # 2. 基础审查命令可用 hunk diff # 审查工作区变更 # 3. 查看完整帮助确认 diff rail 相关渲染选项 hunk --help验证要点二进制可执行直接运行hunk --version即是最简单的权限自检平台匹配Intel macOS 用户应能拿到官方预编译产物对应修复 #17视图偏好会话内调整--mode等参数不会自动写入配置文件对应变更 #13。相邻发布参考0.3 的上一版本Hunk 0.20.3 的下一版本Hunk 0.4完整发布历史All releases赞分享开发工具代码评审CLIAI 应用【免费下载链接】hunkReview-first terminal diff viewer for agentic coders项目地址https://gitcode.com/gh_mirrors/hu/hunk点击查看免费下载相关推荐使用 Changesets 管理 Hunk 的发布说明与 npm 版本发布流程使用 Changesets 管理 Hunk 的发布说明与 npm 版本发布流程 本指南以 Hunk 仓库的 .changeset/README.md https开发工具代码评审CLIAI 应用Hunk 0.2 发布说明npm 安装修复与 Bun 运行时打包策略Hunk 0.2 发布说明npm 安装修复与 Bun 运行时打包策略 Hunk 是一款面向 Agent 编码场景的review first终端 diff开发工具代码评审CLIAI 应用Hunk 0.4 发布解析MCP Daemon 自动启动与方向键逐行滚动Hunk 0.4 发布解析MCP Daemon 自动启动与方向键逐行滚动 Hunk 是一个面向 Agent 型开发者的 Review first评审优先开发工具代码评审CLIAI 应用上一篇5分钟上手deit_tiny_patch16_224.fb_in1k从环境搭建到图像分类的完整指南下一篇如何快速上手electerm5分钟完成安装与基础配置指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考