a4agent 发行版 - Gitee.com

最新版

2026-09-16 04:32 v0.3.0 2a69284

# v0.3.0 · 控制台全面重构：layui Web UI

在 v0.2.1 基础上的界面架构重写版本：原生 WinForms 界面替换为与 a4api 一致设计语言的 Web 控制台（html + js + css + layui），整体配色与交互全面对齐 a4api 旗舰店柜台风格。

## 下载

| 文件 | 说明 |
| --- | --- |
| `a4agent-Lite-setup-v0.3.0.exe`（约 70 MB） | **推荐**。仅含启动器，首次运行向导按显卡自动下载 llama.cpp 官方引擎 |

安装包 SHA256：构建后由更新清单 `latest.json` 自动携带校验。

## 新增与变更

- **全新控制台 UI**：前端重构为 html + js + css + layui 静态页面，薄荷画布、无瑕白卡、发丝分隔线、状态绿独点，与 a4api 同一设计语言；状态 / 模型 / 设置 / 接入四个页面全部迁移
- **内嵌控制台服务**：应用内置 HttpListener（仅绑定 127.0.0.1:18080，端口占用自动顺延），前端以嵌入资源随单文件 exe 分发，REST API + SSE 实时日志流
- **WebView2 宿主**：主窗口内嵌 WebView2 渲染控制台（用户数据位于 `%LOCALAPPDATA%\a4agent\WebView2`）；Runtime 缺失时自动降级为系统浏览器打开同一地址
- **实时日志**：引擎输出经 SSE 推送毫秒级上屏，环形缓冲保留最近 800 行，断线自动重连补齐
- **目录选择器**：引擎目录 / 模型目录改为控制台内的目录浏览抽屉（浏览器无法直接获取本地路径，由本地 API 列目录）
- **应用内更新走 Web 流程**：检查更新 → 下载进度条 → 校验通过 → 确认安装并重启；不再使用原生更新弹窗
- **引擎缺失非阻塞引导**：启动时未检测到引擎不再弹原生对话框，改为控制台顶部警示条 + 一键重新运行向导
- **托盘行为不变**：关闭最小化到托盘、服务常驻、托盘菜单启停服务 / 打开控制台 / 打开 llama-server WebUI
- 常规：`--uitest` 冒烟保留；发布脚本清理 WebView2 附带的 Intellisense 文档

## 升级说明

- 配置文件、已下载引擎、模型目录完全兼容，安装器自动覆盖升级
- 控制台端口 18080 起自动寻找空闲端口；llama-server 服务端口（默认 8080）与局域网开关不受影响
- 开源协议：MIT；引擎二进制来自 [llama.cpp](https://github.com/ggml-org/llama.cpp) 官方发布，遵循其自身许可

最后提交信息为： chore(release): v0.3.0

v0.2.1 · 引擎自动接管与局域网地址修复

2026-09-12 19:30 v0.2.1 b3a362b

最后提交信息为： chore(release): v0.2.1

v0.2.0 · 首个开源版本

2026-09-12 13:53 v0.2.0 16f101c

# v0.2.0 · 首个开源版本

a4agent 正式开源！本地大模型推理控制台，一键把 `.gguf` 模型变成 **OpenAI 兼容的局域网 API 服务**（基于 llama.cpp `llama-server`）。

## 下载

| 文件 | 说明 |
| --- | --- |
| `a4agent-Lite-setup-v0.2.0.exe`（约 69 MB） | **推荐**。仅含启动器，首次运行向导按显卡自动下载 llama.cpp 官方引擎 |

安装包 SHA256：`AFEC779069F748E308E902E5E1DB990EB1F0A15B6CA1521DE29567854DA23877`
| 离线完整版（内置引擎） | 超出 Gitee 附件体积限制，请参考 README 自行打包：`installer/build.ps1 -Version 0.2.0` |

## 亮点

- **首次配置向导**：自动检测显卡 / 显存 / 驱动版本，推荐推理预设（上下文、KV 量化、MTP 投机解码），模型显存风险提示
- **引擎按需获取**：向导按硬件自动推荐并下载 llama.cpp 官方 Release（钉定 [b10919](https://github.com/ggml-org/llama.cpp/releases/tag/b10919)）：
  - Vulkan（30 MB，NVIDIA / AMD / Intel 通用）· CPU（18 MB）· CUDA 12.4 / 13.3（NVIDIA，按驱动版本自动选择，自动合并 cudart 运行库）
  - 下载先写临时目录、校验后原子换入，失败不污染现有目录；也支持离线指定引擎目录
- **图形化管理**：模型库扫描 + GGUF 元数据解析、引擎参数可视化调整、运行日志、托盘常驻
- **局域网开放开关**：设置页一键切换 `127.0.0.1` / `0.0.0.0`，接入页附 curl 与 openai SDK 示例
- **细节**：崩溃与端口占用检测、健康检查轮询、定时内存裁剪

## 说明

- 开源协议：[MIT](https://gitee.com/eogee/a4agent/blob/master/LICENSE)
- 引擎二进制来自 [llama.cpp](https://github.com/ggml-org/llama.cpp) 官方发布，遵循其自身许可
- 网络受限环境可在向导中改用"离线安装"，手动指定引擎目录

**Full Changelog**: 首个公开发布

最后提交信息为： feat: 开源首个版本，支持引擎自动检测下载与轻量安装包

eogee / a4agent .gitee-modal { width: 500px !important; }

搜索帮助

eogee / a4agent