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
