前言¶
在 DeepSeek Harness（dsh）的 web profile 中，會話界面通常不會直接顯示後端服務是否仍然可用。手動刷新頁面可以判斷頁面能否打開，但如果想持續觀察 dsh web 服務狀態，額外發起一次模型請求並不合適，也會消耗 token。
dsh-alive 針對這個問題提供了一個常駐狀態點：它通過本地進程內 ping 判斷服務是否在線，不調用 LLM，也不消耗 token。下面介紹它的功能、安裝方式和使用注意點。
這是什麼¶
dsh-alive 是 AikenFra 維護的 dsh Web 界面插件，許可證爲 MIT。
它的作用是在 dsh web 會話頭部右上角顯示一個狀態點：
- 綠色：在線
- 紅色：離線
- 黃色：檢測中
當前 package.json 版本爲 0.1.1，要求 Node >=18，並測試於 dsh 0.1.0-rc.6 的 web profile。
核心功能¶
dsh-alive 提供的能力比較集中，主要圍繞“在線狀態可見”：
- 會話頭部右上角常駐狀態點，綠色 = 在線，紅色 = 離線，黃色 = 檢測中。
- 每 15 秒自動檢測一次，無需手動刷新。
- 零 token 消耗：純進程內 ping，不調用任何 LLM。
- 開箱即用，無需配置。
- 服務不可用時狀態點變紅，恢復後自動變回綠色。
工作原理¶
後端在 dsh 服務進程中註冊一個進程內 HTTP 端點：
GET /dsh-alive/ping
該端點直接應答，不經過任何模型。
前端通過 dsh 的 slot 系統注入組件，掛載位置爲：
conversation.session.header.utilities
前端每 15 秒輪詢一次上述 ping 端點，並根據響應更新狀態點。
安裝與啓用¶
先確認本機已安裝 DeepSeek Harness（dsh），並且準備在 web profile 下使用。
使用插件安裝命令¶
README 標註 dsh plugin --profile web add dsh-alive 適用於 npm 發佈後的安裝方式。執行後會安裝到 web profile：
dsh plugin --profile web add dsh-alive
安裝完成後重啓 dsh web 服務：
dsh web
重啓後打開瀏覽器頁面，並按 Ctrl+F5 強制刷新。會話頭部右上角應能看到狀態點。
本地或手動安裝¶
如果 npm 包發佈狀態尚未確認，可以使用本地方式安裝。
1、把本倉庫放到指定目錄：
~/.dsh/profiles/web/dsh-alive
2、在本地 profile 的 package.json 中添加依賴：
{
"dependencies": {
"dsh-alive": "file:./dsh-alive"
}
}
對應文件路徑：
~/.dsh/profiles/web/package.json
3、在 dsh profile 配置的 dsh.profile.bundles 列表中追加插件名：
"dsh-alive"
4、重啓 dsh web：
dsh web
5、打開頁面並硬刷新，例如按 Ctrl+F5。
卸載¶
使用插件命令卸載：
dsh plugin --profile web remove dsh-alive
卸載後重啓 dsh web：
dsh web
典型用法¶
適合在啓動 dsh web 後快速確認服務是否可用：
1、啓動 dsh web 服務：
dsh web
2、打開 dsh web 頁面。
3、查看會話頭部右上角的狀態點：
- 綠色表示在線。
- 紅色表示離線。
- 黃色表示正在檢測。
4、等待約 15 秒，狀態點會自動更新，不需要手動刷新。
如果服務恢復，狀態點會自動從紅色變回綠色。
適用場景與注意¶
適合以下場景：
- 使用 dsh 的
webprofile，希望在不消耗 token 的情況下觀察服務在線狀態。 - 本地調試 dsh web 時，需要快速發現服務是否掛掉。
- 頁面長時間打開，希望狀態點持續提示後端服務狀態。
需要注意以下幾點：
- dsh-alive 依賴 dsh 的 slot 系統
conversation.session.header.utilities與webServer服務注入，要求 dsh web 客戶端框架版本匹配。 - 安裝後必須重啓 dsh web 並硬刷新頁面，否則前端組件可能不會生效。
- 該插件會註冊進程內 HTTP 端點，並注入前端組件。安裝前建議檢查源碼、依賴和 MIT 許可證。本文資料未提供獨立權限模型說明，應以當前 dsh 進程權限爲界評估其運行影響。
dsh plugin --profile web add dsh-alive在資料中標註適用於 npm 發佈後；如果 npm 包發佈狀態未確認，優先使用本地或手動安裝方式。- 本文不引用星標數、分類或具體目錄頁地址，因爲這些信息未在已覈實資料中明確出現。
結尾¶
dsh-alive 的價值比較直接：用一次進程內心跳替代額外模型調用，在 dsh web 界面中常駐顯示在線狀態。當前可參考倉庫爲：
https://github.com/AikenFra/dsh-alive
目錄頁 URL 未在已覈實資料中確認，本文不提供具體目錄頁地址。
