前言¶
在 DeepSeek Harness（DSH）里接插件时，常见问题是：任务、健康、资产分散在不同 Markdown 或表格里，侧栏里看不到「一眼汇总」。要么为看板单独迁数据进插件存储，要么只覆盖单一领域。
dsh-lifeboard 走另一条路：不新建数据库、不上云，只读取你已经在写的 Markdown 与 TSV，在 DSH 侧栏折成五张卡（健康、任务、资产、情绪/运动、书架）。除勾选任务、情绪打卡外默认不改原文件；资产与消费相关卡片默认不主动读取，需你点击查看。
这是什么¶
- 名称：dsh-lifeboard（npm 包名同此）
- 维护者：leotier196
- 分类：客户端插件（
platform: web，注入 DSH 客户端 UI） - 许可：MIT；当前 npm 版本 1.0.6；要求 DSH >=0.2.1-rc.2，Node >=20
- 定位：Local-only life dashboard —— 人生看板，数据不出本机；插件自述不发起网络请求
社区目录页：https://www.skillhub.cn/plugins/leotier196/dsh-lifeboard
源码与文档：https://github.com/leotier196/dsh-lifeboard
五张卡各自读什么¶
| 卡片 | 数据源 | 展示与交互（据 README） |
|---|---|---|
| 健康 | 每日笔记中的健康表，以及睡眠、运动、饮食段落 | 体重及变化、7 日折线、体脂等指标、蛋白进度环等 |
| 任务 | TODO 文件中的 - [ ] 行 |
按截止日期排序，逾期标红，#tag 区分工作/生活；可勾选或延后 |
| 资产 | 资产快照 TSV | 分类环形图、持仓前几名、当月消费（需主动查看时涉及财务文件） |
| 情绪·运动 | 日志中的情绪、运动段落 | 7 日打点、连续打卡、一键情绪打卡 |
| 书架 | 书架目录下的 .md |
封面展示；点选可随机摘读片段 |
某路径对应文件缺失时，该卡显示「无数据」，不会拖垮整块面板。
安装与启用¶
- 在终端用 profile 安装（命令来自官方 README）：
dsh plugin --profile <your-profile> add dsh-lifeboard
-
或在 DSH 里走 Plugins → Add plugin，输入
dsh-lifeboard。 -
重启 DSH 后，侧栏会出现 Lifeboard 入口。
尚无真实笔记时，可在 Settings → Lifeboard 打开 Demo preview。插件会在 ~/.dsh/storages/dsh-lifeboard/demo-vault/ 生成本地虚构数据集（与真实目录隔离），安装即可预览界面。
配置路径¶
不必先搭固定目录结构。README 中的 _assistant/... 仅为示例；在 Settings → Lifeboard 使用 Auto-detect 可扫描笔记目录并填充路径。
也可在 profile 的 cordis.patch.yml 中设置默认值，例如：
- id: lifeboard
name: dsh-lifeboard
config:
vaultRoot: "" # 空则自动探测
logDir: "_assistant/life/log" # 每日笔记 YYYY-MM-DD.md
todoFile: "_assistant/TODO.md"
assetsFile: "_assistant/life/private/资产快照.tsv"
financeFile: "_assistant/life/private/消费流水.tsv"
shelfDir: "_assistant/notes/书架"
coverDir: "_assistant/life/private/书/封面"
excerptDir: "_assistant/life/private/书/抽取"
windowDays: 7
proteinTarget: 130
cards:
health: true
tasks: true
assets: true
mood: true
shelf: true
demoMode: false
路径均相对 vaultRoot。可用 cards 下各布尔项隐藏不需要的卡片。
笔记格式与兼容¶
解析器支持多种写法（表格、表头+数据行、键值、列表、英文键、YAML frontmatter 等），单位会自动换算（如斤、磅、分钟）。若字段用语不同，在 Settings → Lifeboard → Field aliases 中按行配置别名，保存即生效。
每日笔记 logDir/YYYY-MM-DD.md 示例：
## 健康
| 指标 | 数值 |
|:--|:--|
| 体重 | **70.0 kg** |
| 体脂率 | **22.0%** |
## 睡眠
- 睡了 7.5 小时
## 情绪
- **正常**
## 运动
- 户外步行 2.0 km
## 饮食
- 今日累计（日终）：蛋白 **~130g**
任务 todoFile：
- [ ] 整理季度复盘 | 截止：2026-11-20 | #工作
- [x] 续费服务器 | 完成：2026-11-09
资产 TSV（金额单位为「万」）：
日期 类别 名称 金额万
2026-11-09 基金 全球股票指数 32.0
尚无结构时，设置里 Create samples 可生成 lifeboard-示例/ 供复制，不改动已有文件。
适用场景与注意¶
适合：已在用 Markdown 记日记、TODO、资产表，希望在 DSH 侧栏只读汇总，并尽量少改写作习惯的用户。
运行边界（据 README）：
- 插件以当前 DSH 进程权限读写在 vault 内的文件；安装前宜查看源码与 MIT 许可证。
- 写操作限于：勾选/延后任务（会先备份 TODO 至
.bak）、情绪打卡；点击卡片「来源」会用系统默认应用打开文件（路径限制在 vault 内，扩展名白名单）。 - dsh.so 扫描可能提示子进程与备份目录写入，README 说明为有意设计，非漏洞类问题。
生态上，DSH 采用「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-lifeboard 的价值在于：不迁库、不联网，把你已有的 Markdown/TSV 折成五域看板并挂在 DSH 侧栏；财务敏感块默认等你点开再读。进一步了解：
- 目录页：https://www.skillhub.cn/plugins/leotier196/dsh-lifeboard
- GitHub：https://github.com/leotier196/dsh-lifeboard
