跳到主要内容
AI教程

富江破甲安装与使用教程:为 DeepSeek Harness 配置安全技能、知识库与作业链

本教程介绍富江破甲 0.20.12 的用途、安装流程、提示词开关、技能库、CVE/PoC 知识库、漏洞报告和渗透作业链,并说明兼容性、备份机制与安全使用注意事项。

富江破甲安装与使用教程:为 DeepSeek Harness 配置安全技能、知识库与作业链

项目简介

富江破甲是一款面向 DeepSeek Harness 的自定义提示词与安全评估辅助插件。当前 README 标注的版本为 0.20.12。项目会把 @deepseek-ai/dsh-prompt-custom 安装到 Harness 配置目录,并将插件程序与 prompt-custom.json 提示词配置分开保存。

插件提供自定义提示词、技能库、内置 CVE/PoC 知识库、漏洞报告和渗透作业链等功能。它适合在明确获得授权的环境中整理资产、匹配候选漏洞、记录验证步骤和生成报告,不应把知识库候选项或自动化进度直接视为已经确认的漏洞。

项目名称以及对 DeepSeek 的提及不代表官方背书。开始使用前,请阅读仓库中的免责声明,并确保测试目标、范围和操作方式均已获得授权。

主要功能

  • 提示词注入:输入框附近提供“富江破甲”状态开关和设置入口。关闭注入后会恢复官方开头,同时保留用户自己的提示词正文。
  • 漏洞报告:持久化保存人工智能写入的漏洞记录,可按严重、高危、中危、低危和信息等级查看。
  • 技能库:按需下载、启用或关闭 REA 与 AboutSecurity,并让人工智能发现已注册的技能内容。
  • 内置知识库:随插件提供九类 CVE/PoC 知识,启用本身不需要额外下载。
  • 渗透作业链:管理任务、资产、验证步骤、尝试记录、阶段和后续建议。
  • 本地指纹匹配:根据端口、服务标识或产品名称,对知识库候选条目排序并给出匹配原因。

自定义提示词界面

自定义提示词配置独立保存在 prompt-custom.json 中,可能包含个人配置。再次安装、备份或分发前,应确认文件内容是否适合共享。

富江破甲自定义提示词设置界面

技能库与知识库

技能库支持两个上游项目:REA 逆向分析工具和AboutSecurity 安全评估技能库。第三方项目分别适用其自身许可条件。

富江破甲技能库管理界面

内置知识库覆盖 Java 反序列化、Java Web、边界设备、Exchange 与域环境、Web 与 CMS、Linux 提权、云与容器、业务接口风险以及漏洞分诊等类别。条目会记录产品、版本、端口、关键词、严重程度、前置条件、修复建议和参考来源。

富江破甲内置知识库界面

安装前准备

  1. 确认使用受支持的 DeepSeek Harness 版本。插件声明兼容 DeepSeek Harness 与 dsh-system-prompt 的 >=0.2.1-rc.5 <0.3.0 版本。
  2. 确认 Cordis 版本处于 >=4.0.5 <5 范围内。
  3. 至少启动一次官方 DeepSeek Harness Desktop,让程序完成 desktop 配置初始化。
  4. 安装前完全退出 Harness,包括从 Windows 右下角托盘图标中选择“退出”。
  5. 从可信来源下载仓库,并在执行脚本前检查文件内容。

使用安装脚本

在仓库页面选择 Code → Download ZIP 并解压,也可以使用 Git 克隆仓库。完全退出 Harness 后,双击解压目录中的 点我执行脚本.cmd。

# 完全退出 Harness 后执行安装
.\点我执行脚本.cmd

# 仅查看安装计划,不修改文件
.\install.ps1 -DryRun

-DryRun 适合在正式安装前检查脚本准备执行的操作。安装器默认使用 desktop 配置,并优先调用 Desktop 自带的 DSH 命令行工具。需要自定义环境时,可通过 -Profile、-DshCommand 和 -DshHome 指定配置名称、命令行工具与数据目录。

若未设置 DSH_HOME,默认数据目录为 $env:USERPROFILE\.dsh。安装脚本会把插件复制到 $DSH_HOME\local-plugins\dsh-prompt-custom,使用 DSH 插件管理器注册,然后复制附带的 prompt-custom.json。

如果原有提示词配置与新配置不同,安装器会先在原文件旁创建备份。注册失败且存在备份时,脚本会恢复原提示词配置。安装成功后,脚本还会尝试在相邻位置写入 install.log,但该文件并不是完整运行日志。

如果安装器检测到 Harness 仍在运行,它会提示退出并停止,本次不会修改文件。安装器不会自动关闭或重启 Harness,也不支持 -NoRestart 参数。

脚本被 Windows 拦截时如何处理

安装器是可阅读的 PowerShell 脚本,主要执行文件复制与 DSH 命令调用。README 说明它不包含隐藏窗口启动、强制结束进程、创建计划任务或通过 WMI 创建进程的行为,但这不等同于任何安全软件的检测结论。

如果 Windows 因下载来源标记阻止脚本,应先核实下载来源并审阅脚本内容。还可以计算 SHA256 校验值,与发布者提供的值进行核对:

Get-FileHash .\install.ps1 -Algorithm SHA256

确认文件可信后,可通过 Windows 文件“属性”中的“解除锁定”处理下载来源标记。

手动安装方法

如果不希望运行自动安装脚本,可以在完全退出 Harness 后手动复制并注册插件。以下命令使用默认数据目录和 Desktop 自带的 DSH 命令行工具:

$pluginTarget = Join-Path $env:USERPROFILE '.dsh\local-plugins\dsh-prompt-custom'
New-Item -ItemType Directory -Force -Path $pluginTarget | Out-Null
Get-ChildItem -LiteralPath .\plugin -Force | ForEach-Object {
  Copy-Item -LiteralPath $_.FullName -Destination $pluginTarget -Recurse -Force
}

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add $pluginTarget

如果还要采用仓库附带的提示词配置,请先备份现有的 $env:USERPROFILE\.dsh\prompt-custom.json,再复制新文件。完成安装后,需要自行重新启动 Harness。

基础使用流程

第一步:启用提示词注入

重新启动 Harness 后,在输入框附近找到“富江破甲”状态入口。启用时,插件会以空段替代官方 harness:identity 开头;关闭后恢复官方开头。你的自定义提示词正文不会因此被删除。

第二步:配置技能库

打开设置面板中的“技能库”,按需下载并启用 REA 或 AboutSecurity。AboutSecurity 会从 GitHub 下载当前 master 分支压缩包,只提取其中的 skills/ 目录。下载过程支持进度显示和取消。

REA 要求兼容的 Node.js 版本为 ^22.23.4 || ^24.22.1 || >=26.12.1。插件通过 npm 安装 REA 时会关闭生命周期脚本,因此不会通过这种安装方式构建 Frida 的可选原生绑定。具体工具能否运行,仍取决于本地运行环境与分析引擎。

AboutSecurity 主要由 Markdown 技能文档构成,不需要额外的原生运行组件。技能下载成功只表示文件已经获得并注册,不代表每项工具都完成了运行验证。

第三步:使用知识库辅助匹配

知识库默认开启,状态保存在 $DSH_HOME/fujiang-skills/knowledge-state.json。关闭后,插件不再向人工智能提供相关知识内容,但原始文件仍保留在本地。

在获得授权的测试中,可以先向人工智能说明目标产品、版本、端口、服务标识和测试范围,再要求它检索相关知识条目。例如:

这是一个已获得授权的测试环境。请根据已确认的产品名称、版本和开放端口检索知识库候选项,列出匹配原因、适用前置条件、仍需验证的证据以及修复建议。不要把候选项表述为已确认漏洞。

知识条目是公开资料的整理,通常通过 verified: false 和 sources: 等元数据标记验证状态与来源。实际使用时必须结合目标版本、配置和前置条件复核。

第四步:创建渗透作业链

当前实现要求用户先在插件面板中创建任务,然后人工智能才能使用已有任务记录资产、步骤和结果。作业链按以下阶段组织:

  1. 信息收集
  2. 指纹识别
  3. 漏洞匹配
  4. 可行性验证
  5. 漏洞利用
  6. 横向移动
  7. 报告输出

每个任务可以绑定一个会话,一个会话最多绑定一个任务。插件会通过 campaign:context 向绑定的人工智能提供任务、阶段、资产数量和后续建议。

富江破甲渗透作业链管理界面

建议在创建任务时明确填写授权目标、允许操作的范围、禁止动作、测试时段和停止条件。任务进度与阶段只是组织信息,不能代替漏洞验证证据。

第五步:记录漏洞报告

当验证结果足以支持结论后,再让人工智能写入漏洞记录。报告应包含受影响资产、复现条件、证据、影响判断、严重程度、修复建议与参考来源。未经验证的候选项应保持“待验证”状态,而不是直接标记为漏洞。

本地接口与原生工具

插件提供本地指纹匹配和任务台账接口。匹配计算与台账写入在本机完成,但技能下载、联网模型调用以及实际目标验证仍可能产生网络请求。

  • POST /api/dsh-prompt-custom/match:根据端口、服务标识或产品名称返回排序后的知识库候选项及匹配原因。权重包括端口 40、产品 30、CVE 20、关键词 20、严重级别 5。
  • /api/dsh-prompt-custom/campaigns:管理测试范围、资产指纹、执行步骤、尝试记录和任务阶段。台账保存在 $DSH_HOME/vuln-report/campaigns.json。
  • GET ?id=:读取指定任务及下一步建议。

任务接口还提供 bind、unbind 和 kick 等操作。原生工具包括 kb_match、campaign_upsert、finding_upsert 与 pipeline_next;技能检索入口包括 skill_search 和 skill_read。原生工具注册依赖可解析的 DSH 工具服务。

进阶使用建议

先用 DryRun 检查安装计划

首次安装或变更配置目录时,先运行 .\install.ps1 -DryRun。这样可以确认目标路径、配置名称与预期操作,同时避免立即修改文件。

分别备份插件与个人提示词

prompt-custom.json 独立于插件程序,可能包含个人配置。升级或重新分发前,应单独备份并审查该文件,避免覆盖定制内容或意外分享敏感信息。

区分候选匹配与有效漏洞

指纹匹配只是根据端口、产品、CVE、关键词和严重级别排序候选项。高排名不意味着目标一定受影响。应继续核实版本、部署方式、补丁状态、前置条件与实际证据。

谨慎使用自动续跑

自动续跑默认最多 8 轮,并带有停滞判断和下一步建议。使用时应设置清晰的授权边界与停止条件,并持续人工复核,避免模型因上下文不足执行不合适的后续操作。

理解知识库更新方式

知识条目位于 plugin/knowledge/,每次加载条目时会重新读取文件,因此内容更新可在后续调用中生效。分类定义位于 lib/knowledge.js;如果修改分类,需要重新加载插件。

排查输入快捷键问题

README 记录了一项已知情况:免责声明弹窗关闭后,Enter 或 Esc 的监听仍可能影响输入和快捷键。遇到异常时,可先检查是否与该已知问题有关,再重新加载插件或重启 Harness。

兼容性与验证边界

插件通过公开的 systemPrompt、skills、tools、智能体生命周期和 webServer 服务工作,不通过修改 Harness 程序文件安装。安装后必须完全退出并重新启动 Harness。

README 表示当前版本已核对文件结构与安装逻辑,但没有重新完成全部功能的实际运行验证。因此,不能据此承诺所有技能、CVE 条目或自动化流程都可用。部署到正式环境前,应在隔离且已授权的测试环境中逐项验证。

结语

富江破甲将提示词管理、安全技能、内置知识库、漏洞报告和任务台账整合进 DeepSeek Harness。正确的使用方式是先检查兼容性和安装计划,再配置技能与知识库,最后在明确授权范围内创建任务、验证候选项并保存证据。始终把人工复核、最小权限和可靠证据放在自动化流程之前。