DSH 開發者在調試智能體發出的 HTTP 請求時,往往需要在本地攔截、查看或限制請求。直接使用瀏覽器開發者工具或通用抓包工具通常缺乏上下文,且容易暴露敏感信息。爲了解決這一問題,mkaliezz/dsh-api-client 提供了基於本地進程的 HTTP 調試能力。
插件定位¶
這是一款運行在本地環境下的 DSH 插件,由 MkaliezZ 維護。它以 localhost 爲優先目標,用於捕獲和分析 DSH 進程發起的 HTTP 請求。在 v0.1 版本中,它默認攔截遠程主機並隱藏敏感請求頭,旨在爲開發者提供一個安全可控的調試環境。
核心功能¶
- 本地優先調試:專注於捕獲 DSH 進程發出的 HTTP 請求。
- 默認安全策略:在 v0.1 版本中,默認屏蔽遠程主機(Localhost-first),並隱藏敏感請求頭,防止敏感信息泄露。
- 流量限制:對請求和響應的大小進行邊界限制,防止異常流量佔用過多資源。
- 命令適配器:暴露了一個小的 DSH 命令接口,方便在命令行中控制調試行爲。
安裝與啓用¶
插件包名爲 @mkaliezz/dsh-api-client,當前版本爲 0.2.2。該插件通過 TypeScript 構建,主要入口爲 lib/src/plugin.js。在 DSH 生態中,此類插件通常通過包管理器安裝並自動應用 cordis.patch.yml 配置。
安裝前需確保 Node.js 版本滿足 >=20。
{
"name": "@mkaliezz/dsh-api-client",
"version": "0.2.2",
"type": "module",
"private": false,
"description": "DSH plugin: dsh-api-client",
"license": "MIT",
"main": "lib/src/plugin.js",
"types": "lib/src/plugin.d.ts",
"files": ["lib", "cordis.patch.yml", "README.md", "LICENSE"],
"scripts": {
"build": "tsc -p tsconfig.json",
"test": "npm run build && node --test lib/test/*.test.js",
"prepublishOnly": "npm run build"
},
"engines": {
"node": ">=20"
},
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
}
適用場景與注意¶
- 適用場景:開發者在本地調試智能體調用外部 API 的行爲,特別是需要驗證 localhost 回調或排查跨域/網絡問題時。
- 重要限制:它不是憑據管理器,不會繞過 Secret Guard 或 AgentFuse。插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證(MIT)。
總結¶
該工具通過本地優先和默認攔截策略,爲 DSH 開發提供了基礎的安全調試能力。更多細節可參考其 SkillHub 目錄 或 GitHub 倉庫。