Codex Cosmos 是一个跨平台桌面常驻组件：把本机 Codex 额度、时间、天气、每日一言与一组富有生命力的桌面工具收进一颗黑洞。
当前公开版本：V1.2.4。
- 为虫洞、星炉和回收站的原生拖放增加任务级去重锁；同一批路径在首个操作完成前不会再次启动，避免慢速压缩时延迟到达的重复 drop 生成两个 ZIP。
- 修复 Linux/Wayland 下原生拖放监听器在异步重订阅时可能残留、导致同一文件被虫洞处理两次并显示“源文件不存在”的竞态；重复 drop 现在也会被即时去重。
- 修复设置抽屉打开后底层信息面板仍可滚动、两层滚动条重叠的问题；设置页现在独立滚动，并在打开期间锁定后方内容。
- 修复 Linux 下虫洞目标位于其他磁盘、FUSE 挂载、NTFS/exFAT 或网络盘时可能传送失败的问题；跨文件系统移动改用可靠的流式复制，并在失败时清理未完成的目标文件。
- 星际通讯站补齐双向发送：可向手机或另一台电脑上的 LocalSend/Codex Cosmos 选择并发送多个文件，提供等待确认、实时进度、完成、失败和取消状态。
- 接收端改为逐批显式确认，默认拒绝自动接收；无论黑洞挂件、紧凑还是展开形态，来件请求都会唤醒窗口并显示全局确认提示。
- HTTPS 发送使用持久客户端证书，并在 TLS 握手阶段固定校验发现广播中的 SHA-256 证书指纹；私钥仅保存在系统凭据库。
- 设备发现增加子网定向广播兜底，改善 Wi-Fi/AP 屏蔽多播时手机或电脑无法发现 Cosmos 的问题。
- 新增「剪贴板流星」：复制文本时一颗流星从右下斜划至左上、停在可点击亮点；按
C或点击亮点弹出剪贴板历史面板，点条目重新写入剪贴板，支持去重置顶与逐条删除。 - 新增「星际通讯站」：局域网文件投递接收端（对齐 LocalSend v2 协议），手机端 LocalSend 可直接向黑洞投递文件。
- 新增专注完成提示音：Web Audio 轻量音效，无需音频资源，首次交互后生效。
- 桌面生态「剪贴板彗星」更名为「剪贴板流星」，动画重做为真正的划过 + 长尾拖痕。
- 新增 DeepSeek 与 New API 中转站余额查询；支持账户 PAT、数字用户 ID，以及近 24 小时消耗、历史使用和请求数曲线。
- 新增自定义用量查询模块，并完善标准、展开和极简模式的自适应布局与滚动行为。
- 重做 Codex 额度趋势：按真实 7 天周期聚合，容忍重置时间漂移，过滤过期回退采样，并修复 30 天消耗的重复累计。
- 新增“自动回收”开关；面板可常驻，启动时仍保持收起，双击可手动展开或收回。
- 改进原生文件拖放区域与坐标换算，修复回收站、虫洞和 ZIP 星炉的目标识别及拖出交互。
- 优化展开模式天气布局、极简模式尺寸和余额模块加入后的页面排版。
- 拖拽回弹修复：拖动期间彻底暂停「边缘巡游」，松手后 8 秒宽限期，窗口稳定停在放置位置。
- 滑动条样式重做：深色轨道 + 绿色滑块，
color-scheme与accent-color兜底，避免 WebView2 下出现原生白条。 - 黑洞手势重排：双击左键打开额度面板、单击右键打开回收站、双击右键恢复上次回收。
- 新增「自定义用量 API」：支持自定义 REST 接口 + JSON Pointer 映射读取 token 用量，DSH 式环形 + 分段明细面板。
- 新增「余额查询」：DeepSeek 官方 / 中转站只需填写 API Key，自动读
/user/balance余额；凭据存入系统凭据管理器。
- 显式声明方形 PNG bundle 图标，修复 Linux AppImage 封装失败；Windows 托盘继续显式继承应用图标。
- Codex 额度：读取本机
~/.codex/sessions与~/.codex/archived_sessions的最新额度事件，展示剩余比例、官方周期、重置倒计时和 30 天本地估算。 - 日常信息：时间、日期、问候语、城市天气、体感温度、湿度、风速、降雨概率、7 天预测和离线每日一言。
- 三种尺寸：极简条、标准卡片与展开仪表盘；支持置顶、托盘、开机启动和低额度通知。
- 黑洞回收站：原生文件拖放、安全移入系统回收站、恢复最近一次回收、查看历史和双击打开回收站。
- 虫洞传送：将文件拖入虫洞，经过吸入与出口动画移动到独立配置的目标路径；同名文件自动避让。
- ZIP 星炉：投入
.zip自动安全解压，投入其他文件或目录自动压缩为 ZIP；输出路径独立配置，原文件始终保留。 - 桌面生态：剪贴板流星（C 打开剪贴板历史）、专注月球、边缘巡游、天气视觉联动和随回收数量成长的黑洞。
- 崎岖桌面：原生、引力凹陷、月球坑、液态桌面、积雪、沙丘、太空尘埃七种可切换模式。
- GPU 效果：实时引力透镜、背景采样与局部扭曲、鼠标引力和粒子轨迹；提供节能、平衡、电影三档质量。
- 跨平台策略：Windows 使用桌面背景采样；Linux X11 使用内置星场与局部粒子；Wayland 自动降级受限的窗口定位能力。
从 Releases 下载：
- Windows 安装包：
Codex Cosmos_*_x64-setup.exe - Windows 便携版：
CodexCosmos-Windows-x64-Portable.exe - Linux：AppImage 或 DEB
待机状态下将文件拖向不同区域：
- 中央黑洞：移入系统回收站
- 左下虫洞：移动到虫洞目标路径
- 右下星炉：ZIP 解压；其他文件或目录压缩为 ZIP
虫洞与星炉路径均可在设置中单独指定为绝对目录。
需要 Node.js 22、pnpm 11、Rust stable 和 Tauri 2 所需系统依赖。
pnpm install --frozen-lockfile
pnpm tauri dev验证：
pnpm build
cargo test --manifest-path src-tauri/Cargo.toml
pnpm tauri buildLinux 推荐 Ubuntu 22.04 或 Debian 12：
sudo apt update
sudo apt install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf build-essential curl wget file libssl-dev
pnpm tauri build --bundles appimage,deb完整架构、开发流程、兼容约束、测试清单和后续路线见 中文开发交接文档。
- 只解析额度所需的
token_count.rate_limits字段。 - 不读取
~/.codex/auth.json，不读取或展示会话正文。 - 不上传本地 Codex 数据；历史采样保存在操作系统应用数据目录。
- 天气只向 Open-Meteo 发送用户手动选择的经纬度，不使用 IP 定位。
- “30 天消耗”是明确标注的本地估算，不冒充官方月额度。
黑洞渲染与安全回收语义借鉴并适配自 Black Hole Trash。完整第三方许可见 THIRD_PARTY_NOTICES.md。
本项目使用 MIT License。