DeepSeek Harness 插件：dsh-clock

前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在開發或使用過程中，有時需要常駐查看當前時間。dsh-clock 是一個客戶端插件，它在聊天界面的底部狀態欄（composer dock）常駐顯示當前日期與時間，並提供可視化配置入口。

核心功能¶

• 常駐顯示：在底部狀態欄顯示當前日期與時間，默認每秒刷新。
• 可視化配置：提供設置面板，可直接點選或撥動控件進行配置。
• 顯示內容配置：支持“日期+時間”、“僅日期”、“僅時間”三種模式。
• 細節配置：可控制是否顯示星期幾、是否顯示秒。
• 刷新間隔：支持自定義刷新頻率，範圍 250–60000ms。
• 持久化：配置持久化到當前 profile 的 Cordis patch (cordis.patch.yml)。
• 命令行支持：支持通過配置文件預設默認值。

安裝與啓用¶

前提條件：將插件作爲依賴安裝後，必須將其添加到 profile 的 dsh.profile.bundles 中，否則不會加載。

桌面端：通過設置 → 插件進行安裝或啓用。

命令行安裝（以下任選其一）：

dsh plugin --profile <name> add github:DeepCodec/dsh-clock
dsh plugin --profile <name> add https://github.com/DeepCodec/dsh-clock.git
dsh plugin --profile <name> add /path/to/dsh-clock
dsh plugin --profile <name> add @deepcodec/dsh-clock

生效：安裝後必須重啓 DSH Desktop。

配置方式¶

可視化配置：打開設置 → 通用 → 時鐘，直接點選/撥動即可，改動即時生效。

配置文件配置：在 profile 的 cordis.patch.yml 中預設默認值。配置項說明如下：
- mode：顯示內容，可選 date（僅日期）、time（僅時間）、dateTime（日期+時間）。
- weekday：日期行是否含星期幾，布爾值。
- showSeconds：時間是否顯示秒，布爾值。
- intervalMs：刷新間隔，數值，範圍 250–60000ms。

示例配置：

- id: dsh-clock
  name: dsh-clock
  config:
    mode: dateTime
    weekday: true
    showSeconds: true
    intervalMs: 1000

注意事項¶

• 命名空間：插件的設置命名空間等於 profile entry id（即 dsh-clock），配置讀寫均基於此 key。
• 重啓生效：修改配置或安裝插件後，需重啓 DSH Desktop 才能生效。
• 生態說明：DSH 插件目錄與 DeepSeek 或幻方無官方從屬關係。