@kungfu-tech/dsh-kungfu
用于已安装 Kungfu Projects 和 Work 的类型化、只读 DeepSeek Harness 工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @kungfu-tech/dsh-kungfu@0.1.0Kungfu 以 @kungfu-tech/dsh-kungfu 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →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.
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.
@deepseek-ai/dsh-tools in the supported peer range;kungfu 4.0.0-alpha.2 available on PATH, or an explicit KUNGFU_BIN.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.
| Tool | Purpose | Installed Kungfu command |
|---|---|---|
kungfu_workspace_inspect | Inspect one workspace candidate. | kungfu workspace inspect PATH --json |
kungfu_projects | List remembered local Projects. | kungfu project list |
kungfu_project_works | List retained Work for one Project. | kungfu project works PATH |
kungfu_work_status | Read one exact Initiative/Assignment status. | kungfu work status --workspace ... --initiative-id ... --assignment-id ... |
See docs/tools.md for inputs, outputs, and error behavior.
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.
docs/MAP.md routes users, contributors, and reviewers.CONTRIBUTING.md covers development and DCO.SECURITY.md describes private vulnerability reporting.Apache-2.0. See LICENSE. Project names and marks are addressed in
TRADEMARK.md.