Alhaitham DNS Proxy 0.2 (46)已发布
https://testflight.apple.com/join/r8yjKr4P

Alhaitham Dashboard 0.4 (142)已发布
https://testflight.apple.com/join/pR1xwCfB

公共更新：
改进了策略与流视图，配置的策略和 DNS 服务器可以正确显示
改进了 DNS 记录视图，因策略被阻止的 DNS 请求状态可以正确显示

Per-App VPN + App Proxy 跑通咯

Alhaitham DNS Proxy 0.2 (49)已发布
https://testflight.apple.com/join/r8yjKr4P

Alhaitham Dashboard 0.4 (145)已发布
https://testflight.apple.com/join/pR1xwCfB

公共更新：
1. 流（Flow）不再储存匹配到的规则快照，而是直接连接到匹配到的策略（Policy）
2. 改进了策略（Policy）与流（Flow）视图
- 长按流（Flow）的行，会展开显示流与对应策略（Policy）的详情
- 流（Flow）的详情页面也可以直接跳转到匹配的策略页面
- 分流页面逻辑优化，提升加载速度
3. 更新更多翻译文本与翻译方式

App Proxy 更新：
1. Extension 启动逻辑与 DNS Proxy Extension 对齐

已知问题：
1. 流（Flow）如果没有匹配到任何策略（Policy），就算使用了默认策略，也不会关联到流（Flow），目前显示为 策略(不适用） 标签

Alhaitham DNS Proxy 0.2 (50)已发布
https://testflight.apple.com/join/r8yjKr4P

Alhaitham Dashboard 0.4 (146)已发布
https://testflight.apple.com/join/pR1xwCfB

公共更新：
1. 流（Flow）读写统计数据（字节数）现在正常回写数据库，在流（Flow）的相关视图可以看到读写的字节数
2. 流管理器现在采用延迟写入，每 200 ms 保存一次更新，以节省 CPU 使用、降低磁盘读写频率
3. 流（Flow）命中的默认策略现在正确回写

App Proxy 更新：
1. 新增 PASS (Passthrough/穿透）策略，此模式下不经过任何处理引擎，原样转发数据
- 与 DIRECT （直连）策略是不同的，DIRECT 依旧会经过处理引擎识别解析协议及内容

Alhaitham App Proxy 0.1 (3) 已发布

Alhaitham DNS Proxy 0.3 (53) 已发布
https://testflight.apple.com/join/r8yjKr4P
Alhaitham Dashboard 0.4 (149) 已发布
https://testflight.apple.com/join/pR1xwCfB

# 公共更新

## 新增：事务（Transaction）体系
- 相当于 Surge 的请求 Request 或 Clash 的连接 Connection
- 支持统一查看全部事务，也可以分别查看 HTTP 事务、DNS 事务与应用层（AppLayer）事务

## 新增：应用层（AppLayer）事务识别
- 应用层（AppLayer）事务是从原始 TCP/UDP 流量中分析、识别、拼接并还原出的上层协议请求/响应
- HTTP 事务会还原为具体的 HTTP 请求/响应
- DNS 事务会还原为具体的 DNS 查询/响应
- 暂时无法识别的流量会记录为兜底（Fallback）事务，方便后续排查

## 新增：事务详情页
- 支持查看基础信息、请求/响应内容、统计信息、端点（Endpoint）、DNS 生存时间（TTL）与过期时间等信息

## 新增：事务统计与管理入口
- 新增事务统计卡片、侧栏分组、搜索、筛选与缓存清理入口

## 新增：聚合外观设置页
- 新增全部流（All Flow）与全部事务（All Transaction）外观设置页
- 可以在一个入口内切换不同类型并调整显示样式

## 新增：HTTP 与 DNS 数据视图
- 仪表盘（Dashboard）、应用代理（App Proxy）、DNS 代理（DNS Proxy）的聚焦页面现在可以直接进入对应数据页面

## 改进：外观设置页面布局
- iOS 预览与分页内容不再被拉伸
- macOS 预览区和设置列宽恢复对齐

## 改进：状态与本地化显示
- 改进流（Flow）、策略（Policy）、DNS、事务（Transaction）的状态展示与本地化文本
- 减少 N/A、空白状态和错误状态显示不一致的问题

## 改进：运行期数据写入性能
- 流（Flow）、DNS、事务（Transaction）等运行期数据改为按唯一标识（uid）持续写回
- 通过写入队列与节流保存降低频繁读写带来的卡顿

## 改进：生命周期收尾保存
- 提供器（Provider）停止与休眠时会显式落盘待保存数据
- 减少短时间统计数据、事务状态或缓存数据丢失的情况

## 修复：底部附属视图宽度
- 修复底部附属视图（Bottom Accessory）处于内联（inline）状态时，分段选择器或策略底部控件宽度溢出的问题

## 调整：共享（Shared）数据源结构
- 移除独立连接（Connection）页面
- 连接相关展示合并到事务与流体系中

# Alhaitham 应用代理（App Proxy）0.1 (3)

## 新增：应用层（AppLayer）事务记录
- 直连（DIRECT）转发下可以记录 HTTP、DNS 以及无法识别协议的兜底（Fallback）事务
- 应用层（AppLayer）事务会从原始 TCP/UDP 流量中分析、识别、拼接并还原出上层协议请求/响应
- 例如 HTTP 事务会还原为具体的 HTTP 请求/响应，DNS 事务会还原为具体的 DNS 查询/响应

## 新增：聚焦页面
- 新增应用流（App Flow）、事务（Transaction）、HTTP 聚焦页面
- 可以在应用代理（App Proxy）内直接查看流量、事务与 HTTP 数据

## 新增：设置入口
- 设置页新增统一事务外观设置入口
- 设置页新增事务缓存清理入口

## 改进：转发管线
- 重构转发管线，统一 TCP/UDP 转发入口
- 修复部分连接释放、等待就绪与响应写回问题

## 改进：流执行器（Flow Actor）生命周期
- 每个流（Flow）独立持有运行期对象
- 持久化写回由管理器统一处理

## 修复：启动残留数据
- 启动时会清理旧应用流（App Flow）、HTTP 事务与应用层（AppLayer）事务
- 避免上次运行残留数据影响本次显示

## 已知问题：应用代理仍处于早期测试阶段
- 部分无法识别的应用层（AppLayer）协议会以兜底（Fallback）事务展示

# Alhaitham DNS 代理（DNS Proxy）0.3 (53)

https://testflight.apple.com/join/r8yjKr4P

## 新增：事务聚焦页
- 恢复并改进事务聚焦页
- 现在可以查看 DNS 流（DNS Flow）、DNS 事务与 DNS 模型数据

## 新增：设置入口
- 设置页新增统一事务外观设置入口
- 设置页新增事务缓存清理入口

## 改进：DNS 缓存
- 改进 DNS 缓存查询与命中逻辑
- 修复缓存响应 ID、缓存 payload 回读与服务器选择相关问题

## 改进：DNS 报文解析
- 改进 DNS 报文解析
- 修复压缩指针截断、循环指针、DNS over TCP 解析模式等问题

## 修复：DNS 解析失败记录缺失
- DNS 解析失败时也会记录兜底（Fallback）事务
- 方便后续排查异常请求

# Alhaitham 仪表盘（Dashboard）0.4 (149)

https://testflight.apple.com/join/pR1xwCfB

## 新增：全部事务（All Transaction）入口
- 新增全部事务入口
- 接入 HTTP、DNS、应用层（AppLayer）事务的独立页面

## 新增：聚合外观设置入口
- 外观设置入口合并为全部流（All Flow）、DNS、全部事务（All Transaction）、DNS 策略（DNS Policy）等聚合入口
- 减少应用流（App Flow）、DNS 流（DNS Flow）、V1 事务分散入口

## 改进：全部事务（All Transaction）外观设置
- 全部事务外观设置支持 V1 应用层（AppLayer）事务
- 在可用系统上显示 HTTP、DNS 等事务类型的预览与分段设置

## 改进：Surge / Clash / Stash 数据导入
- HTTP、DNS、应用层（AppLayer）事务分开写入
- 批量写入速度提升

## 改进：概览页
- 概览页新增 DNS 与事务相关卡片
- 调整流（Flow）、策略（Policy）、DNS、事务（Transaction）的展示顺序

## 改进：设置页
- iOS 与 macOS 设置页接入共享（Shared）DNS
- 新增事务缓存、流外观与事务外观设置入口

## 修复：非共享（Non-Shared）DNS 数据显示
- 非共享数据源继续使用 V1 内存模型
- 修复 DNS V1 写入与混用 V1/V2 schema 导致的数据不显示问题

# 本次更新说明

本次更新距离上次发布已经过去约半个月，期间累计接近 400 次提交。更新规模较大，重点不只是增加页面或修复显示问题，而是对底层架构、数据处理方式和持久化方式做了一轮完整调整。

本轮更新确立了新的三层数据储存架构：流（Flow）、事务（Transaction，相当于 Surge 的请求 Request 或 Clash 的连接 Connection）与应用模型。流（Flow）负责描述网络连接与传输过程，事务（Transaction）负责记录从流量中识别、拼接并还原出的请求/响应，而应用模型则用于保存那些需要长期复用、或者脱离单个流与单个事务后依然有价值的数据。

同时，本次更新完全分离了数据库读写与数据处理线程。数据处理过程不再直接被数据库操作拖慢，运行期数据会通过管理器、写入队列与节流保存机制持续写回。实测在当前设计下，请求记录模式可以长期保持开启：系统会持续嗅探、识别、拼接并保存每一个请求，包括 UDP 流量中的请求/响应。

应用模型是这次架构调整中比较重要的一层。它用于保存需要长期存在、或者未来处理流式数据时可能需要跨事务引用的数据。目前 HTTP 应用模型会保存捕获到的 HTTP 请求与响应对数据，效果上接近 Surge 的捕获流量；DNS 应用模型会保存每个“服务器 + 请求”组合下不重复的响应，用作本机 DNS 缓存。

未来如果继续实现 WebSocket、HTTP/3 这类更长生命周期的代理转发，应用模型也可以继续承担上下文数据的保存工作。比如某些脚本修改、协议处理或流式数据分析，可能依赖当前事务之前已经出现、但并不属于当前事务本身的数据，这类数据就适合由应用模型承载。

目前应用代理（App Proxy）不会按端口提前排除未知应用层协议，而是会对所有暂时无法识别的应用层（AppLayer）数据包持续进行分析、分类、规则匹配与保存。即使在 App Proxy Provider 约 15 MB 的内存限制下，当前实现也已经能够稳定运行。

本项目不会优先实现 SS、V2Ray、Trojan 等传统代理协议。应用代理（App Proxy Provider）的接管优先级高于包隧道（Packet Tunnel Provider），可以与传统 VPN 同时启用，并位于其上游。因此，本项目更适合用来尝试解决传统 VPN 当前不涉及、或很难处理的问题；至于下游继续使用哪种 VPN 或代理协议，并不是本项目优先关心的重点。

如果后续确实需要完整的代理转发能力，本项目更可能会另行推出一款基于包隧道（Packet Tunnel Provider）的专用代理工具，而不是把传统代理协议优先塞进当前应用代理架构里。

Alhaitham App Proxy 0.1 (13) 已发布
https://testflight.apple.com/join/KVmQFXAA
Alhaitham DNS Proxy 0.3 (67) 已发布
https://testflight.apple.com/join/r8yjKr4P
Alhaitham Dashboard 0.4 (155) 已发布
https://testflight.apple.com/join/pR1xwCfB

## 主要更新

本次更新距离 main 基线约 26 天，累计 410 次提交。更新重点不是单纯增加页面，而是围绕 App Proxy Flow、事务体系、应用模型、Forwarder 调度与 SwiftData 写入边界进行了一轮完整重构。

## 公共更新

### Flow / Policy / Transaction 数据结构重构

- 统一 Flow 基础模型，回收旧 AppFlow / DNSFlow 分裂结构。
- Flow、Policy、Transaction 的展示、筛选、统计卡片与外观设置入口进一步合并。
- 运行期写入统一以 uid / pid 和轻量值类型为边界，减少模型快照和重复持久化字段。

### 应用层事务体系增强

- 支持 HTTP、DNS 与通用 AppLayer 事务的分层记录。
- 事务模型进一步区分传输层信息、应用层协议信息、请求/响应 payload 与长期可复用应用模型。
- HTTP 事务改为保留原始请求/响应字节，并通过 HTTP metadata 计算完整度与展示字段。

### TLS 元数据能力

- 新增 `DataProviderTLS`，引入 TLS Record / ClientHello 建模。
- Flow 可以展示 TLS ClientHello 相关元数据，例如 SNI。
- TLS 解析从 AppProxyFlow 内部逻辑迁移到 DataProvider / Shared 边界，便于复用和展示。

## App Proxy 更新

### AppProxyFlow 运行时结构重构

- AppProxyFlow 模块拆分为 Core、Routing、Relay、DNS、Transaction 等边界。
- TCP / UDP Relay 入口重新整理，Pipeline 层命名收敛为 Routing，App 叶子层收敛为 Relay。
- 修正 NEAppProxyFlow 空读 EOF 语义，避免把空数据当作普通 chunk 继续循环。

### TCP / HTTP Relay 改进

- HTTP Relay 改为通过 HTTPManager 增量写入请求与响应模型。
- 保留 HTTP relay 原始数据，修正 rawValue 保真、Content-Length、部分响应边界与空响应 EOF 语义。
- 应用层 Reject 支持按请求版本构造响应，并释放当前事务边界。

### UDP / DNS Relay 改进

- UDP relay 收敛为单入口和四模式调度。
- Forwarder 支持 UDP 数据报异步入队发送，DNS 转发切换到新的 Forwarder 池。
- DoH 路径切换到 URLSession manager，普通转发路径继续走 Forwarder manager。

## DNS Proxy 更新

- 改进 DNS over TCP 长度前缀识别与事务写入。
- 修正 system DNS endpoint 转发、空服务器 endpoint 兜底与 DNS 默认策略解析上下文。
- DNS 详情页、header flags、记录计数字段、可展开详情 Section 与事务页面展示均有调整。

## Dashboard / 数据视图更新

- 新增或改进 HTTP、DNS、Flow、Policy、Transaction 的聚焦页面、侧栏、筛选、统计卡片与外观设置。
- Dashboard 接入 App Proxy 默认策略设置、App Proxy DNS 设置、统一事务入口和缓存清理入口。
- Server 值结构、共享数据源清理、来源过滤与本地化资源同步更新。

Alhaitham App Proxy 0.1 () 已发布

Alhaitham DNS Proxy 0.4 () 已发布

Alhaitham Dashboard 0.4 (167) 已发布
https://testflight.apple.com/join/pR1xwCfB

## 主要更新

本次更新相对 main 基线累计 125 次提交，重点是重构 Dashboard 的远程服务管理，并完善 App Proxy、DNS 与事务详情的稳定性。

## Dashboard

### 远程服务器管理重构

- 全面更新 Clash、Stash 与 Surge 的远程服务配置。
- 支持为同一服务配置多个有序 Endpoint，并在连接失败时自动切换。
- Surge 现同时使用 HTTP 与 TCP 通道，提升策略、DNS 与流量数据的获取稳定性。
- API 凭据改由 Keychain 保存；启动时会自动清理已删除服务器遗留的凭据。
- 切换或编辑服务器时，修正 Policy 内容刷新、任务取消与凭据被误写的问题。

> 服务器配置已升级为新格式：更新后请重新添加现有远程服务器及其凭据。

### 数据与详情页面

- HTTP 事务详情改为分层展示，补充 URL、请求、响应与协议相关信息。
- DNS 详情页改为“一个记录一个折叠项”；iPhone/iPad 可折叠查看，macOS 保持完整展开。
- 改进详情折叠标题与摘要样式。
- Dashboard 的 DNS 统计会持续刷新，不再停留在旧数据。

## App Proxy 与 DNS Proxy

- 重构 App Proxy TCP Flow 处理流程，事务仅在数据实际写回应用侧后完成，改善记录状态与异常收尾的一致性。
- 修正连续 HTTP 消息的字节边界处理。
- DNS over TCP 现可正确关联同一连接中的多个请求与响应。
- 统一 Provider 的启动、休眠、唤醒与停止生命周期，避免尾部数据写入丢失。
- 修复首页统计卡片恢复与共享数据恢复流程。

## 稳定性与兼容性

- 修复旧系统上 SwiftData 继承模型唯一约束可能导致的崩溃。
- 修复 Dashboard、App Proxy 与 DNS Proxy 的 iPad 多任务方向配置。
- 清理旧 Xcode Framework 集成，统一改用 Swift Package 依赖，降低构建与嵌入配置问题。

# Alhaitham 下一版本更新

Alhaitham App Proxy 0.1 (20) 已发布
https://testflight.apple.com/join/KVmQFXAA
Alhaitham DNS Proxy 0.4 (81) 已发布
https://testflight.apple.com/join/r8yjKr4P
Alhaitham Dashboard 0.4 (169) 已发布
https://testflight.apple.com/join/pR1xwCfB

## 重要提示

1. Dashboard 升级了服务器配置与凭据储存结构。升级后，旧服务器配置及对应凭据会被清理，需要重新添加服务器。
2. Shared Store 数据模型有较大调整。如果旧数据库无法打开，请在“设置 → 开发者 → Shared Store Management”中手动重建。重建会删除原有记录。

## 公共更新

1. 升级转发内核至 Forwarder 2.2.0，重新整理 TCP、UDP 转发与数据处理流程。
2. 重构 Shared Store 加载与恢复流程，现在会明确显示打开、恢复、失败和就绪状态。
3. 重构 Flow、DNS、Policy 与 Transaction 的统计和持久化结构，修复部分统计卡片不刷新、层级列表显示异常及继承模型查询问题。
4. 重做 HTTP 详情页面，分别展示请求行、状态行、Headers、Body 与目标 Endpoint。
5. 修复连续 HTTP 消息的字节边界计算，提高 HTTP 请求与响应还原准确性。

## Dashboard 更新

1. 重做服务器管理：
- 每个服务器最多可以配置 4 个 Endpoint
- Endpoint 支持排序、单独启用或停用
- Surge 支持 TCP、HTTP 与 HTTPS
- Clash 和 Stash 支持 HTTP 与 HTTPS

2. 新增 Endpoint 故障转移：
- 按列表顺序尝试连接
- 当前 Endpoint 失败后自动切换至下一个
- 高优先级 Endpoint 恢复后自动切回
- 服务器列表会显示连接状态、当前连接方式及 Fallback 状态

3. 服务器 API 凭据改存 Keychain，并在启动、编辑和删除服务器时同步清理孤立凭据。

4. Surge 同时支持 TCP Controller 与 HTTP API：
- 同步连接、DNS、策略组、策略顺序与延迟测试结果
- 支持实时更新以及断线自动恢复
- 切换策略后会重新读取实际结果，避免显示未生效的目标

5. 区分 Clash 与 Stash 的连接数据语义，修复连接结束状态及不同服务器数据互相混入的问题。

6. 修复切换服务器时 Policy、DNS 与 Transaction 刷新任务残留的问题，并恢复 DNS 统计持续刷新。

7. 修复 iPad 分屏及多任务场景下的界面方向支持。

## App Proxy 更新

1. 重构 TCP 与 UDP Flow 的读取、写入、转发和收尾流程。
2. 修复取消 Flow 时系统读取或写入无法及时结束的问题。
3. 修复 EOF、连接错误及 Provider 停止时 Flow 和 Transaction 终态记录不完整的问题。
4. 改进 HTTP 与 DNS 协议识别及事务关联。
5. DNS 缓存响应现在会按照 TCP 或 UDP 的实际承载方式正确写回。
6. 支持 DNS over TCP 连续事务的响应关联，并记录最终使用的上游 DNS 服务器。

## DNS Proxy 更新

1. 统一 Provider、Flow、Transaction 与后台写入队列的生命周期，减少休眠、停止及重新打开时的残留状态。
2. 修复首页统计卡片与 DNS 统计刷新。
3. DNS、Flow、Transaction、Policy 和搜索页面现在会显示 Shared Store 的实际加载或失败状态。
4. Shared Store 打开失败时不再自动覆盖原数据库，可由用户在管理页面中选择重新打开、创建或重建。