Skill: puppetcat-fire/knowledge-habit-skill (version 1.0.9)

--- 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 - **核心功能**：单习惯专注、事件证据链、节点候选生成、纯本地数据 - **隐私设计**：离线第一、数据所有权完全归用户 - **开放集成**：为知识共建平台提供节点候选对接接口 ## 开发路线图 ### 近期计划 - 节点候选编辑界面 - 习惯数据分析可视化 - 多设备加密同步方案 - 知识共建平台深度集成 ### 远期愿景 - 习惯智能推荐系统 - 认知负荷自适应调整 - 多模态习惯记录（语音、图像） - 跨平台知识工作流自动化 --- **核心价值主张**：这不是另一个通用的待办事项或习惯追踪工具，而是专门为知识工作者设计的、尊重认知规律和隐私需求的系统。它相信真正的知识工作需要在深度专注中进行，而习惯养成应该服务于而不是干扰这一过程。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)