deCOLE118/dsh-sitemap

README 摘要

dsh-sitemap DeepSeek Harness（DSH）站点地图插件 · 把 Yakit 的站点地图交互搬进 DSH 在 DSH 侧边栏一键打开「站点地图」：按主机树形组织工作区侦察到的接口，支持搜索、接口详情（方法 / 参数 / 出现次数）、一键复制 curl，数据实时同步。 设计来源 Yakit 里的「站点地图」我觉得做得很好，就借鉴了它的交互：把发现的所有接口按主机自动归类，形成一棵可展开、可搜索的树： 做资产梳理和接口测试时，这棵树比零散的请求记录直观得多。本插件把同样的体验带到 DeepSeek Harness：不用另开工具，在 DSH 侧边栏点一下「🗺 站点地图」，应用内直接弹出树形接口地图。 特性 - 🗺 侧边栏入口 ：点击「站点地图」打开应用内全屏地图（中 / 英双语） - 🌲 主机树 ：主机 → 接口路径两级树，可折叠、显示统计 - 🔍 实时搜索 ：按主机名 / 接口路径过滤 - 📋 接口详情 ：方法、参数、出现次数；一键复制 curl、新窗口打开 - ⚡ 数据实时同步 ：每次打开 / 刷新都从宿主路由读取最新数据，无缓存 使用方法 1. 把插件放入 DSH 插件目录并重启（见「安装」） 2. 侧边栏底部点击「🗺 站点地图」打开地图 3. 弹窗打开时会自动从宿主路由拉取最新数据；点「刷新」可随时重新拉取 数据从哪来？ 插件只负责展示，不负责扫描——数据源是工作区里的 sitemap data.json （格式见下节），由你自己的侦察工作流生成，例如 JS / 接口挖掘脚本把结果按主机汇总成该格式即可。 什么时候触发？ 按钮在插件加载后常驻侧边栏；每次打开弹窗或点「刷新」才触发一次数据拉取（无缓存，拿最新内容）。文件不存在时弹窗显示错误 / 空状态；文件更新后重新打开或点「刷新」即见新数据，无需重启 DSH。 实现原理 整体架构：双半区 DSH 插件分两个半区运行，本插件亦是如此： 半区 文件 运行环境 职责 宿主半区 src/index.ts Node 侧（cordis 插件） 注册 webServer 路由，读取工作区数据文件 浏览器半区 src/client/index.tsx 浏览器侧（React） 侧边栏入口 + 树形地图弹窗，fetch 拉取数据 宿主半区：只做数据中转 宿主半区是一个 cordis 插件，通过 ctx.inject(['webServer']) 拿到宿主 webServer 能力后注册两条路由： - GET /dsh-sitemap/data → 读取 / /sitemap data.json ，以 JSON 信封 { ok, data } 返回；文件不存在时返回 404 - POST /dsh-sitemap/regen → 同样重新读取并返回（预留"重新生成后取数"的语义） 文件访问被 …

分类