前言¶

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