dsh-plugin-auto-proxy

安装和使用

推荐在 DSH 插件管理页面通过“本地安装包”入口（如果该版本提供）选择 dsh-plugin-auto-proxy-1.0.5.tgz。源码 checkout 生成的包位于 downloads/；下载 Release 附件后使用实际保存位置。

对于使用 CLI 管理的部署，在安装包所在目录执行（将 web 换为实际 profile）：

dsh plugin --profile web add ./dsh-plugin-auto-proxy-1.0.5.tgz --ignore-scripts

官方桌面版的 profile 由应用管理，请优先使用应用内安装入口。安装命令只用于登记插件，不是日后启动 DSH 的入口。安装新插件是否需要宿主重新加载由 DSH 管理器决定；插件加载后，开关和代理切换不需要重启 DSH。

功能入口与多端协同

插件支持以下多种便捷入口，所有入口通过内部 ProxyStateHub 全局单例总线保持实时状态同步，在任意位置操作均可即时反映到全界面：

1. 右侧边栏（Right Sidebar）：
   • 在安装了 dsh-better-sidebar 的环境中，点击右侧标签栏上的“🌐 自动代理”图标，即可展开完整的功能控制台与网络拓扑。
   • 在未安装 BetterSidebar 的原生 DSH 环境中，同样提供原生侧栏选项卡支持。
2. 下侧边栏与底部工作台（Bottom Workbench）：
   • BetterSidebar 的底部面板原生支持直接打开或将“自动代理”页签停靠在底部工作台，与右侧栏保持完全一致的功能与设置。
3. 对话框底部环境胶囊（Composer Dock）：
   • 对话输入框正下方常驻显示紧凑的代理状态胶囊（例如 [ 🌐 自动代理: 127.0.0.1:7897 ● 已连接 ]）。
   • 点击胶囊即可一键切换启停代理，无需离开对话界面。
4. 插件管理设置页面（Plugins Config）：
   • 在 DSH 插件管理中找到 dsh-plugin-auto-proxy，展开配置卡片，提供完整的美化配置界面。

快速开始

1. 正常启动代理软件和 DSH。
2. 在任意入口（右侧边栏、下侧工作台、底部胶囊或插件设置卡片）开启“自动代理”。
3. 状态自动同步并显示“已连接”，拓扑图直观展示 DSH 入口 ➔ 本机代理 ➔ 外部网络 的链路连通情况。
4. 如需指定特定端口，可在设置区域填入手动地址（例如 http://127.0.0.1:7897），点击保存即可立即生效。

关闭“开启自动代理”并保存，会恢复插件开启前 DSH 的代理策略。卸载也会清理入口及恢复策略。卸载操作交由 DSH 原生插件管理器处理。