v0.4.17

DeskPet v0.4.17 — 移除 Clawd 资产 + 修正 IP 边界措辞

这是 docs + chore release —— 无新功能，只做 IP 边界清正：删除老 themes/clawd-dev/ 文件夹（66 文件，2.2MB），重写 README 和此前 release notes 的鸣谢措辞。功能与 v0.4.16 等价，可放心从 v0.4.16 升级（无 breaking change）。

---

⚠️ 事实边界声明（本次修正核心）

之前 README / release notes 出现了不准确的措辞，暗示原作者 @rullerzhou-afk 对 Clawd 形象给过使用授权：

❌ "授权我直接借鉴老 Clawd 动画 keyframes 与状态逻辑"
❌ "在 Claude Code 小螃蟹形象设计 / 像素动画规范上给出关键指导"
❌ "pet-forge skill + workflow + 螃蟹形象指导"

事实是：

• pet-forge 工作流是 MIT 授权的，使用完全合规
• Clawd 形象本身从未授权给本项目 —— 早期临时借用过 Clawd 资产，被原作者发现后她给了一个缓冲期让我重做
• 于是有了 v0.4.9 起的完全原创 deskpet-cc 主题
• deskpet-cc 21 个 sprite 完全独立重画，致敬 Anthropic Claude Code 公开 mascot 形象（小螃蟹是 Anthropic 公开 IP），不含任何 Clawd 资产

本次 v0.4.17 把 README + v0.4.15/v0.4.16 历史 release notes 措辞全部修正，并彻底删除 themes/clawd-dev/ 文件夹（曾作骨架学习历史对照保留，但既然没授权就不应该挂在 repo 里）。

---

🗑️ 删除内容

• themes/clawd-dev/ 整个目录（66 文件 / 2.2MB / 0 个代码 import）
• 含 64 个 SVG/GIF sprite + 1 个 README + 1 个 theme.json + .gitignore
• 代码已无引用（v0.4.9 切到 deskpet-cc 后此文件夹已 dead）

Clawd 是 @rullerzhou-afk 的 IP —— 想看 / 想用请去她的 clawd-on-desk 项目并联系她。

---

📝 措辞修正范围

文件 / 位置	改了什么
根 README.md banner	"老 Clawd 设计语言指导" → "Clawd 形象本身未获原作者授权使用 / 仅借鉴骨架"
根 README.md License	"授权指导" → "只借鉴骨架不复刻 / clawd-dev 已删"
根 README.md Acknowledgments	加 ⚠️ 事实边界声明段，明确 4 条
01-桌宠客户端/desktop-pet/README.md	同步上面
v0.4.15 release notes	重写鸣谢段，加 ⚠️ 边界声明 + 历史措辞修正说明
v0.4.16 release notes	同步上面
App.tsx:32 comment	清理过时表述

---

🙏 感谢

感谢 @rullerzhou-afk ——

• 开源了 pet-forge（MIT）这套 SVG 桌宠制作工作流，本项目用它从零搭建 deskpet-cc 的全部 21 个 sprite
• 她的 Clawd 项目 为本项目提供了骨架层面的学习参考（动画 rigging 思路 / 状态机层次结构）

虽然 Clawd 形象本身未授权使用，但她的开源工作流和给的缓冲期让我能从零做出 deskpet-cc。功能本身等价于 v0.4.16：详见 v0.4.16 release notes（trash + trust scope + copy_file + organize_files）。

---

📥 下载

平台	文件
Apple Silicon	DeskPet-0.4.17-arm64-mac.zip
Intel Mac	DeskPet-0.4.17-mac.zip
Windows	DeskPet-0.4.17-setup.exe
Linux AppImage	DeskPet-0.4.17-x86_64.AppImage
Linux deb	DeskPet-0.4.17_amd64.deb

英文版加 -EN 前缀。一键装：

curl -fsSL https://raw.githubusercontent.com/Ice-teapop/desktop-pet/main/scripts/install.sh | bash

v0.4.16

DeskPet v0.4.16 — 🗑 删除走废纸篓 + AI tool chain 一气呵成 + 整理 macro

用户反馈两个痛点：① "把桌面文件移到我桌宠文件夹里" 要追多轮对话才能完成；② "删除文件的本质不是隐藏文件，而是移动到垃圾桶里"。这次三方诊断（架构师 + 审核官员 + tool 分析师并行）找到根因并一并修复。

---

🗑 删除文件 → macOS 废纸篓（可恢复）

• 之前：fs.unlink / fs.rmdir 永久删除，不可恢复，跟 macOS 用户对 "Delete" 的心智模型严重错位
• 现在：走 electron.shell.trashItem —— 跨平台 macOS Finder 废纸篓 / Windows 回收站 / Linux freedesktop trash
• 文件可在 Finder → 废纸篓 → 右键放回 完整恢复
• 模态文案改为 "🗑 AI 想把这个移到废纸篓（可在 Finder 恢复）"，不再宣称 "不可恢复"
• 副作用收益：非空目录现也能删 —— 整树进废纸篓，不再 ENOTEMPTY 阻塞
• 废纸篓不可用时（Linux headless / 只读卷 / SMB）弹 fallback modal 让你选 "永久删 / 取消"，绝不静默 fall-through 到 unlink

🚀 单轮 chain — AI 一气呵成不再追多轮

之前 AI 调一个 tool 就让出 control 等用户回话，把"移到桌宠文件夹"这种 3 步任务拆成 3 轮对话。这次：

• trust scope 扩展：move_file 现在跟 write_file 一样走 trust check —— 当 src + dest 都在默认信任范围（~/Documents、~/Downloads、~/Desktop、~/DeskPet、~/Projects 等 HOME visible 顶级目录）时静默执行无 modal
• system prompt 重写：删掉 "调之前在回复里先简短告知'我要删 X 你点确认'" 这条让 AI 中途让出 control 的引导；加 "一气呵成 (CRITICAL)" 段明确要求 AI 在单轮 response 内跑完整链
• batch 强制：≥2 个文件必须用 paths[] / moves[] / copies[] 一次 modal 批准全部，禁止 loop 调 N 次

效果："把桌面 X.png 移到 ~/DeskPet/assets/" → AI 单轮内 create_directory + move_file 跑完，0 个 modal，直接告知完成。

📋 新 tool: copy_file

move_file 的镜像但 src 保留。用途：复制模板 / 改前 snapshot / 把截图复制进项目目录但留底原文件。

• schema: { src, dest, overwrite? } 单次 / { copies: [{src, dest, overwrite?}, ...] } 批量
• 实现：fs.cp({ recursive: true, force: overwrite })
• 同 move_file 的 trust 规则 —— 都在 trusted scope 内静默

🗂️ 新 macro tool: organize_files

整理类任务的一气呵成 —— 内部串 find_files + create_directory + 批量 move/copy，1 个 modal 解决。

• schema: { from, to, pattern?, action: 'move'|'copy', overwrite? }
• 例： "桌面所有 *.png 归档到 ~/Pictures/Screenshots/" → AI 调一个 organize_files 而不是手动串 3 个 tool
• AI 在 system prompt 里被显式鼓励 "整理类任务优先用这个 macro"

📦 总览

• AI 可用 tool 数：16 → 18（加 copy_file + organize_files）
• 7 个相关文件改动，568 行新增 / 68 行删除
• 真实 user smoke test：5 个 case 全 pass

📥 下载

平台	文件
Apple Silicon	DeskPet-0.4.16-arm64-mac.zip
Intel Mac	DeskPet-0.4.16-mac.zip
Windows	DeskPet-0.4.16-setup.exe
Linux AppImage	DeskPet-0.4.16-x86_64.AppImage
Linux deb	DeskPet-0.4.16_amd64.deb

英文版加 -EN 前缀。一键装：

curl -fsSL https://raw.githubusercontent.com/Ice-teapop/desktop-pet/main/scripts/install.sh | bash

🙏 鸣谢

感谢 @rullerzhou-afk 开源 pet-forge（MIT）工作流，本项目用它从零搭建 deskpet-cc 全套 21 个 sprite。

⚠️ Clawd 形象本身未获原作者授权使用 — deskpet-cc 21 个 sprite 完全独立重画，致敬 Anthropic Claude Code 公开 mascot 形象，不含任何 Clawd 资产。详见 v0.4.17 release notes 的事实边界声明。

v0.4.15

DeskPet v0.4.15 — 全主题切换 deskpet-cc + 全项目 MIT

这是 v0.4.14（构建失败、未发布）的修复版。v0.4.14 commit 意外截断了 package.json，CI npm ci 阶段直接挂掉，0 artifact 产出；v0.4.15 把文件恢复并重新打包，无功能差异，请装这个。

---

🦀 主题：21 个原创 sprite deskpet-cc

老的 clawd-dev 主题资源不再随 release 打包（保留在 repo 作为历史参考）；当前 active 主题是全套原创像素螃蟹 themes/deskpet-cc/，致敬 Claude Code 公开 mascot 形象。

21 个 sprite 覆盖：idle / yawning / dozing / collapsing / sleeping / wake / thinking / typing(working-wizard) / happy / error / notification / mini-idle / sweeping / hammer / search / carrying / peek / wave / jump / looking-around / juggling / conducting

动画细节：4.6s 巫师帽事故 sequence（4 专家联合设计：动画师/运动分析师/动画轨道师/创意师）、shadow 实时跟随 pet 本体呼吸 + 倾斜、wake 1.5s 完整 stir → 撑起 → 站定 → 眨眼、6s 7-phase 4 连击东张西望。

---

📄 License 改纯 MIT

• 全项目 MIT，可商用
• deskpet-cc 主题是原创 by @Ice-teapop（即 han），随 MIT 发布
• ⚠️ 老 clawd-dev 主题资源在 v0.4.17 起已从 repo 完全删除（Clawd 形象未获原作者授权使用，详见下方鸣谢段事实边界）

---

🙏 鸣谢 — @rullerzhou-afk

感谢 rullerzhou ——

• 开源了 pet-forge（MIT）这套 SVG 桌宠制作工作流，本项目用它从零搭建 deskpet-cc 的全部 21 个 sprite
• 她的 Clawd 项目 为本项目提供了骨架层面的学习参考（动画 rigging 思路 / 状态机层次结构）

⚠️ 事实边界声明（v0.4.17 修正）

• Clawd 形象本身未获原作者授权使用 —— 本项目早期临时借用过 Clawd 资产，被原作者发现后她给了一个缓冲期让我重做，于是有了完全原创的 deskpet-cc 主题（v0.4.9 起）
• deskpet-cc 21 个 sprite 完全独立重画，致敬 Anthropic Claude Code 公开 mascot 形象（小螃蟹是 Anthropic 公开 IP），不含任何 Clawd 资产
• 老 themes/clawd-dev/ 文件夹已于 v0.4.17 从 repo 完全删除（曾作骨架学习历史对照保留）
• Clawd 是 @rullerzhou-afk 的 IP，想看 / 想用请去她的 clawd-on-desk 项目并联系她

📝 历史措辞修正说明：本 release 早期版本错误描述为"原作者授权直接借鉴老 Clawd 动画 keyframes"，事实并非如此。pet-forge 的 MIT 授权是真实的，但 Clawd 形象从未授权过。已于 v0.4.17 修正。

---

📦 下载

平台	文件
Apple Silicon	DeskPet-0.4.15-arm64-mac.zip
Intel Mac	DeskPet-0.4.15-mac.zip
Windows	DeskPet-0.4.15-setup.exe
Linux AppImage	DeskPet-0.4.15-x86_64.AppImage
Linux deb	DeskPet-0.4.15_amd64.deb

英文版同名加 -EN 前缀。一键装：

curl -fsSL https://raw.githubusercontent.com/Ice-teapop/desktop-pet/main/scripts/install.sh | bash

macOS 首次右键 → 打开（绕 Gatekeeper），或终端 xattr -dr com.apple.quarantine /Applications/DeskPet.app。

v0.4.13

DeskPet v0.4.13 — README 大改

仅文档发版（代码无变化，从 v0.4.12 直接 bump）。

📚 README 重写要点

• 顶部加项目状态 + deskpet-cc 主题介绍
• 普通用户 1 行安装放最前
• 桌宠交互列表（单/双/4 击 / 拖拽 / sleep chain / mini peek）
• LLM Providers 改成表格列 6 个（不再只 Anthropic 必需）
• 已实现功能全面更新（21 sprite + 多 provider fallback + native server-side tools）
• 开发者发版流程改成 git tag 自动 CI 触发
• npm scripts:en 系列补齐

🙏 特别鸣谢

特别感谢 @rullerzhou ——

• 无偿提供了 pet-forge（MIT）这套 SVG 桌宠制作 skill + 完整工作流
• 在 Claude Code 小螃蟹形象设计 / 像素动画规范 / 状态衔接节奏上给予关键指导
• 全程持续的鼓励与耐心带教

本版本 deskpet-cc 主题的 21 个 sprite 全部参考 pet-forge 的 SVG 路线规范创作；睡眠链 / 打字 / 巫师事故 / 抛球 / 招手 / 锤击 等动画 keyframes 节奏直接借鉴老 Clawd 设计语言。

没有她的开源精神和细致带教，DeskPet 桌宠形象不可能在这么短时间内完成从零到 21 个 sprite 的全套替换。一切归功于她。

📦 下载

跟 v0.4.12 相同代码，二进制只是版本号 bump（README 跟 release entry 更新）。

v0.4.12

DeskPet v0.4.12 — 像素 CC 螃蟹主题全面替换 + 完整状态机调优

这是 DeskPet 桌宠 sprite 全主题替换的收官版本。从 v0.4.9 起 4 个连续发版完成了从老 Clawd 资源到全新 deskpet-cc 像素螃蟹主题的过渡 + 21 个 sprite 设计 + 状态机时长调优。

🎨 主题变更

• 全新 deskpet-cc 主题 — 21 个手工像素 sprite（idle / wizard / typing / conducting / juggling / sweeping / hammer / search / carrying / peek / wave / yawning / dozing / collapsing / sleeping / wake / thinking / happy / error / notification / mini-idle）
• viewBox 0 0 45 45 + outer scale 0.7 锚脚底 — pet 缩 30%，跟输入框水平对齐
• 像素风纯整数坐标 + shape-rendering crispEdges
• 配色锁定（5 色：主体 / 高光 / 暗带 / 描边 / 眼）

🔧 核心修复

• 眼跟随 + 钳子静态 — 严格搬老 Clawd 结构（eye-blink CSS animation 放 inner wrapper，#eyes-js 留给 rAF 写 inline transform，不冲突）
• 影子实时同步 — 删 CSS animation 抢占，App.tsx rAF inline 计算 sin 3.2s 跟 body breathe 同步
• 影子 body-driven（不再 cursor 远近）— 跟 pet 本体空间站位 + 倾斜方向同步
• wake 守护期 minMs 0→1500 — 醒来 1.5s 过渡动画完整播完（stir → 撑起 → X X 晕 → 站定 → 眨眼）
• wizard 重入场 — 主动切换时 React mount key 自增让 hat-drop 入场重播
• 双击跳一跳 + 四击东张西望 import 路径修正
• chat 打开期间锁 idle — 不切 idle variant 避免对话框旁边突然动作

🙏 特别鸣谢

特别感谢 @rullerzhou ——

• 无偿提供了 pet-forge（MIT）这套 SVG 桌宠制作 skill + 完整工作流
• 在 Claude Code 小螃蟹形象设计 / 像素动画规范 / 状态衔接节奏上给予关键指导
• 全程持续的鼓励与耐心带教

本版本 deskpet-cc 主题的 21 个 sprite 全部参考 pet-forge 的 SVG 路线规范创作；睡眠链 / 打字 / 巫师事故 / 抛球 / 招手 / 锤击 等动画 keyframes 节奏直接借鉴老 Clawd 设计语言。

没有她的开源精神和细致指导，DeskPet 的桌宠形象不可能在这么短时间内完成从零到 21 个 sprite 的全套替换。一切归功于她。

📦 下载

macOS Apple Silicon: `DeskPet-0.4.12-arm64-mac.zip`
macOS Intel: `DeskPet-0.4.12-mac.zip`
Windows: `DeskPet-0.4.12-setup.exe`
Linux: `DeskPet-0.4.12-x86_64.AppImage` / `DeskPet-0.4.12_amd64.deb`

英文版同前缀加 `-EN`。

v0.4.11

Multi-platform installers (mac arm64/x64 zip, win nsis, linux AppImage/deb) × ZH + EN locale builds. See CHANGELOG.md for changes.

v0.4.9

Multi-platform installers (mac arm64/x64 zip, win nsis, linux AppImage/deb) × ZH + EN locale builds. See CHANGELOG.md for changes.

v0.4.8

Multi-platform installers (mac arm64/x64 zip, win nsis, linux AppImage/deb) × ZH + EN locale builds. See CHANGELOG.md for changes.

v0.4.7

Multi-platform installers (mac arm64/x64 zip, win nsis, linux AppImage/deb) × ZH + EN locale builds. See CHANGELOG.md for changes.

v0.4.6

Multi-platform installers (mac arm64/x64 zip, win nsis, linux AppImage/deb) × ZH + EN locale builds. See CHANGELOG.md for changes.