In the DeepSeek Harness (DSH) ecosystem, Host plugins are responsible for adapting external inference engines into the Harness framework. h3-hip.c is an engine that supports the MiniMax-H3 model and is typically started with --serve, using the v1alpha protocol for communication. dsh-plugin-h3-hip is the corresponding Host bundle, independent of the HIP tree, intended to handle protocol integration and task management.

Plugin Positioning

This is a DeepSeek Harness Host bundle specifically designed to connect to the h3-hip.c engine. It implements the v1alpha protocol and does not depend on the HIP tree, making it easier to track breaking changes in DSH preview releases.

Core Features

  • h3_generate: Submits semantic tasks to POST /v1/jobs and uses ctx.jobs to track SSE streams.
  • h3-prompt skill: Provides the three-part prompt structure and reference tags specific to MiniMax-H3.
  • GET /v1/info: Performs a protocol check, verifies the X-H3-Protocol: v1alpha header, and prompts the user to upgrade if a 426 is returned.
  • Fake daemon: Provides a mock daemon for testing (npm test).

Installation and Prerequisites

Before installation, ensure the environment meets the following requirements:
1. h3-hip.c version >= v0.12-exp, started with the --serve argument.
2. DSH uses the web profile, with tools and jobs mounted (typically dsh-jobs-local + dsh-tool-jobs).
3. Pin the DSH CLI version, as preview APIs may break compatibility.

Install this bundle into the web profile:

dsh plugin --profile web add github:alexhegit/dsh-plugin-h3-hip#<40-char-sha>

Typical Usage

  1. Use skill to invoke h3-prompt to compose the prompt.
  2. Call h3_generate, passing prompt, and optionally specify preset, mode, or geometry.
  3. Call job_output or job_kill on the returned DSH jobId.

Development and Testing

The project provides test scripts to validate functionality.

npm test
node tests/fake-daemon.mjs --listen   # H3D_PORT=8571 stand-in

Configuration and Notes

Configuration is prioritized from environment variables: H3D_BASE_URL or H3D_BIND + H3D_PORT (default http://127.0.0.1:8571).

  • Security: Do not bind the daemon to public internet; DSH is the sole network entry point.
  • License: MiniMax-H3 weights follow the model community license. Be sure to review it before using it in IM or public sharing.

Ecosystem Context

The DSH philosophy is “everything is a plugin.” This plugin is documented in the community directory and has no official affiliation with DeepSeek or High-Flyer.