前言¶
在 DeepSeek Harness（DSH）裏寫代碼、和智能體對話時，往往希望「下一次禮拜什麼時候開始」能一眼看見，而不是切到手機 App 或單獨打開禮拜時刻網站。社區插件生態裏常見做法是外掛桌面小組件或瀏覽器標籤頁；dsh-salah 則把當日五番禮拜表、下一次禮拜倒計時和可拖拽懸浮條放進 Harness Web 界面，與側邊欄、對話區同屏使用。
下面介紹該插件的定位、能力與在本機從倉庫目錄安裝並確認設置的步驟。事實依據爲 GitHub 倉庫 README 與 package.json；插件以你當前 DSH 進程的權限運行，安裝前請自行審閱源碼與 MIT 許可證。
這是什麼¶
dsh-salah（包名 @local/dsh-salah，當前版本 1.2.0）由維護者 ienugr 發佈，是面向五番禮拜（Salah）時刻的 DSH 插件：可選 AlAdhan、MyQuran 或本機 Adhan 計算作爲時刻來源，支持瀏覽器定位、城市搜索或座標與時區，並在完成「審閱設置」後提供懸浮倒計時條與完整禮拜表頁面。倉庫面向 GitHub 本地 bundle 分發，未以 npm 公開發布；package.json 中 private 爲 true。
社區目錄頁：https://www.skillhub.cn/plugins/ienugr/dsh-salah。
源碼與文檔：https://github.com/ienugr/dsh-salah。
Skillhub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係；安裝方式以 README 爲準，不要憑插件名拼接 dsh plugin add github:owner/repo。
運行環境與依賴¶
README 聲明並已測試的運行時爲 DeepSeek Harness 0.2.1-rc.5（package.json 的 engines.dsh 一致）。其他 Harness 版本未經驗證，出現兼容性提示時不應未經覈對就忽略。
此外需要：
- Node.js 22.15 或更高 與 npm，用於安裝插件運行時依賴；
- 可使用的 Harness Web 界面（懸浮條留在 Harness 內，不是桌面總在最前窗口）；
- 在線時刻表與城市搜索需要 網絡；在已知位置與時區後，純本機 Adhan 計算可不請求禮拜時刻 API。
核心功能¶
倒計時與懸浮條¶
- 實時倒計時：顯示下一次禮拜及其計劃開始時刻，含跨日切換。
- 懸浮條（floating widget）：默認靠近界面右上方，切換 Harness 面板時仍可用；可拖拽標題欄移動，聚焦後可用方向鍵（按住 Shift 大步移動），可關閉後在「Prayer times」頁通過 Show floating widget 再顯示；Reset widget position 可重置位置。
- 對話區下方還有緊湊的禮拜/倒計時控件；頁腳形式如
Maghrib 1:12:47，工具提示與無障礙名稱含更完整的時刻與來源信息。
每日禮拜表¶
在 Prayer times 頁可查看當日五番、日出（參考時間，非禮拜）及次日安排。
三種時刻來源¶
| 來源 | 覆蓋 | 工作方式 |
|---|---|---|
| AlAdhan | 全球 | 按所選計算法與 Asr 約定拉取計算結果；返回的時區爲權威值。 |
| MyQuran | 印尼城市 | 拉取所選城市公佈時刻表；計算法與 Asr 由提供方決定。 |
| Adhan | 本機計算 | 在 Host 上按座標、時區、算法與 Asr 本地計算，不請求禮拜時刻 API。 |
默認公共端點無需 API Key；各提供方的可用性與配額由其自行規定。在線源失敗時，界面會標明是否正在使用本機計算結果。
位置與時區¶
- 當前位置：需在瀏覽器中授權；插件做一次性定位 fix，不持續跟蹤位移；頁面未關閉時若位置變化需再次選擇 Use current location。不會用 Host 服務器 IP 推斷位置。
- 城市搜索：需選對城市與國家（README 後續說明城市搜索可配置 Open-Meteo 等提供方）。
- 座標與時區：可手動輸入。
時刻表按所選位置的時區生成，並考慮夏令時。界面支持 英語與印尼語 文案，隨 Harness 當前語言環境切換（在對應語言可用時）。
審閱設置（1.2 重點）¶
在完成三項設置審閱確認並選擇 Confirm reviewed setup 之前，頁面爲帶標籤的預覽態；懸浮條與對話 dock 會提示完成設置，而不是展示未審閱的倒計時。需審閱的內容包括：時刻來源、位置/時區、計算方式；使用 MyQuran 時還需區分提供方時刻表與單獨的離線回退設置。
懸浮條會標明實際 schedule 來源、有意的離線計算與自動離線回退，以及拉取時間/新鮮度狀態；過期、失敗或未知時間戳等狀態會明確標識。
安裝與啓用¶
本倉庫 不 通過 git clone 以外的「一鍵商店命令」安裝；README 要求在本機擁有插件目錄後安裝依賴，再通過 Harness Plugin Manager 從 該目錄的絕對路徑 安裝 bundle。客戶端資源已包含在倉庫中，終端用戶無需自行構建 UI；本地目錄安裝會鏈接到該 checkout，插件存續期間請保持目錄可用。
- 獲取倉庫並在終端進入插件根目錄（clone 或下載均可，路徑以你機器爲準）。
- 安裝運行時依賴：
npm ci --omit=dev --ignore-scripts
- 在 Harness 中請智能體使用
plugin_manager、action: install_bundle，從你本機 checkout 的 絕對路徑 安裝。README 示例表述爲：
Install the Salah plugin from the absolute path to my local checkout using the Harness Plugin Manager.
請將「absolute path」替換爲你實際的插件目錄路徑。
- 按 Plugin Manager 提示刷新或重啓後，在側邊欄打開 Prayer times。
- 選擇禮拜時刻來源。若用當前位置，需顯式選擇 Use current location 以請求瀏覽器權限；或搜索城市，或輸入座標。MyQuran 必須從其目錄中選擇城市。
- 審閱界面上顯示的來源、位置/時區與方法（MyQuran 另審閱提供方時刻表與離線回退項）。
- 勾選全部三項審閱確認，選擇 Confirm reviewed setup。
典型用法¶
配置來源與位置¶
先做來源選擇（AlAdhan / MyQuran / Adhan），再定位置：瀏覽器定位、城市搜索或座標+時區。MyQuran 僅適用於其城市目錄內的印尼城市。
使用懸浮條與完整表¶
經過上面的審閱確認後，懸浮條顯示「當前禮拜」語義爲：最近一次已開始 的計劃禮拜時刻，不對禮拜窗口的法理有效性做裁定；日出與 Dhuhr 之間會顯示處於禮拜間隙，而非繼續把 Fajr 標爲當前。
需要完整信息時：點懸浮條打開按鈕，或使用對話區下方的緊湊控件，進入 Prayer times 全頁。
偏好與多會話¶
同一 Harness profile 下，來源、計算、地理編碼提供方與手動選擇的位置等偏好跨會話共享；懸浮條可見性、位置及審閱設置的 SHA-256 指紋保存在當前瀏覽器。修改相關偏好或重新打開設置審閱會使瀏覽器側確認失效，再次確認前會重讀共享偏好。
適用場景與注意¶
適合：已在 DSH 0.2.1-rc.5 上使用 Web 界面、希望在同一工作區內跟進五番禮拜時刻與倒計時的開發者或用戶；在印尼使用 MyQuran 官方城市表的場景也對應 README 設計。
注意：
- 插件邏輯與網絡請求在 當前 DSH Host/進程權限 下執行，安裝前請閱讀源碼、
PRIVACY.md與SECURITY.md。 - 截圖 README 中部分界面來自 1.1 預發佈，1.2 新增審閱設置、來源/新鮮度信息與城市搜索提供方控制，與舊圖可能不一致；圖中時刻僅爲示例，不代表你的地點與日期。
- 本倉庫未聲明經 npm 發佈；不要假設
npm install @local/dsh-salah可從公網 registry 獲得。
結尾¶
dsh-salah 把禮拜時刻來源選擇、時區感知的日程與可移動的倒計時條收進 Harness，用顯式「審閱設置」避免未確認配置就開始倒計時。若要查看簡介或鏈到源碼，可打開社區目錄 skillhub.cn/plugins/ienugr/dsh-salah 與 GitHub github.com/ienugr/dsh-salah。
