Nailong Desktop Pet · dsh-nailong-desktop-pet

English | 中文

An unofficial, customizable Nailong (奶龙) desktop-pet community plugin for DeepSeek Harness. Nailong is the lead character and visual identity of the project, with the DeepSeek whale and other companion presets included. This repository is an early Alpha intended for feedback and iterative releases.

On macOS, the plugin launches a transparent, borderless AppKit companion that can move across applications and Spaces. On other platforms, it falls back to a transparent pet inside the Harness window. The plugin also adds a Desktop Pet page under Settings > Plugins.

Install

Download the release archive and install it locally:

dsh plugin --profile web add ./dsh-desktop-pet-0.1.0-alpha.1.tgz

After this repository has been published and tagged, install the pinned GitHub release:

dsh plugin --profile web add github:2002yxy/dsh-nailong-desktop-pet#v0.1.0-alpha.1

Pinning the tag is strongly recommended because DeepSeek Harness and this plugin are both still evolving. Restart Harness after installation if the plugin does not appear immediately.

To remove it:

dsh plugin --profile web remove dsh-desktop-pet

See COMPATIBILITY.md before installing.

What it does

• Shows or hides a desktop pet from the high-frequency control at the top of the plugin page.
• Puts Nailong (奶龙) at the center of the experience and ships four additional presets: the DeepSeek whale, Naihuang, Jinglong, and Naijing.
• Supports per-character size and motion settings, transparent artwork, hover animation, directional drag animation, and saved position.
• Summarizes Harness task state as waiting for input, unread completion, running, or idle.
• Lets users create a custom pet from PNG, JPEG, WebP, GIF, AVIF, or BMP.
• Packages a /create-desktop-pet Skill and two host tools that inspect, normalize, and install the uploaded character.

The macOS pet is artwork-only: there is no square card, focus ring, titlebar, or window shadow. It can be dragged anywhere on the desktop. Clicking it brings Harness to the foreground. The in-Harness fallback can also open the most relevant Session and show an activity tray.

Custom-pet flow

1. Choose Custom pet, select an image, and click Create pet.
2. The plugin stores the source under an unguessable draft id, creates a blank DeepSeek task, selects the packaged Skill, and pre-fills an editable /create-desktop-pet request.
3. Review and manually send the request.
4. The Skill calls inspect_desktop_pet_draft once, then install_desktop_pet once with the final safe settings.
5. The Host corrects orientation, optionally removes only edge-connected background pixels, trims transparent bounds, adds padding, normalizes the result to a 512 px transparent PNG, and returns the installed character to the pet gallery.
6. Select the new character and adjust its size and motion like any preset.

The source image is not attached to the model message, so the workflow also works with text-only models. Image bytes stay in the local Host workflow.

Model and privacy impact

Normal display, movement, selection, and configuration add no model input or tokens. Only a custom-pet task that the user explicitly sends adds one text request, the packaged Skill text, and two local tool calls plus their results. The image itself does not enter model context.

Custom characters and preferences remain local to the current Harness browser profile. Review SECURITY.md for reporting guidance.

Compatibility and limitations

• The native companion targets macOS 13+ on Apple Silicon and Intel. It is not yet signed or notarized.
• Other platforms use the in-Harness fallback and cannot move the pet outside the Harness window.
• Each custom character currently becomes one static PNG. Animated output and multi-state sprite packs are deferred.
• Native clicking activates Harness but does not yet deep-link to a specific Session.
• Preferences do not sync across devices.
• This Alpha ships prebuilt runtime files so GitHub installation does not depend on a repository-side build. Source is included for review, but this package is not yet a standalone development workspace.

Community release checklist

The maintainer checklist, GitHub topic, tag, archive, checksum, and clean-profile verification steps are in RELEASING.md. Changes are tracked in CHANGELOG.md.

License and names

Code is released under the MIT License. This is an independent community project and is not an official DeepSeek release. DeepSeek and its whale mark belong to their respective owners. Preset artwork provenance and redistribution rights must be confirmed before a public release; see THIRD_PARTY_NOTICES.md.