Introduction¶
When developing or running agent services with DSH (DeepSeek Harness), if you use mihomo as a proxy, you usually need to monitor node latencies, running status, and the current selection. The dsh-proxy-panel plugin provides a proxy status panel on the DSH settings page and displays this information in real time by reading the local mihomo controller API.
Installation and Enablement¶
Add the plugin using the official install command:
dsh plugin --profile web add seconic037/dsh-proxy-panel
After installation, restart the web profile and refresh your browser. You can then see the “Proxy Status” option in the settings menu.
Core Features¶
The plugin provides the following read-only information:
* Running status: Shows whether the mihomo controller API is reachable.
* Listening port: Shows mihomo’s mixed-port (default 7890).
* Proxy groups and nodes: Shows the proxy group name (default Ghelper) and the currently selected node.
* Latency monitoring: The panel automatically refreshes latency every 5 seconds and supports clicking a button to test manually.
* Permission limits: Reads data only; it does not modify any mihomo or proxy configuration.
Configuration¶
The default configuration works out of the box. To modify the controller address or watch a different proxy group, override it in the profile’s cordis.patch.yml by id: proxy-panel:
- id: proxy-panel
config:
controller: http://127.0.0.1:54438
group: Ghelper
controller: Points to mihomo’sexternal-controlleraddress. Default is127.0.0.1:54438on localhost.group: Specifies the proxy group name to monitor. Default isGhelper.
Prerequisites¶
This plugin does not include subscription or node information; it only reads local mihomo status. Before use, enable the controller API in mihomo’s config.yaml:
external-controller: 127.0.0.1:54438
mixed-port: 7890
You also need to configure proxy-providers and proxy-groups (for example, using a group of url-test type). Subscription links contain private credentials; do not write them to public repositories.
Notes¶
The panel exposes read-only routes through the DSH host’s webServer. The only external dependency is the mihomo controller API (TCP 127.0.0.1:54438).
Uninstallation¶
dsh plugin --profile web remove dsh-proxy-panel