前言¶
DSH 通過插件擴展外部能力。若要把 Livis 的消息、文件上傳和結果回傳接入持久 DSH Agent，單獨處理授權、綁定、連接狀態和任務冪等會比較零散。fyy99/dsh-livis-connector 是一個原生 Cordis 插件，將 Livis 接入 DeepSeek Harness，授權、Agent ID 綁定引導與連接狀態都在 DSH 設置頁完成，運行時不依賴 OpenClaw。
這是什麼¶
fyy99/dsh-livis-connector 是 fyy99 維護的獨立社區連接器，許可證爲 MIT。它解決的問題是在 DSH Web 設置頁完成 Livis 賬號授權和連接管理，並把 Livis 消息交給持久 DSH Agent 後可靠回傳結果。
它不隸屬於或代表 DeepSeek、理想汽車或 Livis；相關名稱歸各自權利人所有。
核心能力¶
- 在 DSH 設置頁完成 Livis 賬號授權和連接管理
- 生成並展示 Agent ID，引導在 Livis App 中完成設置
- 將 Livis 消息交給持久 DSH Agent，並把結果可靠回傳
- 支持取消、結果確認、斷線重連和
job_id冪等 - 支持白名單文檔上傳，並限制在配置的目錄內
refresh token僅保存在 DSH Host，不會下發到瀏覽器頁面- 運行時不依賴 OpenClaw
環境要求¶
- Node.js：
^22.19.0 || >=24.0.0 - DeepSeek Harness：
0.1.0-rc.6 - DSH 仍處於 developer preview；本插件跟隨其插件 API 演進，升級 DSH 前請先檢查兼容性
安裝與啓用¶
下面介紹安裝和啓動 Web profile 的步驟。先安裝 GitHub 倉庫，再 dump 當前配置，最後啓動 Web profile。
1、使用 DSH 官方插件命令安裝 GitHub 倉庫：
dsh plugin --profile web add github:fyy99/dsh-livis-connector
2、安裝後執行配置 dump，確認插件配置已經進入當前 profile：
dsh --profile web --dump-config
3、啓動 Web profile：
dsh web
連接 Livis¶
連接流程如下：
1、打開 DSH，進入「設置 → 插件 → Livis」。
2、點擊「開始授權」，等待頁面顯示已連接到 DSH，並複製生成的 Agent ID。
3、在 Livis App「我的 → 連接與服務 → 我的 Agent」粘貼 Agent ID。
4、從 Livis App 發送一條測試消息，確認消息進入 DSH Agent 並能收到回傳。
授權中斷或過期時，回到同一頁面重新發起即可；插件不會在頁面加載時自動開始授權。
可復現部署¶
需要可復現部署時，把 GitHub 依賴固定到經過驗證的 commit SHA，而不是長期跟隨默認分支。
也可以先執行 npm pack 生成 tarball，再把 tarball 路徑交給同一個 dsh plugin --profile web add 命令：
npm pack
安全與注意¶
- 不要把 DSH Web 監聽到
0.0.0.0。管理 RPC 只允許 loopback，但 DSH Web 本身不提供用戶登錄認證。 - Livis relay 會處理賬號令牌、設備與 Agent ID、消息、回覆，以及用戶明確上傳的文件。
- 三個目錄字段必須使用絕對路徑。
- 生產端點強制
HTTPS/WSS；僅localhost測試允許明文協議。 - 遠端文本始終作爲普通用戶消息進入模型，不會作爲 DSH 斜槓命令執行。
- Livis Agent 的審批策略固定爲
never；需要本地批准的操作會失敗。 - 建議使用專用低權限 API Key，不要使用
danger-full-access，並讓 DSH 在無敏感數據的工作區運行。 - 插件會在當前
dsh進程權限下運行，安裝前應先檢查源碼與 MIT 許可證。 - 發現安全問題應通過倉庫 Security Advisories 私下報告，不要在公開 Issue 提交令牌、Agent ID、消息內容或本機路徑。
結尾¶
fyy99/dsh-livis-connector 的價值是把 Livis 授權、Agent ID 綁定、消息回傳和上傳限制放進 DSH 設置頁，減少外部連接的手工配置。它適合作爲 DSH Web profile 下的社區連接器使用，但需要保持版本兼容性和低權限運行邊界。
GitHub 倉庫：https://github.com/fyy99/dsh-livis-connector
目錄頁線索：https://www.skillhub.cn/plugins/fyy99/dsh-livis-connector（未在本材料中驗證，不作爲確定事實）
