Viff v0.4.3

中文

Viff 0.4.3 增加通过 SSH 只读观察远程仓库，并修正欢迎页的搜索范围与变更列表的勾选保留。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这一版可以直接打开服务器上的工作区查看状态、历史与 diff（只读），同时让欢迎页搜索回到按名称匹配，并让右键已勾选的变更行保留勾选。

✨ 新功能

• 以 ssh://host/path 只读打开 Linux/macOS 服务器上的工作区：状态、历史、diff、引用、文件树与工作树文件都来自服务器上的 Git，Viff 不向服务器写入任何内容。
• 认证继承 ~/.ssh/config、ssh-agent 与 known_hosts，不需要在 Viff 里保存密钥；首次连接前需在终端信任主机密钥，当前不提供密码输入框。

⚡ 改进

• 欢迎页搜索默认只按仓库名称做子串匹配，搜索框右侧的 Name / Path 可切到完整路径（子序列）匹配，用于按父目录或路径片段筛选。

🛠 修复

• 右键已勾选的文件、目录或整组打开菜单时保留现有勾选与跨组多选，折叠节点里已勾选的文件也计入批量操作，实际作用范围与勾选状态一致。

升级说明

• 从 v0.4.2 升级：设置文件格式未变，原有设置在升级后继续生效。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器。
• Windows 便携包：解压后进入新目录执行 viff.exe，不写入安装信息。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.4.3-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 要求 13 或更高版本；Linux 需要可用的图形会话、渲染后端和发布指南中列出的系统库。
• macOS 应用使用 ad-hoc 签名，未经 Developer ID 签名或公证；Windows 安装器未经 Authenticode 签名，系统可能显示安全提示。
• 远程仓库是只读观察模式：只支持 key/agent 认证，服务器需为 Linux/macOS 并安装 Git；fetch/pull/push、暂存与提交、应用内编辑、冲突接受、终端与外部打开都不可用，文件变化依赖每 5 秒轮询 git status。
• 应用内编辑只支持工作树中的 UTF-8 文本文件，原始文件和保存后的内容都不超过 1 MiB；历史版本、diff 与冲突仍只读，也不提供补全、多光标或自动保存。
• Windows 和 Linux 上外部工作区文件变化可能需要最多约 30 秒才会刷新；WSL 仓库使用独立的轮询间隔。
• Subversion 属性编辑和锁操作尚未实现；WSL 仓库的内置终端与内容搜索仍在 Windows 侧运行。

仅安装来自项目发布页且已核对校验值的文件；如遇系统拦截，请先确认来源。

查看完整变更

---

English

Viff 0.4.3 adds read-only observation of remote repositories over SSH, and fixes the welcome-screen search scope and change-list check retention.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This release lets you open a working tree on a server to read its status, history, and diffs (read-only), brings welcome-screen search back to name matching, and keeps the checks when you right-click an already checked change row.

✨ New features

• Open a working tree on a Linux/macOS server as ssh://host/path in read-only mode: status, history, diffs, refs, the file tree, and working-tree files all come from the server's Git, and Viff writes nothing to the server.
• Authentication follows ~/.ssh/config, ssh-agent, and known_hosts, so no key is stored in Viff; trust the host key in a terminal before the first connection, as there is no password prompt yet.

⚡ Improvements

• Welcome-screen search now matches repository names only by default; the Name / Path switch beside the box moves to full-path (subsequence) matching for filtering by parent directory or path fragment.

🛠 Fixes

• Right-clicking an already checked file, directory, or whole group keeps the current checks and cross-group selection, and checked files hidden inside collapsed rows still count for batch actions, so the acted-on scope matches the check state.

Upgrade instructions

• Upgrading from v0.4.2: the settings file format is unchanged, so existing settings keep working.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer.
• Windows portable: extract the archive, enter its directory, and run viff.exe without installing.
• Debian/Ubuntu: run sudo apt install ./viff-v0.4.3-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• macOS requires version 13 or later; Linux needs a working graphical session, rendering backend, and the system libraries listed in the release guide.
• The macOS app is ad-hoc signed without Developer ID signing or notarization; the Windows installer is not Authenticode signed, so the system may show a security prompt.
• Remote repositories are read-only observation: key/agent authentication only, and the server must run Linux/macOS with Git installed; fetch/pull/push, staging and committing, in-app editing, conflict acceptance, the terminal, and external opening are unavailable, and file changes rely on polling git status every 5 seconds.
• In-app editing supports only UTF-8 text files in the working tree, up to 1 MiB for both the original file and the saved text; historical revisions, diffs, and conflicts stay read-only, and there is no completion, multi-cursor editing, or autosave.
• On Windows and Linux, external working-tree file changes may take up to about 30 seconds to refresh; WSL repositories use a separate polling interval.
• Subversion property editing and locking are not implemented; the integrated terminal and content search for WSL repositories still run on Windows.

Install only files from the project release page after checking their checksums; verify the source if the operating system blocks them.

Full changelog

🙌 感谢贡献者

感谢 @1lck 与 @muchenhen 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck and @muchenhen for contributing to this release.

Viff v0.4.2

中文

Viff 0.4.2 增加工作树文本文件的应用内编辑，并修正提交时间的时区、编码容错与格式选择。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这一版把只读文件查看器变成可选的编辑器，同时让提交时间按本机时区显示，并允许在 24 小时制与 12 小时制之间选择。

✨ 新功能

• 文件查看器可直接编辑工作树中的 UTF-8 文本文件：Edit（⌘E）进入，⌘S 保存，Revert 还原，Done 返回只读，并保留行号、水平滚动与语法着色。
• 保存前会重新读取文件，外部改动会拒绝覆盖；行尾、UTF-8 BOM 和文件权限保留不变。

⚡ 改进

• 提交时间按本机时区显示，设置中可在 24 小时制与 12 小时制之间切换。
• 欢迎页搜索同时匹配工作区里已添加的仓库，最近项目上限从 20 提高到 50。

🛠 修复

• 提交信息含非法 UTF-8 字节时只替换坏字符，不再让整个日志视图报错。
• 跨时区比较不再把今天的提交误判成昨天。

升级说明

• 从 v0.4.1 升级：设置文件格式未变，原有设置在升级后继续生效。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器。
• Windows 便携包：解压后进入新目录执行 viff.exe，不写入安装信息。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.4.2-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 要求 13 或更高版本；Linux 需要可用的图形会话、渲染后端和发布指南中列出的系统库。
• macOS 应用使用 ad-hoc 签名，未经 Developer ID 签名或公证；Windows 安装器未经 Authenticode 签名，系统可能显示安全提示。
• 应用内编辑只支持工作树中的 UTF-8 文本文件，原始文件和保存后的内容都不超过 1 MiB；历史版本、diff 与冲突仍只读，也不提供补全、多光标或自动保存。
• 应用内编辑的 Windows/Linux 实机输入法、WSL 仓库保存与三平台桌面验收仍待补充；无头 CI 不代表完整桌面兼容。
• Windows 和 Linux 上外部工作区文件变化可能需要最多约 30 秒才会刷新；WSL 仓库使用独立的轮询间隔。
• Subversion 属性编辑和锁操作尚未实现；WSL 仓库的内置终端与内容搜索仍在 Windows 侧运行。

仅安装来自项目发布页且已核对校验值的文件；如遇系统拦截，请先确认来源。

查看完整变更

---

English

Viff 0.4.2 adds in-app editing for working-tree text files, and fixes commit-time time zones, invalid encoding, and clock format.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This release turns the read-only file viewer into an optional editor, shows commit times in the local time zone, and lets you choose a 24- or 12-hour clock.

✨ New features

• Edit UTF-8 text files in the working tree from the file viewer: press Edit (⌘E), save with ⌘S, revert with Revert, and return with Done while keeping line numbers, horizontal scrolling, and syntax colours.
• A save re-reads the file and refuses to overwrite an external change; line endings, a UTF-8 BOM, and file permissions stay intact.

⚡ Improvements

• Commit times now follow the local time zone, and settings can switch between a 24- and 12-hour clock.
• Welcome-screen search now also matches repositories in the workspace, and the recent-project limit rises from 20 to 50.

🛠 Fixes

• Invalid UTF-8 bytes in a commit message are replaced instead of making the whole log view fail.
• Cross-time-zone comparisons no longer show today's commit as yesterday.

Upgrade instructions

• Upgrading from v0.4.1: the settings file format is unchanged, so existing settings keep working.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer.
• Windows portable: extract the archive, enter its directory, and run viff.exe without installing.
• Debian/Ubuntu: run sudo apt install ./viff-v0.4.2-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• macOS requires version 13 or later; Linux needs a working graphical session, rendering backend, and the system libraries listed in the release guide.
• The macOS app is ad-hoc signed without Developer ID signing or notarization; the Windows installer is not Authenticode signed, so the system may show a security prompt.
• In-app editing supports only UTF-8 text files in the working tree, up to 1 MiB for both the original file and the saved text; historical revisions, diffs, and conflicts stay read-only, and there is no completion, multi-cursor editing, or autosave.
• Real Windows/Linux input-method testing, saving in WSL repositories, and full desktop acceptance remain outstanding; headless CI is not a complete desktop compatibility claim.
• On Windows and Linux, external working-tree file changes may take up to about 30 seconds to refresh; WSL repositories use a separate polling interval.
• Subversion property editing and locking are not implemented; the integrated terminal and content search for WSL repositories still run on Windows.

Install only files from the project release page after checking their checksums; verify the source if the operating system blocks them.

Full changelog

🙌 感谢贡献者

感谢 @1lck 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck for contributing to this release.

Viff v0.4.1

中文

Viff 0.4.1 改进启动和分支操作，并修复通知与历史读取问题。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这一版减少启动和后台刷新的等待，同时让分支双击行为可配置。

✨ 新功能

• 分支双击默认只筛选日志；可在设置中启用双击检出，右键检出仍然可用。

⚡ 改进

• 减少启动时对远程仓库路径和版本探测的等待，并降低部分平台的后台刷新频率。
• 文件管理器菜单按系统显示 Finder、文件资源管理器或文件管理器。

🛠 修复

• 对话框打开时暂时隐藏通知气泡，关闭后恢复显示，避免遮挡按钮。
• 历史读取结束后及时释放进程，减少仓库文件被占用的情况。

升级说明

• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器。
• Windows 便携包：解压后进入新目录执行 viff.exe，不写入安装信息。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.4.1-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 要求 13 或更高版本；Linux 需要可用的图形会话、渲染后端和发布指南中列出的系统库。
• macOS 应用使用 ad-hoc 签名，未经 Developer ID 签名或公证；Windows 安装器未经 Authenticode 签名，系统可能显示安全提示。
• Windows 和 Linux 上外部工作区文件变化可能需要最多约 30 秒才会刷新；WSL 仓库使用独立的轮询间隔。
• Subversion 属性编辑和锁操作尚未实现；WSL 仓库的内置终端与内容搜索仍在 Windows 侧运行。

仅安装来自项目发布页且已核对校验值的文件；如遇系统拦截，请先确认来源。

查看完整变更

---

English

Viff 0.4.1 improves startup and branch actions, and fixes notifications and history reading.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This release reduces startup and background refresh waits and makes branch double-click behavior configurable.

✨ New features

• Double-clicking a branch filters the log by default; enable checkout on double-click in settings, or use the context menu to check out.

⚡ Improvements

• Reduce startup waits for remote repository paths and version probes, and refresh less often in the background on some platforms.
• Name the file manager action Finder, File Explorer, or File Manager for the current system.

🛠 Fixes

• Hide notification balloons while a dialog is open and show them again after it closes, so they do not cover buttons.
• Release the history reader process when reading finishes, reducing files held open in the repository.

Upgrade instructions

• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer.
• Windows portable: extract the archive, enter its directory, and run viff.exe without installing.
• Debian/Ubuntu: run sudo apt install ./viff-v0.4.1-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• macOS requires version 13 or later; Linux needs a working graphical session, rendering backend, and the system libraries listed in the release guide.
• The macOS app is ad-hoc signed without Developer ID signing or notarization; the Windows installer is not Authenticode signed, so the system may show a security prompt.
• On Windows and Linux, external working-tree file changes may take up to about 30 seconds to refresh; WSL repositories use a separate polling interval.
• Subversion property editing and locking are not implemented; the integrated terminal and content search for WSL repositories still run on Windows.

Install only files from the project release page after checking their checksums; verify the source if the operating system blocks them.

Full changelog

🙌 感谢贡献者

感谢 @1lck 与 @VedaChen 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck and @VedaChen for contributing to this release.

Viff v0.4.0

中文

Viff 0.4.0 让同一个窗口也能打开 Subversion 工作副本和 WSL 发行版里的仓库，并补上读代码时最常用的跳转、搜索与缩略图。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这一版拆掉了「只能打开 Git 仓库」的两个前提：版本控制系统不再只有 Git，仓库也可以位于 Windows 之外的发行版里。读代码的一侧同时补上了跳转、按需搜索与代码缩略图。

✨ 新功能

• Subversion 工作副本：检出与打开、状态、diff、blame、历史、提交（可选择本次提交的文件）、更新、还原、分支切换都在同一个窗口里；后端没有的能力入口直接隐藏，不会显示出来再报错。
• WSL 仓库：Windows 版可以直接打开发行版内的仓库，Git 由该发行版执行，凭据、签名与 hooks 沿用 Linux 侧的配置。
• 在文件中查找：⇧⌘F 按需搜索工作树内容，列出相对路径、行号与命中行文本，不建索引，结果最多 300 条，遵守 Git 跟踪与 .gitignore 并跳过二进制文件。
• 跳转到源码：在 diff 里直接打开改动所在的文件与行。
• 变更刻度与代码地图：diff 右缘标出改动位置，并可按需显示代码地图。
• 从父目录发现仓库：选择上层目录即可扫描并批量导入其中的仓库。
• 日志分支筛选：分支筛选框支持输入搜索，不再需要在长列表里翻找。
• 文件缩略图：只读文件查看器右侧显示代码缩略图，拖动视口遮罩可快速定位，正文、遮罩与滚动条同步。

⚡ 改进

• diff 里的文本可以直接选中复制。
• 中文界面覆盖 Project 面板的右键菜单、工具栏提示与空状态，不再中英混排。
• 术语统一：储藏、空白差异与历史相关标签在整份消息表里保持一致。
• Git 路径回显按仓库给出：打开 WSL 仓库时，设置页显示的是该发行版内的 git，而不是 Windows 的默认值。

🛠 修复

• 标题栏的最小化、最大化与关闭按钮随主题取色，切换主题后不再因浅色压浅色而看不见。
• Project 面板在应用筛选时仍可正常折叠与展开。
• 状态栏的文件计数在中文界面下不再显示英文复数形式。

升级说明

• 从 v0.3.x 升级：设置文件格式未变，原有设置在升级后继续生效。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器，或解压便携 ZIP 后执行 viff.exe。
• Windows 便携包：解压后进入新目录执行 viff.exe，不写入安装信息。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.4.0-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH；使用 Subversion 仓库时，本机还需要 svn 客户端。

兼容性与已知问题

• macOS 两个架构都要求 macOS 13 及以上；Linux 需要可用的图形会话与渲染后端。
• macOS 应用使用 ad-hoc 签名，未经 Developer ID 签名或公证；Windows 安装器未经 Authenticode 签名，系统可能显示安全提示。
• Subversion 支持仍在补全：属性编辑（svn:ignore、svn:eol-style）与 lock/unlock 尚未实现，相关入口不显示。
• Subversion 的历史需要访问仓库：仓库不可达时会直接报错，而不会把旧结果标注为陈旧后继续展示。
• WSL 仓库仅限 Windows：内置终端与内容搜索仍走 Windows 侧，设置里针对 Windows git 的取值（Git 路径、GPG 程序、签名密钥、凭据助手、SSH 命令）对 WSL 仓库不生效。
• 缩略图只在只读文件查看器里出现，diff 视图仍然只有右缘的变更刻度。
• 输入法、外部编辑器与各类显卡环境仍需在实际桌面环境继续验收。

仅安装来自本项目发布页且已核对校验值的文件；若系统拦截，请先确认来源，再使用系统提供的允许打开选项。

查看完整变更

---

English

Viff 0.4.0 opens Subversion working copies and repositories inside a WSL distribution in the same window, and adds the jumps, search and minimap you reach for while reading code.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This release removes the two assumptions behind "Git repositories only": the version control system is no longer just Git, and a repository no longer has to live on the Windows side. The reading side gains jumps, on-demand search and a code minimap at the same time.

✨ New features

• Subversion working copies: open, status, diff, blame, history, commit (choosing the files this commit takes), update, revert and branch switching all happen in the same window; entries a backend cannot offer are hidden rather than shown and failing.
• WSL repositories: the Windows build opens a repository inside a WSL distribution and runs Git in that distribution, so credentials, signing and hooks come from the Linux side.
• Find in Files: ⇧⌘F searches the working tree on demand and lists relative paths, line numbers and the matching line, building no index, stopping at 300 results, honouring Git tracking and .gitignore, and skipping binaries.
• Jump to Source: open the file and line a diff change comes from, straight from the diff.
• Change marks and code map: the right edge of a diff marks where changes are, and a code map can be shown on demand.
• Repository discovery: pick a parent folder and scan it for repositories to import in one go.
• Searchable log branch filter: type to narrow the branch list instead of scrolling it.
• Code minimap: the read-only file viewer shows a minimap on the right; dragging the viewport mask jumps through the file, with the text, the mask and the scroll bar kept in step.

⚡ Improvements

• Text inside a diff can be selected and copied.
• The Chinese interface covers the Project panel's context menus, toolbar tips and empty states instead of mixing both languages.
• Consistent terminology: stash, whitespace and history labels now read the same way across the whole message table.
• The Git path echo follows the repository: with a WSL repository open, settings name the git inside that distribution rather than the Windows default.

🛠 Fixes

• The titlebar's minimize, maximize and close buttons take their color from the current theme, so switching themes no longer leaves them invisible.
• The Project panel keeps folding and expanding while a filter is applied.
• The file count in the status area no longer shows an English plural in the Chinese interface.

Upgrade instructions

• Upgrading from v0.3.x: the settings file format is unchanged, so existing settings carry over.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer, or extract the portable ZIP and run viff.exe.
• Windows portable: extract the archive, enter its directory, and run viff.exe; no installation information is written.
• Debian/Ubuntu: run sudo apt install ./viff-v0.4.0-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH; Subversion working copies also need an svn client on the machine.

Compatibility and known issues

• Both macOS architectures require macOS 13 or later; Linux needs a working graphical session and rendering backend.
• The macOS app is ad-hoc signed without Developer ID signing or notarization, and the Windows installer is not Authenticode signed, so the operating system may show a security prompt.
• Subversion support is still being filled in: property editing (svn:ignore, svn:eol-style) and lock/unlock are not implemented, and their entries are not shown.
• Subversion history needs the repository: when it cannot be reached the failure is reported instead of keeping an old answer on screen labelled as stale.
• WSL repositories are Windows-only: the integrated terminal and content search still run on the Windows side, and the settings that configure the Windows git (Git path, GPG program, signing key, credential helper, SSH command) do not apply to a WSL repository.
• The minimap appears in the read-only file viewer only; a diff still carries just the change marks on its right edge.
• Input methods, external editors and graphics configurations still need acceptance on real desktops.

Install only files from this project's release page after checking their checksums; if blocked, verify the source before using the operating system's option to allow the app.

Full changelog

🙌 感谢贡献者

感谢 @1lck、@VedaChen 与 @muchenhen 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck, @VedaChen and @muchenhen for contributing to this release.

Viff v0.3.0

中文

Viff 0.3.0 让 AI 生成的提交说明按你自己写的规则来，并记住窗口所在的位置，Update Project 也可以不再每次都问。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这一版处理两处「每次都得重复一遍」的摩擦：提交说明的格式不再写死在程序里，窗口的位置也不再每次重开都丢掉。

✨ 新功能

• 提交信息规则：右键 AI 按钮可以按项目选择规则、新建或编辑规则文本，随时切回内置规则；规则保存在与设置同目录的 prompts.json 里。
• 记住窗口位置：窗口在哪个屏幕、哪个位置关闭，下次就在那里打开。
• Update Project 不再询问：更新对话框新增「不再询问」，勾选后快捷键按上次记住的方式直接更新，并通知用了哪个远端、哪种方式。

⚡ 改进

• AI 按钮的提示会显示当前生效的规则名；右键菜单里还有一个默认开启的「生成前先确认」开关，发送 diff 前先问一次。
• 自定义规则生效时，发给模型的上下文把最近提交标为命名参考，不再当作格式范例，避免历史提交盖过你写的规则。
• 设置 → Git 页新增「询问更新方式」，作为勾选「不再询问」之后的撤销入口。

升级说明

• 从 v0.2.x 升级：可以在应用内检查更新，也可以手动下载安装包；设置文件仍是同一格式版本，旧设置直接沿用。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器；也可以解压便携 ZIP 后运行 viff.exe。
• Windows 便携包：解压后进入新目录执行 viff.exe，不写入安装信息。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.3.0-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 包要求 macOS 13 及以上，Apple Silicon 与 Intel 机型均可安装；Linux 需要可用的图形会话。
• macOS 应用使用 ad-hoc 签名，尚无 Developer ID 签名或公证；Windows 安装器尚无 Authenticode 签名，系统可能显示安全提示。
• 窗口位置只记录普通窗口几何：最大化状态不单独保存，副屏拔掉后由平台把窗口回退到主屏可见区域。
• 勾选「不再询问」后，Update Project 按记住的方式直接执行 pull，属于写操作；需要恢复询问时到设置 → Git 页打开「询问更新方式」。
• AI 生成提交说明仍默认关闭；启用后会把分支名、最近五条提交、变更文件、diff 以及你写的规则文本发送到你自己配置的端点，边界见隐私说明。
• 自定义规则不做校验：模型回答原样填入提交框，程序不解析结构、不静默改写，空回答仍报错。
• 撤销只在当前会话、当前仓库生效，保留最近 20 条，也没有 redo。
• 网页链接不登录、不调用服务 API；Git LFS 只检测不管理；Copy for AI 只写系统剪贴板。
• 中英双语覆盖主要界面；Git 命令与输出、文件路径与哈希、快捷键、日志字段与诊断 issue 模板保持英文。
• 应用内更新继续使用 HTTPS 与 SHA-256 校验，不做系统签名校验；下载来源是本项目 GitHub Releases。
• 输入法、外部编辑器与各类显卡环境仍需在实际桌面环境继续验收。

仅安装来自本项目发布页且已核对校验值的文件；若系统拦截，请先确认来源，再使用系统提供的允许打开选项。

查看完整变更

---

English

Viff 0.3.0 lets the AI commit message follow rules you write, remembers where the window was, and stops asking about Update Project every time.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This release removes two frictions that had to be repeated every time: the shape of a commit message is no longer hardcoded in the program, and the window position is no longer lost on every start.

✨ New features

• Commit message rules: right-click the AI button to choose the rules a repository uses, write or edit your own rules text, and switch back to the built-in rules at any time; the rules live in prompts.json next to the settings file.
• Remembered window position: Viff reopens on the screen and at the position where it was closed.
• Update Project without a question: the update dialog gains "Do not ask again"; once ticked, the shortcut updates the way it last remembered and reports which remote and which mode it used.

⚡ Improvements

• The AI button's tooltip names the rule in use, and its context menu carries an "Ask before generating" switch, on by default, that asks once before the diff is sent.
• With custom rules, the context sent to the model labels recent commits as naming reference instead of format examples, so the history does not outweigh your own rules.
• Settings → Git gains "Ask how to update", the way back after ticking "Do not ask again".

Upgrade instructions

• Upgrading from v0.2.x: check for updates inside the app or download a package; the settings file is still the same format version, so existing settings carry over.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer, or extract the portable ZIP and run viff.exe.
• Windows portable: extract the archive, enter its directory, and run viff.exe; no installation information is written.
• Debian/Ubuntu: run sudo apt install ./viff-v0.3.0-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• The macOS package requires macOS 13 or later on both Apple Silicon and Intel; Linux needs a working graphical session.
• The macOS app is ad-hoc signed without Developer ID signing or notarization, and the Windows installer is not Authenticode signed, so the operating system may show a security prompt.
• The window position covers normal window geometry only: the maximized state is not stored separately, and when a secondary display goes away the platform moves the window back onto the main display.
• After ticking "Do not ask again", Update Project runs the remembered pull directly, which is a write; to get the question back, open "Ask how to update" on the settings Git page.
• AI commit messages remain off by default; when enabled, they send the branch name, the last five commits, the changed files, their diffs and the rules text you wrote to the endpoint you configure. See the privacy guide.
• Custom rules are not validated: the model's answer goes into the commit box as it is, Viff does not parse the structure or silently rewrite it, and an empty answer is still an error.
• Undo is limited to the current session and repository, keeps the last 20 entries, and has no redo.
• Web links never sign in or call a service API; Git LFS is detected but not managed; Copy for AI writes to the system clipboard only.
• English and Simplified Chinese cover the main windows; Git commands and output, paths and hashes, shortcuts, log fields and the diagnostics issue template stay English.
• In-app updates keep using HTTPS and SHA-256 rather than operating-system signature verification; downloads come from this project's GitHub Releases.
• Input methods, external editors and graphics configurations still need acceptance on real desktops.

Install only files from this project's release page after checking their checksums; if blocked, verify the source before using the operating system's option to allow the app.

Full changelog

🙌 感谢贡献者

感谢 @1lck 与 @VedaChen 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck and @VedaChen for contributing to this release.

Viff v0.2.0

中文

Viff 0.2.0 加入网页链接、会话内撤销、Git LFS 检测与冲突上下文复制，并修复大仓库里日志卡在加载态、提交详情被分支查询拖慢的问题。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这次更新围绕日常操作的三处摩擦：把提交和分支送回浏览器、给误操作一颗后悔药、让外部 AI 更容易接手冲突；同时修掉大仓库里两个真实的等待问题。

✨ 新功能

• 网页链接：Log 的单提交菜单与分支弹窗可以打开 GitHub、GitLab、Bitbucket、Gitea 上的提交、分支、比较与创建 PR／合并请求页面，不需要登录或令牌。
• 撤销：⌘Z（Windows/Linux 为 Ctrl+Z）撤销本会话内最近一次本地操作，覆盖提交、Amend、merge、rebase、cherry-pick、revert、reset、检出与分支新建/删除/重命名。
• Git LFS：检测仓库的 LFS 规则与受管文件，状态栏显示数量；本机缺少 git-lfs 时在提交面板给出安装提示。
• Copy for AI：冲突查看器把当前冲突的结构化上下文复制到剪贴板，交给外部 AI 修改；Viff 不调用模型、不联网。

⚡ 改进

• 提交详情先显示正文，包含该提交的分支列表随后补充，不再等分支查询完成才出内容。
• 冲突查看器的复制动作与逐块接受共用同一份解析结果，标记不可靠时不提供复制。

🛠 修复

• 修复大仓库中 Log 可能永久停在 Loading、提交列表为空的问题。
• 修复提交详情在分支较多的仓库里要等待约两秒才显示的问题。

升级说明

• 从 v0.1.x 升级：可以在应用内检查更新，也可以手动下载安装包；设置文件格式没有变化，旧设置直接沿用。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器；也可以解压便携 ZIP 后运行 viff.exe。
• Windows 便携包：解压后进入新目录执行 viff.exe，不写入安装信息。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.2.0-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 包要求 macOS 13 及以上，Apple Silicon 与 Intel 机型均可安装；Linux 需要可用的图形会话。
• macOS 应用使用 ad-hoc 签名，尚无 Developer ID 签名或公证；Windows 安装器尚无 Authenticode 签名，系统可能显示安全提示。
• 撤销只在当前会话、当前仓库生效，保留最近 20 条；首次提交、reword/squash/drop、冲突后 continue、reset --soft/--mixed 的撤销不支持，也没有 redo。
• 网页链接不登录、不调用服务 API：未知主机按 GitHub 页面布局生成地址，Bitbucket 不生成比较与创建 PR 页面，未推送的分支由服务端提示不存在。
• Git LFS 只检测不管理：不安装 git-lfs，不执行 install、track、pull 或 push；未暂存的 LFS 指针文件不计入列表。
• Copy for AI 只写系统剪贴板，不调用模型、不发网络请求；单块超过 200 行或 20 KB、全文超过 200 KB 时截断并注明。
• 中英双语覆盖主要界面；Git 命令与输出、文件路径与哈希、快捷键、日志字段与诊断 issue 模板保持英文。
• AI 生成提交说明仍默认关闭；启用后会把分支名、最近五条提交、变更文件与 diff 发送到你自己配置的端点，边界见隐私说明。
• 应用内更新继续使用 HTTPS 与 SHA-256 校验，不做系统签名校验；下载来源是本项目 GitHub Releases。
• 输入法、外部编辑器与各类显卡环境仍需在实际桌面环境继续验收。

仅安装来自本项目发布页且已核对校验值的文件；若系统拦截，请先确认来源，再使用系统提供的允许打开选项。

查看完整变更

---

English

Viff 0.2.0 adds web links, a session-wide undo, Git LFS detection and a copyable conflict context, and fixes the log hanging on its loading state and commit details waiting on a branch query in large repositories.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This release removes three points of friction: commits and branches go back to the browser, a mistake gets one step of recovery, and an external AI can pick up a conflict more easily. It also fixes two real waits in large repositories.

✨ New features

• Web links: the log's commit menu and the branch popup open commit, branch, comparison and pull/merge request pages on GitHub, GitLab, Bitbucket and Gitea, without signing in or storing a token.
• Undo: Command-Z (Control-Z on Windows and Linux) reverses the last local operation of this session, covering commit, amend, merge, rebase, cherry-pick, revert, reset, checkout, and branch create/delete/rename.
• Git LFS: Viff reports the repository's LFS rules and managed files and shows the count in the status bar; when git-lfs is missing, the commit panel says how to install it.
• Copy for AI: the conflict viewer copies the structured context of the current conflict for an external AI tool; Viff calls no model and opens no connection.

⚡ Improvements

• Commit details appear first; the list of branches that contain the commit follows, instead of holding the panel until the branch query finishes.
• The conflict viewer's copy actions use the same parse as the per-block accept controls, and are not offered when the markers are not reliable.

🛠 Fixes

• Fixed the log sometimes staying on Loading with an empty commit list in large repositories.
• Fixed commit details waiting about two seconds in repositories with many branches.

Upgrade instructions

• Upgrading from v0.1.x: check for updates inside the app or download a package; the settings file format is unchanged, so existing settings carry over.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer, or extract the portable ZIP and run viff.exe.
• Windows portable: extract the archive, enter its directory, and run viff.exe; no installation information is written.
• Debian/Ubuntu: run sudo apt install ./viff-v0.2.0-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• The macOS package requires macOS 13 or later on both Apple Silicon and Intel; Linux needs a working graphical session.
• The macOS app is ad-hoc signed without Developer ID signing or notarization, and the Windows installer is not Authenticode signed, so the operating system may show a security prompt.
• Undo is limited to the current session and repository, keeps the last 20 entries, and does not cover the first commit, reword/squash/drop, continue after a conflict, or reset --soft/--mixed; there is no redo.
• Web links never sign in or call a service API: an unknown host is assumed to follow GitHub's page layout, Bitbucket comparison and pull request pages are not generated, and an unpushed branch is reported by the service.
• Git LFS is detected, not managed: Viff does not install git-lfs or run install, track, pull or push; unstaged LFS pointer files are not counted.
• Copy for AI writes to the system clipboard only and sends nothing; a block over 200 lines or 20 KB and the whole text over 200 KB are truncated with a note.
• English and Simplified Chinese cover the main windows; Git commands and output, paths and hashes, shortcuts, log fields and the diagnostics issue template stay English.
• AI commit messages remain off by default; when enabled, they send the branch name, the last five commits, the changed files and their diffs to the endpoint you configure. See the privacy guide.
• In-app updates keep using HTTPS and SHA-256 rather than operating-system signature verification; downloads come from this project's GitHub Releases.
• Input methods, external editors and graphics configurations still need acceptance on real desktops.

Install only files from this project's release page after checking their checksums; if blocked, verify the source before using the operating system's option to allow the app.

Full changelog

🙌 感谢贡献者

感谢 @1lck 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck for contributing to this release.

Viff v0.1.2

中文

Viff 0.1.2 是一次功能更新：新增只读的 Project 文件浏览与 Quick Open、图片 diff、界面与等宽字体设置、系统状态区图标，界面支持中英双语；提交面板加入变更树复选框、可折叠的说明输入区，并可选让模型按 Conventional Commits 生成提交说明。Viff 仍然是一个原生 Go 程序，不捆绑 Electron 或浏览器运行时。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

这次更新的主线是把日常浏览与提交补完整：浏览工作区文件、直接看图片改动、用中文界面，以及更顺手的提交面板。

✨ 新功能

• Project 工具窗口：只读浏览工作区的已跟踪与未跟踪文件，按目录折叠、按路径过滤、按 Git 状态着色，⌘1 或左侧文件夹图标打开。
• Quick Open：⇧⌘O 按路径片段模糊匹配任意文件，回车在只读查看器中打开。
• 只读查看器支持用鼠标或键盘选择文本并复制。
• 图片 diff：PNG、JPEG、GIF 的改动并排显示图片、格式与像素尺寸，不再只显示“二进制文件不同”。
• 界面字体：设置里可选择界面使用的字体，保存后立即生效。
• 等宽字体：diff、控制台与提交哈希使用的等宽字体可以单独选择。
• 状态区图标：Viff 常驻系统状态区，点击图标把窗口带回前台，菜单里可以退出。
• 中英双语：设置 → General → Language 在英文与简体中文之间切换，默认英文，旧设置文件的行为不变。
• 变更树复选框：勾选单个文件、目录或整组，暂存、取消暂存、回滚、查看 diff 等批量操作作用于勾选的文件。
• 折叠提交说明：提交面板底部的说明区可一键折叠，把空间让给变更树，折叠状态在会话内保留。
• AI 生成提交说明：可选功能，按 Conventional Commits 生成，内置 OpenAI、Anthropic、DeepSeek、OpenRouter、Ollama 等预设，结果只填入输入框、不自动提交。

⚡ 改进

• 设置对话框分为 General、Git 与 AI 三页，AI 页可以填端点、密钥、模型并获取模型列表。
• 语言、界面字体与等宽字体保存在设置文件里，保存后立即生效。

🛠 修复

• 修复在设置里切换页面后，打开的下拉菜单没有关闭的问题。
• 修复变更文件计数把数量传了两次、显示成 6 files%!(EXTRA int=6) 的问题。

升级说明

• 从 v0.1.1 升级：可以在应用内检查更新，也可以手动下载安装包；本次没有设置文件格式变化，旧设置直接沿用。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器；也可以解压便携 ZIP 后运行 viff.exe。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.1.2-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 包要求 macOS 13 及以上，Apple Silicon 与 Intel 机型均可安装；Linux 需要可用的图形会话。
• macOS 应用使用 ad-hoc 签名，尚无 Developer ID 签名或公证；Windows 安装器尚无 Authenticode 签名，系统可能显示安全提示。
• 中英双语覆盖主要界面；Git 命令与输出、文件路径与哈希、快捷键、日志字段与诊断 issue 模板保持英文，少量相对时间提示（如“Moments ago”“Today 14:30”）仍是英文。
• AI 生成默认关闭；启用后会把当前改动的分支名、最近五条提交、变更文件与 diff 发送到你自己配置的端点，单文件最多 4000 字符、最多 8 个文件，跳过 lock 文件与二进制 diff，详见隐私说明。
• 应用内更新继续使用 HTTPS 与 SHA-256 校验，不做系统签名校验；下载来源是本项目 GitHub Releases。
• 输入法、外部编辑器与各类显卡环境仍需在实际桌面环境继续验收。

仅安装来自本项目发布页且已核对校验值的文件；若系统拦截，请先确认来源，再使用系统提供的允许打开选项。

查看完整变更

---

English

Viff 0.1.2 is a feature release: a read-only project browser with Quick Open, picture diffs, interface and fixed-pitch font settings, a status-area icon, and an English/Chinese interface. The commit panel gains checkboxes in the changes tree, a collapsible message editor, and an optional model-written commit message following Conventional Commits. Viff remains a native Go application without Electron or a bundled browser runtime.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

The theme of this release is finishing the everyday browsing and committing paths: browsing working-tree files, seeing picture changes directly, using the interface in Chinese, and a smoother commit panel.

✨ New features

• Project tool window: browse tracked and untracked working-tree files read-only, folded by directory, filtered by path, and coloured by Git status; open it with ⌘1 or the folder icon in the left stripe.
• Quick Open: ⇧⌘O matches any file by path fragment and opens it in the read-only viewer.
• The read-only viewer supports selecting text with the mouse or keyboard and copying it.
• Picture diffs: PNG, JPEG and GIF changes show side by side with format and pixel dimensions instead of “binary files differ”.
• Interface font: choose the font the interface uses in Settings; it applies as soon as the dialog is saved.
• Fixed-pitch font: the family used by diffs, the console and commit hashes is chosen separately.
• Status-area icon: Viff stays in the system status area; pressing the icon brings the window forward and its menu can quit.
• English and Chinese: switch between them in Settings → General → Language; English is the default and existing settings files keep working.
• Changes-tree checkboxes: check a file, a directory or a whole group; stage, unstage, roll back and show diff act on the checked files.
• Collapsible commit message: the message area at the bottom of the commit panel folds away and gives its space to the changes tree; the state is kept for the session.
• AI commit message: optional, follows Conventional Commits, ships presets for OpenAI, Anthropic, DeepSeek, OpenRouter, Ollama and others, and only fills the message box without committing.

⚡ Improvements

• Settings is split into General, Git and AI pages; the AI page holds the endpoint, key, model and model discovery.
• Language, interface font and fixed-pitch font are stored in the settings file and take effect on save.

🛠 Fixes

• Fixed a dropdown staying open after switching pages in Settings.
• Fixed the changed-file count printing its number twice, as in 6 files%!(EXTRA int=6).

Upgrade instructions

• Upgrading from v0.1.1: check for updates inside the app or download a package; the settings file format is unchanged, so existing settings carry over.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer, or extract the portable ZIP and run viff.exe.
• Debian/Ubuntu: run sudo apt install ./viff-v0.1.2-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• The macOS package requires macOS 13 or later on both Apple Silicon and Intel; Linux needs a working graphical session.
• The macOS app is ad-hoc signed without Developer ID signing or notarization, and the Windows installer is not Authenticode signed, so the operating system may show a security prompt.
• The bilingual interface covers the main windows; Git commands and output, paths and hashes, shortcuts, log fields and the diagnostics issue template stay English, and a few relative-time labels (“Moments ago”, “Today 14:30”) are still English.
• AI generation is off by default; when enabled it sends the branch name, the last five commits, the changed files and their diffs to the endpoint you configure, at most 4000 characters per file and 8 files, skipping lock files and binary diffs. See the privacy guide.
• In-app updates keep using HTTPS and SHA-256 rather than operating-system signature verification; downloads come from this project’s GitHub Releases.
• Input methods, external editors and graphics configurations still need acceptance on real desktops.

Install only files from this project's release page after checking their checksums; if blocked, verify the source before using the operating system's option to allow the app.

Full changelog

🙌 感谢贡献者

感谢 @1lck 与 @VedaChen 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck and @VedaChen for contributing to this release.

Viff v0.1.1

中文

Viff 0.1.1 加入应用内更新：可以在启动时自动检查，也可以从帮助菜单手动检查；确认更新后由应用下载安装包、校验 SHA-256，再点“Restart to Update”完成替换并重启，不需要打开浏览器。Windows 新增便携 ZIP，后续版本可以从应用内升级。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Windows x64 · 便携 ZIP
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

本次的核心是应用内更新，以及为它补齐的 Windows 便携 ZIP。Viff 仍然是一个原生 Go 程序，不捆绑 Electron 或浏览器运行时。

✨ 新功能

• 应用内更新：启动时静默检查（可在设置关闭）或从“Check for Updates…”手动检查，发现新版本后显示版本与发布说明。
• 应用内下载：下载过程显示进度并支持取消，完成后用发布页的 SHA256SUMS 校验，校验失败不会安装。
• 重启以更新：点“Restart to Update”后 Viff 退出，helper 在后台替换当前安装并自动启动新版本；macOS 替换整个应用包，Windows 与 Linux 便携包替换可执行文件。
• Windows：新增便携 ZIP，既可作为免安装版本使用，也是应用内更新在 Windows 上的下载包。
• Linux：便携包继续自替换；DEB 安装会下载对应的 DEB，并提示用 sudo apt install 完成提权安装，不直接改写包管理器管理的文件。
• 设置：新增“Check for updates at startup”开关，默认开启。

升级说明

• 从 v0.1.0 或更早版本升级：本版是第一个带更新器的版本，需要先手动安装一次；之后的新版本可以在应用内升级。
• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器；也可以解压便携 ZIP 后运行 viff.exe。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.1.1-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 包要求 macOS 13 及以上，Apple Silicon 与 Intel 机型均可安装。
• macOS 应用使用 ad-hoc 签名，尚无 Developer ID 签名或公证；Windows 安装器尚无 Authenticode 签名，系统可能显示安全提示。
• 应用内更新使用 HTTPS 与 SHA-256 校验，不做系统签名校验；下载来源是本项目 GitHub Releases。
• Windows 与 Linux 的自替换只更新可执行文件，随包文档和 Windows 卸载项中的版本号保持旧值，直到下次完整安装；macOS 替换整个应用包。
• DEB 安装受权限限制，最后一步需要 sudo apt install，无法完全一键完成。
• 更新检查是 Viff 默认开启的唯一网络请求，只读取公开版本信息；可在设置关闭，详见隐私说明。
• 输入法、外部编辑器与各类显卡环境仍需在实际桌面环境继续验收。

仅安装来自本项目发布页且已核对校验值的文件；若系统拦截，请先确认来源，再使用系统提供的允许打开选项。

查看完整变更

---

English

Viff 0.1.1 adds in-app updates. Viff checks at startup or from the Help menu, downloads the package inside the app, verifies it with SHA-256, and replaces and relaunches itself through “Restart to Update” without opening a browser. Windows also gains a portable ZIP, and later releases can upgrade from inside the app.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Windows x64 · Portable ZIP
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

The core of this release is the in-app updater, together with the Windows portable ZIP it needs. Viff remains a native Go application without Electron or a bundled browser runtime.

✨ New features

• In-app updates: Viff checks quietly at startup (configurable in Settings) or on demand from “Check for Updates…”, then shows the version and release notes.
• In-app download: progress and cancellation, followed by a SHA-256 check against the release’s SHA256SUMS; a mismatch is never installed.
• Restart to update: “Restart to Update” quits Viff, a helper replaces the current installation, and the new version starts automatically. macOS replaces the whole application bundle; Windows and the Linux portable archive replace the executable.
• Windows: a portable ZIP that doubles as the download package for in-app updates and as a no-install option.
• Linux: the portable archive still updates itself; a DEB installation downloads the matching DEB and asks for sudo apt install instead of overwriting files owned by the package manager.
• Settings: a “Check for updates at startup” switch, enabled by default.

Upgrade instructions

• Upgrading from v0.1.0 or earlier: this is the first release with the updater, so install it by hand once; later releases can upgrade from inside the app.
• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer, or extract the portable ZIP and run viff.exe.
• Debian/Ubuntu: run sudo apt install ./viff-v0.1.1-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• The macOS package requires macOS 13 or later and runs on both Apple Silicon and Intel Macs.
• The macOS app is ad-hoc signed without Developer ID signing or notarization, and the Windows installer is not Authenticode signed, so the operating system may show a security prompt.
• In-app updates use HTTPS and SHA-256, not operating-system signature verification; downloads come from this project’s GitHub Releases.
• Windows and Linux self-updates replace only the executable, so bundled documentation and the Windows uninstall entry keep the old version until a full install; macOS replaces the whole bundle.
• A DEB installation needs sudo apt install as its final step, so it cannot be fully automatic.
• The update check is Viff’s only default network request and only reads public release metadata; it can be disabled in Settings. See the privacy guide.
• Input methods, external editors, and graphics configurations still need acceptance on real desktops.

Install only files from this project's release page after checking their checksums; if blocked, verify the source before using the operating system's option to allow the app.

Full changelog

🙌 感谢贡献者

感谢 @1lck 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck for contributing to this release.

Viff v0.1.0

中文

Viff 发布首个正式版。本次修复了 Windows 上控制台黑框连续闪现的问题，新增 macOS Intel 安装包，并带来本地事件日志、崩溃记录和诊断包导出。

下载

• 项目主页
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · 安装 EXE
• Linux x64 · DEB
• Linux x64 · 便携包
• SHA-256 校验值
• 全部下载文件

重点更新

本次从预发布转为正式版，保持 Go 与 Viva 的轻量原生形态，不捆绑 Electron 或浏览器运行时；集中修复 Windows 使用体验，补齐 Intel Mac 安装包，并增强问题排查能力。

✨ 新功能

• macOS：新增 Intel 机型安装包，Apple Silicon 与 Intel 可分别下载对应的 DMG。
• 帮助菜单：新增“Report a Problem…”录制入口与诊断包导出，便于把问题整理成可分享的排查材料。
• 稳定性：新增本地崩溃记录，异常退出后再次启动会给出提示并支持导出。

⚡ 改进

• 品牌：应用图标统一为白底橙色图标，Windows 安装器与开始菜单同步更新。
• Windows：Git 命令在后台静默执行，不再打断当前操作。

🛠 修复

• Windows：修复打开应用后控制台黑框连续闪现、界面无法操作的问题。

升级说明

• macOS：按机型选择 Apple Silicon 或 Intel 的 DMG，退出旧版后打开 DMG，将 Viff.app 拖入“应用程序”并替换旧版。
• Windows：退出旧版后运行 x64 安装器，原 ZIP 解压目录可在确认迁移后删除。
• Debian/Ubuntu：执行 sudo apt install ./viff-v0.1.0-linux-amd64.deb。
• Linux 便携包：解压后进入新目录执行 ./viff，并自行安装所需系统库。
• Git 需单独安装并加入 PATH，Linux 系统库要求见发布指南。

兼容性与已知问题

• macOS 包要求 macOS 13 及以上，Apple Silicon 与 Intel 机型均可安装。
• macOS 应用使用 ad-hoc 签名，尚无 Developer ID 签名或公证，首次打开可能需要在系统设置中允许。
• Windows x64 安装器尚无 Authenticode 签名，系统可能显示安全提示。
• Linux x64 的 DEB 适用于 Debian/Ubuntu，其他发行版需自行满足便携包依赖。
• 本次未提供 Homebrew 安装方式或自动更新。
• 输入法、外部编辑器与各类显卡环境仍需在实际桌面环境继续验收。

仅安装来自本项目发布页且已核对校验值的文件；若系统拦截，请先确认来源，再使用系统提供的允许打开选项。

查看完整变更

---

English

Viff ships its first stable release. This version fixes the console windows that kept flashing over the Windows app, adds a macOS Intel package, and brings local event logs, crash reports, and diagnostic export.

Downloads

• Project homepage
• macOS Apple Silicon · DMG
• macOS Intel · DMG
• Windows x64 · Setup EXE
• Linux x64 · DEB
• Linux x64 · Portable archive
• SHA-256 checksums
• All downloads

Highlights

This is the first stable release. Viff keeps its lightweight native form built with Go and Viva, without Electron or a bundled browser runtime. It focuses on the Windows experience, adds an Intel Mac package, and improves troubleshooting.

✨ New features

• macOS: install the DMG that matches your Mac, with separate Apple Silicon and Intel packages.
• Help menu: record a problem with “Report a Problem…” and export a diagnostic bundle to share.
• Stability: local crash reports appear on the next launch after an abnormal exit and can be exported.

⚡ Improvements

• Branding: the application icon is now the orange-on-white Viff mark on every platform, including the Windows installer and Start menu.
• Windows: Git commands run silently in the background instead of interrupting your work.

🛠 Fixes

• Windows: fix console windows flashing repeatedly after launch and making the application unusable.

Upgrade instructions

• macOS: choose the Apple Silicon or Intel DMG, quit the old version, open the DMG, and replace Viff.app in Applications.
• Windows: quit the old version and run the x64 installer before removing any obsolete ZIP extraction directory.
• Debian/Ubuntu: run sudo apt install ./viff-v0.1.0-linux-amd64.deb.
• Linux portable: extract the archive, enter its directory, and run ./viff after installing the required system libraries.
• Install Git separately on PATH, and check the release guide for Linux dependencies.

Compatibility and known issues

• The macOS package requires macOS 13 or later and runs on both Apple Silicon and Intel Macs.
• The macOS app is ad-hoc signed, without Developer ID signing or notarization, so the first launch may require approval in System Settings.
• The Windows x64 installer is not Authenticode signed, so Windows may show a security warning.
• The Linux x64 DEB targets Debian/Ubuntu, while other distributions must provide the portable archive's dependencies.
• This release does not provide Homebrew installation or automatic updates.
• Input methods, external editors, and graphics configurations still need further acceptance on real desktops.

Install only files from this project's release page after checking their checksums; if blocked, verify the source before using the operating system's option to allow the app.

Full changelog

🙌 感谢贡献者

感谢 @1lck 为本次发布作出的贡献。

🙌 Contributors

Thanks to @1lck for contributing to this release.

Viff v0.1.0-alpha.2

Lightweight native Git desktop client / 轻量原生 Git 桌面客户端

Viff uses Go + Viva, without Electron, a WebView, or a bundled browser runtime.
Viff 使用 Go + Viva，无 Electron、WebView 或内置浏览器运行时。

This release corrects the ZIP-only distribution in alpha.1 with native installation formats:
本次修正 alpha.1 仅提供 ZIP 的交付方式，补齐三平台安装包：

Platform / 平台	Package / 安装包
macOS 13+, Apple Silicon arm64	DMG — drag Viff.app to Applications / 拖入应用程序目录
Windows x64	setup.exe — per-user installation and uninstaller / 当前用户安装与卸载
Debian/Ubuntu x64	DEB — sudo apt install ./viff-*.deb
Linux x64	tar.gz — extract and run ./viff / 解压后运行

Install Git separately. The DEB declares rendering dependencies; portable Linux users should follow the README dependency instructions. All packages include license notices. Verify downloads with SHA256SUMS.
需另行安装 Git。DEB 声明了渲染库依赖；Linux 便携包请按照 README 安装系统依赖。所有安装包均保留许可声明，并提供 SHA256SUMS 校验。

Validation: three-platform Git and Viva headless UI CI, DMG bundle/mount checks, Windows silent install/uninstall and registry checks, and Linux DEB install/remove plus portable archive checks. These checks do not open application windows.
验证包括三平台 Git 与 Viva 无头 UI CI、DMG 挂载及应用目录检查、Windows 静默安装卸载和注册表检查、Linux DEB 安装移除及便携包检查，全程不打开应用窗口。

Pre-release limitations: macOS is ad-hoc signed, not Developer ID signed or notarized; Windows is not Authenticode signed. Full interactive Windows/Linux desktop acceptance remains open. These packages target the architectures listed above.
预发布限制：macOS 仅使用临时签名，未经过 Developer ID 签名或公证；Windows 未经过 Authenticode 签名。Windows/Linux 完整交互式桌面验收尚未完成，仅支持上表架构。