← 返回 Skills 市场
341
总下载
0
收藏
0
当前安装
8
版本数
在 OpenClaw 中安装
/install knowledge-habit-skill
功能描述
知识工作习惯追踪器：为知识工作者设计的隐私优先、离线第一的习惯与事件记录系统，支持单习惯专注、事件沉淀、节点候选生成，以及Web、Electron桌面、Android覆盖层多平台支持。
使用说明 (SKILL.md)
知识工作习惯追踪器
技能描述
这是一个专为知识工作者和终身学习者设计的习惯追踪系统，核心设计哲学是隐私优先、离线第一、单习惯专注。系统默认所有数据（习惯、事件、计时、备份）都运行在浏览器本地沙箱中，只有在你主动启动本地服务时才会写入本机日志。
核心设计原则
📍 单习惯专注
- 一次只养一个习惯：减少注意力切换，聚焦当前最重要的知识工作习惯
- 激活习惯机制：同一时间只有一个激活习惯，避免多任务干扰
- 渐进式养成：从简单记录开始，逐步形成稳定的知识工作节奏
🔒 隐私优先，离线第一
- 纯本地数据：习惯、事件、计时、备份都保存在当前浏览器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
- 核心功能：单习惯专注、事件证据链、节点候选生成、纯本地数据
- 隐私设计：离线第一、数据所有权完全归用户
- 开放集成：为知识共建平台提供节点候选对接接口
开发路线图
近期计划
- 节点候选编辑界面
- 习惯数据分析可视化
- 多设备加密同步方案
- 知识共建平台深度集成
远期愿景
- 习惯智能推荐系统
- 认知负荷自适应调整
- 多模态习惯记录（语音、图像）
- 跨平台知识工作流自动化
核心价值主张：这不是另一个通用的待办事项或习惯追踪工具，而是专门为知识工作者设计的、尊重认知规律和隐私需求的系统。它相信真正的知识工作需要在深度专注中进行，而习惯养成应该服务于而不是干扰这一过程。
安全使用建议
Before installing/running this skill:
- Expect install.sh to require network access: it will git-clone https://github.com/puppetcat-fire/knowledge-habit-tracker if a local tracker/ directory is missing, and will run npm install which fetches packages from the npm registry. Verify you trust the remote repository and packages before running.
- The metadata lists node/npm/bash but not git; ensure git is available or be aware install.sh will fail. This mismatch is an oversight but important to know.
- install.sh is interactive (prompts for choice). In automated or sandboxed environments the prompt can hang; run it in an interactive shell or inspect/modify the script first.
- Because the app is fetched and built at install time, review the cloned repository (its package.json and source) before starting the service to check for any unwanted network calls or packages with concerning permissions.
- Run the install and runtime (npm start / npm run desktop) in an isolated environment (container or VM) if you want to minimize risk. Confirm the web service listens on 127.0.0.1 only as claimed, and inspect network activity when first running.
If you need, I can: (a) list the files expected inside the tracker repo to look for before running, (b) show commands to safely clone and inspect the repo without executing install.sh, or (c) help audit the tracker repository's package.json and main server code once you provide it.
功能分析
Type: OpenClaw Skill
Name: knowledge-habit-skill
Version: 1.0.9
The skill functions primarily as a downloader/installer that fetches external code from a GitHub repository (github.com/puppetcat-fire/knowledge-habit-tracker.git) and executes it via 'npm install' inside 'install.sh'. This pattern is risky because the core logic of the application is not contained within the analyzed bundle, bypassing static analysis. Additionally, 'install.sh' uses interactive shell prompts and performs symlink operations ('ln -sf') based on user-provided paths, which could lead to local file system manipulation if exploited.
能力评估
Purpose & Capability
The name and description match the included scripts and SKILL.md: this is a local/offline-first Node/Electron habit tracker. However, the shipped files do not include the actual 'tracker' application; install.sh will clone https://github.com/puppetcat-fire/knowledge-habit-tracker if no local tracker directory exists. The registry metadata requires node/npm/bash but does not declare git — yet install.sh requires git. Asking to clone a remote repository is plausible for this purpose but should be expected and was not declared in requires.bins.
Instruction Scope
SKILL.md instructs the agent to run local services (npm start / npm run desktop) and asserts data stays in browser localStorage unless the user explicitly exports or runs service. The runtime scripts themselves (install.sh, start-*.sh, habit-cli.sh) operate locally and reference only local paths. There is no code in the provided files that reads arbitrary system files or environment variables beyond standard PATH checks. However, SKILL.md and README claim 'no automatic upload' — the install step and subsequent npm install will fetch remote packages, and the install.sh can clone a remote repo (network operation). Also the install script is interactive (read prompts) which may block automated installs or produce unexpected choices if run non-interactively.
Install Mechanism
There is no bundled tracker app in the skill files; install.sh will attempt to git clone the tracker repo from GitHub if tracker/ is missing. Cloning from GitHub is a well-known host (lower risk than arbitrary URLs) but it is a remote fetch of code not bundled in the skill. The script then runs npm install/ci which pulls packages from npm registry. install.sh is interactive (prompts user for choice), which can hang in automated contexts. The risk is moderate because remote code (the tracker repo and npm dependencies) will be written to disk and executed locally.
Credentials
The skill declares no required environment variables or credentials (correctly aligned with an offline-first tracker). install.sh generates a .env.example but does not require secrets. One inconsistency: install.sh checks for 'git' but the metadata's required binaries list omits git. npm install will pull packages from the public registry; that is expected but means network access and dependency provenance should be verified.
Persistence & Privilege
The skill is not always-included and is user-invocable; it does not request persistent elevated privileges. Its install script writes helper scripts, .env.example, and will create a tracker directory (or clone it). That is normal for a local app. There is no evidence it modifies other skills or system-wide agent settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install knowledge-habit-skill - 安装完成后，直接呼叫该 Skill 的名称或使用
/knowledge-habit-skill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.9
- Bumped version to 1.0.9.
- Updated node version and skill version metadata to 1.0.9.
- "版本历史" now documents v1.0.9 as the initial public release, moving previous v1.0.8 notes to v1.0.9.
- No changes to core functionality or described features.
v1.0.8
- 更新版本号至 1.0.8，并同步 node_version（文档及配置均已更新）
- 增加了 v1.0.8 版本历史记录，作为初始发布内容（原 1.0.7 记录已替换为 1.0.8 并时间/描述不变）
- 其余主体内容保持不变，仅进行例行维护同步
v1.0.7
- 更新版本号至 1.0.7
- 元数据 `node_version` 对应升级至 1.0.7
- 版本历史部分增加 1.0.7 版本说明，内容与上一版一致，作为新基线起点
- 其他文档内容保持不变，主要为配置和文档同步版本更新
v1.0.6
- 更新版本至 1.0.6，反映在 SKILL.md 与 package.json。
- metadata 中 node_version 更新为 1.0.6。
- 版本历史条目更新至 v1.0.6，内容仍为初始发布特性描述。
- 其余文档内容保持不变，仅进行版本号调整。
v1.0.5
- Bumped version to 1.0.5.
- Updated node version requirement in metadata.
- Updated version history in documentation to reflect v1.0.5.
- No functional or feature changes; this is a metadata and documentation update.
v1.0.4
- Bumped version to 1.0.4.
- Updated required node version in metadata.
- Sync version number in documentation and package configuration.
- No functional or feature changes in this release.
v1.0.3
- 版本号升级为 1.0.3，对应 package.json 和 SKILL.md 的同步更新
- 修正 metadata 中所需 node_version 字段（从 1.0.2 更新为 1.0.3）
- 版本历史中“初始发布”等内容由 v1.0.2 更新为 v1.0.3，并同步调整相关说明
- 其他内容未变，属于版本号和文档版本对齐更新
v1.0.2
knowledge-habit-tracker v1.0.2
- 初始发布版本，专为知识工作者设计的习惯与事件追踪系统
- 支持 Web、Electron 桌面、Android 覆盖层多平台使用
- 核心特性：单习惯专注、事件沉淀、节点候选生成、离线隐私数据存储
- 支持本地 JSON 数据导出/导入，数据完全由用户掌控
- 提供与知识共建平台的节点对接接口
元数据
常见问题
Knowledge Habit Skill 是什么？
知识工作习惯追踪器：为知识工作者设计的隐私优先、离线第一的习惯与事件记录系统，支持单习惯专注、事件沉淀、节点候选生成，以及Web、Electron桌面、Android覆盖层多平台支持。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 341 次。
如何安装 Knowledge Habit Skill？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install knowledge-habit-skill」即可一键安装，无需额外配置。
Knowledge Habit Skill 是免费的吗？
是的，Knowledge Habit Skill 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Knowledge Habit Skill 支持哪些平台？
Knowledge Habit Skill 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Knowledge Habit Skill？
由 渡鸦大人（@puppetcat-fire）开发并维护，当前版本 v1.0.9。
推荐 Skills