DeepSeek Harness 插件

dsh-kungfu

Typed, read-only DeepSeek Harness tools for installed Kungfu Projects and Work.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
kungfu-systems/dsh-kungfu
最近更新
2026年8月18日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/kungfu-systems/dsh-kungfu
插件名:dsh-kungfu
作者:kungfu-systems

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-kungfu

dsh-kungfu is a standalone DeepSeek Harness plugin for inspecting installed Kungfu Projects and durable Work state through typed, read-only tools.

The first release targets Kungfu 4.0.0-alpha.2 and does not require changes to Kungfu itself. The plugin invokes a fixed allowlist of local Kungfu CLI commands without a shell, applies time and output limits, and returns structured results to the Harness.

Status

Version 0.1 targets DeepSeek Harness 0.1.0-rc.x and an installed Kungfu 4.0.0-alpha.2. It was tested against the public DSH plugin interfaces and the four exact read-only commands exposed by Kungfu alpha.2.

Requirements

  • Node.js 22 or newer;
  • DeepSeek Harness with @deepseek-ai/dsh-tools in the supported peer range;
  • kungfu 4.0.0-alpha.2 available on PATH, or an explicit KUNGFU_BIN.

Install

Install the prebuilt npm package into a Harness profile:

dsh plugin --profile default add @kungfu-tech/dsh-kungfu

Until the npm package is available, use the prebuilt tarball attached to the GitHub release:

dsh plugin --profile default add \
  https://github.com/kungfu-systems/dsh-kungfu/releases/latest/download/kungfu-tech-dsh-kungfu-0.1.0.tgz

Restart that profile after installation. The bundle patch registers the plugin with these defaults:

binary: kungfu
timeoutMs: 15000
maxOutputBytes: 1048576

Set KUNGFU_BIN before starting the Harness when the executable is not named kungfu or is outside PATH.

Tools

ToolPurposeInstalled Kungfu command
kungfu_workspace_inspectInspect one workspace candidate.kungfu workspace inspect PATH --json
kungfu_projectsList remembered local Projects.kungfu project list
kungfu_project_worksList retained Work for one Project.kungfu project works PATH
kungfu_work_statusRead one exact Initiative/Assignment status.kungfu work status --workspace ... --initiative-id ... --assignment-id ...

See [docs/tools.md](docs/tools.md) for inputs, outputs, and error behavior.

Scope

  • local, read-only inspection only;
  • no arbitrary command or shell execution;
  • no credential collection or network transport;
  • no mutation of Kungfu Projects, Work, or configuration.

The plugin launches only the fixed argument vectors above with shell: false. It applies cancellation, timeout, and combined-output limits before parsing a JSON object. Results can contain local paths and Work metadata already visible to the invoking user, so treat Harness transcripts as potentially sensitive.

Project map

  • [docs/MAP.md](docs/MAP.md) routes users, contributors, and reviewers.
  • [CONTRIBUTING.md](CONTRIBUTING.md) covers development and DCO.
  • [SECURITY.md](SECURITY.md) describes private vulnerability reporting.

License

Apache-2.0. See [LICENSE](LICENSE). Project names and marks are addressed in [TRADEMARK.md](TRADEMARK.md).