SRC 研究项目目录结构与主要组件说明。
当前目录文件分析#
分析日期:2026-09-23。范围:当前 SRC 研究包中与 DSH、Claude Code、Codex 部署直接相关的目录结构、入口文件及记录;仅整理这三个客户端的状态,不保留其他客户端部署记录。
结论#
本目录由共享的研究规则、技能知识库、MCP 服务源码、部署/检查脚本组成。三个客户端使用彼此独立的用户级配置与服务副本:DSH 通过激活 profile patch 加载 MCP;Claude Code 使用用户级技能、全局入口和 MCP 配置;Codex 保留技能副本,但 2026-09-21 的最新记录显示本项目 MCP 注册已注销。
当前 DSH 路由已同步为:recon-mcp 统一 Gateway 为主搜索源,独立 Netlas、Quake、FOFA 为串行备用,顺序为 Netlas → Quake → FOFA;Playwright 仅为浏览器工具,不属于搜索源。DSH 的服务器实现目录是 ~/.dsh/mcp-servers/,实际注册和加载顺序由激活 profile 的 cordis.patch.yml 决定。
本分析基于本项目文件、活动 DSH profile 和《部署记录.md》的本地记载,不读取或记录任何凭据值。部署日期、测试输出和回滚位置以部署记录中的对应条目为准。
三个平台的文件关系与记录状态#
| 客户端 | 用户级入口与配置 | 本项目部署状态(按最近记录) |
|---|---|---|
| DSH Desktop | ~/.dsh/AGENTS.md、~/.dsh/skills/src-research/、激活 profile 的 cordis.patch.yml、~/.dsh/mcp-servers/、/Users/feliz/Documents/recon-mcp/ | recon-mcp 为主搜索源;Netlas → Quake → FOFA 为串行备用;Playwright 为浏览器工具;ZoomEye 已移除。 |
| Claude Code | ~/.claude/CLAUDE.md、~/.claude/skills/src-research/、~/.claude.json、~/.claude/mcp-servers/ | ZoomEye 已移除;最新路线记录为 Netlas → FOFA;Claude Code 迁移、验证和清理历史保留。 |
| Codex | ~/.codex/AGENTS.md、~/.codex/skills/src-research/、~/.codex/config.toml | 2026-09-21 已注销本项目的 Quake、Netlas、FOFA、Playwright MCP 并归档服务目录;技能仍保留。 |
本目录中与部署有关的组件#
| 路径 | 用途 |
|---|---|
AGENTS.md | 项目级研究规则入口。 |
rules/ | 研究范围、流程、验证和报告格式等规则。 |
skills/skill/SKILL.md、skills/skill/知识库/ | src-research 技能入口和专题资料。 |
/Users/feliz/Documents/recon-mcp/ | DSH 统一资产侦察 Gateway;提供 asset_search、recon、deep_recon,本地优先并保留 provider fallback。 |
mcp-servers/quake_MCP/、mcp-servers/netlas_MCP/、mcp-servers/fofa_MCP/ | 三个搜索服务的共享源码。 |
scripts/deploy_dsh.py | DSH profile、技能及服务的预检/部署入口。 |
scripts/deploy_codex.py | Codex 用户级技能和服务的预检/部署入口。 |
scripts/add_quake.py | Quake 增量部署辅助脚本。 |
scripts/check_*.py、tests/ | MCP 本地检查与自动化回归。 |
README.md、部署记录.md | 三个平台的简要使用说明、历史状态、验证及回滚记录。 |
部署记录覆盖范围#
《部署记录.md》按时间保留了 DSH 的初始部署、Quake 接入、recon-mcp Gateway 接入及当前主备路由;Claude Code 的目录、技能和 MCP 状态核验,以及 ZoomEye 增删记录;Codex 的初始部署、Quake 增量和 2026-09-21 MCP 注销记录。历史 Quake 第一来源条目保持原样,并在当前摘要中与现行 recon-mcp 主路由区分。
Codex MCP 注销仅涉及用户级配置和服务副本;记录明确说明 Codex 的 src-research 技能与本项目源码未改动。DSH 和 Claude Code 的客户端配置仍以各自目录和部署记录为准,不由 Codex 的状态推断。