DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

ds-hu /

ds-hu/dsh-personal-track

Verified

DeepSeek Harness(DSH)插件:右侧栏每日习惯看板 + 主区域统计页。

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@b2c20896

personal-track

license version tests DSH plugin platform

中文 · English

给 DeepSeek Harness 写的一个习惯看板:一个主面板, 左手边专注栏,中间当日打卡与统计;点开任务或影视书籍就是全屏的专注模式(笔记 + 素材)。界面跟随外壳语言(中文 / English),切换即时生效。

看板

打卡 统计
统计 专注

它管什么

分组 内容
日常 洗漱 ×2、洗澡、洗衣(存量 ±1 与「洗完」会话分开记)
饮食 早饭 / 午饭 / 晚饭:点一下盖时间戳,可改时间与价格
学习 背单词(按当日目标、加权进度,复习词按 1/5 计)、多邻国(任意节数)
健身 跑步(配速派生)、跳绳(次数自由、节奏派生)、引体向上、平板支撑、健身器材、自由锻炼
记录 影视书籍(三态 + 评分)、任务(进度 → 三态 + 逾期,可拖进度条,带检查点)

完成条是分数的,不是复选框:九个习惯格之外,当日到期的任务各占一格,所以读数是 5.3/10 这样的小数; 每格按自己的分数渐变填绿,悬停给出百分比。「健身」是存在格——任一训练有记录就填满,所以休息日读 8/9。

专注模式是整屏的不透明工作面:左侧名称/截止/累计专注/笔记,右上一条细工具条(进度条可拖、可 ±、 检查点可点),右下是素材流(Markdown 文本块 + 图片,粘贴或拖入即加)。进即开始一段专注会话,出即结束; 时长只由起止时刻派生,崩掉的未闭合会话不计。

专注栏是派生的:显示全部条目里已闭合会话中开始最晚的那一段,不存、不记浏览器本地, 所以刷新、换标签页、删掉条目之后它都与历史一致;它也没有 ×——换一张的办法是去专注别的条目。

复制纯文本报告把正在看的一天折成几行贴得进聊天:完成度、每组习惯一行,末尾是任务列表 (全部未完成 + 当日及以后截止的已完成,每条都写截止日 M-D,逾期注明,已完成行末 ✓)。

安装

推荐用法:fork 一份,让 DSH 自己改,再 link: 装上。

每个人的习惯表都不一样,而这个插件的「可配置面」是故意小的:四个字段走 Config,其余全在代码里。 把习惯、分组、统计卡做成界面上的枚举开关,只会让界面越来越杂,而且永远列不全——八个计数器、 五种会话、谁和谁合成一格,都是会变的判断。在 DSH 里改自己 fork 的那份比加开关便宜: 让 agent 先读 AGENTS.md 与 CONTEXT.md,它就照本仓库自己的规矩改, 改完跑一遍 pnpm test 就知道有没有把别处弄坏。所以不要原样装上再找「配置习惯」的开关(没有)—— fork 之后改成自己的作息,用下面的方式 A 装上。

# A —— 本机(推荐):link 不打包、不触发 pnpm 的构建审批;装完重启 dsh --profile web
dsh plugin --profile web add link:D:/Projects/dsh-personal-track
dsh --profile web --dump-config        # 应出现 "# == @ds-hu/personal-track" 层

# B —— 从 GitHub 装:仓库只有源码,lib/ 由 prepare 在安装时现场构建
dsh plugin --profile web add github:ds-hu/dsh-personal-track
# pnpm 11 默认拦下依赖的构建脚本,首次会以 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 失败,
# 并打印精确键(含 tarball 与 commit sha)。原样抄进 profile 的 pnpm-workspace.yaml:
#   allowBuilds:
#     @ds-hu/personal-track@https://codeload.github.com/ds-hu/dsh-personal-track/tar.gz/<sha>: true
# 再跑一次同样的 add 即可。键里带 sha,仓库每推一个新提交就要重新批准一次。

# C —— 临时试用,不安装
dsh --profile web --patch D:/Projects/dsh-personal-track/dev.patch.yml

只有四个字段走配置(写在 cordis.yml,不改代码就能调):

字段 默认 作用
dayStartHour 4 习惯日起点;00:00–04:00 归前一晚
timezone 本机时区 固定时区覆盖
defaultVocabTarget { new: 20, review: 60 } 无历史目标可继承时的背单词目标
defaultRunMinutes 30 新跑步记录的默认时长

其余都在源码里:改哪一种格怎么算达成改 src/host/derive.ts,改卡片与分组改 src/client/board/BoardBody.tsx,改文案改 src/client/copy/table.ts。 逐条清单见 CONTEXT.md 的习惯清单与 AGENTS.md。

数据

~/.dsh/storages/habit/,人类可读的 JSON,per-record 布局: days/<日期>.json(一个习惯日)、counters/laundry.json(待洗存量)、 media/<id>.json、tasks/<id>.json(登记条目)、assets/<id>.json(素材图片字节)。 空白天不产生文档;只存事实,格数、比率、连续、逾期、专注时长都是读的时候派生的。

备份:统计视图的「导出」得到 personal-track-<日期>.json(格式 personal-track/backup,版本 3), 只含事实——导入后重算一切派生值,所以文件里不可能出现与数据矛盾的字段。v1 / v2 仍可导入;反向不行 (旧的构建会整份拒绝它不认识的版本)。「选择备份…」只解析并显示条数,此时还没写入;随后选合并 (同键覆盖)或覆盖(额外删掉文件里没有的本地记录),整份先按同一套 schema 校验,任何一条不合法即整份拒绝。

开发

pnpm install     # 装依赖;prepare 顺带 build
pnpm build       # lib/index.js(宿主)+ lib/client.js(浏览器闭包工厂)
pnpm test        # 逐文件跑 tests/*.test.ts
pnpm typecheck   # 宿主 / 浏览器 / 测试三个独立程序
pnpm verify      # 构建 + 客户端 facade + 宿主真实栈端到端

改完动过宿主半身要重启 dsh --profile web,只动客户端 bundle 是热重载。规则、坑与验证口径在 AGENTS.md,领域术语在 CONTEXT.md,设计背景在 docs/adr/,版本变化在 CHANGELOG.md。

结构

src/shared/   两半身共用的纯规则:路由声明、习惯日算术、专注会话、跳绳合并
src/host/     zod 域 + 派生 + 存储访问 + 路由 + 统计聚合 + 备份读写
src/client/   api(命令面)· copy/(全部界面文字)· board/(看板、统计、专注、素材)
              styles.ts(注入式样式表)· index.tsx(唯一主面板 + 侧栏入口)
scripts/      build.mjs · run-tests.mjs · verify-client.mjs · verify-host.mjs
tests/        规则层(进程内、无端口、无磁盘);接线与持久化在 scripts/verify-*.mjs
docs/adr/     0001 树外传输 · 0002 状态派生不落库 · 0003 图片存域内 base64 · 0005 共享习惯日

图标 icon.svg(完成度环),Plugins 面板的标题与一句话说明来自 locale/{zh,en}.json。

—/ 5

No ratings yet

Verified DSH bundle

Commit b2c208963d29

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout