Knowledge Habit Skill

知识工作习惯追踪器：为知识工作者设计的隐私优先、离线第一的习惯与事件记录系统，支持单习惯专注、事件沉淀、节点候选生成，以及Web、Electron桌面、Android覆盖层多平台支持。

知识工作习惯追踪器

技能描述

这是一个专为知识工作者和终身学习者设计的习惯追踪系统，核心设计哲学是隐私优先、离线第一、单习惯专注。系统默认所有数据（习惯、事件、计时、备份）都运行在浏览器本地沙箱中，只有在你主动启动本地服务时才会写入本机日志。

核心设计原则

📍 单习惯专注

• 一次只养一个习惯：减少注意力切换，聚焦当前最重要的知识工作习惯
• 激活习惯机制：同一时间只有一个激活习惯，避免多任务干扰
• 渐进式养成：从简单记录开始，逐步形成稳定的知识工作节奏

🔒 隐私优先，离线第一

• 纯本地数据：习惯、事件、计时、备份都保存在当前浏览器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 desktop

Android覆盖层

# 使用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
• 核心功能：单习惯专注、事件证据链、节点候选生成、纯本地数据
• 隐私设计：离线第一、数据所有权完全归用户
• 开放集成：为知识共建平台提供节点候选对接接口

开发路线图

近期计划

• 节点候选编辑界面
• 习惯数据分析可视化
• 多设备加密同步方案
• 知识共建平台深度集成

远期愿景

• 习惯智能推荐系统
• 认知负荷自适应调整
• 多模态习惯记录（语音、图像）
• 跨平台知识工作流自动化

---

核心价值主张：这不是另一个通用的待办事项或习惯追踪工具，而是专门为知识工作者设计的、尊重认知规律和隐私需求的系统。它相信真正的知识工作需要在深度专注中进行，而习惯养成应该服务于而不是干扰这一过程。