v2.0.9 — macOS 可拖动 + 界面与 Windows 版一致

这个版本修什么

2.0.8 修掉了「独立窗口一启动就崩溃」，也让 macOS 版第一次真正跑起来。跑起来之后暴露出两个问题：窗口拖不动，以及界面是系统默认控件，和 Windows 版完全不是一个样子。2.0.9 把这两件事一起修了。

1. 无法拖动

面板是 .nonactivatingPanel，macOS 的规则是首次点击只用于激活窗口、不会传给 mouseDown，所以实际手感是「点了没反应，得再点一次」。

现在 SpriteView 重写 acceptsFirstMouse 直接接受首次点击，单击即可拖动。

精简模式（隐藏形象）原本完全没有可拖区域，补齐了对应 Windows 版 dragGrip 的握把。

2. 界面与 Windows 版对齐

新增 native/CompanionTheme.swift 设计系统，直接复用 Windows 版的配色与几何，不再各写一套：

令牌	深色	浅色
背景	#24272D	#FFFFFF
前景	#EDF1F7	#202C40
描边	#404650	#DEE6F0
强调	#669FE8	#4279C9
次要	#A4B1C3	#6C7B91

• 宠物面板：状态胶囊（显示当前状态或自定义标签）+ 悬停工具栏，工具栏是一个圆角胶囊，内含「聊一聊 / 动态 / 设置」，图标矢量路径沿用 Windows 版。
• 聊天面板：标题与副标题、分隔线、圆角输入框、主次按钮、输入提示，不再是灰色系统控件。
• 动态面板 / 完成气泡：同步改版，圆角 + 描边 + 阴影。
• 精简模式：圆角胶囊（握把 + 名称 + 状态），替代原来的灰色方块。
• 深色 / 浅色两套主题即时切换，applyTheme() 统一重绘。

顺带修掉一个实际缺陷：工具栏原本定位在面板边界之外 28px，被完全裁掉，所以此前的实现里工具栏根本不存在。现在布局为它预留了高度。

构建与校验

• 助手程序拆为三个 Swift 文件（main.swift 是顶层代码必需），build-native-macos.mjs 一并编译。
• build.json 的 sourceSha256 改为三个源文件的联合摘要，verify-native-bundle.mjs 用同样的算法，改动任一源文件都会让校验失败，避免再出现「源码改了、发布包还是旧二进制」。
• 通用二进制 arm64 + x86_64，已 ad-hoc 签名。
• scripts/verify-native-macos.mjs 冒烟通过：图集裁切、悬浮窗、上下文、面板切换与跟随、精简模式、回退、EOF 关闭。
• 深浅两套主题的渲染截图均人工核对。

安装 / 升级

dsh plugin --profile desktop update dsh-codex-mini-pet

或下载下方 dsh-codex-mini-pet-2.0.9.tgz 后：

dsh plugin --profile desktop add /绝对路径/dsh-codex-mini-pet-2.0.9.tgz

macOS 原生程序仍未做 Apple 开发者签名与公证。

v2.0.8 — 修复 macOS 独立桌面伙伴启动崩溃

修复

macOS 12–13 上，独立桌面伙伴（surface: desktop）启动即崩溃，一直回退成应用内显示，窗口拉不出来。

根因在 native/PetWindow.swift 的 SpriteView.draw：把裸 Swift 枚举直接放进 NSImage 的 hints 字典，

hints: [.interpolation: NSImageInterpolation.high]

AppKit 读取 hint 值时按 Objective-C 发送 -unsignedIntegerValue，而裸 Swift 枚举被装箱成 __SwiftValue，没有这个 selector，于是抛 NSInvalidArgumentException，进程以 SIGILL 终止。宿主检测到子进程退出，回退到应用内显示。

修复：显式包一层 NSNumber，让 hint 正确桥接。

let hints: [NSImageRep.HintKey: Any] = [.interpolation: NSNumber(value: NSImageInterpolation.high.rawValue)]

为什么之前没发现

该崩溃在 macOS 12–13 稳定复现（本机 macOS 13.7.8 实测 100%，崩溃偏移固定在同一处），macOS 14+ 的 AppKit 取值路径不同，不一定触发，因此此前在较新系统上的自动化验证未能覆盖。

验证

• 原版二进制：每次启动 exit 132 / Illegal instruction: 4，报错 -[__SwiftValue unsignedIntegerValue]
• 修复版二进制：exit 0，无异常，连续多次稳定
• scripts/verify-native-macos.mjs 冒烟通过：图集裁切、悬浮窗、面板跟随、精简模式、回退与 EOF 关闭
• release-check 通过：lib/ 与源码一致
• 通用二进制 arm64 + x86_64，已 ad-hoc 签名，build.json 哈希与产物一致

安装

下载 dsh-codex-mini-pet-2.0.8.tgz，然后：

dsh plugin --profile desktop add /绝对路径/dsh-codex-mini-pet-2.0.8.tgz

也可以从插件市场按 git 方式安装，本版本已提交构建产物，无需放行构建脚本。

macOS 原生程序仍未做 Apple 开发者签名与公证。

v2.0.7 — macOS 桌面伙伴（首次适配）

首次为 macOS 增加可显示在 Harness 窗口外的独立桌面伙伴。

新功能

• macOS 12+ 原生 AppKit 透明置顶窗口，支持 Apple 芯片与 Intel；通用程序随插件分发，无需 Xcode。
• 支持高清动画、目光跟随、拖动与位置保存、精简模式、中英文和减少动态效果。
• 快捷聊天与动态面板随宠物移动，可再次点击收回；支持工作区与会话选择、任务完成气泡提醒。
• macOS 全局快捷键 ⌘⌥⇧P；快捷发送不会主动唤起 Harness，点击在主会话编辑、查看任务或设置时才激活主程序。
• 窗口启动失败时回退应用内显示；插件或 Harness 退出时关闭伙伴。

安装

下载 dsh-codex-mini-pet-2.0.7.tgz，在 Harness 插件管理中更新，重启后开启「桌面置顶」。Windows 和 macOS 使用同一安装包。

验证与当前范围

86 项测试通过；Windows、Ubuntu CI 通过。macOS 上完成双架构编译、签名完整性校验和实际原生窗口自动化验证（图集、置顶、工作区、面板开关与跟随移动、精简模式、关闭清理）。构建文件与 Swift 源码的 SHA-256 在发版检查中一并核对。

macOS 是首次适配，尚未经过人工实机交互验证；多桌面 / 全屏切换及混合 DPI 多屏效果仍需实际使用确认。原生程序使用临时本地签名，尚无 Apple 开发者签名和公证；如系统策略阻止运行，会保留应用内宠物。

v2.0.6 — 新会话模式切换修复

修复市场安装的聊天界面仍显示旧版工作 / 聊天选项卡的问题。

• 聊天 / 工作切换仅在新会话页显示，已有会话自动隐藏。
• 统一两个新会话页的选项卡尺寸和位置，跳转期间避免闪现。
• 提交最新构建文件，市场安装直接加载修复后的界面。
• 加入 CI 构建一致性检查。

验证：84 项测试、静态检查和构建一致性检查通过。

安装：下载 dsh-codex-mini-pet-2.0.6.tgz，通过 Harness 插件管理安装；市场用户请更新插件并重启 Harness。

v2.0.5

2.0.5 — 2026-10-18

修复：插件市场安装失败

插件市场用的是 dsh plugin add github:HuiHuangDDFS/dsh-codex-mini-pet。pnpm 打包 git 依赖时，若仓库里找不到 package.json 的 main（lib/index.js），就判定为源码包、需要先跑构建脚本；而市场的安装路径无法授权构建脚本，于是每次都以 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 失败。

本次把安装时直接加载的 lib/index.js 与 lib/client.js 一起提交进仓库。pnpm 判定「入口文件已存在、无需构建」，市场安装不再需要放行构建脚本。

说明

• 没有改用 prepare 脚本：pnpm 见到 prepare 会无条件构建，反而又回到同一条拒绝。原因记录在 package.json 的 //scripts。
• 新增 npm run release-check：重建后比对已提交的 lib/，避免发版时漏提构建、让 git 安装拿到旧代码。

安装

dsh plugin --profile <profile> add github:HuiHuangDDFS/dsh-codex-mini-pet

或下载本页 Assets 中的 dsh-codex-mini-pet-2.0.5.tgz 安装。

注意：若所在 profile 中存在其他刚发布不久的插件版本，pnpm 的 minimumReleaseAge（默认 24 小时）仍可能整体拒绝本次改动。这与本插件无关，等待窗口过去后即可正常安装。

v2.0.4 · 修复分享入口误识别并恢复自动验证

修复分享入口误识别

修复 2.0.3 在官网分享入口缺失时，可能将右上角其他 SVG 图标当作分享按钮的问题。建议 2.0.3 用户升级。

• 分享控件必须具备明确的分享标签，或匹配已知的官网桌面 / 移动版分享图形；不再仅凭位置选择任意图标。
• 排除正文、弹窗和菜单中的控件；入口未知或不唯一时显示提示并停止操作，避免误隐藏和误点击。
• 清理错误的旧隐藏标记，并尊重无按钮语义控件的禁用状态。
• 新增 5 项回归测试，保留无标签 .ds-icon-button 分享入口及重复扫描兼容性。

验证

本地 81 项测试全部通过，语法检查、构建和安装包内容检查通过；GitHub Ubuntu 与 Windows 两个平台检查均通过。

查看自动验证

安装

下载 dsh-codex-mini-pet-2.0.4.tgz，在 Harness「设置 → 插件管理器」安装并重新启动。安装包包含构建结果，升级保留已有宠物库和偏好。附带 SHA256SUMS.txt 供下载校验。

已在 DeepSeek Harness 0.2.1-rc.2 验证可用。官网聊天仍需在内嵌网页中登录；官网图标结构改变后可能需要更新适配。

完整变更：v2.0.3…v2.0.4

v2.0.3 · 修复聊天页重复标题与分享按钮

聊天页标题与分享入口修复

• 修复 DeepSeek 官网会话名称和分享按钮在 Harness 页眉下方重复显示的问题，兼容无按钮语义、无可访问标签的图标按钮及未标注的顶部标题行。
• 当前会话名称统一显示在 Harness 页眉左上角，分享入口保留在页眉工具区。
• 更新 README 的版本号、下载链接和安装示例至 2.0.3。

安装

下载下方的 dsh-codex-mini-pet-2.0.3.tgz，在 Harness「设置 → 插件管理器」安装并重新启动。升级继续使用已有宠物库和显示偏好。

已在 DeepSeek Harness 0.2.1-rc.2 验证可用。发布包已包含构建结果；附带 SHA256SUMS.txt，可校验安装包。

官网聊天仍需在内嵌网页中手动登录；官网结构变化后可能需要更新适配。

完整变更：v2.0.2…v2.0.3

v2.0.2 · deepseek 高清伙伴与聊天页眉优化

deepseek 高清伙伴，聊天页眉更清楚

• 新增 deepseek：依据用户提供的角色设定图生成蓝发鲸鱼女仆风 Q 版伙伴，包含九类动作与十六方向注视。新安装默认选中，升级保留已有宠物选择。
• 高清重绘：全部 73 个姿势重绘，界面与 Windows 桌面使用 2 倍图集，保持原显示尺寸；导出继续使用标准 Codex v2 图集。
• 修复动画裁边：完整提取原图中的角色，再装入带透明留白的动画格，修复头发、尾巴和双脚被截断的问题。
• 标题统一放在页眉：当前聊天名称显示在 Harness 页眉左上角，隐藏网页里的重复会话标题。
• 分享入口移到页眉：点击后打开 DeepSeek 官网原有分享弹窗；重复扫描保留官网入口，并排除弹窗、菜单及正文中的其他按钮。
• 补齐文档与双语介绍：更新 README、新伙伴资源来源、英文描述和 2.0.2 安装示例。

安装

下载 dsh-codex-mini-pet-2.0.2.tgz，在 Harness「设置 → 插件管理器」安装并重新启动。也可使用桌面安装包自带的 CLI：

dsh.cmd plugin --profile desktop add <安装包绝对路径>

已在 DeepSeek Harness 0.2.1-rc.2 验证插件可用，Windows 宿主已确认新 deepseek 卡片与桌面形象正常显示。既有宠物库和显示偏好继续使用。

官网聊天需要桌面内嵌浏览器及手动登录同一账号。插件通过官网现有界面处理聊天与分享；官网结构变化后可能需要更新适配。

76 项自动测试、语法检查、构建及安装包检查通过，包含真实 WPF 高清裁帧检查。附带 SHA256SUMS.txt，可校验下载的安装包。

v2.0.1 · 聊天与工作模式界面优化

2.0.1

• 聊天历史栏紧接工作区项目列表；项目较多时可随侧栏滚动，聊天会话列表仍在聊天栏内独立滚动。
• 统一聊天与工作模式切换条的宽度和按钮尺寸，聊天模式标题栏不再显示网址。
• 本版本继续保留 2.0 的聊天 / 工作双模式、DeepSeek 官网会话管理与桌面伙伴能力。

安装

下载 dsh-codex-mini-pet-2.0.1.tgz，在 Harness 插件管理器中安装并重启应用。也可使用桌面版自带 CLI 安装本地包。

v2.0.0 · 聊天、工作与桌面伙伴

聊天、工作与桌面伙伴，一个 Harness

2.0 新增「聊天 / 工作」双模式。聊天在 Harness 内打开 DeepSeek 官方网页，工作保留原生项目、模型、文件上下文与工具。

• 聊天历史放在工作区下方：新聊天、标题搜索、同步、重命名与删除入口集中管理，删除保留官网确认。
• 切换更稳：已加载会话通过官网路由切换；保留左侧列表、固定标题行与区域高度，支持收起 / 展开和再次点击关闭菜单。
• 草稿继续写：聊天与工作之间切换，保留当前官网页面和未发送草稿。
• 桌面伙伴继续陪伴：后台快捷回复、任务动态、完成气泡、中英双语、自定义宠物与原有偏好均保留。

README 已更新双模式截图、功能优势、安装和使用说明。

安装

下载 dsh-codex-mini-pet-2.0.0.tgz，在 Harness 插件管理器安装；也可使用桌面安装包自带 CLI：

dsh.cmd plugin --profile desktop add <安装包绝对路径>

适配基线为 DeepSeek Harness 0.2.0-rc.2，官网聊天已在 Windows 桌面宿主验证。纯 Web profile 保留应用内宠物，官网聊天需要桌面内嵌浏览器能力。

登录与验证范围

官网聊天目前需要手动登录同一账号，不自动复用 Harness 登录凭据；完全退出应用后可能需要重新登录。聊天列表同步官网当前已加载的导航标题，官网结构变化后可能需要适配更新。

63 项自动测试、语法检查、构建与打包检查通过。Windows 宿主已实测双模式切换、草稿保留、历史同步和专用测试会话重命名。

附带 SHA256SUMS.txt，可用于校验安装包。