Skip to main content

deepseek-harness-desktop/test/fixtures/sample-plugin

41Stars1Forks2Issues0Watchers

A smoke test fixture for plugin install/uninstall bundled with the deepseek-harness-desktop repository. Only used by the verify-tauri script to verify the dsh plugin chain. Not a user-facing utility plugin.

Categories⌨ Developer Tools
Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
chokwinleechokwinlee
·chokwinlee/deepseek-harness-desktop
Language
JavaScript
License
MIT
Branch
main
ai-agentscoding-agentcross-platformdeepseekdeepseek-harnessdesktopdesktop-appdsh

Install

cmdweb profile
$ dsh plugin --profile web add github:chokwinlee/deepseek-harness-desktop#path:test/fixtures/sample-plugin

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin chokwinlee/deepseek-harness-desktop/test/fixtures/sample-plugin for me: review the repository at https://github.com/chokwinlee/deepseek-harness-desktop first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Pitch

This is the "plugin smoke test sample" bundled with the deepseek-harness-desktop repository, used only by scripts/verify-tauri.sh to verify that the dsh plugin add/remove workflow functions correctly in a packaged Tauri application. It is not a practical plugin for end users.

Core Capabilities

  • Provides a valid npm package structure that can be recognized by dsh plugin --profile web add, allowing the script to complete the installation path
  • Uses an empty cordis.patch.yml (content []) so the install/uninstall process doesn't modify host behavior, enabling "addable/removable" loop assertions
  • Reused by verify-tauri.sh to verify that the dsh command can correctly read/write the profile manifest in the packaged Tauri application

Technical Implementation

  • Language: JSON / YAML manifests (no runtime code)
  • Key Dependencies: None (its own dependencies is empty; only referenced by other npm packages via link:)
  • Architecture Pattern: Uses dsh.bundle.patch to point to a cordis patch with an empty array [], achieving zero-intrusion injection into the host
  • Entry Point: None (the fixture doesn't provide any code entry point)

Use Cases

Only maintainers of the deepseek-harness-desktop project will use this when modifying plugin loading logic or running macOS packaging verification: executing scripts/verify-tauri.sh will temporarily install link:<this directory> into an isolated DSH_HOME, verifying that dependencies and dsh.profile.bundles are correctly written and then removed. Ordinary users won't gain any benefit from installing it.

Prerequisites & Compatibility

DependencyMinimum VersionNotes
DSHNot Declaredsample-plugin/package.json doesn't declare engines or peerDependencies
NodeNot DeclaredSame as above
PlatformCross-PlatformFixture has no platform-specific code; its consuming script verify-tauri.sh only validates on macOS
Native ModulesNoneDoesn't depend on any native modules

Installation

dsh plugin --profile web add github:chokwinlee/deepseek-harness-desktop/test/fixtures/sample-plugin

This command has no meaning for real users — after installation it doesn't add any functionality; it just adds one dependency entry and one bundle item to the profile manifest.

Configuration

This plugin requires no additional configuration (cordis.patch.yml contains an empty array; installation behavior is entirely determined by the host defaults).

FAQ

Q: What does this plugin do?

A: It has no practical functionality for end users. It's just a standard test sample used by deepseek-harness-desktop project's scripts/verify-tauri.sh to verify the dsh plugin add/remove command chain. It doesn't inject any patches.

Q: What changes will happen to my DSH after installation?

A: No visible changes. The cordis.patch.yml content is an empty array [] and won't inject any modifications into the host. It only adds one item to the dependencies and dsh.profile.bundles lists in ~/.dsh/profiles/web/package.json.

Q: verify-tauri.sh uses link: instead of github: for installation — is there a difference?

A: Yes. link: uses local path resolution and is used for CI smoke testing; github: pulls from the remote repository. Both will ultimately write the fixture to the profile manifest, providing the same verification result, but only the link: form will be automatically executed by verify-tauri.sh.

Q: Can this fixture run independently outside the repository?

A: No. It depends on test/fixtures/fake-dsh.mjs from the same repository along with the FAKE_DSH_MODE=plugin-install-ready environment variable to simulate the "plugin installation successful" path. Using it separately without that script will lack the test target.

Q: Can it be kept in production long-term?

A: Not recommended. The package.json has private:true and has no business capabilities; keeping it will only add a useless dependency entry to the profile manifest. verify-tauri.sh will immediately remove it after running tests.

Difficulty Level

Beginner — because there's "nothing to get started with": no configuration, no entry point, no patch. It's purely a manifest consumed by scripts.

Known Issues & Limitations

  • package.json has private:true, so npm's public registry won't include it; must be accessed via github: or link: paths
  • cordis.patch.yml is an empty array [] and doesn't inject any capabilities into the host
  • Only consumed in the scripts/verify-tauri.sh smoke test chain; without the accompanying fake-dsh.mjs, it cannot complete end-to-end assertions
  • Has no engines / peerDependencies field declarations, providing no guarantee of safe loading on arbitrary DSH versions
  • Installing it outside the repository won't cause errors, but also won't provide any functionality

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/chokwinlee/deepseek-harness-desktop/test/fixtures/sample-plugin)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory