DeepSeek Harness plugin

dsh-plugins-lzxbill

A deterministic, credential-free DeepSeek Harness Host Tool example

Jump to install

Source facts

Repository
lzx-Bill/dsh-plugins
Latest update
Aug 18, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Package path
packages/tool-example
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
packages/tool-example/package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-21

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/lzx-Bill/dsh-plugins/tree/HEAD/packages/tool-example
Plugin: dsh-plugins-lzxbill
Author: lzx-Bill

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@supercarlosluo/dsh-tool-example

这是一个用于 DeepSeek Harness 的最小 Host Tool Bundle 示例。它注册确定性的 example_greet 工具:输入姓名,返回带可配置前缀的问候语。插件只依赖 Harness 的 tools 服务,不访问网络、文件系统或外部凭据。

本地开发

本仓库的 [examples/local-profile/cordis.patch.yml](../../examples/local-profile/cordis.patch.yml) 是可复制的开发模板,其中的源码 URL 使用 ABSOLUTE_PATH_TO_DSH_PLUGINS 标记,不包含维护者机器路径。请按 [examples/local-profile/README.md](../../examples/local-profile/README.md) 复制模板到临时文件并替换标记,再启动本地 Harness。

$env:DSH_PLUGINS_ROOT = (Resolve-Path '<path-to-dsh-plugins>').Path
$env:DSH_HARNESS_ROOT = (Resolve-Path '<path-to-deepseek-harness>').Path
# 复制并替换 overlay 后:
Set-Location $env:DSH_HARNESS_ROOT
pnpm dsh web --patch '<path-to-private-overlay>/tool-example.patch.yml'

overlay 的 prefix 配置为 Local。启动后在 Harness Web/Headless 流程中请求 example_greet 问候 Ada,应得到 Local, Ada!。这一步是本地真实行为验收的一部分;仅构建成功、进程启动或 HTTP 200 不足以证明工具行为正确。

配置与副作用

Bundle 默认配置如下:

- insert:
    - id: dsh-tool-example
      name: '@supercarlosluo/dsh-tool-example'
      config:
        prefix: 'Hello'

prefix 必须包含至少一个非空白字符。工具参数 name 必填,返回值始终是 ${prefix}, ${name}! 的字符串。插件没有网络、文件、子进程、凭据、定时器或持久化副作用;工具执行只在当前 Harness 进程内计算字符串。

包级命令

在仓库根目录安装依赖后:

pnpm --filter @supercarlosluo/dsh-tool-example run typecheck
pnpm --filter @supercarlosluo/dsh-tool-example test
pnpm --filter @supercarlosluo/dsh-tool-example run build
pnpm --filter @supercarlosluo/dsh-tool-example run pack

pack 使用 npm pack --dry-run 检查发布文件清单。发布前必须先生成 tarball,在全新 Harness profile 中安装并通过 --dump-config 检查 Bundle/插件行,再真实调用工具;人工发布 npm 包后,从 registry 的精确版本重复同一验收,验收通过后再创建 Git tag/GitHub Release。本仓库不提供自动发布 workflow。

兼容性与状态

代码依据 DeepSeek Harness 0.1.0-rc.7defineTool、Cordis tools 注入和 Bundle manifest API 编写;由于 Harness 处于 Developer Preview,每次发布都应以目标宿主的完整 commit 重新构建并验证。@supercarlosluo/dsh-tool-example@0.1.0 已通过本地 tarball与 npm registry clean install 的隔离宿主验收,证据见仓库兼容矩阵。

许可证与来源

代码使用 MIT 许可证,来源与兼容性假设见 [SOURCE.md](SOURCE.md)。