Architecture
KCHub 的五层架构
触发轻，执行重；每个 Skill 独立可换；数据留在家里。
Layer 01
客户端
多端入口
📱 微信小程序 🌐 Web 网页 💬 OpenClaw 机器人
Layer 02
触发层
任务入口
小程序 API Webhook 派单 OpenClaw 对话转任务
Layer 03
家庭电脑
执行环境
Mac mini 常驻 OpenCode / Claude Code Agent 编排器
Layer 04
Skills 工具集
可复用的"做事方式"
搜索 / 抓取 Markdown 写作 HTML 报告生成 天气 / 财经 / 日历 记忆 / 上下文
Layer 05
数据与产出
持久化 & 反馈
本地 SQLite / 笔记库 HTML 报告静态托管 评论与修复日志
Flow
一份攻略是怎么从 0 到 1 的
- 1
Kang 在小程序说"做一份京都 5 日攻略"
小程序把任务 POST 到家庭电脑的 webhook 端点，附带 session、用户偏好、预算。
- 2
家庭电脑的 Agent 接到任务
解析意图 → 拆解子任务（景点 / 交通 / 住宿 / 餐厅 / 天气）→ 选择要用的 Skills。
- 3
Skills 并行执行
搜索 Skill 拉资料，写作 Skill 起草，HTML Skill 套模板。各 Skill 之间用结构化数据通讯。
- 4
HTML 报告生成
渲染模板，注入数据，输出 kyoto-5-days.html，存到家庭电脑的静态目录。
- 5
推回客户端
小程序 / Web 拿到链接，在阅读器里展示，右侧是侧栏评论区。
- 6
Chen 评论 + 一键修复
"Day3 走太多路" → 评论触发 Agent 改稿 → 报告版本 v2 推送 → 旧版存档。
Why this works
为什么这个架构对我们够用
能拆能换
每个能力都是一个独立的小模块，好用就保留，不好用就拆掉重写。
让 Agent 自己拆任务
我们不写死流程，提需求、怎么干、中间怎么调整，都让 Agent 现场决定。
数据留在家里
日程、待办、纪念日都留家里那台 Mac mini，出门访问走加密通道。
失败能回头
每一步都有上下文快照，出问题可以从任意一步重试，不会从头来过。