dsh-daily-progress
Author / Maintainer: @Zacklinkk
每日进度成就系统（DSH Web 插件，双半架构）：
- host 半（
src/ → lib/index.js）：daily_progress 存储域（每日计划持久化于宿主 storage-domain 的 json 后端）+ 完成率 / streak / 周率指标 + 自有 HTTP 路由（/daily-progress/state、/daily-progress/mutate，loopback-only）。
- client 半（P1 起，
src/client/ → lib/client.js）：conversation.input.dock 温度计 widget + 两栏计划面板（Modal）+ 21:00 浏览器提醒。
已确认口径
- 存储：storage-domain + json 后端（记录键
<scope>:<date>，V1 scope=default，按用户隔离预留）。
- streak：达成日 = 当日有 ≥1 条计划且完成率 100%；今天未达成不中断历史 streak（只暂停累计）。
- 周完成率：本周（周一为起点）截至今天的条目 done/total；未来日不参与。
- 日期一律是用户的本地日历日（YYYY-MM-DD 字符串，由 client 随请求携带）；历史日锁定只读；跨日惰性 rollover（昨天未完成项自动 carry，
clearToday 后不重携）。
开发
npm install
npm run typecheck # tsc --noEmit
npm test # node:test 单测（metrics/calendar）
npm run build # tsc 产出 lib/
npm run probe # 活体验证：真实 @deepseek-ai 运行时包 + json 后端全链路
probe 依赖本机 DSH 运行时包解析：把 node_modules/@deepseek-ai/ 下三个包软链到
${DSH_PROFILE:-~/.dsh/profiles}/node_modules/@deepseek-ai/{dsh-storage,dsh-storage-json,dsh-storage-domain}。
生产环境由宿主组合在运行时解析这些包，无需随包发布。
安装（DSH profile）
- 在 profile 的
package.json dependencies 加入本包（或 dsh plugin install 渠道）；
- profile 的
cordis.patch.yml 加一行 { id: daily-progress, name: dsh-daily-progress }（本包 dsh.bundle.patch 指向的 cordis.patch.yml 已含此 insert）；
- 重启 DSH Web；client 半由
dsh.client manifest 自动装配。
路由契约（host）
GET /daily-progress/state?localDate=YYYY-MM-DD&tz=IANA → SnapshotPOST /daily-progress/mutate {localDate, tz, op, payload} → {ok:true, snapshot} | {ok:false, code, message}
- ops：
toggleItem{itemId}（仅当天）、addItem{target:'today'|'tomorrow', text}、removeItem、editItemText、setTomorrow{items}、clearToday
- 所有路由仅接受 loopback Host；写操作落盘后广播
domain/changed（进程内）。
已知边界
- 「今天」以 client 上报的
localDate 为准（host 不知道用户时区）；单机个人工具语义下可接受，防回溯/防篡改不在威胁模型内。
- 数据通道为插件自有同源路由 + 轮询/乐观更新（外部插件无法扩展核心
/api RPC 表或转发事件 allowlist）。
