Introduction¶

In the bottom-left corner of DSH’s sidebar is the account row, displaying the current account’s nickname and avatar. Often, we just want it to look like this machine—for example, for demos, screen recordings, or distinguishing different machines when multiple people share an account—but the account row is tied to the account, so modifying it requires either changing the account profile or simply leaving it alone.

dsh-plugin-custom-profile is exactly for changing this row to local values: it only modifies the local display, does not touch the account, and does not upload anything. Below is the description of this plugin.

What is this¶

dsh-plugin-custom-profile is a DSH client plugin, maintained by JonyFang, categorized under “Fun Costumes”. Its positioning is narrow: replacing the nickname and avatar in the sidebar account row with local, device-saved values.

The package name is dsh-plugin-custom-profile, the plugin ID is plugin-custom-profile, the current version is 0.2.2-rc.1, and the license is MIT. The client baseline it is written for is 0.2.2-rc.1; if the DOM structure of the account row changes, the plugin will stop drawing rather than break the page.

It is important to note that this plugin performs pure local display replacement: the account itself is not edited, and values are not uploaded. Therefore, it changes the “name and avatar you see on your machine,” not the account profile.

Core Features¶

1. Set nickname and avatar in Settings → Profile, and the account row syncs the display after saving.
2. Supported image formats: PNG, JPG, WebP, GIF, AVIF, max 10MB per image; images will be cropped to a square and converted to 128x128 WebP (falls back to PNG if failed), GIFs only keep the first frame.
3. Nickname max 32 characters; leave empty to continue displaying the account name.
4. Save after Reset to restore the account name and avatar; Cancel discards unsaved edits.
5. Values follow the device, not the account: custom values disappear after clearing site data or changing devices.
6. Leaves the account row alone when not logged in; only shows the avatar when the sidebar is collapsed.

In one sentence: it adds a display overlay for the current device without touching the account.

Installation and Enablement¶

The two recommended methods both come from the official README.

Method 1: Direct operation in the app. Open Settings → Plugins → Install → Local directory, select the checkout directory of this repository. After the package is released, you can also search for dsh-plugin-custom-profile to install directly.

Method 2: Use the command line after stopping the app:

dsh plugin --profile desktop add /absolute/path/to/dsh-plugin-custom-profile

Switch to other profiles using dsh plugin --profile <profile> add dsh-plugin-custom-profile, or github:<your-account>/dsh-plugin-custom-profile. This plugin does not require building.

If you want to wire it manually, symlink the directory to that profile’s node_modules, and append to the end of cordis.patch.yml:

- insert:
    - id: plugin-custom-profile
      name: dsh-plugin-custom-profile

If the Profile does not appear, restart the application.

Typical Usage¶

After installation, open Settings → Profile, fill in a nickname, select an avatar, and click Save. The account row in the bottom-left will display the same value. To restore the original, click Reset then Save; to abandon the edit midway, click Cancel.

A real-world scenario: the same account running DSH on multiple machines, using this plugin to set different nicknames for each machine, which only takes effect locally and does not affect the account’s display on other machines or other platforms.

Use Cases and Notes¶

Suitable for developers who want to display personalized nicknames or avatars on their local account row but don’t want to change account profiles, especially for demos, screen recordings, and scenarios where multiple people share an account. It only changes the display and does not involve account data upload.

A few things to note:

1. The plugin runs with the permissions of the current DSH process; you should read the source code before installing to confirm the behavior meets expectations. The license is MIT.
2. If another plugin drawing the same account row is already installed, they will conflict; this plugin will not import values saved by the other.
3. Changes in client version are the main risk point. The README specifies the baseline is 0.2.2-rc.1, and the plugin will stop drawing if the client structure changes; there is a daily GitHub Action in the repository watching the Harness page, which will open an issue for the dsh-compat agent after a client update.
4. Runtime environment requirements: Node ^22.19.0 || >=24.0.0, DSH client >=0.2.1-rc.5. The repository currently has 57 tests, run with npm test.

Conclusion¶

The value of this plugin lies in splitting “changing the account row” into “changing local display”: no touching the account, no uploading, taking effect per device, and one-click reset when needed. If you just want the sidebar on the machine at hand to look like yourself, it is a small but sufficient choice.

Directory page: https://www.skillhub.cn/plugins/JonyFang/dsh-plugin-custom-profile

GitHub: https://github.com/JonyFang/dsh-plugin-custom-profile