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 或幻方无官方从属关系。