dsh-agentic-proxy

LIMITATIONS

Known limitations

- **首次需要能访问 GitHub。** npm 与 npmmirror 都**没有** mihomo 二进制，所以下载源是 GitHub 直连 + `gh-proxy.com` + `ghproxy.net`。若三者都不可达，请手动下载内核并在设置里 填入路径。（实测数据见仓库中的 `FINDINGS.md`。） - **无官方 sha256。** 上游不提供校验文件，因此只做了长度比对与 zip 头校验这类弱校验。 - **仅 Windows 已实测。** 内核获取、解压（`tar.exe`）与 shim（`.cmd`）目前是 Windows 路径。 - **`proxy` 会进入 PATH。** 插件停止时会按标记清理；若你手动删过文件，残留的 `proxy.cmd` 也可以直接删除，插件下次启动会重新生成。 - **Agent 需要被告知才有这个能力。** 插件**不注册模型工具**（那会成为与 shell 命令并列的 第二条执行路径），而是注册一个运行时技能 `agentic-proxy`：它的名称与描述常驻在技能目录里， 正文按需加载。**因此技能只在 `proxy` 命令确实存在于 PATH 上时才注册**——否则等于让模型 去执行一条不存在的命令。未点过「安装命令前缀」时不会有这个技能。 - **模型仍可能选择不用。** 知道能力存在不等于每次都会用；直连失败时它更可能直接报告"网络不通"。 - **受限沙箱里 Schannel 可能拿不到证书凭据。** `curl.exe`（以及 git 在 Schannel 模式下） 会报 `schannel: AcquireCredentialsHandle failed: SEC_E_NO_CREDENTIALS (0x8009030E)`。 **这不是代理不通**（通道已经建立），而是 TLS 后端取不到 Windows 证书库。对**该条命令** 加 `-c http.sslBackend=openssl` 即可（`proxy git -c http.sslBackend=openssl clone …`）； Node 与 Python 自带 OpenSSL，不受影响。**不要**把它写进全局 git 配置——Schannel 用的是 Windows 证书库，某些环境（企业 MITM 代理）的根证书只在系统库里，强制 OpenSSL 会因无法 验证证书而失败。这一条已写进技能正文，Agent 遇到时可自行恢复。