把 AI 模型、渠道和 Agent，收进一个桌面窗口。
zen-gate 的 Windows 桌面重构版本 · Go + Win32 + WebView2
下载安装包 · 从 zen-gate 迁移 · 反馈问题 · 原版 zen-gate
Lamp Guide 基于 zen-gate 继续开发，将网关与桌面界面整合进一个进程。你可以在窗口里登录渠道、管理模型、配置代理、接入 Agent，并通过兼容 OpenAI / Anthropic 的本地入口调用模型。
项目关系： zen-gate 保留原版源码与发布记录；Lamp Guide 在本仓库独立迭代。两者版本号分别计算，Lamp Guide 1.2.0 是重构版版本号，不表示 zen-gate 1.10.0 的降级。当前重构版提供 Windows 10 / 11 x64 安装包；其他平台请使用原仓库。
| 功能 | 使用方式 |
|---|---|
| 完整桌面界面 | 服务、模型、聚合、渠道、供应商、OpenCode、联网、Agent、日志、设置，集中在侧栏 |
| 模型聚合 | 搜索模型名称、ID 或渠道，启用项优先显示，分页按钮位于列表底部 |
| 渠道参与开关 | 点击“参与轮换 / 不参与轮换”切换接入状态，自定义渠道也可管理 |
| 按模型批量控制 | 展开模型后“全部启用 / 全部停用”，统一控制该模型下的渠道候选 |
| 完整模型目录 | 纳入上游返回的免费与积分模型，展开渠道查看其积分倍率；未知价格不编造 |
| 模型名称归并 | 统一可确认的别名，保留版本、能力和变体差异，减少重复条目 |
| 禁用状态同步 | 模型所有候选被停用后，从聚合 API 与相关客户端同步名单中移除 |
| OpenCode 专页 | 单独管理相关设置、代理与额度刷新 |
| 账号与代理 | 管理渠道登录状态、额度、出口、代理模式与订阅轮换 |
| 自动与手动签到 | 渠道页「一键签到」、按账号定时领取、渠道开关、失败补签；能力与限制见签到及渠道状态 |
| 新渠道 | AStudio、AutoClaw 国内/国际版、超级麦吉/MagiCrew 国际版；支持插件导入或手工凭据，新渠道为试验接入，原生登录向导及真实账号验证尚待完成 |
| 日间 / 夜间 | 标题栏一键切换、平滑过渡、记忆主题，兼容系统减少动画偏好 |
| 安装与卸载 | 中文安装向导、目录与快捷方式选择，附 WebView2 离线运行环境 |
模型目录、额度、积分倍率及可用性以各渠道实际返回为准。目录列出模型，不代表当前账号一定具备调用权限；付费模型可能消耗积分或产生费用。
- 打开 Releases，下载
LampGuide-Setup-1.2.1-win-x64.exe。后续版本使用对应版本号。 - 正常退出正在运行的 zen-gate / Lamp Guide，再按安装向导完成安装。首次安装缺少 WebView2 时会补齐运行环境。
- 在“服务”页查看实际 Base URL、端口与访问 Key；在“渠道”登录账号，或在“供应商”添加自己的 API。
- 在“聚合”搜索和展开模型，选择渠道是否参与轮换，并查看各渠道的积分倍率。
- 在“Agent”页配置支持的客户端，也可以将“服务”页的地址、Key 和模型 ID 填入兼容客户端。
安装包附带 SHA-256 校验文件。在 PowerShell 中运行以下命令，并与 .sha256 文件比较：
Get-FileHash .\LampGuide-Setup-1.2.1-win-x64.exe -Algorithm SHA256当前安装包未做代码签名。WebView2 使用微软签名的官方运行环境。更新 Lamp Guide 时，请下载新安装包并安装到原目录；目前不提供原地替换 EXE 的自动升级。
为兼容 zen-gate，继续使用原有数据路径与协议标识：
| 内容 | 默认位置 |
|---|---|
| 网关账号、配置、日志 | %APPDATA%\zen-gate，可用 ZEN_GATE_HOME 覆盖 |
| WebView2 与主题数据 | %LOCALAPPDATA%\ZenUI\webview |
| 应用安装目录 | %LOCALAPPDATA%\Programs\Lamp Guide |
迁移前备份网关数据目录。两个程序会共享账号与配置，避免同时运行，以免端口冲突或并发写入。卸载保留账号、配置、主题缓存和共享的 WebView2 环境。详细说明见 迁移指南。
需要 Windows x64、Go 1.26、Node.js 22+。前端使用原生 HTML / CSS / JavaScript，随 Go 二进制嵌入，无前端打包服务。
git clone https://github.com/LAGcomcom/Lamp-Guide.git
cd Lamp-Guide
go test ./...
go vet ./...
go build -trimpath -ldflags="-H=windowsgui" -o LampGuide.exe .上面的命令构建应用；带图标、版本资源及 WebView2 的完整安装包另见 安装包构建说明。Windows CI 会检查 Go 测试、静态分析、JavaScript 语法并构建应用。
| 目录 | 职责 |
|---|---|
main.go、identity_windows.go |
进程入口与 Windows 应用身份 |
internal/shell、internal/native |
Win32 窗口、WebView2 宿主与系统调用 |
internal/host、internal/zenbridge |
页面宿主接口及进程内管理请求 |
internal/zen |
网关、渠道、账号、模型聚合、路由及配置存储 |
web |
桌面页面、主题样式与 SVG 图标 |
packaging、tools |
安装向导、品牌资源及发布构建脚本 |
本项目是 LAGcomcom/zen-gate 的桌面重构与扩展，保留原作者与上游许可声明。渠道协议实现参考了 dsh-our-free-model；内嵌 QoderCN 网关来源于 qodercn-gateway。
渠道账号、额度与聚合实现还参考了 iJetLi/dsh-providers-hub。项目许可证见 LICENSE，各组件来源、独立许可及 QoderCN 上游权利范围说明见 THIRD_PARTY.md。第三方服务名称和商标属于其各自所有者，账号权限、额度和使用规则由对应服务决定。
参与开发见 CONTRIBUTING.md，安全反馈见 SECURITY.md，版本变化见 CHANGELOG.md。