DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

coldgust /

coldgust/dsh-proxy-manager

Verified

Manage proxy settings in DeepSeek Harness. A single settings page sets, inspects and clears the proxy configuration of the developer tools · 在 DeepSeek Harness 中管理代理设置:通过一个设置页面查看、配置与清除开发工具的代理

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@7bc4f252

English | 中文

dsh-proxy-manager

Set, inspect and clear the proxy configuration of the developer tools on this machine from one page in Settings → Proxy: 13 tools are built in, your own can be added, and one click enables or clears the proxy for all of them.

The Proxy page in Settings: the proxy address and bypass list at the top, then the searchable list of tools with their state, address and configuration file

What it does

  • One list, every tool. Each row shows whether the proxy is on, the address it uses, and the exact configuration file that holds it.
  • One click to enable or clear. Enable for all / Clear for all, or the switch on a single row. Files are edited in place: comments, ordering and unrelated keys survive.
  • Use the system proxy. Reads the proxy the operating system itself is set to and fills it in, including the bypass list.
  • Open the configuration file. Opens it in the default text editor; rows whose file does not exist yet are marked and cannot be opened.
  • Pin, search, page. Pinned tools stay on top, configured tools sort above unconfigured ones, missing files go last; search filters by name, id, path, category or address; 10 rows per page.
  • Extensible three ways. Add software from the page, add a built-in adapter in code, or register one from another plugin at runtime.
  • Available to the agent too. The proxy_manager tool reads the same state and performs the same actions as the page.

Install

  1. In Plugins, choose Add plugin, enter dsh-proxy-manager, and press Install — or run dsh plugin --profile <profile> add dsh-proxy-manager, where <profile> is the one you boot (for example web).
  2. Choose Enable now, or switch on the Proxy manager row.
  3. Restart DeepSeek Harness once — the Host module and the browser bundle are loaded with a new process. After that, toggling the row is enough to reload the plugin.
  4. Open Settings → Proxy.

To upgrade, reinstall: uninstall the row and add dsh-proxy-manager again (dsh plugin --profile <profile> add dsh-proxy-manager@latest).

Supported tools

Tool Configuration file Written keys
Git ~/.gitconfig [http] proxy, [https] proxy
npm ~/.npmrc proxy, https-proxy
pnpm ~/.npmrc (shared with npm) proxy, https-proxy
Yarn ~/.yarnrc.yml httpProxy, httpsProxy
Cargo ~/.cargo/config.toml [http] proxy
pip ~/Library/Application Support/pip/pip.conf (macOS), ~/.config/pip/pip.conf (Linux), %APPDATA%\pip\pip.ini (Windows) [global] proxy
Maven ~/.m2/settings.xml one <proxy> element (dsh-proxy-manager)
Gradle ~/.gradle/gradle.properties systemProp.http(s).proxyHost/proxyPort/nonProxyHosts
DeepSeek Harness $DSH_HOME/.env HTTP_PROXY, HTTPS_PROXY, NO_PROXY
Docker ~/.docker/config.json proxies.default.httpProxy/httpsProxy/noProxy
Shell environment ~/.zshrc / ~/.bashrc (Windows: PowerShell profile) HTTP_PROXY, HTTPS_PROXY, NO_PROXY
curl ~/.curlrc proxy, noproxy
wget ~/.wgetrc http_proxy, https_proxy, no_proxy

The shell entry covers every tool that only reads environment variables — Go, kubectl, Helm, Terraform, aws, uv, Poetry, Bundler, Homebrew.

Use it

  1. Open Settings → Proxy.
  2. Enter the proxy address (for example http://127.0.0.1:7890), or press Use system proxy to take the system value, and the bypass hosts.
  3. Press Save, then Enable for all — or flip the switch on the tools you want.
  4. Use Clear for all, or a single switch, to remove the proxy again.

Programs that are already running keep the proxy they read at start-up: restart the tool, or open a new terminal. DeepSeek Harness itself applies the change on its next start.

Add software

From the page. Open Add software at the bottom of the list and describe the tool: display name, file format, configuration file, section, key, and what that key holds (the whole URL, host, port or bypass list). The adapter is stored in this plugin's own state file.

In code. Add src/host/adapters/<tool>.ts:

import type { ToolSpec } from '../core/types.ts'

export const bun: ToolSpec = {
  id: 'bun',
  name: 'Bun',
  category: 'javascript',
  kind: 'toml',
  path: '~/.bunfig.toml',
  section: 'install',
  fields: [{ key: 'proxy', part: 'url' }],
}

then list it in builtinAdapters in src/host/adapters/index.ts. The page, the HTTP endpoint and the agent tool all read that one table.

From another plugin:

const dispose = ctx.proxyManager.registerTool({ id: 'my-tool', name: 'My tool', kind: 'json', path: '~/.my-tool/config.json', fields: [{ key: 'proxy.url', part: 'url' }] })

Adapter fields

Field Meaning
kind File dialect: ini ([section] + key = value), props (key=value), yaml (top-level key: value), toml ([table] + key = "value"), json (dotted path), env (KEY=VALUE), shell (managed export block), xml (managed <proxy> element)
path One path, a list of candidates (the first existing one wins), or a per-platform table; ~, $DSH_HOME and %APPDATA% expand
section Section or table name for ini / toml; a field may override it
fields[].key Key, dotted JSON path, or element name inside the managed block
fields[].part url (whole address), scheme / host / port (stored separately), noProxy
fields[].transform jvmNoProxy converts the bypass list to the JVM's `
binary Executable checked against PATH for the "not installed" hint

Agent tool

proxy_manager with action:

  • status — every tool, its proxy and its configuration file
  • enable — write the proxy (tools limits it to specific ids, proxy overrides the saved address for the call)
  • disable — remove it (optionally for tools)
  • system — what the operating system proxy is

Notes

  • Use system proxy reads the manual proxy of the OS (macOS scutil --proxy, Windows Internet Settings, GNOME gsettings). An automatic configuration script (PAC) or a TUN/VPN adapter exposes no fixed address, and the page says so instead of guessing.
  • pnpm and npm share ~/.npmrc, so enabling one shows both as enabled — that is the real state.
  • Windows and Linux paths, registry/GNOME detection and explorer/xdg-open are implemented and unit-tested, but only macOS has been run end to end.

Development

pnpm 12 is pinned in package.json (packageManager); pnpm-workspace.yaml allows the one build script development needs (esbuild).

pnpm install
pnpm typecheck
pnpm build     # lib/loader.js, lib/host.js, lib/client.js
pnpm test

pnpm build writes the committed lib/ artifacts; reload the plugin row (or restart once after installing) to load them.

License

MIT — see LICENSE.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit 7bc4f2529f46

Community comments

No comments yet. Be the first to write one.