前言¶
在 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。
