插件目录 / Developer / dsh-fingerprint-relay
dsh-fingerprint-relay
未验证 Wilfred-wei
功能简介
DSH plugin: managed local fingerprint relays so DSH can reach providers that gate on the client's TLS fingerprint
未验证 — 尚未实测
DSH plugin: managed local fingerprint relays so DSH can reach providers that gate on the client's TLS fingerprint 尚未验证——请自行安装测试。
「未验证」表示我们的自动化 CI 尚未安装过该插件。功能描述与版本兼容性均为作者声明。这不是安全审计，也不代表对第三方代码的背书。
README
DSH Fingerprint Relay
Lets DSH reach providers that gate on the client's TLS fingerprint (for example agentrouter.org).
The plugin runs a local Python egress process that the upstream allow-lists, and forwards DSH's requests through it.
When you need it
The provider works in a browser or its official CLI, but DSH gets unauthorized client detected or a 403.
Requirements
- DSH Desktop (framework
0.1.0-rc.8) - Python 3.11+
Install
git clone https://github.com/Wilfred-wei/dsh-fingerprint-relay.git
cd dsh-fingerprint-relay
.\scripts\install.ps1
The script installs the plugin, creates a Python venv, installs its dependencies, writes the interpreter path into your profile, and verifies the result.
Then restart DSH Desktop.
Without the script: two manual steps
# 1. install the plugin
dsh plugin --profile web add dsh-fingerprint-relay
# 2. create the Python environment
$relay = "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-fingerprint-relay"
python -m venv "$env:USERPROFILE\.dsh\fingerprint-relay-venv"
& "$env:USERPROFILE\.dsh\fingerprint-relay-venv\Scripts\python.exe" -m pip install -r "$relay\resources\requirements.txt"
Then point the plugin at that interpreter in %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml:
- id: fingerprint-relay-host
config:
pythonPath: C:\Users\<you>\.dsh\fingerprint-relay-venv\Scripts\python.exe
Usage
- Settings -> Fingerprint relay -> Add relay
- Upstream URL:
https://agentrouter.org - Local port:
7187
- Upstream URL:
- Press Start; the status becomes
running / healthy - Under Providers through a relay, point an Anthropic provider (such as
agent-claude) at it - Chat as usual
The API key stays where it already is — in the provider's own configuration. The relay stores no keys.
Limitations
- Anthropic Messages channel only; on new-api style gateways set the provider's protocol to
anthropic-messageseven for GPT models (the gateway converts them). Native OpenAI endpoints are not supported. - The egress process listens on
127.0.0.1only - Accepted on Windows
Troubleshooting
| Symptom | Fix |
|---|---|
| No "Fingerprint relay" section in Settings | Restart DSH Desktop; dsh --profile web --dump-config should list fingerprint-relay-host |
| Start fails: missing Python packages | Re-run .\scripts\install.ps1, or pip install fastapi uvicorn httpx anthropic for that interpreter |
| Start fails: port in use | Pick another local port |
| Requests return 401 | That provider has no API key configured |
Long stall, then no stream data for 120s |
The upstream stalled; the relay already retried once — send again |
| Config change had no effect | Press Stop then Start in Settings |
Building from source
npm install --legacy-peer-deps
npm run build
npm test
npm pack --ignore-scripts
Architecture and behaviour specs live in docs/.
License
MIT
安装
装一次目录插件，之后本站所有插件都能让 DeepSeek Harness 自动找、自动装：
dsh plugin add dshbase-catalog然后对 agent 说「帮我装 dsh-fingerprint-relay」，它会在目录里找到并自动安装。文档：dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码（未发 npm）——直接从仓库装：
Web profile：
dsh plugin --profile web add github:Wilfred-wei/dsh-fingerprint-relayHeadless（CLI）profile：
dsh plugin --profile headless add github:Wilfred-wei/dsh-fingerprint-relay实测报告
尚未 L3 验证——若已跑过，见下方失败备注。
分享徽章
把这枚徽章粘进 README——它会链回本页，实测状态变化时自动更新：
[](https://dshbase.com/zh/plugins/dsh-fingerprint-relay/)<a href="https://dshbase.com/zh/plugins/dsh-fingerprint-relay/"><img src="https://dshbase.com/badges/dsh-fingerprint-relay.svg" alt="dshbase 已收录"></a>