dsh-pet 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +91 -4
  2. package/README.zh.md +91 -4
  3. package/package.json +20 -3
package/README.md CHANGED
@@ -1,10 +1,97 @@
1
- # dsh-pet
1
+ # dsh-pet 🐾
2
2
 
3
- A floating desktop pet for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI.
3
+ <p align="center">
4
+ <a href="https://www.npmjs.com/package/dsh-pet"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-pet?label=npm&color=blue"></a>
5
+ <a href="https://www.npmjs.com/package/dsh-pet"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-pet?color=brightgreen"></a>
6
+ <a href="https://github.com/PC2005-cloud/dsh-pet"><img alt="stars" src="https://img.shields.io/github/stars/PC2005-cloud/dsh-pet?style=social"></a>
7
+ <a href="https://github.com/PC2005-cloud/dsh-pet/blob/master/LICENSE"><img alt="license" src="https://img.shields.io/github/license/PC2005-cloud/dsh-pet?color=orange"></a>
8
+ <a href="https://awesome-dsh-plugin.com"><img alt="awesome dsh plugin" src="https://awesome-dsh-plugin.com/badge.svg"></a>
9
+ <img alt="platform" src="https://img.shields.io/badge/platform-DeepSeek%20Harness%20Web-8A2BE2">
10
+ <img alt="assets" src="https://img.shields.io/badge/assets-25%20animations-ff69b4">
11
+ </p>
12
+
13
+ > A floating desktop pet for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI.
14
+ > 一只住在 DeepSeek Harness Web 界面里的桌面宠物：待机呼吸、随机动作、屏幕漫游、点击反应、可拖拽。
15
+
16
+ ---
17
+
18
+ ## ✨ 功能特性
19
+
20
+ - **25 个手绘风透明动画**：待机呼吸、打瞌睡、玩魔方、哼歌、炸毛、吐泡泡……全部无缝衔接
21
+ - **永不停止的动画链**：每段动画播完立即按概率选下一个（30% 待机 / 10% 转向 / 40% 动作 / 20% 移动）
22
+ - **屏幕漫游**：朝 facing 方向行走，自动检查空间、不走出屏幕
23
+ - **点击 / 拖拽**：点击有随机回应动画（开心 / 害羞 / 傲娇），可拖到任意位置
24
+ - **左右朝向**：所有动画 CSS 镜像，人物可朝左 / 朝右
25
+ - **落地对齐**：动画统一脚底线，宠物始终站在"地面"上
26
+ - **流畅切换**：双缓冲 video 交叉淡入，切换零空白帧
27
+ - **无障碍友好**：支持 `prefers-reduced-motion`
28
+
29
+ ## 📦 安装
4
30
 
5
31
  ```sh
6
32
  dsh plugin --profile web add dsh-pet
7
33
  ```
8
34
 
9
- Full source, asset pipeline, and generation prompts live in the repository:
10
- **https://github.com/PC2005-cloud/dsh-pet**
35
+ 重启 `dsh web`，宠物出现在界面右下角。
36
+
37
+ ## ⚙️ 配置
38
+
39
+ | 配置项 | 说明 | 当前状态 |
40
+ |---|---|---|
41
+ | `size` | 宠物显示高度（px） | 默认 260，**暂未下发到浏览器**（DSH 客户端配置管线限制，走代码默认值） |
42
+ | `position` | 默认角落位置 | 默认右下角，同上暂未下发 |
43
+ | `fullRoot` | 原始 1200×1200 母版资源目录 | 默认 `$DSH_HOME/pet-assets`，需手动下载母版后生效 |
44
+
45
+ > 说明：插件安装即用，上述配置均为可选；`size`/`position` 的浏览器侧配置化正在规划中。
46
+
47
+ ## 🗑️ 卸载
48
+
49
+ ```sh
50
+ dsh plugin --profile web remove dsh-pet
51
+ ```
52
+
53
+ ## 🖥️ 运行效果
54
+
55
+ 宠物实际运行在 DSH Web 界面中的样子：
56
+
57
+ <p>
58
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/assets/screenshots/dsh-pet-running-1.png" width="380" alt="dsh-pet running in DSH Web UI 1" title="dsh-pet running in DSH Web UI 1">
59
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/assets/screenshots/dsh-pet-running-2.png" width="380" alt="dsh-pet running in DSH Web UI 2" title="dsh-pet running in DSH Web UI 2">
60
+ </p>
61
+
62
+ ## 🎬 效果预览
63
+
64
+ > 动画为透明背景；GIF 预览中透明部分显示为页面底色，实际播放为透明。
65
+
66
+ <p>
67
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E5%BE%85%E6%9C%BA%E5%91%BC%E5%90%B8%E4%BC%91%E9%97%B2.gif" width="160" alt="待机呼吸休闲" title="待机呼吸休闲">
68
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E4%B8%9C%E5%BC%A0%E8%A5%BF%E6%9C%9B.gif" width="160" alt="东张西望" title="东张西望">
69
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E5%8E%9F%E5%9C%B0%E6%BC%82%E6%B5%AE%E8%B8%8F%E6%AD%A5.gif" width="160" alt="原地漂浮踏步" title="原地漂浮踏步">
70
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E5%8E%9F%E5%9C%B0%E5%B0%8F%E6%86%A9%E6%B2%89%E7%9C%A0.gif" width="160" alt="原地小憩沉眠" title="原地小憩沉眠">
71
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E7%82%B9%E5%87%BB%E5%9B%9E%E5%BA%94%20-%20%E5%BC%80%E5%BF%83%E8%B7%83%E5%8A%A8.gif" width="160" alt="点击回应 - 开心跃动" title="点击回应 - 开心跃动">
72
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E8%A2%AB%E9%BC%A0%E6%A0%87%E6%8B%96%E6%8B%BD%E6%82%AC%E7%A9%BA%E5%8F%8D%E9%A6%88.gif" width="160" alt="被鼠标拖拽悬空反馈" title="被鼠标拖拽悬空反馈">
73
+ </p>
74
+
75
+ 全部 25 个动画见仓库：`dsh-pet/assets/thumb/`。
76
+
77
+ ## 📚 完整项目（不止是插件）
78
+
79
+ 这是**完整的三件套项目**，任何人 clone 仓库都可以从零生成自己的桌面宠物：
80
+
81
+ ```
82
+ ① 提示词（配方） → ② 素材生成链（引擎） → ③ 插件（成品）
83
+ AI 生成动画的配方 源视频 → 透明动画的管线 运行在 DSH 里的宠物
84
+ ```
85
+
86
+ - 仓库：[PC2005-cloud/dsh-pet](https://github.com/PC2005-cloud/dsh-pet)
87
+ - 设计与实现文档：[DESIGN.md](https://github.com/PC2005-cloud/dsh-pet/blob/master/DESIGN.md)
88
+
89
+ ## 🔎 发现更多 DSH 插件
90
+
91
+ - 社区插件目录：[awesome-dsh-plugin.com](https://awesome-dsh-plugin.com)
92
+ - DSH 官方仓库：[deepseek-ai/DeepSeek-Harness](https://github.com/deepseek-ai/deepseek-harness)
93
+
94
+ ## 📄 许可
95
+
96
+ - 代码：MIT
97
+ - 素材（动画/提示词）：见仓库说明
package/README.zh.md CHANGED
@@ -1,10 +1,97 @@
1
- # dsh-pet
1
+ # dsh-pet 🐾
2
2
 
3
- 一只住在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web 界面里的桌面宠物。
3
+ <p align="center">
4
+ <a href="https://www.npmjs.com/package/dsh-pet"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-pet?label=npm&color=blue"></a>
5
+ <a href="https://www.npmjs.com/package/dsh-pet"><img alt="npm downloads" src="https://img.shields.io/npm/dm/dsh-pet?color=brightgreen"></a>
6
+ <a href="https://github.com/PC2005-cloud/dsh-pet"><img alt="stars" src="https://img.shields.io/github/stars/PC2005-cloud/dsh-pet?style=social"></a>
7
+ <a href="https://github.com/PC2005-cloud/dsh-pet/blob/master/LICENSE"><img alt="license" src="https://img.shields.io/github/license/PC2005-cloud/dsh-pet?color=orange"></a>
8
+ <a href="https://awesome-dsh-plugin.com"><img alt="awesome dsh plugin" src="https://awesome-dsh-plugin.com/badge.svg"></a>
9
+ <img alt="platform" src="https://img.shields.io/badge/platform-DeepSeek%20Harness%20Web-8A2BE2">
10
+ <img alt="assets" src="https://img.shields.io/badge/assets-25%20animations-ff69b4">
11
+ </p>
12
+
13
+ > 一只住在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web 界面里的桌面宠物：待机呼吸、随机动作、屏幕漫游、点击反应、可拖拽。
14
+ > A floating desktop pet for the DeepSeek Harness Web UI.
15
+
16
+ ---
17
+
18
+ ## ✨ 功能特性
19
+
20
+ - **25 个手绘风透明动画**：待机呼吸、打瞌睡、玩魔方、哼歌、炸毛、吐泡泡……全部无缝衔接
21
+ - **永不停止的动画链**：每段动画播完立即按概率选下一个（30% 待机 / 10% 转向 / 40% 动作 / 20% 移动）
22
+ - **屏幕漫游**：朝 facing 方向行走，自动检查空间、不走出屏幕
23
+ - **点击 / 拖拽**：点击有随机回应动画（开心 / 害羞 / 傲娇），可拖到任意位置
24
+ - **左右朝向**：所有动画 CSS 镜像，人物可朝左 / 朝右
25
+ - **落地对齐**：动画统一脚底线，宠物始终站在"地面"上
26
+ - **流畅切换**：双缓冲 video 交叉淡入，切换零空白帧
27
+ - **无障碍友好**：支持 `prefers-reduced-motion`
28
+
29
+ ## 📦 安装
4
30
 
5
31
  ```sh
6
32
  dsh plugin --profile web add dsh-pet
7
33
  ```
8
34
 
9
- 完整源码、素材生成链与提示词都在仓库中：
10
- **https://github.com/PC2005-cloud/dsh-pet**
35
+ 重启 `dsh web`，宠物出现在界面右下角。
36
+
37
+ ## ⚙️ 配置
38
+
39
+ | 配置项 | 说明 | 当前状态 |
40
+ |---|---|---|
41
+ | `size` | 宠物显示高度（px） | 默认 260，**暂未下发到浏览器**（DSH 客户端配置管线限制，走代码默认值） |
42
+ | `position` | 默认角落位置 | 默认右下角，同上暂未下发 |
43
+ | `fullRoot` | 原始 1200×1200 母版资源目录 | 默认 `$DSH_HOME/pet-assets`，需手动下载母版后生效 |
44
+
45
+ > 说明：插件安装即用，上述配置均为可选；`size`/`position` 的浏览器侧配置化正在规划中。
46
+
47
+ ## 🗑️ 卸载
48
+
49
+ ```sh
50
+ dsh plugin --profile web remove dsh-pet
51
+ ```
52
+
53
+ ## 🖥️ 运行效果
54
+
55
+ 宠物实际运行在 DSH Web 界面中的样子：
56
+
57
+ <p>
58
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/assets/screenshots/dsh-pet-running-1.png" width="380" alt="dsh-pet 运行效果 1" title="dsh-pet 运行效果 1">
59
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/assets/screenshots/dsh-pet-running-2.png" width="380" alt="dsh-pet 运行效果 2" title="dsh-pet 运行效果 2">
60
+ </p>
61
+
62
+ ## 🎬 效果预览
63
+
64
+ > 动画为透明背景；GIF 预览中透明部分显示为页面底色，实际播放为透明。
65
+
66
+ <p>
67
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E5%BE%85%E6%9C%BA%E5%91%BC%E5%90%B8%E4%BC%91%E9%97%B2.gif" width="160" alt="待机呼吸休闲" title="待机呼吸休闲">
68
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E4%B8%9C%E5%BC%A0%E8%A5%BF%E6%9C%9B.gif" width="160" alt="东张西望" title="东张西望">
69
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E5%8E%9F%E5%9C%B0%E6%BC%82%E6%B5%AE%E8%B8%8F%E6%AD%A5.gif" width="160" alt="原地漂浮踏步" title="原地漂浮踏步">
70
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E5%8E%9F%E5%9C%B0%E5%B0%8F%E6%86%A9%E6%B2%89%E7%9C%A0.gif" width="160" alt="原地小憩沉眠" title="原地小憩沉眠">
71
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E7%82%B9%E5%87%BB%E5%9B%9E%E5%BA%94%20-%20%E5%BC%80%E5%BF%83%E8%B7%83%E5%8A%A8.gif" width="160" alt="点击回应 - 开心跃动" title="点击回应 - 开心跃动">
72
+ <img src="https://raw.githubusercontent.com/PC2005-cloud/dsh-pet/main/dsh-pet/assets/preview/%E8%A2%AB%E9%BC%A0%E6%A0%87%E6%8B%96%E6%8B%BD%E6%82%AC%E7%A9%BA%E5%8F%8D%E9%A6%88.gif" width="160" alt="被鼠标拖拽悬空反馈" title="被鼠标拖拽悬空反馈">
73
+ </p>
74
+
75
+ 全部 25 个动画见仓库：`dsh-pet/assets/thumb/`。
76
+
77
+ ## 📚 完整项目（不止是插件）
78
+
79
+ 这是**完整的三件套项目**，任何人 clone 仓库都可以从零生成自己的桌面宠物：
80
+
81
+ ```
82
+ ① 提示词（配方） → ② 素材生成链（引擎） → ③ 插件（成品）
83
+ AI 生成动画的配方 源视频 → 透明动画的管线 运行在 DSH 里的宠物
84
+ ```
85
+
86
+ - 仓库：[PC2005-cloud/dsh-pet](https://github.com/PC2005-cloud/dsh-pet)
87
+ - 设计与实现文档：[DESIGN.md](https://github.com/PC2005-cloud/dsh-pet/blob/master/DESIGN.md)
88
+
89
+ ## 🔎 发现更多 DSH 插件
90
+
91
+ - 社区插件目录：[awesome-dsh-plugin.com](https://awesome-dsh-plugin.com)
92
+ - DSH 官方仓库：[deepseek-ai/DeepSeek-Harness](https://github.com/deepseek-ai/deepseek-harness)
93
+
94
+ ## 📄 许可
95
+
96
+ - 代码：MIT
97
+ - 素材（动画/提示词）：见仓库说明
package/package.json CHANGED
@@ -1,8 +1,26 @@
1
1
  {
2
2
  "name": "dsh-pet",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "A floating desktop pet for the DeepSeek Harness Web UI: idle breathing, occasional direction turns, random actions, and screen wandering.",
5
-
5
+ "keywords": [
6
+ "dsh",
7
+ "dsh-plugin",
8
+ "deepseek-harness",
9
+ "desktop-pet",
10
+ "pet",
11
+ "floating-widget",
12
+ "web-ui",
13
+ "cordis",
14
+ "react"
15
+ ],
16
+ "homepage": "https://github.com/PC2005-cloud/dsh-pet#readme",
17
+ "repository": {
18
+ "type": "git",
19
+ "url": "git+https://github.com/PC2005-cloud/dsh-pet.git"
20
+ },
21
+ "bugs": {
22
+ "url": "https://github.com/PC2005-cloud/dsh-pet/issues"
23
+ },
6
24
  "_comment": [
7
25
  "=============== dsh-pet 包清单说明 ===============",
8
26
  "type: module —— 本包是 ESM",
@@ -16,7 +34,6 @@
16
34
  "peerDependencies —— 运行时由宿主（DSH）提供的模块，本包不打包它们",
17
35
  "================================================"
18
36
  ],
19
-
20
37
  "type": "module",
21
38
  "main": "lib/index.js",
22
39
  "exports": {