npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-redteam-asset-graph

v7.9.8

Published

DSH 红队资产图谱插件包:把目标资产自动收集、关联、可视化,并让模型参与研判(面板 + 三个模型工具 + Jina 检索两阶段关联分析)

Readme

红队资产图谱 · DSH 插件包

在 DSH 里做红队测试时,把目标资产自动收集、关联、可视化,并让模型参与研判。

  • 面板:左侧一级菜单「资产图谱」—— 网状图 / 列表 / 垃圾箱三视图
  • 删除:列表每行可单独删除;删除一律进垃圾箱(可恢复),并写入图谱日志的审计链
  • 模型工具:asset_record(登记)、asset_query(查询)、asset_remove(剔除误报)
  • 检索:Jina MCP 直连,按需勾选工具(include_tools 限定,减少上下文占用)
  • 关联分析:两阶段 —— 阶段 1 用 Jina 检索只产出候选,阶段 2 交模型研判决定入库哪些

安装(推荐:插件包)

dsh plugin --profile web add dsh-redteam-asset-graph
# 然后重启 dsh web —— web profile 的 hmr 是 disabled,组合改动不会热生效

本包声明了 dsh.bundle.patch,所以装完即自动挂载,不需要手工编辑任何配置:

  1. dsh plugin 是 pnpm 的转发器,在 profile 目录里执行 pnpm add <包>;
  2. 随后 reconcilePlugins 发现该包声明了 dsh.bundle.patch,就把包名并入 dsh.profile.bundles;
  3. 启动时按层叠加:各 bundle 的 patch → profile 的 cordis.patch.yml → $DSH_HOME/cordis.patch.yml → --patch 覆盖层。

验证组合是否生效:

dsh --profile web --dump-config | tail -4
# 应看到:
#   - id: redteam-asset-graph
#     name: dsh-redteam-asset-graph

--dump-config 用的是与启动同一套 patch 语义(applyEntryPatches),dump 对了启动时就对了。

装完还要做一件事:填 Jina API Key。面板 → 设置 → Jina(必填)。没填时「关联分析」 按钮禁用——本插件的检索与关联分析依赖 Jina。填完可以点「测试连接」确认。

其他安装方式

# 指定版本
dsh plugin --profile web add [email protected]

# 从仓库直接装(开发用;仍是同一套 bundle 机制)
dsh plugin --profile web add github:Fasthei/DSHairedPlugin

# 本地 tarball
npm pack && dsh plugin --profile web add ./dsh-redteam-asset-graph-7.9.7.tgz

# 卸载(bundles 会自动回收该行)
dsh plugin --profile web remove dsh-redteam-asset-graph

发布位置(两个 registry)

同一个插件在两个 registry 上发布,包名不同——这不是笔误,是两边的命名规则决定的:

| registry | 包名 | 谁能直接装 | |---|---|---| | npm(主推) | dsh-redteam-asset-graph | 所有人,一条命令即可 | | GitHub Packages | @fasthei/dsh-redteam-asset-graph | 仅已授权者(见下) |

为什么必须两个名字:GitHub Packages 要求包名是作用域形式,且作用域必须等于仓库属主 (Fasthei → @fasthei/…);而 npm 侧的作用域只能用自己的 npm 用户名,且不允许发布他人的 作用域。所以无法用同一个名字覆盖两边。

GitHub Packages 的额外代价(所以只作备用源):该包是私有的,匿名读取返回 401, 每个使用者都要先在自己 ~/.npmrc 里声明 registry 与凭据:

@fasthei:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=<自己的 GitHub token,需 read:packages>

然后:

dsh plugin --profile web add @fasthei/dsh-redteam-asset-graph

发布(维护者)

# npm(公开)
npm publish

# GitHub Packages(作用域副本由脚本生成,避免手抄两份清单)
npm run publish:gh          # 生成 build/gh-packages/,name 改为 @fasthei/…
cd build/gh-packages && npm publish

两边都受 prepack 保护:lib/ 与 src/ 漂移时拒绝发布,避免发出不一致的包。


三种形态

同一个插件的三种跑法,能力相同、生命周期不同:

| 形态 | 入口 | 生命周期 | 适合 | |---|---|---|---| | 插件包(推荐) | lib/host.js + lib/client.js | 随进程启动,重启不丢 | 日常使用、分发 | | 引导式加载 | 会话内引导码 → 读 src/*.js | 进程内,重启要重跑一次 Package | 本机快速改代码 | | 动态插件 | cordis_define 提交 src/*.js 全文 | 进程内,重启即消失 | 临时试用(不推荐,见下) |

src/ 是权威源码;lib/ 由 npm run build:lib 从它生成,主体逻辑逐字相同, 差异只在文件头尾与一层垫片(详见 lib/README.md)。核对时 diff 两者,差异应只出现在头尾。

插件包的安装(源码方式,适合本机开发)

如果你是从仓库目录直接用(不走 npm),需要三步:

# 1) 让本仓库能解析 @deepseek-ai/* —— 它不在 profile 的解析链上
mkdir -p node_modules
ln -sfn ~/.dsh/profiles/node_modules/@deepseek-ai node_modules/@deepseek-ai

# 2) 把插件行加进活动 profile 的宿主组合
#    文件:~/.dsh/profiles/web/cordis.patch.yml(写法见下)

# 3) 重启 dsh web

组合行必须写成 insert 形态:

- insert:
    - id: redteam-asset-graph
      name: /绝对路径/到/本仓库        # 必须绝对路径,理由见 DEVELOPMENT.md

⚠️ 别与 npm 包同时用:两种都指向本插件,会注册重复的行与重复的工具。


开发

改这个插件(引导式加载、常驻插件包的垫片与编排细节、实测踩过的坑)见 DEVELOPMENT.md。


配置

全部在面板 设置 抽屉里:

| 项 | 说明 | |---|---| | Jina API Key | 必填。本插件的检索与关联分析依赖 Jina,未填写时「关联分析」按钮禁用 | | 工具(按需勾选) | 勾选后端点自动带上 include_tools,只暴露所选工具 | | 跟随工作区 | 开启后项目自动跟随当前会话的工作区目录;项目 = 工作区目录,自动创建与清理 | | 自动研判 | 阶段 1 结束后是否自动唤醒模型做阶段 2 研判 | | 自动捕获 | 只从外部情报工具(web_search / Jina 检索类)攒候选,跳过 bash 与本地读文件;不直接入库。攒到 6 条、或安静 45 秒后自动唤醒模型研判,由模型决定登记哪些 | | 存储路径 | 默认 ~/.redteam-assets.json,相对路径基于用户主目录 |

研判规则外置(调规则不用重发)

研判提示词里那套「哪些候选该收、哪些该排除」的规则,可以在 ~/.redteam-asset-graph.rules.md 覆盖。该文件存在即生效,删除或留空则回退到内置默认。每次研判开始时日志会打一行 研判规则来源:… 告诉你走了哪一份。

这是本仓库刻意留的逃生口:调规则只改这个文件,不用改代码、也不用重新发布包。


关联分析怎么工作

阶段 1/2  Jina 检索        对项目内每个可检索资产发一次最小查询
                          → 只产出候选列表,**不写图谱**
阶段 2/2  模型研判        候选清单随研判规则交给模型
                          → 相关的 asset_record,不确定的登记并标「待验证」
                          → 确认无关的**不调用任何工具**,理由留在推理里
                          → 图谱里已有的误报才用 asset_remove 清理

工具捕获候选(全自动,无按钮)

自动捕获 开关打开时,插件从工具输出里提资产,但只进候选池,不写图谱。

捕获范围是一份正向白名单(web_search / web_fetch / search_* / web_* / read_url / parallel_read_url 等外部检索工具),bash、read、grep、glob 等本地工具一律跳过。这不是保守,是实测出来的:本地工具的输出里同样会出现域名与哈希,而且它们不是目标情报 —— git commit SHA 会被当成 hash 资产(40 位十六进制正好命中),源码里的 relay.ok 会被当成域名(ok 是两位字母),连我自己诊断命令打印的截断串都会被当成 URL:

工具输出 → 提取 → 待研判候选池(去重、上限 300、带来源与命中次数)
                       ↓  攒到 6 条,或最后一条之后安静 45 秒
              自动唤醒模型(复用同一条研判规则与提示词)
                       ↓
       相关的 asset_record 入库;无关的不登记,理由留在推理里
                       ↓
   已被登记的候选自动从池里移出;被排除的留在池里但标记已送,不再重复打扰

顶栏的「待研判候选 N」是只读指示,没有按钮 —— 整个过程自己跑。触发时机由 host 自己的 timer 服务每 5 秒驱动一次(客户端每 2 秒的 snapshot 轮询作为补充)。这一点曾经踩过坑:最初只挂在客户端轮询上,结果面板一关,没有轮询,没有心跳,自动研判永远不触发 —— 候选池涨到 21 条、自动研判候选 一次都没出现在日志里。

面板「关联分析」下方常驻一行状态:未运行 / 运行中(检索中·研判中,带已用时间)/ 已完成(带耗时与结束时刻)/ 已停止 / 分析失败。运行期间该按钮变「停止」,此时重复点击会被拒绝。

图谱中的关系边只来自两类来源:

  1. 本地结构化规则 —— belongs_to(URL→域名)、hosts_on(URL→IP)、exposes_port、subdomain_of、in_range(IP 落网段)、mailbox_at(邮箱→域)
  2. 显式指定 —— 模型或人工在 asset_record 里传 relay + relation

不会从备注文本做子串匹配建边,也不会因为两个资产共享某个标签就两两建边。这两类规则都被刻意移除了:它们是平方级噪声源,实测一个语义标签曾在 8 个资产间炸出 35 条边、占全图 78%。

关联的「依据」从哪来

详情卡片里每条关联都带一行灰色的「依据」,按优先级取:

  1. 边的 evidence 字段 —— 模型调用 asset_record 时传了 evidence(这条关系你看到了什么),用它
  2. 否则取对方资产 note 的首行 —— 也就是模型写「收录依据 / 决定性证据」的地方
  3. 都没有则不显示该行

自动关系的 evidence 是触发匹配的那个值(主机名 / 域名 / 网段),所以也能直接读。注意 evidence 曾一度被填成字面量 "model" —— 那是 bug,已修:宁可空着,也不显示假依据。


隐私与安全

  • 运行数据存在 ~/.redteam-assets.json,其中包含你的 Jina API Key 和真实目标资产,已在 .gitignore 中排除。永远不要提交它。
  • 本仓库的源码里不含任何密钥或测试数据,只有占位符 jina_xxxxxxxxxxxxxxxx。
  • 本工具用于已获授权的安全测试。请自行确认你对测试目标拥有授权。

已知限制

  • 强依赖 Jina API Key,没填等于不能用
  • 研判阶段的 web_fetch 在部分环境不可用(代理会把域名解析到保留地址段),内置规则已注明改用检索类工具
  • 资产值现在只能录入 IP 与域名
  • 数据文件不做并发保护,同时开多个 DSH 实例指向同一份存储会互相覆盖
  • 面板的 RPC 走插件自己的 HTTP 路由(/dsh-redteam-asset-graph/rpc),要求宿主提供 webServer 服务

测试

npm test        # 或 node test/render-smoke.mjs

test/render-smoke.mjs 是 Client 半边的渲染冒烟测试。存在的理由很具体:Client 半边只过 node --check 是不够的 —— 语法完全合法的代码仍可能在运行期崩溃。真实案例:assocInfo 是函数声明(会提升),却在它依赖的 const EV_PLACEHOLDER 初始化之前被调用,抛 Cannot access 'EV_PLACEHOLDER' before initialization(TDZ)。这类错误只在「选中一个带边的资产」时才触发,恰好绕过所有静态检查。

测试用桩件实现 React.useState/useMemo/useRef/createElement 等,把 selected 指向一个真实带边的资产,然后调用 Panel() 走完整渲染路径。数据源优先用 ~/.redteam-assets.json,不存在时退回内置小样本。

版本

7.9.7(仓库版本)。src/ 是权威源码,lib/ 由它生成,因此不存在「仓库版本与运行版本不一致」。

本版只修一处致命缺陷:inject 补上 'tools'。三个模型工具都走 ctx.tools.register, 而 Cordis 只允许访问 inject 里声明过的服务 —— 属性访问未声明的服务会在插件树加载期抛 cannot get property "tools" without inject。7.9.6 正是以这种方式发出去的:装了它的 profile 不是少三个工具,是整个 dsh 起不来,升级到本版即恢复。

同一处闸门也固化进了生成器(tools/build-lib.mjs):src 里注册了模型工具、而 inject 缺 'tools' 就中止构建 —— node --check 与 --check 都拦不住这类错,只能靠产物结构断言。

7.9.5 的内容(候选池结算 —— 研判结束后把本轮送出、且未被 asset_record 采纳的候选出池, 模型这一轮若没有任何推理/输出则把候选退回待研判、重推上限 3 次以防空转;面板「待验证」确认 按钮与详情卡放大/展开;lib/ 常驻插件包与 npm 分发要件 dsh.bundle.patch)见 git log 与 tag v7.9.5。

许可

MIT © 2026 fasthei