Knowledge Habit Skill

SKILL.md

---
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:
      - id: "install-deps"
        kind: "shell"
        command: "./install.sh"
        label: "安装知识习惯追踪器"
    examples:
      - input: "启动Web习惯追踪器"
        output: "在本地浏览器中打开知识工作习惯记录界面"
      - input: "启动Electron桌面版"
        output: "打开桌面应用，包含主窗口和全局悬浮计时窗"
      - input: "记录今日知识工作习惯"
        output: "记录专注时间、事件，生成节点候选"
      - input: "导出习惯数据备份"
        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目录不暴露
- **安全设计**：默认只允许本机访问，最小化网络暴露面

## 安装与使用

### 快速开始
```bash
# 安装依赖并启动Web版
npm install
npm start
# 打开 http://127.0.0.1:3000
```

### 桌面悬浮窗模式
```bash
# 启动Electron桌面版（主窗口+悬浮窗）
npm run desktop
```

### Android覆盖层
```bash
# 使用Android Studio打开android-overlay目录
# 编译并安装到Android设备
```

### 数据迁移
```bash
# 1. 在浏览器版中导出JSON备份
# 2. 在Electron桌面版中导入JSON备份
# 3. 数据在不同平台间手动迁移，保持控制权
```

## 与知识共建平台的集成路径

### 个人→集体的知识转化流程
```
个人习惯记录 → 事件证据链 → 节点候选 → 知识节点提案 → 集体节点治理
```

### 点亮事件对接
- **事件标准化**：习惯事件可转换为标准"点亮事件"
- **节点候选**：为Dragon Palace Knowledge Hub提供教程节点素材
- **材料挂载**：习惯中使用的工具、方法可挂载为知识节点材料

### 治理参与
- **个人节点**：个人习惯转化的知识节点，个人完全控制
- **集体节点**：多人协作的知识节点，基于点亮事件投票治理
- **提案机制**：从节点候选升级为正式节点的提案流程

## 适用场景

### 🧠 个人知识工作者
- 跟踪每日深度工作习惯
- 记录学习进度和方法
- 沉淀个人知识工作流
- 分析时间投入与产出

### 👥 小团队协作
- 共享团队知识工作节奏
- 统一习惯养成方法论
- 对比不同成员的工作模式
- 优化团队知识生产效率

### 🏫 教育研究
- 研究知识获取的认知过程
- 分析习惯养成的影响因素
- 跟踪学习方法的有效性
- 为认知科学提供实证数据

### 🌱 终身学习者
- 建立持续学习习惯
- 跟踪技能掌握进度
- 记录突破性学习时刻
- 构建个人知识发展图谱

## 版本历史

### v1.0.9 (2026-03-15)
- **初始发布**：完整的知识工作习惯追踪系统
- **多平台支持**：Web浏览器版 + Electron桌面版 + Android覆盖层MVP
- **核心功能**：单习惯专注、事件证据链、节点候选生成、纯本地数据
- **隐私设计**：离线第一、数据所有权完全归用户
- **开放集成**：为知识共建平台提供节点候选对接接口

## 开发路线图

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

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

---

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