前言¶

DeepSeek Harness（DSH）的 GUI 通常跑在开发机上。若 Mac 上跑着 DSH、Windows 上日常办公，你会反复遇到两类麻烦：Mac 侧 GUI 只能绑具体局域网 IP，不能绑 0.0.0.0，IP 一变服务可能起不来；DSH 每次重启都会换带 token 的登录 URL，在 Windows 浏览器里手输旧地址往往无效。单靠记 IP 或收藏书签，很难和 Mac 上的真实监听状态对齐。

下面介绍社区插件 dsh-mac-access（维护者 Yo1ick，分类：客户端）。它在 DSH 里注册 mac-access skill，并随包提供运维脚本，用来体检链路、把最新登录 URL 推到 Windows 可读的文件，以及部署 Windows 一键打开脚本与桌面快捷方式。链路设计是通用的：机器相关参数集中在 tools/config.local.env，而不是写死在某一台机器上。

这是什么¶

dsh-mac-access 是一个 Cordis 插件（版本 0.1.0，MIT 许可证，peer 依赖 @deepseek-ai/cordis ^4.0.1，Node >= 22.4.0）。核心做法是：在 DSH 会话里通过 skill 指导 agent 调用 tools/mac-access.sh，完成只读体检、立即推送 URL、或在 Windows 侧部署/修复 ps1、cmd 与桌面快捷方式。

官方仓库：https://github.com/Yo1ick/dsh-mac-access。社区目录页（与 DeepSeek / 幻方无官方从属关系）：https://www.skillhub.cn/plugins/Yo1ick/dsh-mac-access。

链路背景¶

理解插件前，先对齐 README 描述的默认链路：

1. Mac 上 DSH GUI 绑定具体局域网 IP（DSH 不接受 0.0.0.0 通配）。
2. Mac 侧 LaunchAgent（默认 label com.user.dsh-url-push）约每 60 秒把最新登录 URL 写到 Windows 侧约定路径的一个文件里。
3. Windows 双击桌面快捷方式「Mac DSH」，由 open-mac-dsh.ps1 读该文件并打开浏览器；因 token 随重启变化，应始终用脚本打开，不要手输旧地址。

跨机推送方向是 Mac→Windows。README 明确不建议依赖 Windows→Mac 的 sshd（若存在已知故障）。

核心功能¶

插件包内主要组成如下（均来自仓库 README）：

Agent 侧能力概括：

• 一键体检（check）：五项只读检查，不擅自改 DSH 配置、不重启 GUI、不删用户文件。
• 推送登录 URL（push）：立即把 Mac 上最新的带 token 登录 URL 推到 Windows 侧约定文件。
• Windows 部署（win-setup）：部署或修复 Windows 侧的 ps1、cmd 与桌面快捷方式。

安全红线：token 是登录凭证，输出一律脱敏（仅保留尾 4 位）。

安装与启用¶

仓库未提供 dsh plugin add github:... 一类命令；安装步骤以 README 为准。

1. 确认 cordis.patch.yml 中已有挂载条目（insert dsh-mac-access），toolsPath 默认使用随包路径。
2. 将本包加入 web profile 依赖（本地仓 link 或 file: 路径），重启 DSH GUI 使插件生效。
3. 复制配置模板并填写链路参数：

cp tools/config.example.env tools/config.local.env

按你的 Mac↔Windows 链路填写 README 所说的 5 个必填项（具体字段名以 tools/config.example.env 为准）。

安装前请自行阅读源码与 MIT 许可证；插件以当前 DSH 进程权限运行，跨机写文件与部署脚本会触及本机与对端路径，权限与路径需你自行核对。

典型用法¶

在会话里交给 agent¶

在 DSH 会话中可以用自然语言触发 skill，例如：

• 「检查 Windows 访问 Mac DSH 的链路」
• 「把最新地址推给 Windows」

agent 会加载 mac-access skill 并执行对应子命令。

手动执行脚本¶

也可在插件包的 tools 目录下直接调用：

bash tools/mac-access.sh check      # 五项体检，只读
bash tools/mac-access.sh push       # 立即推送最新登录 URL
bash tools/mac-access.sh win-setup  # 部署/修复 Windows 侧 ps1+cmd+桌面快捷方式

经过上面的步骤，Windows 侧应通过桌面快捷方式读推送文件打开浏览器，而不是缓存旧 URL。

适用场景与注意¶

适合谁：Mac 上跑 DSH GUI、Windows 上需要稳定打开最新登录页的开发环境；希望用周期推送 + 桌面一键脚本替代手抄 IP 和 token 的场景。

需要注意：

• Mac IP 变化时，需同时保证 GUI 绑定地址与 config.local.env 等配置一致，否则体检会暴露链路断裂点。
• 仅信任 Mac→Windows 推送方向；不要指望反向 SSH 作为备用通道（README 红线）。
• 社区目录 skillhub.cn 是独立生态站点，插件星标与维护节奏以 GitHub 为准（当前公开仓库星标为 0，不代表功能不可用，但需自行评估维护风险）。

结尾¶

dsh-mac-access 把「Mac DSH 监听在局域网、Windows 要打开最新 token URL」收成一条可体检、可推送、可一键打开的运维链路，并通过 DSH skill 让 agent 按规范调用随包脚本。若你要接入或二次开发，可从目录页与 GitHub 仓库对照 README、skill.md 与 tools/config.example.env 逐项核对。

• 目录页：https://www.skillhub.cn/plugins/Yo1ick/dsh-mac-access
• GitHub：https://github.com/Yo1ick/dsh-mac-access