柳比歇夫时间账本 / Liubishev Time Ledger

手动补录优先的时间记录插件。
Manual-first time logging, stats, Markdown export, and AI review with the Liubishev method.

---

为什么做这个插件

很多时间记录工具更偏向“实时计时”，但柳比歇夫式复盘常常更适合：

• 先专注做事，之后再回顾补录
• 用统一分类长期统计自己的时间结构
• 和 Daily Note、项目笔记联动
• 需要能导出 Markdown，方便写周报、月复盘和 AI 分析

这个插件的设计重点不是“跑表”，而是：

1. 补录足够快
2. 统计足够直观
3. 数据足够可导出、可复用

---

核心特性

1. 手动补录优先

• 默认录入格式是 开始时间 + 结束时间
• 自动计算时长
• 新增表单时，时间输入框自动聚焦
• 自动延续你上一条记录的时间输入风格
• 支持“基于上一条继续补录”

2. 灵活的时间输入

支持多种输入方式，减少填写负担：

• 0910-1040
• 09:10-10:40
• 90m
• 1h30m

你既可以录入完整时段，也可以先记纯时长，之后再补齐具体时间。

3. 今日时间轴

• 按当天真实时间分布展示记录块
• 1 格 = 1h 的可视参考网格
• 时长越长，时间块占用越高
• 很短的记录会自动压缩成 mini block，避免界面拥挤
• 自动识别空档，方便回顾一天的节奏

4. 今日 / 本周 / 本月统计

• 总投入
• 有效时间
• 主力分类
• 标签热点
• 记录预览

可以快速回答这些问题：

• 今天时间主要花在哪里？
• 这一周最重要的投入方向是什么？
• 哪些分类是“看起来很忙但并不高效”？

5. Markdown 导出

支持导出：

• 统计摘要（summary）
• 原始流水（raw log）

适合直接插入笔记、周报、月报，或者继续交给 AI 复盘。

6. Daily Note 自动回写

• 保存 / 删除记录后可自动同步当天摘要到 Daily Note
• 支持自定义文件夹、文件名模板、标题和 block ID

7. 智能分类与 AI 复盘

• 本地规则会根据项目、备注、标签、历史记录给出分类建议
• 可选接入 OpenAI 兼容接口，做：
  • AI 分类复核
  • AI 标签建议
  • 周 / 月 AI 复盘

8. 中英双语界面

• 自动识别 Obsidian 语言
• zh* 使用中文
• en* 使用英文
• 其他语言默认英文

---

安装

方式一：社区插件市场

直接在：

Settings → Community plugins

中搜索：

Liubishev Time Ledger

方式二：手动安装

将以下文件放入你的 Vault：

需要至少包含：

• manifest.json
• main.js
• styles.css

---

使用方式

快速记录

插件提供以下入口：

• Ribbon 图标：时钟按钮
• 命令面板：
  • 新增时间记录 / Add time entry
  • 基于上一条继续补录 / Continue from the previous entry
  • 打开今日记录面板 / Open the Today panel
  • 打开统计视图 / Open the Stats view

推荐录入流程

1. 打开快速记录窗口
2. 输入日期和时间段
3. 选择分类
4. 视情况补充标签、项目、备注
5. 保存

如果你当天主要靠回忆补录，推荐优先输入：

• 时间段
• 分类
• 简短备注

后续再慢慢补标签或项目名。

今日面板

今日视图适合检查：

• 时间块是否连续
• 有没有漏记的空档
• 哪些记录只有时长、还没定位到具体时段

对很短的时间块：

• 不再强行显示分类与时间文案
• 改为更轻量的 mini block
• 支持点击编辑、右键弹出更多操作

统计面板

统计视图支持：

• 今日
• 本周
• 本月

可直接：

• 导出 Markdown 报告
• 导出原始流水
• 对周 / 月数据生成 AI 复盘

---

时间输入示例

输入	含义
0910-1040	09:10 到 10:40
09:10-10:40	09:10 到 10:40
90m	90 分钟
1h30m	1 小时 30 分钟

默认更推荐直接录入完整时间段，因为这能让今日时间轴更完整。

---

设置项

常规

• 自动带出上一条结束时间
• 默认补录分钟数
• 最近分类数量
• 导出目录

分类

• 自定义分类名称
• 调整颜色
• 标记是否计入有效时间
• 启用 / 禁用分类

Daily Note

• 是否自动回写
• Daily Note 文件夹
• 文件名模板
• 区块标题
• block ID

智能分类

• 启用本地智能分类建议
• 高置信度自动应用
• 启用 AI 分类复核
• AI 自动填入标签

AI

• 是否启用 AI
• Base URL
• API Key
• Model
• 是否发送 note 内容

---

AI / 网络 / 隐私说明

默认情况下，插件的本地记录与统计逻辑都在本地运行。

只有在你显式启用 AI 功能并配置了兼容接口后，插件才会向你配置的 AI 服务发送请求。可能发送的数据包括：

• 当前统计摘要
• 当前记录的项目 / 标签 / 备注
• 周 / 月导出的 Markdown 内容

如果你不希望发送备注内容，可以在设置中关闭：

• 发送备注内容 / Send note content

---

开发

安装依赖：

npm install

开发监听：

npm run dev

构建：

npm run build

测试：

npm test

---

项目结构

src/           TypeScript 源码
src/ui/        面板与弹窗 UI
tests/         测试
docs/          设计与实现过程文档
manifest.json  Obsidian 插件清单
styles.css     插件样式
versions.json  Obsidian 兼容版本映射

---

License

MIT