前言¶
DeepSeek Harness（DSH）用 Cordis 配置和插件 bundle 扩展 Agent 模式与工具面。若要在 Harness 里做授权渗透、CTF 或安全教学，常见做法是自建脚本或单独跑一套安全 Agent，模型循环与工具注册往往和 Harness 脱节，证据链也难和会话历史对齐。
下面介绍社区插件 dsh-vulnclaw-pentest（维护者 R1145141919810，分类 admin-security）。它把开源项目 VulnClaw（MIT，作者 UncleC）的能力以原生 Harness 工具形式接入，在模式列表中增加「渗透测试」Agent 模式，由 Harness 自己的模型与 Agent 循环驱动，而不是再启动 VulnClaw 自带的 Agent 循环。
这是什么¶
dsh-vulnclaw-pentest 是一个 DSH 插件包（bundle）：给 Harness 增加一个模式，并把 VulnClaw 的工具面桥接进来。仓库不含 VulnClaw 源码；首次实际调用工具时，插件会在私有 Python 环境中安装 VulnClaw（PyPI 或可编辑的本地检出）。
不是 VulnClaw 的分支或替代品。没有安装 DeepSeek Harness，本插件无法独立运行。
目录页：skillhub.cn/plugins/R1145141919810/dsh-vulnclaw-pentest
源码与文档：github.com/R1145141919810/dsh-vulnclaw-pentest（当前 package 版本 1.1.0，MIT 许可）
仅限已授权测试、CTF、安全教学与红队演练。使用前须取得目标系统书面授权并遵守当地法律。
核心功能¶
选中「渗透测试」模式后，VulnClaw 的 37 个工具会出现在该模式作用域内，例如：
- 扫描与探测：
nmap_scan、http_probe_batch - 目录与前端：
dir_enum、js_recon - 分析与情报：
crypto_decode、source_extract、cve_lookup、attack_map - 证据与流量：
evidence_*、traffic_*，以及报告与 PoC 相关能力
设计要点（与 README 一致）：
| 要点 | 说明 |
|---|---|
| 单一模型 | Harness 持有模型；VulnClaw 只提供工具执行，不另配 API Key，也不会出现双 Agent 争用工具。 |
| 不改上游源码 | 通过公开模块构造 AgentCore、build_openai_tools()、execute_mcp_tool() 与上游同一套分发。 |
| 证据链 | 工具结果写入 VulnClaw evidence，返回文本带 [evidence:eNNN] 前缀，便于 evidence_view、evidence_search、traffic_* 与报告生成串联历史。 |
| 按作用域注册 | 仅在「渗透测试」模式注册；standard / ptc / minimal / cordis 等模式不会多出这些工具。 |
| 环境自举 | 首次用到工具时（非激活时）解析或创建 Python 3.10+ 环境，推荐用 uv 安装 vulnclaw[web] 并补齐执行依赖。 |
除动态注册的 VulnClaw 工具外，bundle 还定义 3 个会话级工具（见仓库 tools.js）。默认会隐藏与渗透无关的桌面自动化工具族（keepDefaultDeny: true）。
前置条件¶
| 依赖 | 说明 |
|---|---|
| DeepSeek Harness | 宿主；插件通过 dsh.bundle.patch 注入 Cordis 配置。 |
| Python 3.10+ | 需能 import vulnclaw；也可由插件用 uv 自动准备。 |
uv（推荐） |
自动创建虚拟环境；若已用 VULNCLAW_PYTHON 指向可用解释器则可不装。 |
nmap（可选） |
仅 nmap_scan 需要；未安装时该工具会明确报错，其它工具不受影响。 |
peer 依赖（运行时从 Harness 安装解析）：@deepseek-ai/dsh-tools 0.2.0-rc.2、@deepseek-ai/schemastery ~3.18.4。
安装与启用¶
官方流程分几步：取得仓库、用 Harness 安装 bundle、链接 Node 依赖、重启后在 UI 选模式。路径建议纯 ASCII，避免 profile 里 link: 路径在编码转换时损坏。
1. 取得代码¶
git clone https://github.com/R1145141919810/dsh-vulnclaw-pentest.git
cd dsh-vulnclaw-pentest
2. 安装 bundle 并链接依赖¶
在 Harness 中执行（将路径换成你机器上的绝对路径）：
plugin_manager(action: "install_bundle", target: "<仓库的绝对路径>")
安装完成后必须链接 Harness 包，否则激活时可能出现 ERR_MODULE_NOT_FOUND: @deepseek-ai/dsh-tools：
npm run link-deps
Harness 装在非默认位置时：
DSH_HOME=/path/to/.dsh DSH_PROFILE=desktop npm run link-deps
3. Python 环境（通常可跳过）¶
首次调用工具时按顺序解析解释器：VULNCLAW_PYTHON → $DSH_HOME/vulnclaw-bridge/venv → 用 uv 新建并 uv pip install "vulnclaw[web]"。
手动指定：
export VULNCLAW_PYTHON=/usr/bin/python3
bundle config 里也可设 pythonPath、sourcePath（本地 VulnClaw 检出以可编辑模式安装）。
4. 重启并验证¶
重启 Harness，新建会话，在模式列表选择「渗透测试」。
可选验证（需已配置能 import vulnclaw 的解释器）：
export TEST_PYTHON="<装了 vulnclaw 的解释器>"
node dev-verify-activation.mjs
node dev-regression.mjs
node dev-verify-schema.mjs
node dev-test.mjs
或一条命令：npm run verify。
配置摘要¶
在 bundle patch 对应行的 config 中常见项：
| 键 | 默认 | 说明 |
|---|---|---|
pythonPath |
空 | 能 import vulnclaw 的解释器 |
sourcePath |
空 | 本地 VulnClaw 目录；空则装 PyPI |
exposeTools |
true |
是否在本作用域注册工具 |
toolPrefix |
空 | 工具名前缀，避免与其它插件冲突 |
callTimeoutMs |
600000 |
单次调用超时 |
permissionMode |
full_access |
VulnClaw 内部 safety.permission_mode |
keepDefaultDeny |
true |
隐藏非渗透桌面自动化工具 |
denyTools |
[] |
额外隐藏的工具名 |
环境变量包括 VULNCLAW_PYTHON、VULNCLAW_BRIDGE_PERMISSION_MODE、VULNCLAW_BRIDGE_MAX_RESULT_CHARS（默认 120000）等。默认关闭 VulnClaw 自建模型连接；仅在有明确需求时通过 VULNCLAW_BRIDGE_LLM_BASE_URL / _API_KEY 打开「模型接缝」。
权限说明：VulnClaw 里 shell_command、python_execute、PoC 等在无头桥接中无法弹出交互审批，故默认 full_access；在 Harness 侧这些能力仍受 Harness 权限系统约束，应按预设控制本机命令执行，不要当作无审批的任意代码入口。
典型用法¶
在 Harness 会话中使用¶
- 新建会话，模式选「渗透测试」。
- 用自然语言描述授权范围内的目标与任务；模型可调用
nmap_scan、http_probe_batch、dir_enum、js_recon等。 - 需要回溯时，让模型使用
evidence_view、evidence_search或traffic_*查看带[evidence:eNNN]标记的历史。
可选：VulnClaw CLI 侧定制¶
若已用 Harness 提供模型与工具，可跳过。仓库提供运行时定制（不改已安装的 VulnClaw 包）：
python python/dsh-vulnclaw.py --help
python python/dsh-vulnclaw.py tui --target https://target.example
适用场景与注意¶
适合：已在 Harness 上开发或运维 Agent、希望在同一套 Cordis 模式与权限模型里做授权渗透、CTF 练习、安全教学或红队演练的团队。
注意：
- 插件以当前 DSH 进程权限在本机执行工具（含
shell_command、python_execute）；安装前应阅读仓库源码、LICENSE与THIRD-PARTY-NOTICES.md，确认与组织安全策略一致。 - 社区目录 SkillHub 是独立站点，与 DeepSeek / 幻方无官方从属关系；插件星标以目录/GitHub 当时公示为准（资料抓取时为 0）。
- 排障常见项：未跑
npm run link-deps、未选「渗透测试」模式、uv不可用且未设VULNCLAW_PYTHON、nmap_scan缺nmap、permissionMode设为ask导致no_channel。
结尾¶
dsh-vulnclaw-pentest 把 VulnClaw 的渗透工具链接到 DeepSeek Harness，用单一 Agent 循环驱动扫描、探测、目录与 JS 侦察、证据与流量、报告与 PoC，并保留 VulnClaw 证据链语义。若你已在 DSH 上扩展模式与工具，这是把 admin-security 类能力纳入同一宿主的一条可核对路径。
- 目录页：https://www.skillhub.cn/plugins/R1145141919810/dsh-vulnclaw-pentest
- GitHub：https://github.com/R1145141919810/dsh-vulnclaw-pentest
