Install
openclaw skills install @cowboy231/kids-points-v2openclaw skills install @cowboy231/kids-points-v2简单、可靠的儿童积分管理工具。V2 相比 1.x 版本做了全面重构:记账稳定性、CLI 对接能力、轻量化都大幅提升。
| 特性 | 说明 |
|---|---|
| 📊 SQLite 存储 | 账本从文本文件迁移到 SQLite,并发/断电不再丢数据 |
| 🤖 LLM 语义分析 | 用大模型提取积分意图,对口语化、方言、不同家庭说法适应性更强 |
| 🛠️ CLI 接口 | 新增 cli.py,方便对接 Agent、脚本、外部程序 |
| 🪶 更轻 | 剥离 ASR(语音转写),复用飞书自带转写 |
| 💬 飞书全量 | 群聊 + 单聊 都支持 |
| 🔁 防重复 | 基于 messageId 自动去重 |
直接给飞书 bot 发自然语言就行:
今天完成了汉字抄写 2 课,口算题卡 2 篇全对
积分消费 买零食花了 20 分
现在多少分?
今日积分
Bot 会自动识别语意 + 记账 + 回报结果。
# 走完整 8 步 pipeline(LLM 识别 + 记账 + 返 reply)
python3 runtime/cli.py "今天数学加 1 分"
# 查余额(不走 LLM)
python3 runtime/cli.py balance
# 今日积分
python3 runtime/cli.py today
# 历史记录
python3 runtime/cli.py history
退出码:0 成功 / 1 数据库错误 / 2 参数错误。
kids-points-v2/
├── runtime/ # V2 Python runtime(核心逻辑)
│ ├── cli.py # CLI 入口
│ ├── db.py # SQLite 操作层
│ ├── pipeline.py # 8 步处理 pipeline
│ ├── llm_config.py # LLM 配置单入口
│ ├── config.yaml.example # 配置模板(复制为 config.yaml 使用)
│ └── data/ # SQLite 账本位置
├── skill/ # OpenClaw skill 包装层
│ ├── SKILL.md
│ ├── agent-handler.js # OpenClaw dispatch 入口
│ ├── build.sh # ClawHub 发布打包
│ └── scripts/
│ └── handle_feishu.py # V2 skill handler
├── extensions/ # 扩展项目(点阵屏看板等)
├── docs/ # 内部文档
├── README.md
├── LICENSE
└── .gitignore
复制示例配置并填入你的信息:
cp runtime/config.yaml.example runtime/config.yaml
# 编辑 config.yaml,填入 api_url / model / key_source
key_source 推荐用环境变量引用,例如 env:OPENAI_API_KEY,然后把 key 放到 shell 环境变量里。
如果你想用其他位置的 runtime,设环境变量:
export KIDS_POINTS_RUNTIME_DIR=/path/to/your/kids-points-runtime
优先级:KIDS_POINTS_RUNTIME_DIR env > 项目根内嵌 runtime/ 默认值。
| 输入 | 行为 |
|---|---|
浮点积分(如 0.5) | 返引导文案,不记账 |
| 模糊短消息 | 返引导文案,提示明确金额 |
| 多笔混合(收入+支出) | 一条 message 处理多笔,写库 |
| 整数加减 | 正常记账 |
| 分支 | 内容 | 用途 |
|---|---|---|
| main | 开源安全版(config.yaml.example + 产品代码) | GitHub 主分支、ClawHub 发布 |
| dev | 自用版(真实配置 + 内部资料 + 测试数据) | 本地开发,不推送 |
开发者:日常在 dev 分支 work,定期 merge 到 main 后 push。
extensions/ 目录用心记录每一次进步。 🌟