Deepsec 提示词引擎实战拆解：Go 多框架（Gin + Chi）批量扫描的 Agent 审查提示词是如何生成与校验的-北京尧图网络

应用安全漏洞扫描人工智能AI Agent【免费下载链接】deepsecDeepsec is a security harness for finding vulnerabilities in your codebase powered by coding agents项目地址https://gitcode.com/gh_mirrors/deeps/deepsec点击查看免费下载导读本文以 prompt-samples/11-go-multi-framework-batch.md 这份提示词样本为主线深入拆解 Deepsec 这个由编码 Agent 驱动的安全扫描器如何为一个同时引入Gin 与 Chi 两个 Go Web 框架的项目自动组装出一份完整、可复现、面向大模型的安全审查提示词。读完本文你将理解 Deepsec 提示词的完整骨架核心提示框架威胁高亮 Slug 级审查笔记 Agent 层包装、样本与源码/测试的对应关系、以及如何通过UPDATE_PROMPT_SAMPLES1 pnpm test:unit重新生成这类样本。一、样本是什么一个Go 双框架批量扫描场景的完整快照prompt-samples/11-go-multi-framework-batch.md是 Deepsec 仓库中 11 个提示词样本之一它并不是一份人类手写的文档而是一份运行时真正发送给编码 Agent 的完整提示词的确定性快照fixture。文件开头的 HTML 注释记录了该场景的元数据逐字段解读如下Scenario : 11-go-multi-framework-batch Go project that pulls in two Go frameworks (Gin Chi) — both highlights ship for a Go-only batch. Detected tags: [gin,chi,go] Batch files : [cmd/server/main.go] Batch langs : [go] Batch slugs : [go-gin-route,go-chi-route,go-ssrf] Generated by : packages/processor/src/__tests__/prompt-samples.test.ts Regenerate : UPDATE_PROMPT_SAMPLES1 pnpm test:unit这 6 行元数据本身就浓缩了 Deepsec 提示词组装的核心链路Detected tags来自扫描器对项目的技术栈识别detectTech()这里识别出项目同时使用 Gin、Chi 与 GoBatch files本次批量调查只包含一个文件cmd/server/main.go一个同时挂了 Gin 和 Chi 路由的 Go 服务入口Batch langs由批内文件的扩展名推导出的规范语言名这里只有go对应 file-language.ts 中.go → go的映射Batch slugs扫描器在该文件上命中的漏洞匹配器集合Generated by / Regenerate表明该样本由 prompt-samples.test.ts 生成并校验可用UPDATE_PROMPT_SAMPLES1 pnpm test:unit在提示词组装逻辑变更后重新生成。这个场景的设计意图从 prompt-samples.fixtures.ts 中的定义可以看得更清楚一个 Go 项目同时引入 Gin 和 Chi 两个框架验证在Go 单语言批量下两个框架的威胁高亮会同时进入提示词。这与 04/05 号样本多语言仓库中按批内语言过滤其他框架高亮形成对照框架高亮跟随的是批内文件的语言而不是整个项目检测到的技术栈。二、提示词的整体架构三段式组装 Agent 层包装这份样本实际是两层代码拼接的产物理解这一点是读懂全文的关键系统提示词半段assembler 组装由 assemblePrompt() 完成顺序为通用核心提示core.ts 中的CORE_PROMPT框架威胁高亮段## Threat highlights for this repos tech stack按detectedTagsbatchLanguages过滤来自 highlights.tsSlug 级审查笔记段## Slug-specific reviewer notes仅包含批内实际命中的 slug来自 slug-notes.ts可选的INFO.md与config.json:promptAppend追加内容用---分隔避免出现连续两个 H2。Agent 层包装buildInvestigatePrompt由 agents/shared.ts 中的buildInvestigatePrompt()完成追加## Target Files含命中行号、## Investigation Instructions调查步骤与## Output FormatJSON 输出规格。样本中## Severity Classification、## Known Vulnerability Categories、## False Positive Guidance等段落来自核心提示### Gin、### Chi段落来自框架高亮go-gin-route/go-chi-route/go-ssrf三条笔记来自 slug 笔记## Target Files及其之后的全部内容来自 Agent 层包装。测试 prompt-samples.test.ts 正是通过断言样本同时包含两半内容来防止其中一半丢失。组装器还有一个重要的预算控制机制FRAMEWORK_SECTION_CHAR_BUDGET 6000字符约 1500 token按 4 字符 ≈ 1 token 估算。当多语言巨型仓库使框架段超预算时会退化为一行本仓库使用 N 个已知框架…的摘要而不是把提示词撑爆见 07 号样本07-overflow-fallback的设计意图。三、核心提示词详解让 Agent 以攻击者思维做静态审查样本正文的第一段定义了 Agent 的角色与任务边界角色设定世界级安全研究员精通 Web 安全、认证系统与跨语言现代框架以攻击者思维寻找自动化工具漏掉的微妙逻辑缺陷——竞态条件、参数操纵导致的认证绕过、信任边界违规候选机制扫描器用正则与启发式模式撒大网产出候选文件多数是误报Agent 的职责是以候选为起点做彻底、开放式的安全审查硬性约束仅做静态分析不得复现、利用或触发任何漏洞不得运行目标代码、向端点发包、执行 PoC 脚本。3.1 严重性分级提示词为安全漏洞定义了三级、为非安全缺陷定义了两级这是后续 JSON 输出的枚举依据级别含义与示例CRITICALRCE、可完全接管系统的认证绕过、敏感数据上的 SQL 注入、可导致 RCE 的无限制文件上传、打到内部服务的 SSRFHIGHXSS、SSRF、权限提升、源码中的硬编码密钥/凭据、不安全反序列化、敏感操作缺少授权MEDIUM开放重定向、弱加密算法、缺少限流、信息泄露、不安全的直接对象引用、竞态条件、认证/权限检查中的逻辑缺陷HIGH_BUG可导致数据丢失、损坏、宕机或严重行为异常的重大非安全缺陷BUG不值得升到 HIGH_BUG 的非安全缺陷逻辑错误、竞态、资源泄漏3.2 已知漏洞类别表提示词内置了一张完整的漏洞类别slug对照表作为 Agent 的查漏清单——无论扫描器是否命中Agent 都应检查所有这些类别SlugCategoryauth-bypassAuthentication checks that can be circumventedmissing-authHTTP endpoints without authenticationacl-checkMissing or incorrect RBAC/permission checksxssCross-site scripting via innerHTML, dangerouslySetInnerHTML, etc.dangerous-htmlUnsafe HTML rendering with user-controlled datarceRemote code execution via exec, eval, spawn, etc.sql-injectionSQL injection via string interpolation/concatenationssrfServer-side request forgery via user-controlled URLspath-traversalFile operations with user-controlled pathssecrets-exposureHardcoded API keys, tokens, passwordsinsecure-cryptoWeak hash algorithms, insecure random generationopen-redirectRedirects to user-controlled URLsunsafe-redirectRedirects bypassing validation functionspublic-endpointPublic endpoints exposing sensitive data without authservice-entry-pointService handlers that may lack proper authwebhook-handlerWebhook endpoints without signature verificationiam-permissionsMisconfigured IAM Action/Resource permissionsjwt-handlingJWT signing/verification misconfigurationsenv-exposureSecrets leaking to client bundlesrate-limit-bypassSensitive operations without rate limitingcache-key-poisoningCache keys including attacker-controlled valuessecret-env-varDirect access to secret environment variablescross-tenant-idUser-supplied IDs in DB lookups without ownership checksecret-in-fallbackSecret env vars with hardcoded fallback valuessecret-in-logCredentials in log statements or error responsesexpensive-api-abuseEndpoints calling expensive APIs (LLM, AI, paid services) without abuse protectionother-*Any other vulnerability not listed above (use descriptive suffix)3.3 误报指导False Positive Guidance提示词要求 Agent 在分类前先核查缓解因素以压制误报输入在使用前是否被清洗/转义参数化查询、HTML 转义是否有中间件或框架防护罩保护该代码路径该脆弱模式是否只用于可信/内部数据而非用户输入认证检查的判定标准只有直接包裹 handler 的中间件才算数Express 中间件、Fastify hooks、NestJS guards、Spring filters、Rails before_action、Django decorators、FastAPI Depends。边缘/代理/CDN/WAF 规则以及运行在 handler 之前的栈前中间件单独不足以构成防护——太容易被误配置或通过逃逸匹配器的路由绕过对于重定向重定向前是否有显式 allowlist 或 origin 检查如果已完全缓解则不得上报只报告真实可利用的漏洞。3.4 认证绕过模式清单核心提示专门列出三类看似有认证实则可绕过的检查模式Query String URL 操纵参数污染重复查询参数如?teamIdxteamIdy能否改变行为或绕过检查编码字符%2Fvs/、%00空字节——应用是否正确处理 URL 编码、双重编码与 Unicode 规范化路径路由参数注入动态路由段能否被操纵以访问他人数据Token 刷新滥用强制刷新 token 的查询参数是否有速率限制认证流程绕过OAuth 回调操纵state 参数篡改、redirect_uri 操纵、自定义 URI scheme 注入会话/JWT 弱点算法未固定algorithm pinning、未配置认证时的 stub 会话、测试 token 在生产可达头注入X-Forwarded-For、Authorization、自定义x-*token 是否被盲目信任授权缺口有认证但认证错了跨租户访问用户提供的teamId/userId直接用于 DB 查询而非认证身份缺少资源级检查认证只确认用户已登录未确认用户拥有该资源取反的权限检查!(await auth.can(...))这类反转逻辑。3.5 Out-of-scope 文件dist/、node_modules/、vendor/、generated/或匹配.gitignore的生成/供应文件应跳过若某文件属于此类则对它返回空 findings 数组。四、框架威胁高亮Gin 与 Chi 的安全检查要点框架高亮是 Deepsec 提示词最有特色的部分它不教模型框架是什么而是直接点名扫描器看不见的高信号威胁与误报缓解点。本样本同时携带了 Gin 与 Chi 两份高亮这正是Go 多框架批量场景的验证目标。Gin每个r.GET/POST/...与r.Group(...)都是一个公共端点通过r.Use(...)应用的认证中间件必须在同一组内的路由注册之前c.Query/c.Param/c.PostForm是用户输入——常规注入面SQL、exec、fs、URL均适用c.HTML(http.StatusOK, tmpl, data)中若data含不可信字符串则是 XSS除非模板使用{{.X}}自动转义而非{{.X | safehtml}}。Chir.Use(middleware)与r.Group(...)定义认证作用域——子路由器会继承但r.Mount(/x, h)不会继承 mount 之后应用的中间件chi.URLParam(r, id)是用户输入在 DB / fs / exec 调用中必须视为不可信render.JSON(w, r, data)原样返回你传入的内容——DB 行常含秘密列应使用响应形状结构体response-shape struct。从 highlights.ts 可以看到这两份高亮的languages都声明为[go]因此在batchLanguages [go]时二者都被保留而 Next.js / Django 等高亮则被语言过滤剔除。这正是本场景元数据里 both highlights ship for a Go-only batch 的含义。与之配套的扫描器侧证据在 go-gin-route.ts 与 go-chi-route.ts前者匹配r.GET/POST/...、.Group(、gin.Default()/gin.New()与c.Query/Param/PostForm/GetHeader/ShouldBind*访问器后者匹配chi.NewRouter()、.Route(、.Group(、.Mount(并特意标注middleware inheritance gotcha与chi.URLParam(。两者都要求requires: { tech: [...] }即只在detectTech()识别到对应框架时才生效且都会跳过_test.go测试文件。五、Slug 级审查笔记go-gin-route / go-chi-route / go-ssrf批内命中的每个 slug 会对应一行上报前先核查什么的评审直觉笔记。本样本的三条go-gin-route弱入口点候选——确认该组内没有先于路由注册的认证r.Use(...)go-chi-route弱入口点候选——确认r.Use(auth)在作用域内且后续没有r.Mount(...)短路掉继承go-ssrf拼接 URL 传给http.Get/client.Do且无 allowlist——内部主机是高严重度情形。这三条笔记分别来自 slug-notes.ts 中的SLUG_NOTES表。需要说明的是通用的ssrf匹配器ssrf.ts主要针对 TS/JS 生态的fetch/axios/got等客户端而 Go 场景里命中的go-ssrf是独立于通用匹配器的 Go 专用 slug笔记也单独维护——这体现了 Deepsec按语言生态定制审查直觉的设计。笔记段由renderSlugSection()生成assemble.ts只包含当前批内出现的 slug因此提示词长度随扫描器实际命中规模伸缩而不是始终携带完整注册表。六、目标文件、调查指令与输出格式Agent 层包装6.1 目标文件与命中行号## Target Files段把批内文件与扫描器命中位置一一对应成为 Agent 的阅读清单cmd/server/main.go[go-gin-route] L18Gin method registration[go-chi-route] L42Chi method registration[go-ssrf] L60http.Get with concatenated URL行号的呈现逻辑来自 agents/shared.ts有候选的文件列出每条[slug] L行号: 命中模式无扫描器命中的文件如process --diff直接调用的场景则标注no scanner hits — full holistic review引导 Agent 做整体审查而非追问候选在哪。6.2 调查指令五步法对每个文件Agent 必须完整读取文件使用 Read 工具追踪数据流——输入从哪来是否用户可控跟进导入——阅读相关文件中间件、工具、共享库以获得完整图景检查缓解措施——是否有清洗、校验、认证中间件或框架防护开阔思考——寻找扫描器标记之外的问题逻辑缺陷、竞态条件、缺失检查等。6.3 输出格式JSON 规格调查结束后Agent 必须对每个文件输出一个 JSON 块格式严格固定[ { filePath: relative/path/to/file.ts, findings: [ { severity: CRITICAL|HIGH|MEDIUM|HIGH_BUG|BUG, vulnSlug: the-vuln-slug-or-other, title: Brief title of the issue, description: Detailed description of the vulnerability, the attack scenario, and evidence from the code, lineNumbers: [10, 15], recommendation: How to fix this vulnerability, confidence: high|medium|low } ] } ]补充规则vulnSlug可以是已知类别之一也可以用other前缀自定义如other-race-condition、other-logic-bug、other-info-disclosure如果某个文件经彻底调查确实没有真实漏洞仍要包含该文件并返回空 findings 数组——这保证了每个批内文件都有对应的结构化结论便于后续的 reconciliation核对与 revalidate复验流程。七、样本的生成与校验测试即文档prompt-samples/目录不是手工维护的而是由测试驱动的确定性产物这一点对使用者非常重要prompt-samples.test.ts 遍历PROMPT_SAMPLE_SCENARIOS为每个场景走与生产完全相同的代码路径assemblePrompt()buildInvestigatePrompt()然后断言磁盘上的样本与实时组装结果逐字节一致场景数据定义在 prompt-samples.fixtures.tsdetectedTags直接来自场景声明batchLanguages由文件扩展名推导batchSlugs由候选 slug 去重而来——样本因此与真实运行保持诚实一致当提示词组装器、框架高亮或 Agent 层有意改变输出形状时开发者设置UPDATE_PROMPT_SAMPLES1 pnpm test:unit即可让测试改写磁盘上的样本之后在 PR 中审查 diff测试代码注释明确建议了这种做法。该测试还附带两条额外断言以守护组装质量样本必须同时包含组装的核心半段与Agent 层的文件列表防止某一半丢失INFO.md内容在最终提示词中恰好出现一次防止 Agent 层重复发射见 prompt-samples.test.ts。八、如何查看与使用这份样本对于使用者而非贡献者而言这份样本的价值在于预测和调试在运行 Deepsec 扫描之前阅读对应场景样本可以准确预期我这种技术栈/批次的仓库Agent 会收到什么样的指令仓库中的 11 个样本覆盖了从空项目01、单框架批量02/03/09/10、多语言过滤04/05/06、超预算回退07、INFO.md 注入08到本文的 Go 双框架批量11等典型形态可作为理解提示词组装行为的参考图谱若你是安全工程师也可以把样本当作Go Gin/Chi 服务安全审查 checklist来用认证中间件顺序Ginr.Use必须先于路由注册、Chir.Mount不继承中间件、用户输入访问器c.Query/chi.URLParam、以及拼接 URL 传给http.Get的 SSRF 风险都是可直接落到代码评审里的检查项。相关源码路径速查组装器 assemble.ts、核心提示 core.ts、框架高亮 highlights.ts、slug 笔记 slug-notes.ts、Agent 层包装 agents/shared.ts、场景定义 prompt-samples.fixtures.ts、生成测试 prompt-samples.test.ts、Go 匹配器 go-gin-route.ts 与 go-chi-route.ts。赞分享应用安全漏洞扫描人工智能AI Agent【免费下载链接】deepsecDeepsec is a security harness for finding vulnerabilities in your codebase powered by coding agents项目地址https://gitcode.com/gh_mirrors/deeps/deepsec点击查看免费下载相关推荐Deepsec 深入解析Rails/Ruby 批量扫描的 Agent 调查提示词是如何构造与执行的Deepsec 深入解析Rails/Ruby 批量扫描的 Agent 调查提示词是如何构造与执行的本篇以 Deepsec 仓库中的确定性提示词样例 prom应用安全漏洞扫描人工智能AI AgentDeepsec Laravel PHP 批量安全审查提示词全解析从自动化扫描到 Agent 深度研判Deepsec Laravel PHP 批量安全审查提示词全解析从自动化扫描到 Agent 深度研判本篇文章以 Deepsec 仓库中的 prompt sa应用安全漏洞扫描人工智能AI Agent读懂 Deepsec 的 AI 安全审查提示词以 Next.js TSX 批量审查样本为例读懂 Deepsec 的 AI 安全审查提示词以 Next.js TSX 批量审查样本为例导读本文围绕 Deepsec 开源仓库中的 prompt s应用安全漏洞扫描人工智能AI Agent上一篇10分钟上手FlatBuffers容器化部署从编译到运行的Docker全流程下一篇10分钟打造专属命令库Scoop别名管理器让效率提升300%的实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Deepsec 提示词引擎实战拆解：Go 多框架（Gin + Chi）批量扫描的 Agent 审查提示词是如何生成与校验的

相关推荐

PaddleSeg DualTaskLoss（双任务损失）详解：基于 Gumbel-Softmax 的语义边界一致性约束

Jellyfin 桌面客户端：免费装 MPV 播放器的 3 步配置，音频直通与硬件解码一篇讲清

ESP32-S3 USB HID 键盘在 Arduino 核心 3.0 中 LED 状态不回传，怎么定位、如何绕过

更多资讯

Ajenti Date Time 插件指南：服务器时区管理、时间设置与 NTP 同步实战

方案网站建设避坑：搞定备案与性能优化的实战指南

xiaobei 项目 zhihu-publish 技能实战指南：基于 camoufox-cli 持久化 Session 的知乎文章与回答发布自动化

2026最新免备案空间哪家好？告别无人访问，3步搞定

linuxkit 内嵌的 go-autorest：从 v1.0.0 到 v14.2.1 的 Azure Go SDK 演进全解读

5类劳动节网页设计素材安全坑，新手建站怎么选才不踩雷

今日更新

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本周精选

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？