状态栏时钟 DeepCodec/dsh-clock

dsh-clock

DSH（DeepSeek Harness）Web 插件：在底部状态栏（composer dock）常驻显示当前日期与时间，提供可视化配置。

效果

聊天界面底部状态条（输入框下方，系统「上下文用量」旁边）显示：

2026年10月12日 星期一 · 15:21:08

默认每秒刷新，纯浏览器本地 Date 渲染。

可视化配置（推荐）

打开 设置 → 通用 → 时钟，直接点选/拨动即可，改动即时生效并持久化到当前 profile 的 Cordis patch（cordis.patch.yml 中 dsh-clock 行的 config）：

| 设置项 | 控件 | 说明 |
| 显示内容 | 下拉菜单 | 日期 + 时间 / 仅日期 / 仅时间 |
| 显示星期几 | 开关 | 日期行是否含星期几 |
| 显示秒 | 开关 | 时间是否显示秒 |
| 刷新间隔（毫秒） | 数字输入 | 250–60000ms |

命令行配置（可选）

同样可在 profile 的 cordis.patch.yml 中预设默认值（就是可视化设置写入的同一层）：

- id: dsh-clock
name: dsh-clock
config:
mode: dateTime # date | time | dateTime
weekday: true # 日期行是否含星期几 showSeconds: true # 时间是否显示秒 intervalMs: 1000 # 刷新间隔（250–60000ms）

解析顺序（dsh-settings）：schema 默认值 → 继承的 composition 层 → 该 profile entry 的 config（用户设置写入的层）。

命名空间 = profile entry id：dsh-settings 以 cordis.patch.yml 中该行的 id 为 key，因此 dsh-clock 既是设置命名空间，也是 cordis.patch.yml 里那一行的 id；浏览器半用同一个 key 走 ctx.configForms.get('dsh-clock')。

实现

| 部分 | 文件 | 作用 |
| 浏览器半 | src/client/index.jsx → lib/client.js | Clock 组件（dock 槽位）+ 设置行（settings.general.item） |
| 设置策略 | src/client/clock-policy.js | ClockPolicy：configForms 读写、clamp、host 采纳、dispose |
| 设置行组件 | src/client/ClockSettingsRow.jsx | 设置 → 通用 里的可视化配置行 |
| 共享设置定义 | src/client/clock-settings.js | 命名空间、字段键、默认值（纯数据） |
| 格式化 | src/client/clock-core.js | 日期/时间本地化格式化（纯函数） |
| 样式 | src/client/styles.js + .css | --dsw- token，data-plugin-css 协议注入 |
| 宿主半 | src/index.ts → lib/index.js | volatile Config + settings.configure({ auto: false }) |
| 构建 | build.mjs | esbuild 双半构建（baseline external） |
| 测试 | test/.spec.mjs | 浏览器注册/策略/格式 + 宿主 schema/注册 + 主题 token 校验（14 项） |

规范符合性（对照 packages/client/AGENTS.md）

- Slot 纪律：dock 槽位 + settings.general.item 槽位，组件经标准 props shares + inject 面拿数据，组件不见 ctx。
- 本地化：文案全部走 zh/en 字典 + t seat（含设置面文案），无硬编码产品文案。
- 样式：CSS 语义类 + --dsw- token，无内联样式/无字面色值；data-plugin-css 幂等注入（HMR claimStyles 协议）。
- 导出纪律：浏览器半只导出 apply/inject；宿主半导出 name/Config/SETTINGS_NAMESPACE/apply。
- 可视化设置：官方 settings 命名空间 = profile entry id；宿主导出 .volatile() Config 并经
settings.configure({ auto: false }) 发布（自绘设置行，不自动生成页面），浏览器半经
ctx.configForms.get('dsh-clock') 读写（与 dsh-client-locale、dsh-client-ui-conversation 同款范式）。
- inject 纪律：inject 只声明运行时真实存在的服务（slots / locale / configForms）。
cordis fiber 会一直 pending 在一个不存在的服务上，而 web boot 审计会把 pending 当作启动失败，直接让整个 Web 页面引导失败——settingsScope 正是这个坑（DSH 里没有这个服务）。
- 依赖声明：peerDependencies 只声明实际使用；浏览器 baseline 模块（dsh-client-store 等）external 由模块表提供。
- 容错：浏览器半 apply 全程 try/catch；host 半嵌套 inject，无 settings provider 也照常激活。

开发

pnpm install # autoInstallPeers=false
pnpm build # 生成 lib/client.js + lib/index.js
pnpm test # 构建 + 33 项测试

安装

装成依赖还不够：插件半必须在 profile 的 dsh.profile.bundles 里才会加载（bundle 列表决定 cordis.patch.yml 里的 insert 是否生效）。

- 桌面端（Desktop）：走 设置 → 插件（插件市场）安装/启用；desktop profile 由 Electron 应用独占管理，命令行 dsh --profile desktop 会被拒绝。
- 其他 profile：

从 GitHub 安装（推荐，全路径）：

dsh plugin --profile <name> add github:DeepCodec/dsh-clock

或指定 GitHub 仓库完整地址：

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

本地开发调试（检出到本机后的绝对路径）：

dsh plugin --profile <name> add /path/to/dsh-clock

发布到 npm 后（直接按包名安装）：

dsh plugin --profile <name> add @deepcodec/dsh-clock

（或手动 cd ~/.dsh/profiles/<name> && pnpm add @deepcodec/dsh-clock，
并在 package.json 的 dsh.profile.bundles 里追加 @deepcodec/dsh-clock。）
重启 DSH Desktop 生效。

卸载

dsh plugin --profile <name> remove dsh-clock