
项目简介
富江破甲是一款面向 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 提权、云与容器、业务接口风险以及漏洞分诊等类别。条目会记录产品、版本、端口、关键词、严重程度、前置条件、修复建议和参考来源。

安装前准备
- 确认使用受支持的 DeepSeek Harness 版本。插件声明兼容 DeepSeek Harness 与
dsh-system-prompt的>=0.2.1-rc.5 <0.3.0版本。 - 确认 Cordis 版本处于
>=4.0.5 <5范围内。 - 至少启动一次官方 DeepSeek Harness Desktop,让程序完成
desktop配置初始化。 - 安装前完全退出 Harness,包括从 Windows 右下角托盘图标中选择“退出”。
- 从可信来源下载仓库,并在执行脚本前检查文件内容。
使用安装脚本
在仓库页面选择 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: 等元数据标记验证状态与来源。实际使用时必须结合目标版本、配置和前置条件复核。
第四步:创建渗透作业链
当前实现要求用户先在插件面板中创建任务,然后人工智能才能使用已有任务记录资产、步骤和结果。作业链按以下阶段组织:
- 信息收集
- 指纹识别
- 漏洞匹配
- 可行性验证
- 漏洞利用
- 横向移动
- 报告输出
每个任务可以绑定一个会话,一个会话最多绑定一个任务。插件会通过 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。正确的使用方式是先检查兼容性和安装计划,再配置技能与知识库,最后在明确授权范围内创建任务、验证候选项并保存证据。始终把人工复核、最小权限和可靠证据放在自动化流程之前。
