Skip to content

Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.

release: publish HiRoute 0.2.0 and update installation guidance (#51)

澄潭c23828a78cc9
diff --git a/README.md b/README.md
index 1e79681d..840b73ee 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,7 @@ previous decision. Choosing again can also keep the same model; cache reuse depe
## News
+- **2026-10-08 · HiRoute 0.2.0** — Stable release with built-in decision models, expanded Agent integrations, and macOS/Linux packages for x86_64 and ARM64. [Release notes](https://github.com/higress-group/HiRoute/releases/tag/v0.2.0) · [Download](https://hiroute.ai/en/download/)
- **2026-10-04** — [GPT-6 Astra × Qwen-3.8 Flash: same quality at 90% lower cost](news/2026-10-04-astra-qwen.en.md). [Website article](https://hiroute.ai/en/news/astra-qwen-smart-routing/) · [Experiments](experiments/README.md)
- [All news](news/README.md)
@@ -59,12 +60,12 @@ for connecting your own decision service.
Download the current DMG from [hiroute.ai](https://hiroute.ai/download/), drag HiRoute into
Applications, and follow the [self-signed package instructions](docs/macos-installation.md) if
-macOS asks for manual approval. The download page is the authority for validated operating
-systems and architectures.
+macOS asks for manual approval. HiRoute 0.2.0 supports macOS 15 or later on Apple silicon
+(`arm64`) and Intel (`x86_64`).
### Linux headless
-Install the current-user CLI and daemon without `sudo`:
+Install the current-user CLI and daemon on Linux `x86_64` or ARM64 (`aarch64`) without `sudo`:
```sh
curl -fsSL https://hiroute.ai/install.sh | sh
@@ -184,9 +185,9 @@ production owners and representative tests.
## Project status
-HiRoute is an MVP. Platform and architecture claims are tied to the evidence for each release;
-source availability does not imply that every environment has been validated. Current Agent
-integrations and planned directions remain separate on the [website](https://hiroute.ai/).
+HiRoute 0.2.0 is a stable release with macOS Desktop and Linux headless packages for both
+x86_64 and ARM64. Download the latest version and read the release notes on the
+[website](https://hiroute.ai/en/download/).
HiRoute is licensed under the [Apache License 2.0](LICENSE). Use
[GitHub Issues](https://github.com/higress-group/HiRoute/issues) for bugs and feature requests.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 8285cfa6..27206887 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -34,6 +34,7 @@ HiRoute 是长程 Agent 的本地控制与执行层。它把模型来源、可
## News · 最新动态
+- **2026-10-08 · HiRoute 0.2.0** — 稳定版本:内置决策模型、更多 Agent 集成,以及 macOS/Linux 双架构安装包。[版本说明](https://github.com/higress-group/HiRoute/releases/tag/v0.2.0) · [下载](https://hiroute.ai/download/)
- **2026-10-04** — [HiRoute 智能路由实战:GPT-6 Astra × Qwen-3.8 Flash,同等质量下成本降低 90%](news/2026-10-04-astra-qwen.zh-CN.md)。[官网阅读](https://hiroute.ai/news/astra-qwen-smart-routing/) · [复现实验](experiments/README.md)
- [全部新闻](news/README.md)
@@ -55,12 +56,12 @@ HiRoute 当前提供固定模型、智能省钱、自定义分支和免费优先
### macOS Desktop
从 [hiroute.ai](https://hiroute.ai/download/) 下载当前 DMG,拖入“应用程序”目录。如果 macOS
-要求手动批准,请按[自签名安装说明](docs/macos-installation.zh-CN.md)操作。每个版本已验证的系统和
-架构以下载页为准。
+要求手动批准,请按[自签名安装说明](docs/macos-installation.zh-CN.md)操作。HiRoute 0.2.0 支持
+macOS 15 或更高版本,提供 Apple 芯片(`arm64`)与 Intel(`x86_64`)安装包。
### Linux 无界面版
-无需 `sudo`,安装到当前用户目录:
+支持 Linux `x86_64` 与 ARM64(`aarch64`),无需 `sudo`,安装到当前用户目录:
```sh
curl -fsSL https://hiroute.ai/install.sh | sh
@@ -165,8 +166,8 @@ npm run build
## 项目状态
-HiRoute 当前处于 MVP 阶段。平台和架构声明与每个版本的验证证据绑定;源码存在不代表所有环境均已
-验收。当前可用的 Agent 集成与后续方向会在[官网](https://hiroute.ai/)中明确区分。
+HiRoute 0.2.0 是稳定版本,提供 macOS Desktop 与 Linux 无界面版,两种平台均支持 x86_64 和
+ARM64。最新安装包与版本说明见[官网](https://hiroute.ai/download/)。
HiRoute 使用 [Apache License 2.0](LICENSE)。缺陷和功能建议请提交到
[GitHub Issues](https://github.com/higress-group/HiRoute/issues)。安全问题和 crash report 请按
diff --git a/apps/website/content/guides/install-linux.en.md b/apps/website/content/guides/install-linux.en.md
index a3b3fc7a..76b56242 100644
--- a/apps/website/content/guides/install-linux.en.md
+++ b/apps/website/content/guides/install-linux.en.md
@@ -2,11 +2,11 @@
HiRoute headless installs the local service, Gateway, CLI, and Agent management Skill for the current user. It is designed for servers, remote workstations, and automation environments without a desktop UI. It is not a reduced read-only client: model sources, smart routes, Agent connections, session observation, and task delegation are all available through the CLI.
-The current public product validation covers Linux on `x86_64` and `aarch64`. Installation needs no `sudo`; it requires `curl`, Python 3, and a glibc Linux environment capable of running the HiRoute binaries.
+Linux packages support `x86_64` and ARM64 (`aarch64`). Installation needs no `sudo`; it requires `curl`, Python 3, and a glibc Linux environment capable of running the HiRoute binaries.
## 1. Install
-After the first stable Linux package is published, run:
+Run this command to install the latest stable release:
```sh
curl -fsSL https://hiroute.ai/install.sh | sh
diff --git a/apps/website/content/guides/install-linux.zh.md b/apps/website/content/guides/install-linux.zh.md
index f09e2c61..a602b157 100644
--- a/apps/website/content/guides/install-linux.zh.md
+++ b/apps/website/content/guides/install-linux.zh.md
@@ -2,11 +2,11 @@
Linux 无界面版把 HiRoute 的本机服务、Gateway、CLI 和 Agent 管理 Skill 安装到当前用户目录,适合服务器、远程工作站和无图形界面的自动化环境。它不是精简的只读客户端:模型来源、智能路由、Agent 接入、会话观测和任务委派都可以从 CLI 完成。
-当前公开产品验证以 Linux 为准,支持 `x86_64` 和 `aarch64`。不需要 `sudo`;需要 `curl`、Python 3,以及能够运行 HiRoute 二进制的 glibc Linux 环境。
+Linux 安装包支持 `x86_64` 和 ARM64(`aarch64`)。不需要 `sudo`;需要 `curl`、Python 3,以及能够运行 HiRoute 二进制的 glibc Linux 环境。
## 1. 安装
-首个稳定 Linux 包发布后,运行:
+运行以下命令安装最新稳定版:
```sh
curl -fsSL https://hiroute.ai/install.sh | sh
diff --git a/apps/website/data/releases.json b/apps/website/data/releases.json
index 241b4feb..98b9802d 100644
--- a/apps/website/data/releases.json
+++ b/apps/website/data/releases.json
@@ -1,13 +1,74 @@
{
"schema": "hiroute.website.releases/v2",
"releases": [
+ {
+ "version": "0.2.0",
+ "channel": "stable",
+ "published_at": "2026-10-08T12:55:25Z",
+ "notes": {
+ "zh": "HiRoute 0.2.0 稳定版本:内置决策模型与自定义任务分支,按执行组比较阶段胜任度,扩展 Qoder、Pi 和 DeepSeek Harness 等 Agent 集成,改进流式输出与任务续接,并提供 macOS 和 Linux 的 x86_64 / ARM64 安装包。",
+ "en": "HiRoute 0.2.0 stable release: built-in decision models and custom task branches, competence comparison by execution group, expanded Agent integrations including Qoder, Pi, and DeepSeek Harness, improved streaming and continuations, and x86_64 / ARM64 installers for macOS and Linux."
+ },
+ "artifacts": [
+ {
+ "kind": "desktop",
+ "platform": "macOS",
+ "architecture": "arm64",
+ "format": "dmg",
+ "minimum_os": "15.0",
+ "distribution": "self-signed",
+ "filename": "HiRoute-0.2.0-bfb8edb4ab9d-macos-arm64-trial.dmg",
+ "sha256": "cd72bf30bf05d1daf459f60ca8d246b82fa3a5a72950466a74f3ee909049c45a",
+ "size": 80973041
+ },
+ {
+ "kind": "desktop",
+ "platform": "macOS",
+ "architecture": "x86_64",
+ "format": "dmg",
+ "minimum_os": "15.0",
+ "distribution": "self-signed",
+ "filename": "HiRoute-0.2.0-bfb8edb4ab9d-macos-x86_64-trial.dmg",
+ "sha256": "ca18ef89a193e142d11a0aaf88aa98602227547735f18a9c20cb9ce853b8cd04",
+ "size": 87918623
+ },
+ {
+ "kind": "standalone",
+ "platform": "Linux",
+ "architecture": "x86_64",
+ "target": "x86_64-unknown-linux-gnu",
+ "format": "tar.gz",
+ "distribution": "unsigned",
+ "filename": "hiroute-0.2.0-bfb8edb4ab9d-x86_64-unknown-linux-gnu.tar.gz",
+ "sha256": "03492a9fc45035589fb7280a4ed164b2f6ad49ac877582b12f68688b725bf57d",
+ "size": 66626440,
+ "manifest_filename": "hiroute-0.2.0-bfb8edb4ab9d-x86_64-unknown-linux-gnu.tar.gz.json",
+ "manifest_sha256": "b0b78970e232f49788ad8751326f24f65a222ba7f555f35e148e01eef72dbaa3",
+ "manifest_size": 2121
+ },
+ {
+ "kind": "standalone",
+ "platform": "Linux",
+ "architecture": "aarch64",
+ "target": "aarch64-unknown-linux-gnu",
+ "format": "tar.gz",
+ "distribution": "unsigned",
+ "filename": "hiroute-0.2.0-bfb8edb4ab9d-aarch64-unknown-linux-gnu.tar.gz",
+ "sha256": "06f9c7aa08db255b82039c85c61f780d902bf0ab631cd0245817539496e53902",
+ "size": 62540657,
+ "manifest_filename": "hiroute-0.2.0-bfb8edb4ab9d-aarch64-unknown-linux-gnu.tar.gz.json",
+ "manifest_sha256": "fcf983baca2f9ec448149a18df258a41f979c2c97a4863023a92d01d8d2bb9a9",
+ "manifest_size": 2123
+ }
+ ]
+ },
{
"version": "0.1.0",
"channel": "stable",
"published_at": "2026-09-22T07:41:14Z",
"notes": {
- "zh": "HiRoute 首个公开 MVP:提供 macOS 桌面应用、Linux 无界面 CLI、智能模型路由、Agent 任务路由与可扩展 Decision API。",
- "en": "HiRoute's first public MVP with macOS Desktop, Linux headless CLI, intelligent model routing, Agent task routing, and an extensible Decision API."
+ "zh": "HiRoute 首个公开版本:提供 macOS 桌面应用、Linux 无界面 CLI、智能模型路由、Agent 任务路由与可扩展 Decision API。",
+ "en": "HiRoute's first public release with macOS Desktop, Linux headless CLI, intelligent model routing, Agent task routing, and an extensible Decision API."
},
"artifacts": [
{
diff --git a/docs/standalone-cli.md b/docs/standalone-cli.md
index b7db02a7..c3062738 100644
--- a/docs/standalone-cli.md
+++ b/docs/standalone-cli.md
@@ -7,15 +7,29 @@ CLI, role-all `hirouted` daemon, Local Control, Gateway, business storage, and o
form one control and execution loop. It uses the same-UID local trust boundary, needs no
second “CLI management token,” and exposes no second Agent-management API.
-The MVP does not allow standalone and HiRoute Desktop to run at the same time. It does not
+Standalone and HiRoute Desktop must not manage the same user installation at the same time. It does not
provide a system-wide multi-user install, a Windows installer, runtime downloads, or automatic
updates. macOS can use the same candidate-package mechanism, but this page and the Quickstart
are validated for Linux.
-## Candidate installation
+## Installation
-This repository does not declare an official download URL. A distributor or integrator
-prepares `hiroute`, `hirouted`, and the pinned CPA from one exact committed candidate, then
+Install the latest stable Linux package for `x86_64` or ARM64 (`aarch64`) from
+[hiroute.ai](https://hiroute.ai/en/download/):
+
+```sh
+curl -fsSL https://hiroute.ai/install.sh | sh
+hiroute service start --output json
+hiroute system status --output json
+```
+
+The installer verifies the package and installs for the current user. It does not start
+the service automatically. See the [Linux installation guide](https://hiroute.ai/en/docs/install-linux/)
+for host prerequisites and service management.
+
+## Build a candidate package
+
+A distributor or integrator prepares `hiroute`, `hirouted`, and the pinned CPA from one exact committed candidate, then
builds a reproducible archive and companion manifest:
```sh
@@ -25,7 +39,7 @@ python3 scripts/collect-third-party-licenses.py \
--output /absolute/output/notices
python3 scripts/package-standalone.py build \
- --version 0.1.0 --revision FULL_COMMIT_SHA \
+ --version 0.2.0 --revision FULL_COMMIT_SHA \
--target x86_64-unknown-linux-gnu \
--hiroute /absolute/path/hiroute \
--hirouted /absolute/path/hirouted \
@@ -555,7 +569,7 @@ hiroute gateway recover --output json
The first automatically chosen port is persisted. Local management clients see a
`0.0.0.0` listener as `127.0.0.1:<port>`. A non-loopback address requires explicit risk
acceptance. HiRoute never changes a firewall, configures TLS, or manages a remote Agent.
-IPv6, multiple listeners, and firewall management are outside the MVP.
+IPv6, multiple listeners, and firewall management are not supported.
## Common errors and recovery
diff --git a/docs/standalone-cli.zh-CN.md b/docs/standalone-cli.zh-CN.md
index 619403d6..2e333a78 100644
--- a/docs/standalone-cli.zh-CN.md
+++ b/docs/standalone-cli.zh-CN.md
@@ -6,12 +6,26 @@ Standalone 是不安装 Desktop 时的单用户运行方式。正式 `hiroute` C
role-all daemon、Local Control、Gateway、业务存储和观测共同组成控制与运行闭环。它沿用同 UID
本机信任边界,不需要额外的“CLI 管理 token”,也不提供第二套 Agent 管理 API。
-MVP 不允许 standalone 与 HiRoute Desktop 同时运行,不提供系统级多用户安装、Windows 安装、
+Standalone 与 HiRoute Desktop 不应同时管理同一用户的安装,不提供系统级多用户安装、Windows 安装、
运行时下载或自动更新。macOS 可使用相同候选包机制,但本页验证与 Quickstart 以 Linux 为准。
-## 安装候选
+## 安装
-本仓库不声明官方下载地址。发行或集成方从精确 committed candidate 准备 `hiroute`、
+从 [hiroute.ai](https://hiroute.ai/download/) 安装适用于 `x86_64` 或 ARM64(`aarch64`)的
+最新稳定 Linux 版本:
+
+```sh
+curl -fsSL https://hiroute.ai/install.sh | sh
+hiroute service start --output json
+hiroute system status --output json
+```
+
+安装器会校验安装包并安装到当前用户目录,不会自动启动服务。主机要求和服务管理见
+[Linux 安装指南](https://hiroute.ai/docs/install-linux/)。
+
+## 构建候选包
+
+发行或集成方从精确 committed candidate 准备 `hiroute`、
`hirouted` 和固定版本 CPA,再生成可复现归档及伴随 manifest:
```sh
@@ -21,7 +35,7 @@ python3 scripts/collect-third-party-licenses.py \
--output /absolute/output/notices
python3 scripts/package-standalone.py build \
- --version 0.1.0 --revision FULL_COMMIT_SHA \
+ --version 0.2.0 --revision FULL_COMMIT_SHA \
--target x86_64-unknown-linux-gnu \
--hiroute /absolute/path/hiroute \
--hirouted /absolute/path/hirouted \
@@ -510,7 +524,7 @@ hiroute gateway recover --output json
`set` 保存 desired 后重启,并只在真实 ready 后推进 applied。自动端口首次选定后持久化;
`0.0.0.0` 对本机管理客户端显示为 `127.0.0.1:<port>`。非 loopback 配置要求显式风险确认。
-HiRoute 不自动修改防火墙、TLS 或远端 Agent。IPv6、多监听器和防火墙管理不在 MVP。
+HiRoute 不自动修改防火墙、TLS 或远端 Agent。暂不支持 IPv6、多监听器和防火墙管理。
## 常见错误与恢复