Introduction

DeepSeek Harness (DSH) advocates the philosophy of “everything is a plugin.” For agent development, plugins are not merely about extending functionality; they can also expose key states within the host workflow.

The agent runtime often enters waiting states: requesting user approval, waiting for the user to answer ask_user_question, waiting for confirmation exit_plan_mode, and the end of a conversation turn. If the user is not beside the Web interface, these events are easily missed.

dsh-feishu-notifier solves this problem: it sends text notifications to a Feishu bot when DeepSeek Harness triggers the aforementioned events.

What is it

dsh-feishu-notifier is a DeepSeek Harness Bundle maintained by blooming-fang, licensed under MIT.

Its positioning is to send text notifications to a Feishu bot when the agent requests user approval, waits for a user answer to a question, confirms a plan, or when a conversation turn ends.

Requirements:

  • DeepSeek Harness 0.1.0-rc.5 or compatible versions.
  • Node.js 22.19+.
  • Configure Feishu custom bot webhook in Web settings.
  • peerDependencies in package.json includes @deepseek-ai/cordis, @deepseek-ai/dsh-settings, @deepseek-ai/schemastery.

Core Features

dsh-feishu-notifier provides the following verified capabilities:

  • Send text notifications to a Feishu bot.
  • Trigger notifications on user approval requests, ask_user_question, exit_plan_mode, and turn/end conversation turn end events.
  • For turn/end events, convert completion, error, cancel, and interrupt reasons into readable text.
  • Configure Feishu custom bot webhook in Web settings.
  • Support saving Webhook and sending test messages.
  • Persist configuration to DSH’s settings.yaml via the plugin’s own Host API.
  • Provide Node/Cordis Loader entry lib/index.js and Web browser plugin entry lib/client.js.
  • Support installation from npm or from GitHub.

Installation and Usage

Install to ‘web’ Profile from npm

If using the pre-installed DSH command, execute:

dsh plugin --profile web add dsh-feishu-notifier
dsh --profile web

The first command installs the plugin, and the second command starts DSH under the web Profile.

If running DeepSeek Harness via source code, replace dsh with pnpm dsh:

pnpm dsh plugin --profile web add dsh-feishu-notifier
pnpm dsh --profile web

Install from GitHub

The GitHub installation example given in the README is:

pnpm dsh plugin --profile demo add github:blooming-fang/dsh-feishu-notifier

Here the demo Profile is used; execute according to the actual needs of the project. Installing from GitHub will execute the prepare script to build the plugin. You should only install code from trusted repositories; pnpm may require adding allowBuilds authorization to the Profile’s workspace configuration.

Local Development

Run local development commands in the repository:

pnpm install
pnpm run build
pnpm pack:check

The build generates two entries:

  • lib/index.js: Node/Cordis Loader entry;
  • lib/client.js: Web browser plugin entry.

Typical Usage

After starting DSH, open:

Settings → Feishu Notification

Then configure following the steps below:

  1. Fill in the Feishu bot Webhook.
  2. Click “Save Webhook”.
  3. Click “Send Test Message” to verify the connection.

After saving the configuration, it will be persisted to DSH’s settings.yaml via the plugin’s own Host API. The path usually given in the documentation is:

C:\Users\<username>\.dsh\settings.yaml

Applicable Scenarios and Notes

Suitable for the following scenarios:

  • Need to receive key interaction reminders for DSH agents outside the Web interface.
  • Need to synchronize events such as user approval, user questions, plan confirmation, and conversation turn end to Feishu.
  • Need to manage Feishu bot webhooks in the local DSH Web settings.

Notes to be aware of:

  • Webhook is a sensitive setting and will not be returned to the browser after saving.
  • Do not commit real Webhook addresses to GitHub or publish them to npm.
  • Real Webhooks are not included in npm packages; each user needs to configure their own address.
  • Installing from GitHub executes the prepare build script, so only install code from trusted repositories.
  • pnpm may require adding allowBuilds authorization to the Profile’s workspace configuration.
  • The plugin runs with the current dsh process permissions; you should check the source code and license before installing. The verified documentation lists the license as MIT.

Links

This documentation does not provide a directory page URL; the GitHub repository is:

https://github.com/blooming-fang/dsh-feishu-notifier