- name
- knowledge-habit-tracker
- description
- 知识工作习惯追踪器：为知识工作者设计的隐私优先、离线第一的习惯与事件记录系统，支持单习惯专注、事件沉淀、节点候选生成，以及Web、Electron桌面、Android覆盖层多平台支持。
- author
- puppetcat-fire (柏然)
- version
- 1.0.9
- created
- 2026-03-15
- license
- MIT
- metadata
- openclaw
- emoji
- 📚⏱️
- requires
- bins
- ["node", "npm", "bash"]
- node_version
- 1.0.9
- install
- kind
- shell
- command
- ./install.sh
- label
- 安装知识习惯追踪器
- examples
- output
- 在本地浏览器中打开知识工作习惯记录界面
- output
- 打开桌面应用，包含主窗口和全局悬浮计时窗
- output
- 记录专注时间、事件，生成节点候选
- output
- 导出本地习惯数据为JSON备份文件
知识工作习惯追踪器
技能描述
这是一个专为知识工作者和终身学习者设计的习惯追踪系统，核心设计哲学是隐私优先、离线第一、单习惯专注。系统默认所有数据（习惯、事件、计时、备份）都运行在浏览器本地沙箱中，只有在你主动启动本地服务时才会写入本机日志。
核心设计原则
📍 单习惯专注
- 一次只养一个习惯：减少注意力切换，聚焦当前最重要的知识工作习惯
- 激活习惯机制：同一时间只有一个激活习惯，避免多任务干扰
- 渐进式养成：从简单记录开始，逐步形成稳定的知识工作节奏
🔒 隐私优先，离线第一
- 纯本地数据：习惯、事件、计时、备份都保存在当前浏览器localStorage
- 无自动上传：所有数据默认不离开你的设备
- 主动控制：只有反馈日志在你启动本地服务时才会写入本机磁盘
- JSON备份：支持完全控制的数据导出/导入，数据所有权完全归用户
⏱️ 事件证据链
- 手动记录：快速记录知识工作事件
- 计时记录：精确跟踪专注时间
- 可追溯性：所有事件形成完整的时间线证据链
- 上下文保留：记录事件时的环境、工具、方法等信息
🎯 节点候选生成
- 重复动作聚合：相同或类似习惯事件自动聚合为"节点候选"
- 教程化准备：节点候选为后续转化为结构化知识节点（教程、指南、方法）做准备
- 知识沉淀：从个人习惯到可共享知识的自然转化路径
多平台支持
🌐 Web浏览器版
- 本地运行：
npm start启动本地服务 (127.0.0.1:3000) - 浏览器沙箱：所有数据保存在浏览器localStorage
- 完整功能：习惯管理、事件记录、计时、备份导出
- 隐私保护：只监听本地地址，不对外暴露
💻 Electron桌面版
- 全局悬浮窗：始终置顶的计时窗口，跨软件可见
- 快捷键控制：
- Ctrl+Shift+T：显示/隐藏悬浮窗 - Ctrl+Shift+H：唤起主窗口
- 独立存储：与浏览器版数据隔离，支持数据迁移
- 多窗口协同：主窗口+悬浮窗共享同一份本地状态
📱 Android覆盖层 (MVP)
- 常驻计时条：Android原生悬浮窗，跨App常驻显示
- 前台服务：保证计时器在后台持续运行
- 可拖动UI：可自由拖动的小计时条界面
- 动作记录：当前专注动作的实时输入和显示
- 原生体验：Android Studio项目，完整原生实现
技术架构
数据边界设计
| 数据类别 | 存储位置 | 同步机制 | 隐私级别 |
|---|---|---|---|
| 激活习惯 | 浏览器localStorage | 无自动同步 | 🔒 最高 |
| 历史习惯 | 浏览器localStorage | 无自动同步 | 🔒 最高 |
| 事件记录 | 浏览器localStorage | 无自动同步 | 🔒 最高 |
| 计时器状态 | 浏览器localStorage | 无自动同步 | 🔒 最高 |
| JSON备份 | 用户指定文件 | 手动导出/导入 | 🔒 最高 |
| 反馈日志 | 服务端data/目录 | 仅当服务启动时 | 🔓 可控 |
开发与部署
- 技术栈：Node.js + Express + Vanilla JS + Electron + Android原生
- 开发检查：ESLint + TypeScript检查 + Vitest单元测试
- 部署建议：Node进程只监听内网，Nginx反向代理，data目录不暴露
- 安全设计：默认只允许本机访问，最小化网络暴露面
安装与使用
快速开始
# 安装依赖并启动Web版
npm install
npm start
# 打开 http://127.0.0.1:3000桌面悬浮窗模式
# 启动Electron桌面版（主窗口+悬浮窗）
npm run desktopAndroid覆盖层
# 使用Android Studio打开android-overlay目录
# 编译并安装到Android设备数据迁移
# 1. 在浏览器版中导出JSON备份
# 2. 在Electron桌面版中导入JSON备份
# 3. 数据在不同平台间手动迁移，保持控制权与知识共建平台的集成路径
个人→集体的知识转化流程
个人习惯记录 → 事件证据链 → 节点候选 → 知识节点提案 → 集体节点治理点亮事件对接
- 事件标准化：习惯事件可转换为标准"点亮事件"
- 节点候选：为Dragon Palace Knowledge Hub提供教程节点素材
- 材料挂载：习惯中使用的工具、方法可挂载为知识节点材料
治理参与
- 个人节点：个人习惯转化的知识节点，个人完全控制
- 集体节点：多人协作的知识节点，基于点亮事件投票治理
- 提案机制：从节点候选升级为正式节点的提案流程
适用场景
🧠 个人知识工作者
- 跟踪每日深度工作习惯
- 记录学习进度和方法
- 沉淀个人知识工作流
- 分析时间投入与产出
👥 小团队协作
- 共享团队知识工作节奏
- 统一习惯养成方法论
- 对比不同成员的工作模式
- 优化团队知识生产效率
🏫 教育研究
- 研究知识获取的认知过程
- 分析习惯养成的影响因素
- 跟踪学习方法的有效性
- 为认知科学提供实证数据
🌱 终身学习者
- 建立持续学习习惯
- 跟踪技能掌握进度
- 记录突破性学习时刻
- 构建个人知识发展图谱
版本历史
v1.0.9 (2026-03-15)
- 初始发布：完整的知识工作习惯追踪系统
- 多平台支持：Web浏览器版 + Electron桌面版 + Android覆盖层MVP
- 核心功能：单习惯专注、事件证据链、节点候选生成、纯本地数据
- 隐私设计：离线第一、数据所有权完全归用户
- 开放集成：为知识共建平台提供节点候选对接接口
开发路线图
近期计划
- 节点候选编辑界面
- 习惯数据分析可视化
- 多设备加密同步方案
- 知识共建平台深度集成
远期愿景
- 习惯智能推荐系统
- 认知负荷自适应调整
- 多模态习惯记录（语音、图像）
- 跨平台知识工作流自动化
核心价值主张：这不是另一个通用的待办事项或习惯追踪工具，而是专门为知识工作者设计的、尊重认知规律和隐私需求的系统。它相信真正的知识工作需要在深度专注中进行，而习惯养成应该服务于而不是干扰这一过程。