Polaris v2.3.1 — 环境医生修复

Polaris v2.3.1 — 环境医生检测/更新/安装链路修复

环境医生此前有三处独立缺陷，各自都能单独导致「检测不到 / 装不上」，本版全部修好。

修复

① node/npm 装了却报「未安装」
检测只靠进程 PATH，没带安装目录候选。而 Windows 上 MSI/winget 只写注册表 PATH，正在运行的进程 PATH 是启动那一刻的快照、不会刷新 —— 开着 Polaris 装完 Node，面板就一直说没装。现已补上候选路径；「装了但不在 PATH」会如实标出而不是谎报未安装。

② 有新版也永远显示「已是最新」
更新检测用裸名 claude --version 走 PATH 探版本，可「装了但不在 PATH」恰恰是面板显式支持的状态。那种机器上当前版本恒为空，版本比较直接落到兜底分支 —— 有新版也检测不出。现改为按解析出的绝对路径探版本；真读不出时如实说明，而不是把「不知道」谎报成「没更新」。

③ 点了「更新」版本纹丝不动
不管当初怎么装的一律跑 npm i -g。用官方脚本装的机器上，npm 只会往全局前缀里另装一份，PATH 命中的仍是原来那个 —— 「更新完成」照弹、版本毫无变化。现按安装方式分流：原生装的走 claude update 就地替换。

依赖包分发改走自建 CDN

PowerShell 7 / Node.js / uv 的安装包现从自建 R2 分发，公共代理与官方直连仍作兜底。

• 关掉了 Invoke-WebRequest 的进度条 —— 无窗口 + 输出重定向的场景下它把下载拖慢 7.3 倍（实测 584 → 4266 KB/s）。107MB 的 PowerShell MSI 因此常摸到超时上限而失败，这是「PowerShell 7 有些概率装不上」的主因。
• 下载校验从「大于 1MB」升级为体积下限 + 文件头魔数 —— 代理挂掉时常回「200 + HTML 错误页」，旧校验会把错误页当安装包喂给 msiexec。
• msiexec 报 1618（撞上别的安装正在进行）从直接判死改为等待重试。
• 摘掉实测已返回 500 的 gh-proxy.com；显式并入 TLS 1.2。

实测：PowerShell MSI 从 R2 8 秒下完并校验通过。

安装包

• Windows: Polaris_2.3.1_x64-setup.exe（NSIS x64）
• macOS: Polaris_2.3.1_universal.dmg（universal；未签名，首启需 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app）

macOS 端本版未真机验证（构建与单测已过 CI）。

Polaris v2.3.0

Polaris v2.3.0 — API 切换通用本地路由

新功能

供应商坞 · 通用本地路由(cc-switch 式)

• 新增 OpenAI 协议供应商:GPT 及任何 OpenAI 兼容网关/中转站,填 base_url + API Key 即可给 Claude Code 用。本地路由做 Anthropic ⇄ chat/completions 双向翻译(system / 工具调用 / 图片 / 流式增量 / usage 全覆盖)。添加供应商 → 自定义配置 → 上游协议选「OpenAI 协议 · 本地路由」。
• 新增「本地路由 · 热切换」总开关:打开后所有供应商统一经 127.0.0.1 本地路由转发。Anthropic 兼容的走纯透传(不翻译,只在转发瞬间按 token_field 实时注入 x-api-key / Bearer)——改 Key 即刻生效,真 Key 不再写进子进程环境变量;anthropic-version / anthropic-beta 协议头透传;上游报错原样转达。关闭则回到直连注入。
• 路由按 /p/{供应商id} 分发,每请求实时解析上游 → 改 Key、换模型、切供应商立即生效,并发对话各指不同供应商互不串台。
• 推理系模型(o1/o3/o4/gpt-5*)自动改用 max_completion_tokens 且不透传 temperature,避免上游 400。

移除「Claude Code ⇄ Codex」分段器

Polaris 从不运行 codex CLI —— 对话始终由 claude CLI 跑,「Codex」只是「ChatGPT 订阅」这一家供应商(上游写死 chatgpt.com),不是能在其下挂别家的后端。原分段器的二元框架是错的且具误导性,已移除。现在坞里只有一层真相:选哪家供应商(MiniMax / Kimi / 智谱等在列表里点选即用)。

设备联盟

• 网关挂牌绑定真实账号(落库,云机重启可恢复),换账号注册同一设备直接拒;新增踢下线(端口即时释放)。

安装包

• Windows:Polaris_2.3.0_x64-setup.exe(NSIS · x64 · 20.1 MB)
• macOS:Polaris_2.3.0_universal.dmg(Universal · 37.2 MB)

macOS 包未经 Apple 签名,首次启动需:sudo xattr -dr com.apple.quarantine /Applications/Polaris.app
本版 macOS 端未经真机验证(CI 编译 + ad-hoc 签名通过)。

自动更新

旧版客户端(Windows / macOS)自检即可收到本版升级提示。

Polaris v2.2.0

Polaris v2.2.0 — GPT 一次授权，Claude Code 与 Codex 通用

新功能

• GPT 接入（对齐 cc-switch）：用 ChatGPT 账号授权一次（「网站 + 效验码」交互，也保留浏览器一键），凭据写入 ~/.codex/auth.json。之后 Claude Code（经本地翻译代理）与 Codex CLI 都直接用上这份 ChatGPT 订阅，一次授权两边通用。
• 互联隧道多实例重构：成员侧共享单 iroh Endpoint + 多隧道注册表 + connect 幂等 + mDNS 内网发现，修多盘 / 主客同机 Endpoint 互踩；断外网时同局域网设备照样直连。

安装包

• Windows：Polaris_2.2.0_x64-setup.exe（NSIS x64，约 20 MB）
• macOS：Polaris_2.2.0_universal.dmg（Universal，Intel + Apple Silicon，约 37 MB）

macOS 未签名包：首次打开若被 Gatekeeper 拦，终端执行 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app 解除隔离。
本版 macOS 端未在真机点验（CI 编译 + 签名均通过）。旧版桌面端会经 latest.json 自动检测到本版并升级。

Polaris v2.1.0

Polaris v2.1.0 —— 设备联盟 / 互联 + 手机端

新功能

• 设备联盟双栏形态重排,高级质感头像,加号即出连接窗
• NAS 归我的设备:mine 分区轮询远程盘实况;拉取失败保留旧值并标灰,不再「时有时无」
• 使用盘直达文件中心;NAS 链路如实标注 P2P(不再谎报直连)
• 远端遥测全真 + 「正在发生」活动流
• 账号登录登出;手机端登录优先与琉璃化

安装包

• Windows:Polaris_2.1.0_x64-setup.exe(NSIS x64)
• macOS:Polaris_2.1.0_universal.dmg(universal)

macOS 未经 Apple 签名:自动更新可正常走(minisign 验签),但首次安装后需执行
sudo xattr -dr com.apple.quarantine /Applications/Polaris.app 才能打开。

Docker

镜像见 ghcr.io/wuli2025/polaris:2.1.0(slim,:latest 指向它)与 :2.1.0-full。
更新:./update.sh。安装包与说明见
polaris_docker v2.1.0。

本版 Docker 镜像修了两个老问题:补编 collab-net(此前 NAS 连不出 NodeId,
设备联盟远程盘在容器上不可用的根因)、真正实现 /api/version(此前是幽灵路由,
Web UI 的「当前版本」一直显示 v—)。

已知未验证

mac 端为 CI 产物,未在真机点验;NAS 端到端自更新链路待真机确认。

Polaris v2.0.1

Polaris v2.0.1 — 分仓架构大版本

积木化架构定型:后端拆成 workspace 12 个独立 crate(kernel / fable / forge / wiki / collab / protocol / runtime / sandbox / codec / cli / core),边界由编译器强制,想要哪块组件就取哪块。

本版亮点(累积后端加固):

• forge:截图改异步防钉 UI;新增进程组杀树的超时输出捕获
• 多人协作:设备联盟账号根口令(一个口令把多台设备拉进你的联盟)
• 检索:file_overview 并发单飞 + 短 TTL 缓存(8 路并发 15.8s → 1.9s,内存不再高水位)
• 供应商坞、检索、盘点、沙箱多处稳定性与功能完善

当前仅提供 Windows 安装包;macOS 版随后补充。
国内下载走 gh-proxy 镜像,更新器会自动选择可达源。

Polaris v1.7.1

Polaris v1.7.1 — 扫盘修复 + 更新可靠性

修复 / 改进

• 扫盘「永久漏扫」根治：增量盘点中，子目录因 NAS 瞬断/读失败被跳过后，过去会因父目录 mtime 未变而在后续每次增量盘点中被永久跳过（只有手动「完整盘点」才找得回）。现收尾自愈：作废受影响父目录的「免遍历」资格，下次增量必重读、自动补扫回来。
• 更新弹窗冷启动可靠性：冷启动网络未就绪/离线时，检查更新失败不再吞掉「有新版」提示，中央更新弹窗照常浮出。
• 「请教毛主席」默认隐藏：不再开机自动补装，改为安装「毛主席」名人资料包时才装（不删用户已有数据）。
• Docker/NAS 线同步至 1.7.1。

安装包

• Windows: Polaris_1.7.1_x64-setup.exe（NSIS x64）
• macOS: Polaris_1.7.1_universal.dmg（universal；未签名，首启 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app）

Polaris v1.7.0

Polaris v1.7.0 — 每对话各用各的 API + Kimi 粉丝福利内置

新功能

• 对话框「Auto / API 切换键」：点一下切换本对话用哪家 API/模型；每个对话各记各的，互不串台。
• 真隔离：后端改为「逐条命令注入供应商 env」，多对话并发也不再被全局开关带跑。
• API 选项自动识别：只列出左下角「API 供应商」里已经配好 Key / 已 OAuth 的那些，没配的不显示。
• Kimi 粉丝福利内置：新安装开箱即用，无需自己填 Key（build.rs 滚动混淆注入）。
• NAS 盘管理：文件中心新增「盘管理」，自动发现/记住 NAS，一键 net use 映射成网络盘。
• 微信每日待办技能：wechat-tasks 技能 + 每日 09:00 自动化，本地解密微信后生成晨报待办。
• Codex (ChatGPT) 授权修复：补上 include:["reasoning.encrypted_content"]，授权后每条对话不再 400。

安装包

• Windows: Polaris_1.7.0_x64-setup.exe（NSIS x64，约 16.3 MB）
• macOS: Polaris_1.7.0_universal.dmg（universal；未 Apple 签名，首启 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app）
• mac 自动更新用: Polaris.app.tar.gz

验证

• 四道编译闸（desktop/server/vue-tsc/vite）全绿
• 204 个单元测试通过（含 2 个新单测验证每对话隔离）
• Win 自动更新已验证，mac 未真机验证（CI 构建 + 签名通过）

Polaris v1.6.2

Polaris v1.6.2 — 24/7 长稳硬化

承接 v1.5.x 防卡死脉络,本版聚焦长时间运行的稳定性(防卡死/防 OOM/可观测),纯防御性加固。

改进

• 防卡死:子进程超时默认常开(连续空闲判据,不误杀 ffmpeg)+ 有界等待硬死线强杀回收,根治卡死孙进程钉死读线程导致的句柄/线程泄漏
• 防 OOM:知识库正文有界读 8MiB(防 GB 级文件直读撑爆)+ 前端周期性内存兜底(每 5 分钟收一次缓存,杜绝长周期内存爬升)
• 可观测:后台线程 panic 不再被默默吞,落 panic 日志;并发连接计量(纯观测,绝不阻塞)
• PPTX 异步:多图打包改后台线程池,不再冻 UI

安装包

• Windows: Polaris_1.6.2_x64-setup.exe(NSIS x64)
• macOS: Polaris_1.6.2_universal.dmg(universal;未签名,首启 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app)

老版本(Win+Mac)启动自检即弹升级。

Polaris v1.6.0

Polaris v1.6.0 — 双档引导 + 快速/工作模式 + 防卡死硬化

新功能

• 新用户引导 v2:快速 / 深度双档,边扫边冒重点、迷你检索预览
• 对话框双模式:快速模式(默认,强制查库+召回快档)/ 工作模式(纯 Claude Code 全套工具)
• 空对话工作流推荐:据知识库画像与最近在动的文件,推成体系工作流提示词

稳定性

• 防卡死舱壁化:视图区/抽屉加 FaultBoundary,单块出错不连坐;知识星图布局自适应+节点上限
• 内存占用修复:数据库内存预算按端缩放(桌面大幅下调)、缩略图缓存改 LRU、检索两段式兜底、对话级 LRU、后台自动 trim

安装包

• Windows: Polaris_1.6.0_x64-setup.exe(NSIS x64)
• macOS: Polaris_1.6.0_universal.dmg(universal;未签名,首启 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app)

旧版客户端(Win/Mac)打开后自动检测到本版即弹升级。

Polaris v1.5.6

Polaris v1.5.6 — 检查更新更快(国内秒开)

修复

• 点「检查更新」不再转圈好几秒:更新检查端点最前面加了国内快的 Cloudflare 源(llmwiki.cloud),秒返回;原 gh-proxy / GitHub 退为兜底。此前国内首跳卡在 gh-proxy / 直连 GitHub 超时是「转圈好几秒」的根因(下载安装包早有 CF 兜底,唯独「检查」这跳漏了)。

(承接 v1.5.4「打开软件不再自动建索引」+ v1.5.5 防卡死硬化)

安装包

• Windows: Polaris_1.5.6_x64-setup.exe(NSIS x64)
• macOS: Polaris_1.5.6_universal.dmg(universal;未签名,首启 sudo xattr -dr com.apple.quarantine /Applications/Polaris.app)

老版本会自动检测到本版并提示升级。升级到本版后,以后每次检查更新都会走国内快源。