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.
Rust ai-agentsai-gatewayclaude-codecodexcoding-agentcost-optimizationdeepseekllm-gatewayllm-routerlocal-firstmodel-routingrusttask-routingtauri
release: publish HiRoute 0.2.0 and update installation guidance (#51)
澄潭c23828a78cc9
diff --git a/README.md b/README.mdindex 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 intoApplications, 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`:```shcurl -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.mdindex 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`,安装到当前用户目录:```shcurl -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.mdindex 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:```shcurl -fsSL https://hiroute.ai/install.sh | shdiff --git a/apps/website/content/guides/install-linux.zh.md b/apps/website/content/guides/install-linux.zh.mdindex 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 包发布后,运行:+运行以下命令安装最新稳定版:```shcurl -fsSL https://hiroute.ai/install.sh | shdiff --git a/apps/website/data/releases.json b/apps/website/data/releases.jsonindex 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.mdindex 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 oform one control and execution loop. It uses the same-UID local trust boundary, needs nosecond “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 notprovide a system-wide multi-user install, a Windows installer, runtime downloads, or automaticupdates. macOS can use the same candidate-package mechanism, but this page and the Quickstartare 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, thenbuilds a reproducible archive and companion manifest:```sh@@ -25,7 +39,7 @@ python3 scripts/collect-third-party-licenses.py \--output /absolute/output/noticespython3 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 jsonThe 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 riskacceptance. 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 recoverydiff --git a/docs/standalone-cli.zh-CN.md b/docs/standalone-cli.zh-CN.mdindex 619403d6..2e333a78 100644--- a/docs/standalone-cli.zh-CN.md+++ b/docs/standalone-cli.zh-CN.md@@ -6,12 +6,26 @@ Standalone 是不安装 Desktop 时的单用户运行方式。正式 `hiroute` Crole-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/noticespython3 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、多监听器和防火墙管理。## 常见错误与恢复