插件目录 / 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 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计，也不代表对第三方代码的背书。
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实测报告
验证通过：从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行（dsh 0.1.0-rc.6）。
分享徽章
把这枚徽章粘进 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>