前言¶
在 DeepSeek Harness（DSH）里做日常开发或对话时，习惯、任务和零碎记录往往散落在笔记或聊天里，事后很难按「习惯日」对齐、补卡或拉出连续天数。通用待办工具也很少按洗漱次数、三餐花费、背单词加权进度这类细粒度规则去算「今天完成了多少」。
personal-track 是维护者 ds-hu 发布的 DSH 插件（社区目录分类为「趣味换装」）。它把习惯看板放进 DSH Web 壳：左侧栏进入主面板，在「打卡」与「统计」两个视图之间切换；数据落在本机 JSON 域，不依赖外部服务。下面介绍它做什么、怎么装、以及 fork 改清单时要注意什么。
这是什么¶
- 定位：DSH 插件，主面板为「习惯看板」，含打卡视图（专注栏 + 当日看板）、统计视图，以及任务/影视书籍的专注模式（全屏 + 笔记 + 长图素材）。
- 维护者与来源：SkillHub 目录页、GitHub：ds-hu/dsh-personal-track。
- 当前包信息（以仓库
package.json为准）：包名personal-track，版本0.2.0，许可证 MIT；peerDependencies要求@deepseek-ai/cordis^4.0.2。
README 明确说明：这是作者自用取向的插件，习惯清单在 v1 中硬编码，没有「配置习惯」开关；若要贴合自己的作息，更稳妥的路径是 fork 后改源码再构建。
核心功能¶
打卡看板¶
看板按分组列出习惯与登记项，顶部有完成度环 + 完成条。完成条是分数制（例如 5.3/9）：8 个固定习惯格（洗漱 ×2、洗澡、三餐、背单词、多邻国）之外，当日到期的任务各占一格；背单词格按加权目标进度填格，任务格按 当前/目标量 填格。
| 分组 | 习惯 | 形态与交互（摘要） |
|---|---|---|
| 日常 | 洗漱、洗澡、洗衣 | 打卡槽位；洗衣为存量 + 洗涤会话 |
| 饮食 | 早/午/晚饭 | 紧凑三行，＋ 盖时间戳，可改时间与价格 |
| 学习 | 背单词、多邻国 | 背单词按当日新词/复习目标计进度（复习词按新词 1/5 加权）；多邻国记节数 |
| 健身 | 跑步、跳绳、引体、器材 | 跑步每日至多一次并派生配速；跳绳 90/180 定数等 |
| 记录 | 影视书籍、任务作业 | 跨日登记；点击标题或 ⤢ 进入专注模式 |
可切换到任意历史日补卡（不能进入未来；凌晨时段可标注为「周X夜」）。看板底部支持复制纯文本报告（完成度、各组习惯一行，末尾为剩余任务的 Markdown 列表），优先剪贴板 API，不可用时用隐藏文本域兜底。
专注栏常驻打卡视图左侧：有置顶条目时显示卡片与「继续专注」；无置顶时显示时钟与当日摘要。置顶仅存浏览器本地；置顶任务完成后自动撤下（正在专注的会话除外，退出专注时再撤）。窄屏（≤720px）不显示专注栏，专注仍可从看板条目进入。
专注模式¶
点任务或影视书籍标题（或右侧 ⤢）进入全屏工作面：左侧为名称、学科、截止、专注时长与笔记；右上为工具条（进度、检查点、全屏/退出）；右下为素材流（Markdown 文本块 + 图片，可粘贴或拖入，单张上限 10 MB）。进入即开始专注会话，退出即结束；时长由起止时刻派生，未闭合的崩溃会话不计入统计。
统计与数据¶
统计视图可按近 7 天、本月、近 30/90 天或自定义范围查看：习惯×日期热力图、达标与连续天数、求和指标、三餐花费、心率-配速曲线、登记项累计专注等。
统计页底部数据卡片支持：导出整域 JSON 备份、选择文件后合并或覆盖导入，以及清理未引用图片。磁盘布局在 ~/.dsh/storages/habit/（per-record JSON；图片以 base64 存于 assets/）。空白天不产生文档。
领域语言与架构决策见仓库内 CONTEXT.md、docs/adr/；变更见 CHANGELOG.md。
安装与启用¶
插件以当前 dsh 进程权限运行，安装前请自行审阅源码与 MIT 许可证。以下命令均摘自仓库 README。
方式 A — 本机开发（推荐，link）：
dsh plugin --profile web add link:D:/Projects/dsh-personal-track
dsh --profile web --dump-config # 应出现 "# == personal-track" 层
# 然后重启：dsh --profile web
将 link: 后的路径换成你本机 clone/fork 后的目录。
方式 B — 从 GitHub 安装（README 示例仓库为 cup113/personal-track）：
dsh plugin --profile web add github:cup113/personal-track
README 说明：仓库仅含源码，lib/ 由 prepare 在安装时构建；若遇 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，需把打印出的精确 allowBuilds 键写入 profile 的 pnpm-workspace.yaml 后重试。若你使用 ds-hu/dsh-personal-track fork，安装键与 allowBuilds 规则需按实际 tarball URL 调整，README 未给出 github:ds-hu/dsh-personal-track 一行，请勿凭包名拼接。
临时试用（patch，不安装）：
dsh --profile web --patch D:/Projects/dsh-personal-track/dev.patch.yml
--patch 必须写在 web 之前。name 为包名 personal-track，id 须与宿主半身导出的 name 一致。
不改代码即可调的配置（cordis.yml）：
| 字段 | 默认 | 作用 |
|---|---|---|
dayStartHour |
4 |
习惯日起点；00:00–04:00 归前一晚 |
timezone |
本机时区 | 固定时区覆盖 |
defaultVocabTarget |
{ new: 20, review: 60 } |
无历史快照时的背单词目标 |
defaultRunMinutes |
30 |
新跑步记录默认时长 |
修改习惯清单、格规则、看板布局等需改 src/host/derive.ts、src/client/board/ 等文件后 pnpm build；动过宿主半身需重启 dsh --profile web，仅客户端 bundle 可热重载。
典型用法¶
- 启动带 web profile 的 DSH 并确保插件已加载后，在左侧栏打开「习惯看板」。
- 在「打卡」视图记录当日习惯：例如三餐点
＋打时间戳，背单词改当日目标并记进度，任务拖动进度条或勾选完成。 - 对任务或影视书籍点标题进入专注模式，写笔记、贴素材，退出后会话闭合并参与统计。
- 切换到「统计」查看热力图与连续天数；需要迁移时导出 JSON，在新环境用合并或覆盖导入。
- 需要把当天情况发给他人时，用看板底部「复制报告」得到纯文本与剩余任务列表。
开发侧常用命令：
pnpm install
pnpm build
pnpm watch
pnpm test
pnpm verify
适用场景与注意¶
适合：已在用 DSH Web profile、希望习惯、任务、媒体登记与专注会话都在同一壳内、且能接受 fork 改硬编码清单的开发者或个人用户。
注意：
- 习惯格与多数业务规则写在源码里，原样安装等于使用作者预设的作息表。
- 数据在本机
~/.dsh/storages/habit/；备份格式为personal-track/backupversion 2，导入前整份 schema 校验，不合法则整份拒绝。 - 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文事实以 GitHub README 与
package.json为准。
结尾¶
personal-track 把打卡、分数化完成度、任务登记与专注模式收进 DSH 左侧栏习惯看板，并用统计视图与 JSON 备份支撑复盘和迁移。若要长期自用，README 的建议仍是 fork 后改 CELL_IDS 与相关 derive 逻辑再 link 构建。
- 目录页：https://www.skillhub.cn/plugins/ds-hu/dsh-personal-track
- 源码：https://github.com/ds-hu/dsh-personal-track
