# Changelog

All notable changes to **clawhub-daily** will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2026-06-03

### Added (新增)

- 🎯 **首次安装模式选择**（`references/setup-wizard.md`）
  - 模式 A：常规对话模式（手动触发）
  - 模式 B：Cron 定时任务模式（自动推送）
- ⏰ **Cron 提示词模板**（`references/prompt-templates.md`）
  - Trae SOLO / qclaw / WorkBuddy / OpenClaw / Hermes / crontab / Windows Task Scheduler 全平台覆盖
  - 5 个开箱即用模板 + 痛点列表定制指南
- 🌍 **7 大痛点库**：🤖 自动化办公 / 🛠️ 开发工具 / ✍️ 内容创作 / 🕷️ 数据采集 / 🧠 AI 增强 / 🇨🇳 中文支持 / 💰 金融分析
- 📊 **4 维度轮换**：trending / quality / newcomers / panorama（按 `日期 % 4` 自动选）
- 🆔 **本地 JSON 去重**：10 天滚动窗口，0 数据库依赖
- 📥 **200 Skill 大池子抓取**：Convex API，0 token 消耗
- 📝 **简报中文化**：`chinese_one_liner` 自动拼装 + 英文 `<details>` 折叠
- 📤 **多通道推送**：
  - 飞书云文档 + 卡片消息（200-400 字摘要 + Top 3 详细解读）
  - IMA 知识库推送（`scripts/push_to_ima.py`，CLI 优先 + HTTP API 备选）
  - 本地 Markdown 简报（默认开启）
- 🔌 **`.claude-plugin/plugin.json`**：ClawHub 发布支持（**MIT-0 许可证**）
- 📜 **MIT-0 License**（`LICENSE`）— ClawHub 强制要求
- 📚 **`docs/CONTRIBUTING.md`** + **`docs/PUBLISHING_GUIDE.md`**：发布/贡献完整指南
- 🔐 **凭证管理**：`references/config.json` 模板（用户自填，不入库，支持飞书 + IMA 双渠道）

### Security (安全)

- 🔒 **移除硬编码凭证**：所有 `app_id` / `app_secret` / `user_open_id` 改为用户配置
- 🔒 **`.gitignore`**：忽略 `references/config.json`、`data/snapshots/*.json` 等运行时数据

### Documentation (文档)

- 📚 完整的 `README.md`（中英双语）
- 📚 `references/api-contract.md`（Convex API 契约）
- 📚 `references/source-data-schema.md`（数据字段说明）
- 📚 `references/pain-points.md`（痛点库维护指南）
- 📚 `references/briefing-template.md`（简报模板）

## [Unreleased]

### Planned

- 飞书 WebSocket 长连接（替代轮询）
- 多语言支持（英文 / 日文简报）
- 智能体推荐理由（基于 Skill 描述自动生成更精准的中文解读）
- Telegram / Slack / 企微 推送支持
- Skill 评分系统（基于用户安装/卸载行为）

---

## 版本号规则

- **MAJOR**：不兼容的 API 变更
- **MINOR**：向下兼容的新功能
- **PATCH**：向下兼容的 bug 修复

## 链接

- [Keep a Changelog](https://keepachangelog.com/)
- [Semantic Versioning](https://semver.org/)
