概览
dsh-agentic-proxy
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **首次需要能访问 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 遇到时可自行恢复。
