This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-pet — Whale Girl Pet Plugin

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add @linxin666/dsh-pet

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

• 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
• 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
• 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
• Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
• 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Will Whale Girl appear on all interfaces?

Yes, it will. The plugin attaches itself to document.body and pops up a new chat window, displaying even when there are no conversations, and it won't disappear when switching conversations.

Do I get intimacy even if I don't click the pet?

Yes. The model's intimacy increases by +1 automatically after each round, with 4 levels: Baby Whale → Companion → Best Friend → Deep Sea Bond (capped at 100 points).

Why is there no response when I click the pet?

Clicks repeated within 10 seconds will be rejected by cooldown, and the pet will display "You've pet too much, let Whale Girl rest a bit~".

What is consumed for feeding?

Each feeding consumes 1 small fish, giving +5 intimacy; 1 small fish is earned every 3 work rounds, plus 1 every 30 minutes of idle time, capped at 20 fish.

Where is the data stored?

Stored in $DSH_HOME/pet.json (default ~/.dsh/pet.json), using atomic writes; if the file is corrupted, it will fall back to default state on next startup.

What if I can't see Whale Girl?

First, on the settings page, ensure the "Enable Pet" and "Show Pet" switches are turned on in the "Pet" card; second, edit ~/.dsh/settings.yaml directly in advanced settings to add the pet namespace; finally, you can restart dsh web to reload the plugin.

Is the dragged position saved?

Yes. After releasing, the position is persisted through the settings channel and will remain in the same place when opened next time.

Can I change the name?

Click "Rename" in the floating panel and enter a new name with 1-20 characters; it will sync to the summon button text and the persistence file.

— source: plugin_wiki.faq_json

Compatibility

• DSH: 0.1.0-rc.7+
• Node: >=22.19.0
• Platforms: 跨平台

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule