mkaliezz/dsh-api-client: 本地优先的 HTTP 调试工具

DSH 开发者在调试智能体发出的 HTTP 请求时，往往需要在本地拦截、查看或限制请求。直接使用浏览器开发者工具或通用抓包工具通常缺乏上下文，且容易暴露敏感信息。为了解决这一问题，mkaliezz/dsh-api-client 提供了基于本地进程的 HTTP 调试能力。

插件定位¶

这是一款运行在本地环境下的 DSH 插件，由 MkaliezZ 维护。它以 localhost 为优先目标，用于捕获和分析 DSH 进程发起的 HTTP 请求。在 v0.1 版本中，它默认拦截远程主机并隐藏敏感请求头，旨在为开发者提供一个安全可控的调试环境。

核心功能¶

1. 本地优先调试：专注于捕获 DSH 进程发出的 HTTP 请求。
2. 默认安全策略：在 v0.1 版本中，默认屏蔽远程主机（Localhost-first），并隐藏敏感请求头，防止敏感信息泄露。
3. 流量限制：对请求和响应的大小进行边界限制，防止异常流量占用过多资源。
4. 命令适配器：暴露了一个小的 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 仓库。