應(yīng)用安全漏洞掃描人工智能AI Agent【免費(fèi)下載鏈接】deepsecDeepsec is a security harness for finding vulnerabilities in your codebase powered by coding agents項(xiàng)目地址https://gitcode.com/gh_mirrors/deeps/deepsec點(diǎn)擊查看免費(fèi)下載本文面向使用 deepsec由編碼代理驅(qū)動的代碼庫漏洞掃描工具的開發(fā)者與 AI Agent。核心講解 deepsec 掃描工作區(qū).deepsec/中的入口文檔AGENTS.md它如何告訴編碼代理“該讀哪些文件、執(zhí)行哪些操作”以及圍繞它的三個常見任務(wù)——為項(xiàng)目配置掃描SETUP.md INFO.md 流程、注冊新項(xiàng)目init-project、編寫自定義匹配器。讀完本文你將掌握 deepsec 工作區(qū)的文件契約、Agent 協(xié)作協(xié)議與底層實(shí)現(xiàn)能夠在自己或團(tuán)隊的倉庫里復(fù)現(xiàn)這套“Agent 輔助安全掃描”工作流。一、AGENTS.md 是什么掃描工作區(qū)的 Agent 入口deepsec 是一個“以編碼代理為核心”的漏洞掃描工具開發(fā)者在自己倉庫內(nèi)創(chuàng)建一個.deepsec/工作區(qū)deepsec 用正則匹配器免費(fèi)的scan階段 AI 代理process階段支持 Claude Agent SDK / Codex SDK來發(fā)現(xiàn)安全問題可選的 Vercel Sandbox microVM 用于大規(guī)模并行。.deepsec/AGENTS.md是這個工作區(qū)里專門寫給“編碼代理”看的入口文檔。它的全文核心只有一句話這是一個 deepsec 掃描工作區(qū)。每個已注冊的項(xiàng)目在data/id/SETUP.md都有自己的設(shè)置提示setup prompt——當(dāng)被要求為某個項(xiàng)目做設(shè)置時請打開對應(yīng)的那個文件。換句話說AGENTS.md本身不承載具體項(xiàng)目的安全上下文它是一份“路由表”把代理引導(dǎo)到正確的、按項(xiàng)目隔離的指令文件并給出三類常見任務(wù)的標(biāo)準(zhǔn)操作路徑。這也解釋了為什么工作區(qū)的 README 會把它的角色描述為“Pointer for coding agents”見 .deepsec/README.md。為什么需要這份文件多項(xiàng)目隔離每個項(xiàng)目deepsec、my-app……的上下文存放在data/id/下代理需要按id打開正確的SETUP.md與INFO.md而不是靠記憶或猜測。上下文可提交、可繼承data/*/中的INFO.md、SETUP.md、files/*.json逐文件調(diào)查緩存都簽入 git團(tuán)隊成員和 CI 共享同一份項(xiàng)目上下文CI 可以只重新調(diào)查 PR diff 涉及的文件。與 SKILL.md 分層SKILL.md是 deepsec 的“產(chǎn)品技能文檔”在哪里找文檔、如何回答常見問題、Agent 原生初始化協(xié)議而AGENTS.md是“本工作區(qū)如何使用”的操作提示兩者配合使用。二、工作區(qū)目錄結(jié)構(gòu)速覽要理解AGENTS.md中所有路徑的含義先看工作區(qū)布局來自 .deepsec/README.mddeepsec.config.ts Project list (one entry per scanned repo) data/deepsec/ INFO.md Repo context — checked in, hand-curated SETUP.md Agent setup prompt — checked in, deletable files/ One JSON per scanned source file — checked in (the investigation cache; CI reads this) project.json Absolute root path (gitignored — flips per machine) runs/ Run metadata (gitignored — pure churn) reports/ Generated markdown reports (gitignored) AGENTS.md Pointer for coding agents .env.local Tokens (gitignored)其中兩個文件是AGENTS.md反復(fù)指向的核心路徑作用是否提交data/id/SETUP.md每個項(xiàng)目的 Agent 設(shè)置提示告訴代理“讀 skill、填 INFO.md、可選加匹配器”是設(shè)置完成后可刪除data/id/INFO.md項(xiàng)目上下文信任模型、認(rèn)證形態(tài)、威脅模型、需要標(biāo)記的模式、已知誤報每次掃描批處理都會自動注入 AI 提示詞是手工精選維護(hù)data/id/files/*.json逐文件的調(diào)查緩存FileRecordCI 依賴它實(shí)現(xiàn)增量調(diào)查是data/id/project.json目標(biāo)代碼庫的絕對根路徑每臺機(jī)器不同否data/id/runs/、reports/運(yùn)行元數(shù)據(jù)、生成的 Markdown 報告否deepsec.config.ts項(xiàng)目清單每個被掃描倉庫一條記錄是.env.local各廠商 TokenANTHROPIC_AUTH_TOKEN、OPENAI_API_KEY、AI_GATEWAY_API_KEY、VERCEL_TOKEN等否一個真實(shí)的例子本倉庫工作區(qū)已注冊項(xiàng)目deepsec目標(biāo)為..即倉庫根對應(yīng)的 .deepsec/data/deepsec/SETUP.md 和 .deepsec/data/deepsec/INFO.md 就是AGENTS.md中data/id/SETUP.md、data/id/INFO.md的落地形態(tài)。三、常見任務(wù)一為項(xiàng)目配置掃描SetupAGENTS.md給出的標(biāo)準(zhǔn)流程是讀取data/id/SETUP.md并遵循它按 SETUP.md 的指引先讀node_modules/deepsec/SKILL.md安裝后位于工作區(qū)內(nèi)再從目標(biāo)代碼庫整理內(nèi)容填入data/id/INFO.md。展開看 .deepsec/data/deepsec/SETUP.md它給代理下達(dá)了更具體的指令1. 閱讀 deepsec skill安裝完成后skill 位于.deepsec/node_modules/deepsec/SKILL.md。它把每個文檔主題映射到node_modules/deepsec/dist/docs/下的一個文件。SETUP 要求至少精讀getting-started.md、configuration.md、writing-matchers.md其余可略讀。這些文檔在倉庫源碼中對應(yīng) docs/getting-started.md、docs/configuration.md、docs/writing-matchers.md。2. 填寫 INFO.md50–100 行的精選上下文INFO.md會在每一個掃描批處理中被自動注入 AI 提示詞因此 SETUP.md 明確給出了長度預(yù)算與寫作規(guī)范總長度 50–100 行。過長的上下文會稀釋掃描器提示詞窗口里的信號。目標(biāo)是回答“如果評審者沒讀這些會漏掉什么”而不是窮舉枚舉。每個小節(jié)選 3–5 個代表性條目不要羅列所有文件、輔助函數(shù)或調(diào)用點(diǎn)——選模式。用公共名稱命名原語如withAuthentication、auth.can()、isTeamAdmin不寫行號任何列表中的路徑不超過 5 個。跳過通用 CWE 類別內(nèi)置匹配器已經(jīng)覆蓋 “SSRF”“SQL injection”“XSS”。要覆蓋項(xiàng)目特有的東西內(nèi)部認(rèn)證輔助函數(shù)、自定義中間件名稱、分支特有的樁代碼、有意公開的端點(diǎn)。每節(jié)只寫一段短段落或 3–5 條短要點(diǎn)不要兩者都寫。這些規(guī)范也固化在init-project的模板里見 packages/deepsec/src/commands/init-project.ts 的infoMdTemplate模板預(yù)置了五個小節(jié)What this codebase does、Auth shape、Threat model、Project-specific patterns to flag、Known false-positives。參考素材的閱讀順序SETUP.md 推薦目標(biāo)倉庫的README.md→ 任何AGENTS.md/CLAUDE.md→package.json或go.mod、pyproject.toml等→ 5–10 個代表性代碼文件入口點(diǎn)、認(rèn)證輔助函數(shù)而不是一次完整的代碼瀏覽。本倉庫填充完成的示例見 .deepsec/data/deepsec/INFO.md——它開篇就是信任模型Trust model明確列出哪些輸入是受信任的、真正的信任邊界在哪里這正是“項(xiàng)目特有上下文”的典范。3. 設(shè)置完成的收尾SETUP.md 末尾會給出設(shè)置完成后由用戶執(zhí)行的命令pnpm deepsec scan --project-id deepsec pnpm deepsec process --project-id deepsec并注明設(shè)置完成后該 SETUP.md 文件可以刪除。四、常見任務(wù)二注冊新項(xiàng)目init-projectAGENTS.md給出的命令是deepsec init-project root它會腳手架化data/id/并打印/寫入新項(xiàng)目的設(shè)置提示。具體來說實(shí)現(xiàn)見 packages/deepsec/src/commands/init-project.ts向上查找最近的deepsec.config.ts依次嘗試deepsec.config.ts、.mjs、.js、.cjs找不到則報錯并提示先運(yùn)行deepsec init項(xiàng)目id默認(rèn)取目標(biāo)根目錄的 basename可顯式傳--idid 必須通過嚴(yán)格白名單校驗(yàn)見下文寫入三樣?xùn)|西并更新配置data/id/project.json經(jīng)由ensureProject自動探測githubUrldata/id/INFO.md占位模板帶“設(shè)置未完成”標(biāo)記data/id/SETUP.md按項(xiàng)目生成的 Agent 設(shè)置提示向deepsec.config.ts的projects[]中追加{ id, root }條目。其中向配置文件插入項(xiàng)目記錄依賴一個約定標(biāo)記// deepsec:projects-insert-above。insertProjectIntoConfig會在這個標(biāo)記上方以相同縮進(jìn)插入新條目如果標(biāo)記缺失init-project會直接報錯并給出手工添加的替代寫法{ id: my-app, root: ../my-app },本倉庫工作區(qū)的配置即為此產(chǎn)物見 .deepsec/deepsec.config.ts其中root被規(guī)范化為 POSIX 分隔符..以保證跨平臺Windows 貢獻(xiàn)者不會產(chǎn)生..\foo\bar這種難看且 diff 嘈雜的相對路徑。項(xiàng)目 id 的合法性約束從源碼結(jié)構(gòu)看id會流向路徑拼接、沙箱sh -c插值、git 提交信息等多個下游調(diào)用點(diǎn)因此所有入口統(tǒng)一經(jīng)過 packages/deepsec/src/resolve-project-id.ts 的嚴(yán)格白名單/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/即字母/數(shù)字開頭只能含字母、數(shù)字、點(diǎn)、下劃線、連字符最長 64 字符且不能以分隔符開頭。這能一次性攔下..、路徑分隔符、shell 元字符和空白字符。如果工作區(qū)配置里只有一個項(xiàng)目--project-id可以省略自動解析一旦添加了第二個項(xiàng)目就必須顯式傳--project-id id否則會因歧義報錯——這與 .deepsec/README.md 中的說明完全一致。五、常見任務(wù)三編寫自定義匹配器AGENTS.md對自定義匹配器給出了一個非常重要的約束只在一個真實(shí)的 true-positive 向你展示出值得保留的模式之后才去寫自定義匹配器。也就是說不要投機(jī)性地添加匹配器等待一個確鑿的真實(shí)正例出現(xiàn)再把它固化成檢測模式。操作入口是node_modules/deepsec/dist/docs/writing-matchers.md倉庫源碼對應(yīng) docs/writing-matchers.md。工作區(qū)中的自定義匹配器放在.deepsec/matchers/下并在deepsec.config.ts中通過插件機(jī)制注冊。本倉庫提供了一個完整范例 .deepsec/matchers/archive-extraction-untrusted.ts它針對“tar/zip 解壓到磁盤但缺少顯式條目路徑校驗(yàn)”的場景CWE-22 CWE-59即 Zip Slip / Tar Slip 家族具體動機(jī)是 deepsec 自身的安全模型packages/deepsec/src/sandbox/download.ts會把從遠(yuǎn)端 Vercel Sandbox 收到的 tarball 解壓到本地data/id/鏡像而按威脅模型沙箱返回的任何內(nèi)容都是攻擊者可控的——內(nèi)置的rce匹配器能命中spawn調(diào)用但不會推理歸檔條目路徑它用一組正則識別tar -x、execSync tar x、tar.x/extract、unzipper.Extract、extract-zip、decompress、adm-zip extractAllTo等解壓模式同時帶一個“邊界提示”抑制機(jī)制如果在解壓調(diào)用約 6 行內(nèi)出現(xiàn)path.relative(...).startsWith、realpath、path.normalize(entry、onentry等校驗(yàn)特征則跳過這是為了削減明顯噪聲屬于“不完美但有效”的啟發(fā)式匹配器跳過*.test.*/*.spec.*與.d.ts文件避免測試數(shù)據(jù)和類型聲明產(chǎn)生誤報。注冊方式見 .deepsec/deepsec.config.tsimport { type DeepsecPlugin, defineConfig } from deepsec/config; import { archiveExtractionUntrusted } from ./matchers/archive-extraction-untrusted.js; const deepsecPlugin: DeepsecPlugin { name: deepsec-internal, matchers: [archiveExtractionUntrusted], }; export default defineConfig({ projects: [ { id: deepsec, root: .. }, // deepsec:projects-insert-above ], plugins: [deepsecPlugin], });這里也印證了INFO.md信任模型里的一句話deepsec.config.ts經(jīng)由jiti加載packages/deepsec/src/load-config.ts從中加載任意代碼是設(shè)計使然——這正是插件機(jī)制工作的方式它不是沙箱邊界。六、參考資料SKILL.md 與 dist/docsAGENTS.md最后給出兩類參考資料deepsec skillnode_modules/deepsec/SKILL.mdpnpm install之后存在。倉庫中的源文件是 packages/deepsec/SKILL.md其中包含完整的“在哪里找文檔”清單與“如何回答常見問題”映射表例如“如何安裝/初始化”→“getting-started.md”“deepsec.config.ts里放什么”→“configuration.md samples/webapp/deepsec.config.ts”以及面向非 TTY Agent 會話的初始化協(xié)議先用npx deepsec init --plan --output json查看只讀計劃再按需執(zhí)行npx deepsec init --yes --model-profile value --output jsonl把每一行輸出解析為 JSON遇到needs_input時把消息與動作展示給用戶而不是自行編造補(bǔ)救方案退出碼 2 表示需要輸入、3 表示觸發(fā)了成本/時長邊界。完整文檔包node_modules/deepsec/dist/docs/包括getting-started、configuration、models、writing-matchers、plugins、architecture、data-layout、vercel-setup、faq。倉庫根目錄 docs/ 下即這些文檔的源文件。七、實(shí)踐要點(diǎn)日常命令與安全邊界把AGENTS.md的流程串起來一個工作區(qū)的典型日常是來自 .deepsec/README.mdpnpm install # 安裝 deepsec 與 skill pnpm deepsec scan # 免費(fèi)階段僅正則匹配 pnpm deepsec process --concurrency 5 # AI 階段代理逐文件調(diào)查 pnpm deepsec revalidate --concurrency 5 # 復(fù)核顯著降低誤報率 pnpm deepsec export --format md-dir --out ./findings # 導(dǎo)出報告其中scan是純正則、免費(fèi)process是 AI 階段默認(rèn)在 Opus 上約 $0.30/文件。--project-id在只有一個項(xiàng)目時可省略多項(xiàng)目時必填參見上文第四節(jié)。工作區(qū)還把團(tuán)隊已評審并有意接受的殘余風(fēng)險記錄在 README 中值得在接入時一并了解CodexsandboxMode: danger-full-access見 packages/processor/src/agents/codex-sdk.tsCodex 內(nèi)置沙箱會拒絕約 7% 完全合法的只讀命令cat/sed/rg而被拒絕的工具調(diào)用會靜默破壞裁決結(jié)果因此項(xiàng)目選擇禁用其沙箱以保證調(diào)查可靠。安全做法是本地對不信任的目標(biāo)默認(rèn)--agent claude-agent-sdkCodex 優(yōu)先走deepsec sandbox-all的 Vercel Sandbox microVM 扇出路徑確需在宿主機(jī)直跑 codex 時只針對“你本人也愿意親自執(zhí)行其內(nèi)容”的倉庫。commitAndPushData的脫敏是盡力而為而非絕對可靠見 packages/deepsec/src/data-commit.tsscrubCommittedDataDir()會刪除SECRET_SLUGSsecrets-exposure、secret-in-log、jwt-handling、env-exposure等 8 個對應(yīng)的 snippet并對殘留片段做CREDENTIAL_RE兜底掃描不通過則拒絕提交。它的已知缺口是不在SECRET_SLUGS里的新機(jī)密類匹配器可能漏過脫敏正則也覆蓋不了所有憑據(jù)格式如 Terraformdata塊里的長明文 token。因此約定新增機(jī)密類匹配器時同步把其 slug 加進(jìn)SECRET_SLUGS且不要在沒有核對SECRET_SLUGS與匹配器清單packages/scanner/src/matchers/index.ts的情況下把commitAndPushData指向公共數(shù)據(jù)倉庫。結(jié)語.deepsec/AGENTS.md是 deepsec 工作區(qū)里一份小而關(guān)鍵的路由文檔它把編碼代理引導(dǎo)到按項(xiàng)目隔離的SETUP.md/INFO.md定義了“配置掃描、注冊新項(xiàng)目、編寫自定義匹配器”三個標(biāo)準(zhǔn)任務(wù)的執(zhí)行協(xié)議并把 skill 與完整文檔包作為權(quán)威參考。配合init-project的腳手架實(shí)現(xiàn)、resolve-project-id的嚴(yán)格校驗(yàn)、以及 README 中坦誠記錄的已接受風(fēng)險你可以在任何倉庫復(fù)現(xiàn)這套“代理輔助漏洞掃描”的工程化流程——從首次pnpm deepsec scan到多項(xiàng)目、自定義匹配器與 CI 增量調(diào)查的完整閉環(huán)。贊分享應(yīng)用安全漏洞掃描人工智能AI Agent【免費(fèi)下載鏈接】deepsecDeepsec is a security harness for finding vulnerabilities in your codebase powered by coding agents項(xiàng)目地址https://gitcode.com/gh_mirrors/deeps/deepsec點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Deepsec 掃描工作區(qū)實(shí)戰(zhàn)指南在 .deepsec/ 中配置、運(yùn)行并維護(hù) AI 驅(qū)動的代碼安全掃描Deepsec 掃描工作區(qū)實(shí)戰(zhàn)指南在 .deepsec/ 中配置、運(yùn)行并維護(hù) AI 驅(qū)動的代碼安全掃描 .deepsec/ 是 Deepsec一個由編碼 A應(yīng)用安全漏洞掃描人工智能AI AgentncmdumpGUI網(wǎng)易云音樂NCM格式轉(zhuǎn)換完全指南解鎖音樂播放自由ncmdumpGUI網(wǎng)易云音樂NCM格式轉(zhuǎn)換完全指南解鎖音樂播放自由 你是否曾在網(wǎng)易云音樂下載了心愛的歌曲卻發(fā)現(xiàn)在其他播放器或設(shè)備上無法播放這種格式限制應(yīng)用安全漏洞掃描人工智能AI Agent在 Novu 倉庫中落地 deepsec從零配置一套正則 AI驅(qū)動的代碼安全掃描工作區(qū)在 Novu 倉庫中落地 deepsec從零配置一套正則 AI驅(qū)動的代碼安全掃描工作區(qū) Novu 是一個以 Nx monorepo 形態(tài)組織、含 Ne后端消息路由前端通信AI Agent創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考