# Changelog

本项目的所有重要变更都记录在这里。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。

## [Unreleased]

## [0.1.0] - 2026-10-19

首个公开版本。

### Added

- **按 host 的出网决策**：`inherit` / `direct` / `proxy` 三种通路，命中规则时按 host 选择直连、HTTP(S) 代理或 SOCKS5。
- **客户端指纹**：`none` / `codex` / `claude-code` / `custom`，在传输边界改写 `user-agent`、`originator`、`x-app` 等头；`claude-code` 支持可选的 1M 上下文 beta（`anthropic-beta: context-1m-2025-08-07`，多值累加而非覆盖）。
- **设置页「网络路由」**（`settings.section`，order 72）：默认策略、代理池、按 provider 的规则、最近路由决策。
- **矩阵探测**：`直连 / 每个代理` × `不伪装 / Codex / Claude Code（/ + 1M）`，区分 `ok`、`client-gate`、`context-gate`、`auth`、`model-error`、`timeout`、`network-error`、`http-error`，并对推荐姿势复测一次。
- **真实推理端点校验**：可切换为 `POST /chat/completions`（`max_tokens: 1`），避免只看 `/models` 得出假结论。
- **配置体检**：`baseURL` 尾部空白归一化（探测与真实请求共用 `normalizeRequestUrl`）、规则与当前 host 的漂移检测与一键同步。
- **零依赖传输层**：直连、HTTP(S) 代理（绝对 URI 与 `CONNECT`）、SOCKS5（含认证、TLS、重定向、`AbortSignal`），只实现 HTTP/1.1。
- **规则持久化**：`$DSH_HOME/net-router/rules.json`，临时文件 + rename 原子替换，容忍 BOM；patch 声明式规则与界面规则合并，文件优先。
- **命令行**：`scripts/probe-cli.mjs` 可驱动运行中的插件，或独立探测任意端点；`--api-key-ref` 从 `.credentials.yaml` 取 key，避免写进 shell 历史。
- 82 个测试用例（78 通过、4 个联网集成用例默认 skip），覆盖规则、传输、拦截、探测分类与客户端 bundle 渲染。

[Unreleased]: https://github.com/dyh886/dsh-llm-net-router/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/dyh886/dsh-llm-net-router/releases/tag/v0.1.0