前言¶
在 DeepSeek Harness（DSH）里做安全研究类 Agent，常见做法是堆一层自然语言包装的 CLI：工具说明占满上下文、输出被模型「总结」成结论、日志散落在临时目录，权限边界又往往只写在系统提示词里。授权现场更需要的是：边界落在执行层、结论能回到证据、模式可安装也可卸载，且不改动 Harness 核心。
下面介绍社区插件 dsh-armorbreak（ArmorBreak · 破甲模式）。它以 Cordis Bundle + Agent preset 形式挂在 DSH 宿主进程内，面向已授权的逆向工程与安全研究；维护者为 LYL-Z，在 SkillHub 目录中归类为 admin-security，许可证为 MIT。仓库当前 package 版本为 2.0.0，README 标明与 DeepSeek Harness 0.2.1-rc.2 同代验证（详见仓库 docs/compatibility-matrix.md）。
这是什么¶
一句话：DeepSeek Harness 原生的「授权逆向工程与安全研究」Agent 模式——46 个真实可执行的离线分析能力、L0–L3 代码级权限引擎、逐任务证据哈希链与可复核报告；运行时依赖为 0（仅 Node 内置模块，无构建步骤）。
插件不修改 Harness 核心：通过 bundle patch 增量插入 preset 与工具，卸载后既有模式应完整保留。设计口号在 README 中写为：Evidence or it didn’t happen——安全结论需能回到证据。
- 目录页：https://www.skillhub.cn/plugins/LYL-Z/dsh-armorbreak
- 源码与文档：https://github.com/LYL-Z/dsh-armorbreak
SkillHub 为社区插件目录站点，与 DeepSeek / 幻方无官方从属关系；安装前请自行审阅源码与许可证。
核心功能¶
能力与工具面¶
README 给出的可量化指标（以仓库测试与注册表为准）包括：
| 项目 | 说明 |
|---|---|
| 离线 capabilities | 46 个，分 8 个域，经契约校验注册 |
| 模型可见工具 | 10 个（armorbreak_* 等，非 46 个能力逐一暴露） |
| 内置技能 | 7 个 |
| 工作流模板 | 9 个 |
| 自动化测试 | 190 通过（node --test）；行覆盖率约 85.82% |
典型能力域覆盖本地样本静态分析、APK 审计、PCAP 取证、源码/SBOM 审计、CTF/靶场等离线场景；Ghidra、JADX 等外部工具为可选增强，缺失时 README 说明为「探测 + 安装指引」，不阻断 L0 纯 JS 能力。
权限与执行¶
L0–L3 四级策略由代码强制（ScopePolicy、ExecutionRunner），而非仅靠提示词：
- Fail-closed：无授权则无网络；无审批则无动态执行；L3 永久拒绝（未授权扫描/攻击、凭据窃取等 README 明确列出的场景）。
- 执行入口统一：有界 I/O、超时、审计；目录读取经
realpath收敛，外部进程使用execFile(argv)，不拼 shell。
证据与报告¶
任务产出落在工作区 .armorbreak/（任务状态、JSONL 证据哈希链、审计链）。验证等级区分 observed / corroborated / hypothesis / unverified；扫描告警不会自动升级为「确认漏洞」。
报告可通过 armorbreak_report 导出 markdown / html / json / sarif / pdf 等格式（PDF 依赖本机 LibreOffice，未安装时 README 建议改用 html/markdown）。
界面与可观测性¶
Web 组合下注册只读路由 GET /armorbreak/state，在会话 Composer 展示模式状态卡；headless/TUI 无该卡片属预期行为。
安装与启用¶
环境要求（Quick Start）：
- DeepSeek Harness Desktop 0.2.1-rc.2 或同版本 CLI profile；Node ≥22（
package.jsonengines；Harness 随带 Node 24）。 - 本机文件系统可写，任务数据写入工作区
.armorbreak/。
官方 README「多形态安装」如下，任选其一：
1. DSH 面板（推荐）
设置 → 插件 → 添加插件 → 选择本地目录，或填写：
github:LYL-Z/dsh-armorbreak
安装成功应看到 applied；之后完全重启 Harness 以加载新模块代际。
2. 会话内 plugin_manager
plugin_manager action=install_bundle target=<本地 bundle 路径或 link 目标>
以返回的 application 为准。同版本重复安装可能报 already-installed，需先 remove_bundle 再装新版本。
3. CLI（非 desktop profile）
dsh plugin --profile add github:LYL-Z/dsh-armorbreak
适用于开发/测试 profile。
启用：新建会话 → 模式选择 → 破甲模式；Web 桌面下输入框旁应出现状态卡。若模式列表无「破甲模式」，可执行 plugin_manager list_bundles 确认 bundle 已应用并重启。
典型用法¶
README Quick Start 给出可复现的「第一个分析」提示词形状（路径请换成你本机授权样本）：
调用 armorbreak_health 检查环境；
然后创建任务并用 BinaryStaticAnalysis 工作流分析 D:\samples\hello.exe；
最后生成 markdown 报告并汇报：任务 id、状态、证据数、发现数、报告路径。
预期输出形态示例：
任务 task_xxx → COMPLETED；证据 ≥7；发现 ≥0；
报告：D:\work\.armorbreak\tasks\task_xxx\reports\binarystaticanalysis_<ts>.md
模型侧主要工具（节选，完整参数见 README §11.1）：
| 工具 | 用途 |
|---|---|
armorbreak_health |
环境、隔离、策略、外部工具探测 |
armorbreak_scope |
授权记录（list/authorize/revoke） |
armorbreak_task |
任务创建、列表、完结等 |
armorbreak_workflow |
多步骤模板（如 BinaryStaticAnalysis） |
armorbreak_analyze |
单 capability 执行（L0 自动，L1–L2 需审批） |
armorbreak_evidence |
证据列表、校验、哈希链 |
armorbreak_report |
按任务导出报告 |
策略与审批状态可落在 $DSH_HOME/armorbreak/policy.json（README §10.3）；Runner 默认限制如输入 32 MiB、单文件 4 MiB、结果 256 KiB、超时 60s 等见 lib/core/runtime.js。
适用场景与注意¶
适合谁：软件安全研究员、逆向与 CTF 学习者、代码审计/安全开发、DFIR 分析人员，在授权范围内做本地离线分析、取证与受控测试。
明确不适用（README L3）：对未授权目标的扫描或攻击、凭据窃取、隐蔽持久化、恶意投递、破坏性操作等。
运行权限：插件与 DSH 同一宿主进程、同一 OS 用户权限运行；桌面 profile 可能配置宽松的平台权限，但 ArmorBreak 的 L0–L3 闸门仍独立生效。安装前请阅读 SECURITY.md 与源码，仅在可信环境、合法授权前提下启用 L1/L2（含可选 Docker 隔离、平台审批）。
数据与运维：不要把 .armorbreak/ 提交进业务仓库；批量任务需自行清理旧任务目录。升级流程为 remove_bundle → install_bundle（或替换源码后重启），工作区 JSON/JSONL 格式 README 称向后兼容。
结尾¶
dsh-armorbreak 把「授权边界 + 真实执行 + 证据链 + 可复核报告」做成 DSH 内可拆卸的 破甲模式 Agent preset，适合作为 Cordis 生态里「专业能力 + 策略 + 证据」的参考实现，而不是再叠一层泛泛的安全聊天包装。
- SkillHub 目录：https://www.skillhub.cn/plugins/LYL-Z/dsh-armorbreak
- GitHub 仓库：https://github.com/LYL-Z/dsh-armorbreak
更细的架构、验收报告、故障排查见仓库 docs/ 与 README 目录索引。
