前言¶
在 DeepSeek Harness（DSH）裏做本地智能體時，校園網認證往往卡在「能不能上網」這一步：網關可能對任意 HTTP 請求回登錄頁，單純看 200 並不等於已出網；休眠、重啓或門戶超時後又要重新登錄，而 DSH 沒關時插件還能跑，DSH 一關進程就沒了。手工連 Wi-Fi、打開瀏覽器填門戶，和讓模型通過 tool 查狀態、一鍵登錄，是兩套路。
下面介紹社區插件 dsh-campus-net（維護者 GUANUI，SkillHub 分類 admin-security）：在 DSH 裏提供四個 tool，外加本機設置頁與可選後臺守護進程，用於檢查在線狀態、按需登錄，並在 Windows 上支持憑據加密落盤與開機自啓。內置 南京審計大學（NAU） 預設，也可選可配置的 JSON 門戶模式；不實現 Srun（深瀾）或 Dr.COM 協議。
這是什麼¶
dsh-campus-net 是面向 DSH >= 0.2.0-rc.1 < 0.3.0 的校園網自動登錄插件（package 版本 0.1.0，MIT）。賬號密碼與配置保存在本機，無遙測、無第三方上報；插件與守護進程在當前用戶與 DSH 進程權限下運行，安裝前建議在 GitHub 閱讀源碼與許可證。
核心功能¶
資料中明確列出的能力如下。
- 狀態一覽：在線/離線、Wi-Fi SSID、守護進程狀態、最近一次操作與錯誤；
campus_net_status支持quick: true僅讀緩存。 - 按需登錄：一次 tool 調用完成認證，磁盤上加密保存憑據；密碼錯誤不會重試，避免部分門戶因多次失敗鎖號。
- 本機設置頁：掃描並勾選校園 Wi-Fi、填寫賬號密碼與門戶地址、檢查間隔、自啓等；綁定
127.0.0.1，每次運行帶 token。首次加載會打開五步用戶指南（可通過autoOpenGuide: false關閉）。 - 可選後臺守護進程：獨立 Node 進程，不隨 DSH 子進程退出；
install可在 Windows 註冊隱藏 Startup 項，休眠/重啓/門戶超時後嘗試重連。 - NAU 預設與 JSON 門戶：NAU 門戶與 Wi-Fi 字段預填；其他與 NAU 類似的 JSON HTTP 門戶（含
reply_code及getinfo/login/logout/challenge）可在設置裏選 Custom JSON portal 調整。
在線判定：僅探測 URL 返回 HTTP 204 視爲在線；返回 200（常見爲登錄頁）刻意視爲離線。
環境與限制¶
- DSH：
>= 0.2.0-rc.1 < 0.3.0 - Node.js：20+（DSH 自帶捆綁亦可）
- Windows 10/11：完整能力（DPAPI 憑據、
netsh切 Wi-Fi、Startup 自啓）。macOS/Linux 下門戶登錄與守護進程可用，自動切 Wi-Fi 跳過，自啓需手動配置。
安裝與啓用¶
在 DSH 插件市場搜索 dsh-campus-net 安裝即可。
若從本地目錄手動安裝，README 給出的命令爲：
dsh plugin add link:/absolute/path/to/dsh-campus-net
安裝後若四個 tool 未立即出現，重啓 DSH。
社區目錄頁：dsh-campus-net（SkillHub）。源碼與文檔：GUANUI/dsh-campus-net（SkillHub 爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）。
典型配置與用法¶
1. 打開設置頁¶
讓 DSH 執行 campus_net_setup，返回形如 http://127.0.0.1:<port>/?token=… 的 URL。該鏈接僅在插件進程存活時有效；重啓 DSH 後需再次執行 campus_net_setup。
2. 嚮導中的五步¶
- 在 Campus Wi-Fi 點 Scan nearby Wi-Fi 並勾選校園網（NAU 免費網爲
i-NAU、i-NAU-Lib；chinanet/cmcc/unicom爲運營商付費網，不會自動連接）。 - 填寫校園賬號與密碼，Save。
- Login now 驗證。
- 需要掉線後仍自動維持時，點 Enable autostart，或執行
campus_net_daemon { "action": "install" }。
亦可隨時運行 campus_net_setup，在設置頁頂部打開 User guide。
3. 四個 tool¶
| Tool | 作用 |
|---|---|
campus_net_status |
在線狀態、SSID、守護進程、最近錯誤 |
campus_net_login |
立即登錄；優先嚐試已配置 Wi-Fi |
campus_net_setup |
啓動本機設置頁並返回帶 token 的 URL |
campus_net_daemon |
status / start / stop / install / uninstall / logs |
4. NAU 預設字段（摘錄）¶
| 字段 | 值 |
|---|---|
| Portal | http://login.nau.edu.cn |
| Login API | /api/portal/v1/login |
| Success | reply_code === 0 |
| Wi-Fi | i-NAU（備選 i-NAU-Lib） |
| Online probe | http://connect.rom.miui.com/generate_204 → HTTP 204 |
賬號爲學生學號；該門戶不接受手機號登錄。
適用場景與注意¶
適合：在 DSH 智能體工作流裏需要可重複的「是否出網 → 必要時認證」、希望憑據與配置留在本機、且門戶形態接近 NAU 式 JSON HTTP 的用戶（尤其 Windows 校園環境）。
務必注意：
- 插件不以系統服務運行；敏感操作依賴本機 DPAPI/AES 與
127.0.0.1設置頁 token，使用前請自行評估環境與門戶政策。 - Windows 掃描 Wi-Fi 需開啓位置服務與桌面應用位置權限；也可手填 SSID，無權限時登錄仍可進行。
- 全局代理或遊戲加速器可能導致門戶報
請重新獲取地址!；登錄前應退出或給門戶 IP 配直連路由。 - DSH 關閉後僅插件本身無法維持網絡；需安裝守護進程才能在 DSH 退出後繼續保活。
- 卸載順序：
campus_net_daemon { "action": "uninstall" }→ 在 DSH 移除插件 → 可選刪除%LOCALAPPDATA%\dsh-campus-net。
數據目錄（Windows 默認 %LOCALAPPDATA%\dsh-campus-net\）含 config.json、cred.dat、campus-net.log、state.json；可通過環境變量 DSH_CAMPUS_NET_HOME 更換根路徑。
結尾¶
dsh-campus-net 把校園網「204 纔算在線」的探測、按需登錄與可選守護進程封裝成 DSH tool，並用本機設置頁完成首次配置；NAU 用戶可直接用預設，其他類似 JSON 門戶可走自定義模式。進一步說明見 GitHub README，安裝入口見 SkillHub 目錄頁。
