dsh-fish-pet 0.2.6 → 0.2.8

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.2.8] - 2026-10-31
+
+### Docs
+- README 新增「一分钟了解」表格与「速览」快速开始，访客 30 秒看懂能做什么
+- 新增 `docs/promote.md`：V2EX / 掘金 / B 站 / 小红书 / 少数派 / awesome 列表的现成传播文案
+- README 增加「分享与传播」入口
+## [0.2.7] - 2026-10-31
+
+### Fixed
+- 喂食没有明显反馈：现在会冒泡 + 说话（按主人上一句的语言选台词）
+- 喂食语音和当前对话抢话：正在说话时只冒泡，不插话
+
+### Added
+- `tools/check-versions.ps1`：一条命令检查 Gitee / GitHub / npm 三个渠道版本是否一致
 ## [0.2.6] - 2026-10-31
 
 ### Changed

package/README.md

@@ -10,7 +10,44 @@
 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 养一条住在 Windows 桌面上的蓝鱼。
 它不是网页贴图：是一个**逐像素透明的置顶窗口**，用 PowerShell + WinForms 逐帧绘制，还能**听你说话、跟你聊天、用中文语音回你**。
 
-> 个人作品，与 DeepSeek 官方无关。
+## 一分钟了解
+
+| 它能做什么 | 说明 |
+| --- | --- |
+| 🐟 **住在桌面上** | 逐像素透明置顶窗口，程序不到 100KB——纯 PowerShell + WinForms 手写逐帧绘制 |
+| 🎤 **听你说话** | WASAPI 连续采集 + 自研 VAD，说完自动识别（硅基流动 Qwen3-ASR） |
+| 💬 **跟你聊天** | 接 DeepSeek，带人设、记得上下文、情绪会写在语气里 |
+| 🔊 **念给你听** | 微软 Edge 免费音色（默认晓晓），中英文自动切换音色 |
+| 😊 **有情绪** | 饥饿值 / 亲密度 / 心情，开心睁眼、委屈半垂带泪、生气压低 |
+| 📝 **记事与提醒** | 说"十分钟后提醒我喝水"，到点主动喊你 |
+| 🍚 **能喂** | 点一下就喂白饭，会冒爱心、撒娇 |
+
+> 个人作品，与 DeepSeek 官方无关。需要自备两个 API key（对话 + 语音识别），不是免费服务。
+
+## 速览
+
+```powershell
+# 1) 装成 DSH 插件（推荐）
+dsh plugin --profile web add "git+https://gitee.com/adengou/dsh-fish-pet.git"
+
+# 2) 配两个 key（各写一行，只放 key 本身）
+mkdir "$env:USERPROFILE\.dsh\fish-pet" -Force
+Set-Content "$env:USERPROFILE\.dsh\fish-pet\deepseek.key"    -Value "sk-..." -NoNewline
+Set-Content "$env:USERPROFILE\.dsh\fish-pet\siliconflow.key" -Value "sk-..." -NoNewline
+
+# 3) 想要更自然的朗读音色（可选，免费）
+python -m pip install --upgrade edge-tts
+
+# 4) 重启 dsh web，鱼就来了
+```
+
+不装 DSH 也能单独跑：
+
+```powershell
+wscript.exe assets\start-pet.vbs   # 桌面鱼
+wscript.exe assets\start-ear.vbs   # 语音耳朵（可选）
+```
+
 
 ## 特性
 
@@ -323,3 +360,10 @@ powershell -NoProfile -Command "$e=$null;$t=$null;[void][System.Management.Autom
 ## 许可
 
 MIT，见 [LICENSE](LICENSE)。
+
+## 分享与传播
+
+想帮这个项目被更多人看到？仓库里有现成的素材包：
+
+- [docs/promote.md](docs/promote.md) —— V2EX / 掘金 / B 站 / 小红书 / 少数派的**现成文案**，复制即可用
+- 欢迎提 issue、提 PR，也欢迎点个 Star ⭐

package/assets/fish-pet.ps1

@@ -675,6 +675,17 @@ function Invoke-Feed {
         foreach ($dx in @(-26, 4, 30)) {
             $script:hearts += @{ dx = $dx; age = 0.0; life = 1.4 }
         }
+        # 给个明显的反馈：气泡 + 说话
+        $zhFeed = @('哼，就一口啊…再来一碗嘛', '白饭！主人最好了', '才、才不是为了你才吃的呢', '谢谢主人，鱼鱼吃饱了')
+        $enFeed = @('Hmph, only one bite? More please.', 'Rice! You are the best, master.', 'I am NOT eating because of you, okay?', 'Thank you master, Fatty Fish is full.')
+        $feedLine = ''
+        $feedLang = $script:langMode
+        if ($feedLang -eq 'auto') { try { $feedLang = Get-TextLang ([string]$script:lastUser) } catch { $feedLang = 'zh' } }
+        if ($feedLang -eq 'en') { $feedLine = Get-Random -InputObject $enFeed } else { $feedLine = Get-Random -InputObject $zhFeed }
+        Show-Bubble $feedLine
+        # 正在说话时只冒泡，不插话（否则语音和喂食不搭调）
+        $speechBusy = ($script:ttsSegPlaying -ge 0) -or (@($script:ttsSegs).Count -gt 0) -or ($null -ne $script:ttsHandle)
+        if (-not $speechBusy) { try { Speak-Text $feedLine } catch { } }
         Save-State
     } catch {
         $line = (Get-Date -Format 'HH:mm:ss') + '  FEED-ERR  ' + $_.Exception.Message

package/docs/promote.md

@@ -0,0 +1,189 @@
+# 传播素材包 · dsh-fish-pet
+
+> 用途：把这个项目分享到各平台时，直接复制对应段落改一改就能发。
+> 原则：**不夸大、不刷量、写清成本**。项目是个人作品，与 DeepSeek 官方无关。
+
+---
+
+## 一、30 秒电梯稿（任何场合都能用）
+
+> 给 DeepSeek Harness 养的桌面宠物：一条住在 Windows 桌面上的 AI 蓝鱼。
+> 不是网页贴图，是逐像素透明的置顶窗口，100KB 大小，纯 PowerShell + WinForms 手写绘制。
+> 能听你说话（麦克风）、能回你聊天（DeepSeek）、能用中文语音念出来，还记得你交代过的事。
+
+一句话版：
+
+> 「我在电脑桌面上养了条会说话的胖鱼，饿了会瘪嘴。」
+
+---
+
+## 二、各平台文案
+
+### 1. V2EX · 分享创造
+
+**标题**：`[分享] 用 PowerShell 写了个桌面 AI 宠物：一条会听会说的鱼`
+
+**正文**：
+
+```
+前阵子折腾 DeepSeek Harness，顺手做了个小玩意：一条住在 Windows 桌面上的 AI 鱼。
+
+技术上有意思的地方：
+- 逐像素透明的置顶窗口（UpdateLayeredWindow + GDI+ 逐帧绘制），不是网页贴图
+- 整个程序 100KB 左右，纯 PowerShell 5.1 + WinForms，没有第三方依赖
+- 语音链路：WASAPI 连续采集 + 自研 VAD → 云端 Qwen3-ASR 识别 → DeepSeek 回复 → Edge TTS 朗读
+- 朗读做了分段流水线：先念第一句，后面边播边合成，开口等待约 2 秒
+- 会记情绪（饥饿/亲密度/心情），表情会跟着变：开心睁眼、委屈半垂带泪、生气压低
+- 中英自动切换：说中文回中文，说英文回英文，音色也跟着换
+
+需要自己配两个 key（DeepSeek + 硅基流动），所以是自备 key 自备钱包，不是免费服务。
+
+仓库：https://gitee.com/adengou/dsh-fish-pet
+GitHub：https://github.com/adengou/dsh-fish-pet
+
+欢迎提 issue 骂我代码烂，但求别骂鱼胖。
+```
+
+**标签建议**：`分享创造` `桌面` `PowerShell` `AI`
+
+---
+
+### 2. 掘金 / 博客园 / 思否 · 技术长文
+
+**标题候选**：
+- `用 PowerShell 手写一个 100KB 的桌面 AI 宠物`
+- `桌面宠物怎么做才不假？聊聊分层窗口、VAD 和 TTS 流水线`
+- `从"能跑"到"灵敏"：语音桌面宠物的 5 次性能优化`
+
+**大纲**：
+
+1. 为什么要用 PowerShell 写桌宠（单文件、无依赖、Win10 自带）
+2. 逐像素透明窗口：`UpdateLayeredWindow` 怎么用，为什么不能用 `TransparencyKey`
+3. 绘制：GDI+ 逐帧画圆滚滚的鱼（附参数：身体椭圆、高光、眨眼弧线）
+4. 语音输入：WASAPI 连续采集 + VAD 判定（踩坑：一次性采集中途无法暂停，导致"自己听自己"）
+5. 语音输出：Edge TTS 免费音色 → 常驻进程复用连接 → 分句流水线（4 秒 → 2 秒）
+6. 情绪系统：饥饿值/亲密度/心情如何影响语气与表情
+7. 踩坑清单：UTF-8 BOM、右键菜单闪退、`$g` 插值、泰文乱码
+8. 打包成 DSH 插件 + 发 npm 的流程
+
+**引流技巧**：文末放仓库链接 + 一张动图，标题带"我踩了 X 个坑"这类具体数字。
+
+---
+
+### 3. B 站 · 短视频
+
+**标题**：`桌面养了条会说话的鱼，还能自己记事儿`
+
+**分镜脚本（45 秒）**：
+
+| 时间 | 画面 | 旁白/字幕 |
+| --- | --- | --- |
+| 0-5s | 鱼在桌面游动、眨眼、吐泡泡 | 「我在电脑桌面上养了条鱼」 |
+| 5-12s | 对麦克风说话，气泡出现中文回复，然后鱼开口念出来 | 「它听得懂我说什么」 |
+| 12-20s | 切英文再问一次，鱼用英文回答 | 「说英文它也跟得上，还换成英文的嗓子」 |
+| 20-28s | 右键菜单展开，点「加个提醒」 | 「还能记事儿，到点主动提醒你」 |
+| 28-36s | 连续点几下喂食，鱼冒爱心 + 说「再来一碗嘛」 | 「饿了会瘪嘴，喂它还会撒娇」 |
+| 36-45s | 仓库二维码 + 项目地址 | 「开源，GitHub/Gitee 都能找到」 |
+
+**封面**：鱼的特写 + 大字「桌面养鱼」。
+
+---
+
+### 4. 小红书 · 生活向
+
+**标题**：`桌面养了只会说话的胖鱼🐟 它饿了会瘪嘴`
+
+**正文**：
+
+```
+本来想找个桌面宠物，结果自己写了一条…
+
+它住在电脑桌面最上层，会游来游去、会眨眼、会吐泡泡
+我说话它听得懂，还会用软软的声音回答我
+开心的时候眼睛亮亮的，饿了会瘪嘴，凶它一句就委屈
+
+最上头的是它记事儿——
+我说"十分钟后提醒我喝水"，到点它真的会喊我
+
+（自己写的，开源，仓库放评论区）
+```
+
+**关键词**：`#桌面宠物` `#AI桌宠` `#桌面美化` `#程序员日常`
+
+---
+
+### 5. 少数派 / Matrix · 工具测评向
+
+**标题**：`我在桌面上养了条 AI 鱼：一个 100KB 的开源桌面宠物`
+
+**角度**：不写代码，写"用起来是什么感觉"——
+- 和 Wallpaper Engine 那种静态桌宠的区别（这条会对话）
+- 和网页版 AI 助手的区别（它在你桌面上，抬眼就能看到）
+- 缺点要写：需要自己配 API key、只有 Windows、说话有 2 秒延迟
+
+---
+
+### 6. awesome 列表（长期曝光，适合 GitHub）
+
+可以直接提交的项目：
+
+| 列表 | 提交方式 |
+| --- | --- |
+| `awesome-powershell` | PR 加一行到 "Projects" 区 |
+| `awesome-windows` | PR 加一行到 "Desktop enhancements" |
+| `awesome-desktop-apps` | PR 加一行 |
+| `awesome-chatgpt` 系列（AI 应用类） | 视列表规则 |
+
+**PR 描述模板**：
+
+```
+Add dsh-fish-pet: a 100KB desktop AI pet for Windows written in PowerShell + WinForms.
+- Translucent always-on-top window rendered with GDI+
+- Voice chat: WASAPI capture + VAD → Qwen3-ASR → DeepSeek → Edge TTS
+- Emotion system and reminders
+Repo: https://github.com/adengou/dsh-fish-pet
+```
+
+---
+
+## 三、Gitee 站内优化清单
+
+- [ ] 仓库简介填一句话：「给 DeepSeek Harness 养的桌面 AI 鱼，能听能说能记事」
+- [ ] 加 Topics：`desktop-pet` `windows` `powershell` `winforms` `ai` `text-to-speech` `voice-assistant` `deepseek` `desktop-pet-windows`
+- [ ] README 顶部放动图（比静图点击率高 2~3 倍）
+- [ ] 申请 Gitee 推荐位 / GVP 评选
+- [ ] 打 tag 发 Release（0.2.7），附件放 tgz 包
+
+---
+
+## 四、发布节奏建议
+
+| 时间 | 动作 |
+| --- | --- |
+| 第 1 天 | Gitee 优化完 + 发 V2EX 一帖 |
+| 第 2-3 天 | 掘金发技术长文（文里嵌动图） |
+| 第 4 天 | B 站/小红书发短视频（同一素材剪两版） |
+| 第 2 周 | 向 awesome 列表提 PR |
+| 之后 | 每次发版同步一条动态，别刷屏 |
+
+---
+
+## 五、必须写清楚的三件事（避免招黑）
+
+1. **成本**：每轮对话走 DeepSeek、语音识别走硅基流动，用户要自备 key，不是免费服务
+2. **平台**：只支持 Windows 10/11
+3. **延迟**：说完到开口约 2 秒，不是实时
+
+---
+
+## 六、动图录制指引（自己录，5 分钟）
+
+1. 把桌面清空（关掉聊天窗口，只留壁纸）
+2. 打开鱼，让它游到一个干净的角落
+3. 用 **ScreenToGif**（免费）或 Windows 自带 `Win+G` 录 8~12 秒
+4. 录三段素材：
+   - 游动 + 眨眼 + 吐泡泡
+   - 说一句话 → 气泡出现 → 语音念出
+   - 右键菜单展开
+5. 导出 GIF（宽 600px、10fps、< 3MB）放 `docs/demo.gif`
+6. README 第一行换成 `![demo](docs/demo.gif)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-fish-pet",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Desktop blue fish pet for DeepSeek Harness: per-pixel transparent WinForms window, text chat, and cloud speech-to-text voice conversation.",
   "type": "module",
   "main": "lib/index.js",

package/tools/check-versions.ps1

@@ -0,0 +1,61 @@
+# check-versions.ps1 · 检查 Gitee / GitHub / npm 三个渠道的版本是否一致
+# 用法：powershell -ExecutionPolicy Bypass -File tools\check-versions.ps1
+# 退出码：0 = 全部一致；1 = 有不一致
+
+$ErrorActionPreference = 'Stop'
+$pkgDir = Split-Path -Parent $PSScriptRoot
+$reg = 'https://registry.npmjs.org'
+
+Push-Location $pkgDir
+try {
+    $localVer = (Get-Content 'package.json' -Raw | ConvertFrom-Json).version
+
+    $gitVer = ''
+    try { $gitVer = (git show HEAD:package.json | Out-String | ConvertFrom-Json).version } catch { $gitVer = '(读取失败)' }
+
+    $gitHubVer = ''
+    try { $gitHubVer = (git show 'github/main:package.json' | Out-String | ConvertFrom-Json).version } catch { $gitHubVer = '(未同步)' }
+
+    $npmVer = ''
+    try {
+        $npmVer = (& npm view dsh-fish-pet version --registry=$reg 2>$null | Out-String).Trim()
+        if (-not $npmVer) { $npmVer = '(查询失败)' }
+    } catch { $npmVer = '(查询失败)' }
+
+    $gitHead = (git rev-parse --short HEAD 2>$null | Out-String).Trim()
+    $gitGitee = (git rev-parse --short origin/main 2>$null | Out-String).Trim()
+    $gitGH = (git rev-parse --short github/main 2>$null | Out-String).Trim()
+
+    Write-Host ''
+    Write-Host '渠道            版本        提交' -ForegroundColor Cyan
+    Write-Host ('本地工作区      {0,-10}  {1}' -f $localVer, $gitHead)
+    Write-Host ('Gitee (origin)  {0,-10}  {1}' -f $gitVer, $gitGitee)
+    Write-Host ('GitHub          {0,-10}  {1}' -f $gitHubVer, $gitGH)
+    Write-Host ('npm (latest)    {0,-10}' -f $npmVer)
+    Write-Host ''
+
+    $problems = @()
+    if ($localVer -ne $gitVer) { $problems += "本地 package.json($localVer) 与 Gitee($gitVer) 不一致——忘了提交？" }
+    if ($gitVer -ne $gitHubVer) { $problems += "Gitee($gitVer) 与 GitHub($gitHubVer) 不一致——GitHub 没推上去" }
+    if ($localVer -ne $npmVer) {
+        if ($npmVer -match '^\d') {
+            $problems += "本地($localVer) 与 npm($npmVer) 不一致——npm 可能还在审核，或没发布"
+        } else {
+            $problems += "npm 版本查询失败（$npmVer），检查网络或 registry 配置"
+        }
+    }
+
+    if ($problems.Count -eq 0) {
+        Write-Host '✅ 三个渠道版本一致' -ForegroundColor Green
+        exit 0
+    } else {
+        Write-Host '⚠️ 发现不一致：' -ForegroundColor Yellow
+        $problems | ForEach-Object { Write-Host ("  - " + $_) -ForegroundColor Yellow }
+        Write-Host ''
+        Write-Host '提示：npm 发布后要等自动审核（几分钟），审核通过 latest 才会跳到新版本。' -ForegroundColor DarkGray
+        exit 1
+    }
+}
+finally {
+    Pop-Location
+}