前言¶
DSH 生態強調“一切皆插件”,社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。對經常使用 DeepSeek Harness 的開發者來說,插件不只是擴展模型能力,也可以擴展工作界面和任務反饋。dsh-nailong-desktop-pet 就是這類輕量界面插件:它把 Harness 任務狀態、自定義角色和桌面陪伴放到一個可配置的寵物形態裏。
這是什麼¶
dsh-nailong-desktop-pet 是一個非官方、可自定義的 Nailong(奶龍)桌面寵物社區插件,用於 DeepSeek Harness。維護者是 2002yxy,代碼許可證爲 MIT。項目資料稱其爲 early Alpha,面向反饋和迭代發佈。
它主要解決兩個問題:一是提供一個可顯示、可調整、可自定義的桌面寵物;二是把 Harness 任務狀態彙總爲更直觀的等待、運行、未讀完成或空閒狀態。
核心功能¶
平臺表現¶
在 macOS 上,插件會啓動透明、無邊框的 AppKit companion,可以跨應用和 Spaces 移動。該原生寵物爲純美術展示,沒有方形卡片、焦點環、標題欄或窗口陰影。寵物可以拖拽,點擊可將 Harness 帶到前臺。
其他平臺回退到 Harness 窗口內的透明寵物。該回退可以打開最相關 Session 並顯示活動托盤,但無法把寵物移出 Harness 窗口。
預設與狀態¶
插件內置 Nailong(奶龍),並提供四個額外預設:DeepSeek whale、Naihuang、Jinglong、Naijing。
每個預設以透明 Hatch v1 atlas 提供,包含九個語義狀態和 57 個活動幀。插件支持每個角色獨立的大小設置、運動設置、動畫預覽、方向拖拽動畫和保存位置。
它還可以彙總 Harness 任務狀態,顯示爲等待輸入、未讀完成、運行中或空閒。
自定義寵物¶
插件支持從 PNG、JPEG、WebP、GIF、AVIF 或 BMP 創建自定義寵物。默認路徑可以在本地構建多狀態 2.5D atlas。若配置了可選的圖像生成憑證,可生成一致的 3D-toy pose sheet,並編譯爲 Hatch v1 atlas。
自定義流程打包了 /create-desktop-pet Skill,以及三個 host tools:inspect_desktop_pet_draft、hatch_desktop_pet_draft、install_desktop_pet。
安裝與啓用¶
安裝前建議檢查源碼、許可證和發佈文件。該 Alpha 附帶預構建運行時文件,包含源碼供審查,但還不是獨立開發工作區。
使用本地 archive 安裝:
dsh plugin --profile web add ./dsh-desktop-pet-0.1.0-alpha.2.tgz
如果從 GitHub 安裝,建議使用固定 tag:
dsh plugin --profile web add github:2002yxy/dsh-nailong-desktop-pet#v0.1.0-alpha.2
安裝後如果插件未立即出現,重啓 Harness。
如需移除:
dsh plugin --profile web remove dsh-desktop-pet
典型用法¶
1、進入 Settings > Plugins,打開 Desktop Pet 頁面。
2、使用插件頁頂部的高頻控制顯示或隱藏桌面寵物。
3、選擇一個預設,調整大小、運動、動畫預覽、方向拖拽動畫,並保存位置。
4、在 macOS 上,把寵物拖到合適位置;點擊寵物可將 Harness 帶到前臺。
5、在其他平臺,使用 Harness 窗口內回退,打開最相關 Session 或顯示活動托盤。
創建自定義寵物時,先選擇 Custom pet,選擇圖片並點擊 Create pet。然後審閱並手動發送預填的 /create-desktop-pet 請求。Skill 會調用 inspect_desktop_pet_draft、hatch_desktop_pet_draft 和 install_desktop_pet。安裝完成後,動畫角色會回到寵物庫,可以選擇並像預設一樣調整大小或運動。
適用場景與注意¶
適合想要輕量桌面陪伴、需要把 Harness 狀態放在可見位置、或希望用自己的圖片生成角色動畫的開發者。
需要注意:
- 項目爲 early Alpha,用於反饋和迭代發佈。
- macOS 原生 companion 面向
macOS 13+的 Apple Silicon 和 Intel,尚未簽名或公證。 - 其他平臺使用 Harness 窗口內回退,無法將寵物移出 Harness 窗口。
- macOS 原生點擊可激活 Harness,但尚不能深鏈到特定 Session。
- 偏好設置不在設備間同步。
- 生成 3D 渲染需要單獨配置的圖像生成憑證;否則自動生成本地 2.5D 結果。可選圖像生成憑證僅用於生成的 3D 路徑。
- 普通顯示、移動、選擇和配置不增加模型輸入或 tokens;自定義寵物任務僅在用戶明確發送時增加請求和工具調用。
- 圖片本身不進入模型上下文;自定義角色和偏好保留在當前 Harness 瀏覽器 profile。
- 插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。該項目爲獨立社區項目,不是 DeepSeek 官方發佈;預設美術來源和再分發權利在公開發布前需要確認。
結尾¶
dsh-nailong-desktop-pet 把桌面寵物、預設動畫、任務狀態和自定義角色流程放進同一個 DSH 插件。適合先在小範圍環境中試用,並根據 macOS 原生體驗、自定義寵物流程和當前 Harness 版本持續驗證。
GitHub:https://github.com/2002yxy/dsh-nailong-desktop-pet
社區目錄線索:https://www.skillhub.cn/plugins/2002yxy/dsh-nailong-desktop-pet(該目錄地址來自線索,未作爲已抓取事實確認)