Introduction

Integrating DolphinDB into DeepSeek Harness (DSH) typically requires handling three aspects: the DolphinDB executor, query/write tools visible to the model, and DolphinDB skills. tradercjz/dsh-dolphindb bundles these three parts into an installable profile bundle, which can be mounted uniformly after installation to a profile.

What is this

tradercjz/dsh-dolphindb is the DolphinDB integration for DeepSeek Harness, positioned as an installable profile bundle. It is maintained by tradercjz under the MIT license.

Package information shows:

  • Node engines: ^22.19.0 || >=24.0.0
  • pnpm@11.7.0
  • dependencies: dolphindb ^3.1.54、yaml ^2.4.2

This bundle mounts three parts:

  • dolphindb executor
  • tool-dolphindb tools
  • dolphin-skills

Core Features

  • dolphindb_query: Execute read-only DolphinDB scripts/SQL. Can return result tables, vectors, matrices, scalars, and supports optional charts.
  • dolphindb_execute: Execute write/mutation scripts. This capability is gated behind the approval seam and provides code preview.
  • 23 bundled DolphinDB skills: Provided in the form of SKILL.md trees and exposed via the skill tool.
  • installable profile bundle: After installation, mounts the dolphindb executor, tool-dolphindb tools, and dolphin-skills.

Installation and Activation

Install to profile

First, execute the DSH plugin installation command:

dsh plugin --profile <name> add github:tradercjz/dsh-dolphindb

This command installs github:tradercjz/dsh-dolphindb to the specified <name> profile.

Authorize build scripts

dsh plugin add github:… installs the source. The first installation might fail until the profile’s pnpm-workspace.yaml authorizes build scripts via allowBuilds.

Prioritize the exact commit-pinned allowBuilds key printed by dsh over the loose form. Similar to the following:

allowBuilds:
  "@tradercjz/dsh-dolphindb@https://codeload.github.com/tradercjz/dsh-dolphindb/tar.gz/<commit-sha>": true

The <commit-sha> above is a placeholder; in practice, use the commit-pinned key output by dsh.

Alternatively, in the profile’s dsh.profile.bundles list, add @tradercjz/dsh-dolphindb after @deepseek-ai/dsh-base:

dsh.profile.bundles:
  - @deepseek-ai/dsh-base
  - @tradercjz/dsh-dolphindb

Configure executor

The only required field for the executor is passwordRef, defaulting to DOLPHINDB_PASSWORD. host, port, and username default to 127.0.0.1:8848 / admin.

To connect to a remote DolphinDB, override these fields in the profile’s cordis.patch.yml:

- id: dolphindb
  config:
    host: <host>
    port: <port>
    username: <username>
    passwordRef: DOLPHINDB_PASSWORD

The password should be placed in the process environment or the repository .env, and should not be committed to the repository.

Verify profile layer

After installation and configuration, use the following command to view the profile configuration:

dsh --profile <name> --dump-config

In the output, you should see that the @tradercjz/dsh-dolphindb layer mounts the dolphindb executor, tool-dolphindb tools, and dolphin-skills. After starting this profile, dolphindb_query and dolphindb_execute will be registered, and 23 bundled DolphinDB skills will be exposed via the skill tool.

Typical Usage

  • Read-only query: Use dolphindb_query to execute read-only DolphinDB scripts/SQL, suitable for viewing result tables, vectors, matrices, scalars, or using optional charts when needed.
  • Write or mutation: Use dolphindb_execute to execute write/mutation scripts. This path is constrained by the approval seam and provides code preview.
  • Skill invocation: Access 23 bundled DolphinDB skills (SKILL.md trees) via the skill tool.

Development Verification

When doing local validation and building within the repository, you can use:

pnpm install
pnpm run typecheck
pnpm run build

These three commands are used for installing dependencies, type-checking, and building respectively.

Skills Origin

The bundled skills are vendored from dolphindb/DolphinX_Skill. One source SKILL.md contains an unquoted description, which has been quoted in the vendored copy.

Applicable Scenarios and Notes

Suitable for developers who need to integrate DolphinDB into a DSH profile, especially scenarios where they want to simultaneously obtain the executor, query/write tools, and DolphinDB skills.

Usage notes:

  • The plugin runs with the permissions of the current DSH process. Check the source code before installing and confirm the MIT license is acceptable.
  • dolphindb_execute involves write/mutation scripts. Even with the approval seam and code preview, control database account permissions.
  • The password corresponding to passwordRef should be placed in the process environment or .env, and should not be committed to the repository.
  • If the first installation fails due to build scripts not being authorized, use the exact commit-pinned key output by dsh in the allowBuilds section of pnpm-workspace.yaml.

Conclusion

The value of tradercjz/dsh-dolphindb is packaging the DolphinDB executor, query/write tools, and 23 bundled DolphinDB skills into a DSH profile bundle, making it convenient to mount and verify within a profile.

  • GitHub: https://github.com/tradercjz/dsh-dolphindb
  • Community Directory: The materials verified for this event did not provide a specific URL, and uncertain links are not listed.