Skip to content

About

白龙娘桌宠MacOS-Swift版:Swift + AppKit 原生 macOS 桌宠,非官方,由 Codex 重写。

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

白龙桌宠Swift(MacOS 非官方原生移植版)

陪你工作,也把 Codex 的任务进展带到桌面。

基于 jingh12312-rgb(風-隐)的 GPT白龙娘动态桌宠,由 Codex 进行 Swift + AppKit 原生重写,适配 MacOS,独立维护。支持桌面互动、Codex 对话、任务气泡与本机历史管理。

下载正式版 · 版本变化 · 反馈问题

当前源码:0.7.4。 已发布版本与安装包见 正式 Release。

0.7.4 整理附件与用户消息显示,让 Codex 插话和任务提示更清楚;同步原作待机选择,调整新用户动画默认设置。

下载与使用

需要 macOS 14 或更新版本,提供 Apple Silicon 版和 Intel 社区测试版。Codex 功能需要在本机安装并登录 Codex。

你的 Mac 下载哪个包
Apple Silicon 芯片 文件名以 macos-apple-silicon.zip 结尾
Intel 芯片 文件名以 macos-intel.zip 结尾,社区测试版

不确定机型时,打开苹果菜单 → 关于本机,查看“芯片”一栏。

Apple Silicon 用户请下载原生版,强烈不推荐通过 Rosetta 运行 Intel 版。

Intel 社区测试版未经 Intel Mac 实机测试。 欢迎反馈机型、macOS 版本和使用情况。

  1. 前往正式 Release,下载对应机型的 ZIP 并解压。
  2. 将 白龙桌宠Swift.app 放到你选择的固定目录,推荐拖入访达的“应用程序”,再从访达打开。
  3. 在“设置 → 通用”中选择是否随登录或 Codex 启动;新版会维护已启用的启动项。

App 使用本地签名,没有苹果公证,致使首次打开一定会被系统拦截。先点击“完成”,在“系统设置 → 隐私与安全性”中划到最下方,找到“白龙桌宠Swift.app”,选择“仍要打开”,参见:Apple 操作说明

从旧版升级

退出旧桌宠,再打开新版。新版保留设置与历史,升级历史格式前会备份原文件。更新版本或移动 App 后,先手动打开新版,已启用的登录启动与随 Codex 启动会自动维护注册信息;状态可在“设置 → 通用”查看。

历史和任务文件位于 ~/Library/Application Support/BailongPetAppKit。早期历史备份为 conversations-before-schema2-<时间戳>.json;若切回 0.2.1,使用升级前的备份。0.7.2 起使用 history.sqlite 保存历史,首次迁移后保留原 conversations.json 文件。

特色功能

这里介绍 0.7.4 的功能,各版本的更新见 变更记录。

在桌面看进展,也能回看消息

Codex 工作时,桌宠会显示回复和需要你处理的提醒。单击桌宠,可以查看正在执行和最近结束的任务,以及各自的状态和用时;点击任务就能回到对应的 Codex 会话。

  • 思考和工具调用分开显示:查看公开的思考摘要,或正在读取文件、搜索、运行命令等具体操作;两类信息可以分别开关。
  • 提醒频率由你决定:思考与工具进展小气泡默认开启,每次显示 2 秒,可关闭或调整为 1~10 秒;已有设置保留。工具调用正文超出短气泡时以 ... 省略,悬停可查看完整内容。进展也会显示在任务概览里,不占消息卡片。
  • 久无进展提醒:默认每 5 分钟检查一次提醒间隔,任务至少 90 秒没有新进展时提示仍在处理中;可在消息设置关闭或调整为 1~30 分钟。
  • 消息可以翻页:气泡默认保留本次运行的 20 张消息卡片,可调整数量;正在翻阅旧消息或填写问卷时,不会被新卡片打断。

消息气泡:查看回复、翻页和快捷回复(0.5.0) 任务概览:当前操作、任务状态和用时(0.6.0)

直接回复、回答问题和处理审批

不用每次切回 Codex:在气泡里点“快捷回复”,就能继续原会话;任务还在执行时,也可以补充要求。回复沿用原会话的模型和思考等级。插话显示独立用户卡片,沿用原任务计时;“收到插话”台词可在称呼与个性页修改,也可直接搜索。

  • 处理审批:Codex 发来审批时,气泡先展示申请理由,再展示命令等详情。可以直接拒绝或允许这一次;红叉、绿对钩配合文字区分操作,左右顺序可调,按回车不会误触。桌宠内发起的任务使用原生审批窗口。
  • 回答问卷:选择选项或输入文字,多道题可以上一题、下一题、跳过,翻页保留草稿,最后统一提交。敏感提问通过安全输入窗口或回到 Codex 处理。
  • 选择对话模式:临时聊天窗区分“桌宠人设对话”和“Codex 项目对话”,可选择目标会话、打开工作区、查看最近回复;临时聊天与历史窗口分别保留各会话的草稿。
  • 开启新对话:桌宠人设对话可选择工作文件夹、模型和思考等级;“新对话”提供在默认、当前或其他工作区新建的入口。已有 Codex 项目对话沿用原会话设置。发送与停止任务分开操作。
  • 回到 Codex:临时聊天窗提供“在 Codex 中打开”,可以打开关联的原会话。桌宠人设会话与 Codex 桌面端暂不支持自动交接;遇到会话占用提示时,在当前持有会话的应用中继续。
  • 选择发送快捷键:支持 Command + Enter、Enter,以及 Control 或 Command + Enter 发送,临时聊天和历史窗口将完整用法显示在发送按钮的悬停提示中。

气泡内审批:理由在前,命令支持复制,底部选择拒绝或允许这一次

桌宠人设对话:选择会话、工作区、模型和思考等级 Codex 项目对话:沿用原会话设置,执行中发送插话

找回聊过的内容

历史窗口集中保存桌宠中的对话和同步到本机的 Codex 会话。可以搜索正文、跳到匹配位置,也可以直接在右侧接着回复。Codex 项目历史同时显示用户提问与助手回复;旧记录只在打开当前页时补充缺失提问,关闭历史期间的内容不补录。长历史每页显示 20 轮对话,搜索会定位到命中的页面。

会话标题支持右键重命名、重新同步 Codex 标题或删除记录。删除的是桌宠保存的那份记录,不会删除 Codex 原会话;关闭历史记录后,已有内容保留,关闭期间不再记录。

历史窗口:会话侧栏、正文表格、搜索与原会话回复

代码、表格和文件都能看

用户发送的图片和附件显示为实际提问与紧凑文件入口,减少重复图片占位和多余间隔。回复支持标题、列表、引用、表格和链接。代码放在圆角框中,支持基础语法着色和整块复制;长内容可以滚动阅读。

Codex 回复中的文件产物引用显示为可点击文件名;文件修改摘要列出可点击路径及新增、删除行数,总增减与“已编辑 N 个文件”同排显示,默认展示 3 个文件,可展开全部。目录使用次级灰,文件名及展开/收起使用正文色,增减数量为绿/红。计数汇总本轮已完成的文件修改,历史搜索也可定位这些文件。

首次点击本机文件链接时,系统会请求控制访达的权限;允许后,桌宠会在访达中选中文件,并恢复对应的最小化窗口。点击应用包链接只定位文件,不运行应用。Codex 生成图片后,桌宠会显示可打开的图片文件入口。

名字、台词和外观自己定

你和桌宠的名字、问候语、互动台词、任务状态提示都可以修改。桌宠对话与 Codex 项目分别使用对应的接收台词,收到任务、正在回复、阶段进展和停止状态可分别设置。台词支持 {用户名}、{桌宠名}、{特定称呼},右键输入框即可插入;特定称呼留空时沿用你的名字。

  • 调整大小和形状:分别设置桌宠大小、文字大小和气泡大小,也可以指定气泡宽高比。
  • 选择颜色和材质:外观可跟随系统或选择浅色、深色,强调色可以自定义;macOS 26 起支持液态玻璃,也能切回普通材质、调整背景不透明度并预览。macOS 14、15 使用普通材质,液态玻璃选项不可选。
  • 快速找到设置:设置搜索覆盖具体选项、动作和台词,点击结果直接定位。历史与设置使用原生分栏窗口,绿灯按钮填满屏幕可用区域,再点一次恢复。

称呼与个性设置:名字、变量、问候语和任务状态台词

找回桌宠

桌宠隐藏后,再次从访达或启动台打开 App,就能让它回到桌面;原任务继续保留。托盘菜单第一项也可隐藏/显示桌宠。

想热闹一点,或安静陪着

桌宠支持拖动、落地动画和吸边收起,也会按设置切换动作、在桌面活动。可以调整活跃程度、活动范围和播放速度,单独设置动作出现的频率,以及任务开始和结束时是否播放动画。

默认普通待机按 4:1、吸边按 7:3 选择;任务中按工作/待机 35:65 选择并排除上一动作,组内默认均匀。手动频率与偏爱按比例调整,减少重复设置用于其他随机互动、额外动作和移动。

需要专心时,开启“安静陪伴”或设定专注时段:减少自主活动,停止自动移动、互动台词、进展小气泡和音效;最终回复与需要处理的提醒仍会保留。

查看额度,打开订阅管理

双击桌宠查询 Codex 额度,按账号返回的信息显示套餐、剩余额度、下次重置时间、点数和重置卡。每次都重新查询,不使用上次结果。

剩余额度不超过 10% 时显示橙色,不超过 5% 时显示红色。

底部提供 ChatGPT 网页、Google Play 和 Apple 的订阅管理入口,免费用户也能看到。点击后打开对应平台。

额度查询:套餐、剩余额度、重置时间、点数、重置卡和订阅管理入口

动画播放和日常维护

  • 原画与性能可调:新用户默认 512×512、12 帧缓冲、满帧,已有设置保留;另有 720、384、256 三档。动画默认边读取边播放,切换动作后释放旧缓冲。
  • 透明动画:沿用 0.7.3 的透明 HEVC 素材,由 AVFoundation 解码,CPU/vImage 处理缩放和颜色转换;不随包附带 FFmpeg。
  • 轮廓阴影:默认开启,可在外观页关闭;通过窗口阴影显示,不改动画素材。
  • 按需查看性能:独立窗口显示 FPS、CPU、GPU、运行内存 (RAM) 和动画缓冲,关闭后停止统计。
  • 按需启动和检查更新:可设为登录启动或随 Codex 启动;更新页可以检查正式版本并打开下载页,启动自动检查默认关闭。
  • 默认工作区与清理:在“设置 → 高级”选择人设对话的默认工作区,更改后已有会话目录不变;可将内置工作区的内容移到废纸篓,保留目录和聊天记录,自定义工作区不清理。
  • 集中管理本机数据和权限:设置中提供访达授权、文件权限、登录项入口,以及本应用的数据和缓存清理。历史格式升级前会备份原文件。

常用操作

操作 默认行为
单击 / 双击桌宠 随机动画与任务概览 / 查询额度
右键单击 / 右键双击 打开菜单 / 临时聊天
吸边时单击或拖出 召回桌宠
桌宠隐藏后再次打开 App 找回桌宠,保留当前任务
⌘ Command + ↩ Enter 发送消息;Enter 换行
⌘, 打开设置
设置或历史中的 ⌘F 搜索设置项或历史消息
历史中的 ⌘G / ⇧⌘G 下一处 / 上一处正文匹配

鼠标动作、发送快捷键和消息时长均可调整。右键菜单提供随机动画、Codex 跳转、历史,以及大小和称呼台词设置入口。

  • 气泡默认保留本次运行的 20 张卡片,可设为 5~100;磁盘历史单独保存。
  • 鼠标移入气泡暂停倒计时,移出接着计时;切换卡片重新计时。待回答、待批准和错误气泡由用户处理后关闭。
  • 新任务消息替换任务概览;正在翻阅旧卡或填写问卷时保留当前卡片。
  • 关闭窗口或按 ⌘Q 关闭对应界面;最后一个普通窗口关闭后,Dock 入口收回,最小化的窗口仍可召回。完整退出使用菜单中的“退出白龙桌宠Swift”,停止任务使用对话中的“停止任务”。

性能设置

设置 默认 可选
画质 较高 512×512 原画 720×720、中 384×384、低 256×256
素材帧率 满帧,按实际素材帧率 20 / 15 FPS
动画缓冲 12 帧 6~240 帧
整段预加载 关闭 开启后完整加载当前动作,占用更多运行内存 (RAM)

缓冲帧数越少越省运行内存 (RAM),但解码延迟时更容易停顿。不推荐开启整段预加载:它会在播放前加载完整动画,大幅增加运行内存 (RAM) 占用。独立性能窗口提供当前占用与帧率。实现细节见 来源与架构。

开发分支与资源

main 保留正式版源码与使用说明;joseph/dev 开发分支 用于后续开发,保留完整开发变更、调查文档与待办,不提供开发版 App 下载。

开发者可直接下载 开发资源 ZIP(约 111 MiB),在仓库根目录解压获得 local-assets/。资源包包含 35 段透明 HEVC、素材清单、samples.json、音效、图标和来源说明;详细步骤见 开发资源获取。

资源发布页 标记为 Pre-release,供源码开发使用,不包含应用程序,也不会进入正式版更新提醒。普通用户使用上方的正式版下载入口即可。

从源码构建

需要 Apple Command Line Tools 或 Xcode,以及包含 macOS 27 API 的 SDK;当前使用 SDK 27.2、Apple Swift 6.4.2。应用运行目标仍为 macOS 14 起。以下资源可从上述开发资源包获得:

local-assets/
  native-hevc/catalog/素材清单.json
  native-hevc/catalog/透明HEVC/*.mov
  sounds/click.wav
  sounds/来源.txt
  glass-symbols/
  BailongPet.icns
  openai-logo.png

资源不存放在 Git 中,也可从原生 HEVC 版 App 的 Contents/Resources 提取运行资源。独立预览和 PNG 替换另外需要开发资源包中的 samples.json。PNG 素材接入见 原生素材工具。

./scripts/build.sh arm64           # 构建 Apple Silicon App
./scripts/build.sh x86_64          # 构建 Intel App
./scripts/run-dev.sh --build-only  # 仅编译
./scripts/run-dev.sh               # 开发运行

也可双击 build.command、launch.command、run-dev.command。构建版本取自 VERSION,产物位于 dist/native-hevc/<VERSION>/<架构>/白龙桌宠Swift.app,架构为 arm64 或 x86_64。--build-only 仅生成 .build/dev/BailongPetDev,不会更新 App;构建入口显示阶段、耗时、产物路径与大小。

来源与反馈

原作参考基线为 v0.5.1 / b102e73。动画、音效、图标与软件组件的来源见 来源与架构 和设置中的“关于 → 开源项目、技术栈与致谢”。

反馈问题请提供应用版本、macOS 版本和复现步骤;Codex 问题另附桌面端版本,并注明桌宠内置对话或 Codex 原会话(请勿提交隐私或敏感对话内容)。提交 Issue

About

白龙娘桌宠MacOS-Swift版:Swift + AppKit 原生 macOS 桌宠,非官方,由 Codex 重写。

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages