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專案，完整原生實現

技術架構

資料邊界設計

開發與部署

• 技術棧：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. 資料在不同平臺間手動遷移，保持控制權

與知識共建平臺的整合路徑

個人→集體的知識轉化流程

發現更多技能外掛，請訪問7w4.net。

個人習慣記錄 → 事件證據鏈 → 節點候選 → 知識節點提案 → 集體節點治理

點亮事件對接

• 事件標準化：習慣事件可轉換為標準"點亮事件"
• 節點候選：為Dragon Palace Knowledge Hub提供教程節點素材
• 材料掛載：習慣中使用的工具、方法可掛載為知識節點材料

治理參與

• 個人節點：個人習慣轉化的知識節點，個人完全控制
• 集體節點：多人協作的知識節點，基於點亮事件投票治理
• 提案機制：從節點候選升級為正式節點的提案流程

適用場景

🧠 個人知識工作者

• 跟蹤每日深度工作習慣
• 記錄學習進度和方法
• 沉澱個人知識工作流
• 分析時間投入與產出

👥 小團隊協作

• 共享團隊知識工作節奏
• 統一習慣養成方法論
• 對比不同成員的工作模式
• 最佳化團隊知識生產效率

🏫 教育研究

• 研究知識獲取的認知過程
• 分析習慣養成的影響因素
• 跟蹤學習方法的有效性
• 為認知科學提供實證資料

🌱 終身學習者

• 建立持續學習習慣
• 跟蹤技能掌握進度
• 記錄突破性學習時刻
• 構建個人知識發展圖譜

版本歷史

v1.0.9 (2026-03-15)

• 初始釋出：完整的知識工作習慣追蹤系統
• 多平臺支援：Web瀏覽器版 + Electron桌面版 + Android覆蓋層MVP
• 核心功能：單習慣專注、事件證據鏈、節點候選生成、純本地資料
• 隱私設計：離線第一、資料所有權完全歸使用者
• 開放整合：為知識共建平臺提供節點候選對接介面

開發路線圖

近期計劃

• 節點候選編輯介面
• 習慣資料分析視覺化
• 多裝置加密同步方案
• 知識共建平臺深度整合

遠期願景

• 習慣智慧推薦系統
• 認知負荷自適應調整
• 多模態習慣記錄（語音、影像）
• 跨平臺知識工作流自動化

核心價值主張：這不是另一個通用的待辦事項或習慣追蹤工具，而是專門為知識工作者設計的、尊重認知規律和隱私需求的系統。它相信真正的知識工作需要在深度專注中進行，而習慣養成應該服務於而不是干擾這一過程。

功能設計有創意，隱私保護和文件說明做得很好，但作為習慣追蹤工具獨立使用有些困難——核心程式碼需要額外下載安裝，技術小白容易遇到障礙。建議開發者把原始碼直接打包進來，降低使用門檻。