# 葫芦宝（HoluBot）项目白皮书 v1.0.0 当前现实版 发布日期：2026-05-06 版本定位：1.0.0 正式发布版 主题：有记忆、有温度、会成长的 AI 伙伴控制台 --- ## 0. 一句话 **葫芦宝（HoluBot）是一个有记忆、有温度、会成长的 AI 伙伴系统。** 它不是单一聊天机器人，也不是只会执行命令的 Agent。它有控制平面，能区分任务大小；有法宝和场景包，能调用不同能力；有记忆温度，能动态决定什么该被想起；有灵魂关切，能在低打扰边界内主动关心；有技能进化，能从运行经验里沉淀规则；还有运维健康闭环，让这些能力不只是概念，而是可运行、可观察、可回滚。 当前 v1.0.0 的重点不是宣称“完全体”，而是给出一个真实可发布的工程版本： > **HoluBot v1.0.0：核心系统能跑，发布检查能过，特色能力有代码和测试支撑，进入正式发布。** 当前发布状态、发布验证结果与已知非阻塞项，详见： - `document/1.0.0/HoluBot_v1_0_0_发布说明_2026-05-06.md` --- ## 1. 项目定位 ### 1.1 HoluBot 要解决什么问题 当前 AI 产品大致分成两类： - 工具型 Agent：执行力强，但不认识用户，不关心用户，也不太记得用户； - 陪伴型 AI：表达有温度，但缺少稳定完成真实任务的能力。 HoluBot 选择中间那条更难的路： ```text 伙伴体验 + Agent 执行力 + 可治理运行时 ``` 它既要能聊天、陪伴、主动关切，也要能搜索、写报告、做周报、调工具、处理多步骤任务；同时还要知道边界、记录状态、允许检查、能够回滚。 ### 1.2 当前产品形态 v1.0.0 当前产品形态可以概括为： ```text 多渠道 AI 伙伴 + 桌面控制台 + 控制平面 + 三层执行 + 法宝系统 + 记忆温度 + 灵魂关切 + 技能进化 + 运维健康闭环 ``` 当前桌面端已经进入六栏目控制台结构的可用版本： - 对话 - 状态 - 拓扑 - 法宝 - 日志 - 设置 这里的“已具备”应理解为： - 页面框架与栏目结构已打通； - 桌面 API 已能支撑主要页面； - 桌面端可作为 1.0.0 控制台使用； - 但视觉、交互和长期使用体验仍不是最终终版。 桌面端在 v1.0.0 中是“可用控制台”，不是视觉终版。系统运行稳定性与发布闭环优先于视觉精修。 --- ## 2. 当前架构现实 ### 2.1 总体链路 ```text 用户输入 Telegram / QQ / 飞书 / Discord / Desktop / Voice │ ▼ 渠道层 / Dispatcher 身份归一、消息归一、文件/语音接入 │ ▼ ControlPlane 安全门、路由、确认流、法宝匹配、执行计划 │ ▼ EnvelopeBuilder 记忆温度、场景策略、执行上下文、法宝能力 │ ▼ 执行层 fastpath / chat / Nimbus / Marshal │ ▼ Output Gate + PostProcessor 输出治理、记忆写入、灵魂关切信号、技能经验沉淀 │ ▼ 运维与观测 status snapshot、ops health、release check、logs ``` ### 2.2 三层执行 | 层级 | 适用任务 | 当前实现 | |---|---|---| | 小事 | 问候、简单问答、能力说明 | fastpath / chat / direct response | | 中事 | 搜索、摘要、结构化产出 | Nimbus / runtime tools | | 大事 | 工程任务、复杂多步执行 | Marshal / CLI 军团 | HoluBot 不把所有请求都塞进同一条链路。它会先判断任务大小，再决定是否需要升级到更重的执行层。 ### 2.3 控制平面 当前 ControlPlane 承担： - 安全门与策略门； - capability question 特判； - pending confirmation； - tool pack install； - trace resume； - DispatchPlanner； - EnvelopeBuilder； - Adapter 选择； - output gate； - PostProcessor； - checkpoint 与审计。 这意味着 HoluBot 当前不是“一个 prompt 加一些工具”，而是一个有运行时治理的控制平面系统。 --- ## 3. 三大特色能力 ### 3.1 记忆温度：记得住，也知道什么该先想起 记忆温度是当前最成熟的特色能力。 相关模块： ```text holu_memory/temperature_engine.py holu_memory/query.py holu_memory/store.py holu_memory/canonical_runtime.py core/envelope_builder.py ``` 当前能力： - 记忆带有 `temperature`； - 重要度可映射为初始温度； - 记忆可随时间衰减； - hot memories 会优先注入上下文； - hybrid recall 会结合温度和语义相关性； - 场景不同，注入数量不同； - 低温记忆不会无限占用上下文。 发布状态： ```text 成熟度：A- 口径：稳定能力，可作为正式特色 ``` 推荐产品表达： > HoluBot 不是把所有记忆一股脑塞进上下文，而是像人一样，有些记忆滚烫，有些记忆沉淀。重要、近期、相关的内容会更容易被想起。 ### 3.2 灵魂关切：会主动关心，但不骚扰 灵魂关切是 HoluBot 区别于普通 Agent 的核心体验之一。 相关模块： ```text engines/soul_care/ core/post_processor.py core/dispatcher.py main.py scripts/run_soul_care_qq_smoke.sh ``` 当前能力： - 关切信号检测； - 高/中/低风险分层； - follow-up 事件； - CareScheduler； - PushBudget； - PushSender； - FatigueGuard； - CarePreferenceStore； - QQ fallback smoke； - 安静时段与频率偏好； - 主进程 ticker 接线。 当前数据： - `care_events` 有真实记录； - `care_preferences` 有用户偏好记录； - QQ smoke 已通过。 发布状态： ```text 成熟度：B+ 口径：最小闭环已跑通，灰度发布 ``` 推荐产品表达： > HoluBot 可以在合适的时候主动跟进，但它不是无脑推送。它有偏好、有安静时段、有疲劳门、有预算。 当前限制： - 真实用户触达样本还需要积累； - 打扰率、命中率、长期留存效果仍需灰度期观察； - 不应宣传成完全成熟的心理陪伴或医疗干预系统。 ### 3.3 技能进化：从经验里长出规则 技能进化是后台飞轮，不是前台炫技。 相关模块： ```text engines/skill_evolution/ core/hooks/skill_lesson_sink_hook.py core/envelope_builder.py main.py scripts/holubot_skill_evolution.py workspace/skill_evolution/runs/ ``` 当前能力： - Hook 可沉淀 skill lesson candidates； - 周期任务可分析历史运行结果； - 可生成 `skill_rules`； - 可更新已有 route 经验； - 可生成 SoulCare 词表建议； - 可进入 skill review 流程。 当前数据： - `skill_rules` 已有规则沉淀； - `workspace/skill_evolution/runs/` 已持续生成周期报告； - 最新手工周期可运行并更新规则。 发布状态： ```text 成熟度：B 口径：后台闭环已跑通，真实飞轮仍在积累样本 ``` 推荐产品表达： > HoluBot 会把运行经验沉淀成规则，随着真实任务样本增加，逐步优化自己的执行习惯。 当前限制： - `skill_lesson_candidates` 样本仍少； - `promoted_lessons` 保守； - 更强的自我进化需要更多真实用户任务与反馈。 --- ## 4. repo-local engines：发布结构变化 v1.0.0 之前，部分核心引擎依赖外部包 `holubot-engines`。这对开发方便，但对发布不稳。 v1.0.0 已将核心 engines 纳入当前仓库： ```text engines/ soul_care/ skill_evolution/ token_budget/ trust_adaptive/ quality_score/ ``` 这带来三个变化： 1. 发布包不再依赖本机路径 `/Users/moxi/Documents/holubot-engines`； 2. 新机器部署时不需要额外 editable install 才能启动核心引擎； 3. 白皮书与发布说明必须从“外部闭源包”口径改为“随仓库发布的核心引擎”口径。 当前 `scripts/start_demo.sh` 仍保留外部 fallback，这对开发环境兼容有价值；但发布包应优先使用 repo-local engines。 --- ## 5. 法宝与场景包 HoluBot 的“法宝”不是简单 prompt，而是运行时能力单元。 当前结构： ```text runtime_assets/ scene_packs/ pocket.py treasure_forge.py core/runtime_route_registry.py ``` 法宝可以包含： - 能力说明； - 触发关键词； - 工具调用； - 知识库； - 运行建议； - trust level； - enabled state； - scene/capability policy。 当前已具备的发布级法宝方向包括： - 深度搜索； - 周报； - AI 哨兵； - 老人陪伴场景； - 天气、用药、脑力练习等老人服务能力； - know-yourself 等自我理解类能力仍在 staging/素材整理中。 --- ## 6. 运维健康闭环 v1.0.0 的一项重要进步是：系统状态不再靠主观判断。 当前运维链路包括： ```text scripts/holubot_status_snapshot.py scripts/holubot_ops_health_overview.py scripts/holubot_ops_health_status.sh scripts/holubot_ops_health_smoke_check.sh scripts/run_ops_health_release_check_logged.sh scripts/holubot_release_check_trend_report.py scripts/holubot_ops_health_brief_report.py scripts/holubot_ops_reports_retention.py ``` 当前状态口径： - runtime 在线：`runtime_up` - ops overview：`ok` - release check：`ok` - release consistency：`ok` - observe gate 样本不足：冷启动观测态，不阻塞发布； - router outcome 样本不足：灰度观测项，不阻塞发布。 这意味着 v1.0.0 可以被描述为： > 可运行、可验证、可灰度、可回滚。 --- ## 7. 桌面控制台 当前桌面端已经不是单聊天页，而是六栏目桌面控制台： ```text 对话 / 状态 / 拓扑 / 法宝 / 日志 / 设置 ``` 当前定位： - 对话页：日常工作台； - 状态页：系统运行 dashboard； - 拓扑页：系统结构与节点； - 法宝页：能力中心； - 日志页：近期事件与异常摘要； - 设置页：正式配置入口。 桌面端当前足以作为 1.0.0 控制台使用，但仍不是最终设计精修版。v1.0.0 发布不应把桌面视觉作为主要卖点，主要卖点仍是系统能力与运行闭环。 --- ## 8. 安全与边界 HoluBot 的关心和成长必须被治理。 当前安全边界包括： - SafetyGate； - route gate； - runtime boundary； - tool policy； - output gate； - denial rewrite； - source coverage notice； - hook observe gate； - ops health audit； - trust adaptive； - fatigue guard； - push budget。 特别是灵魂关切，必须坚持： - 不做医疗诊断； - 不伪装真人； - 高风险表达要谨慎处理； - 主动触达必须受频率、安静时段、疲劳门控制； - 用户应能配置偏好或暂停。 --- ## 9. 当前成熟度总表 | 能力 | 当前成熟度 | 发布口径 | |---|---:|---| | 控制平面 | A- | 已形成主链路 | | 三层执行 | A- | 已工程化落地 | | 记忆温度 | A- | 稳定特色 | | 灵魂关切 | B+ | 最小闭环，灰度观测 | | 技能进化 | B | 后台闭环，样本积累中 | | Token 预算 | B | engines 已随仓库发布，仍需更多前台指标展示 | | 信任自适应 | B | engines 已随仓库发布，策略仍需场景化打磨 | | 质量评分 | B | engines 已随仓库发布，质量日报已进入运维链路 | | 法宝系统 | B+ | 已可用，资产仍需归档整理 | | 桌面控制台 | B | 六页结构已成，视觉和交互仍可提升 | | 运维健康闭环 | A- | 发布检查链路可用 | --- ## 10. 当前版本能力边界 ### 10.1 已完成并可作为发布能力说明 - 控制平面主链路 - 三层执行结构 - 记忆温度 - 多渠道基础接入 - 发布检查与运维健康闭环 - 桌面控制台基础框架 ### 10.2 已完成最小闭环，进入灰度观察 - 灵魂关切 - 技能进化 - observe gate 冷启动观测 - router outcome 相关灰度观测项 ### 10.3 已进入结构建设，但不承诺完全成熟 - 桌面端视觉终稿与长期交互精修 - 更大规模真实样本驱动的技能进化飞轮 - 更稳定的主动关切效果评估体系 - 全量法宝/场景资产的正式归档与产品化包装 --- ## 11. 1.0.0 发布边界 v1.0.0 可以承诺： - 系统可以启动； - 桌面 API 可用； - 核心运行状态可检查； - 发布检查可重复执行； - 记忆温度进入主链路； - 灵魂关切最小闭环可运行； - 技能进化后台周期可运行； - engines 随仓库发布； - 出现异常时有状态快照和 run log 可追踪。 v1.0.0 不应承诺： - 桌面端已是最终视觉形态； - 灵魂关切已经等同成熟心理陪伴； - 技能进化已经完全自主改造系统； - 所有场景包和法宝资产都已完成正式归档； - 当前分支已经无任何实验文件或历史素材。 --- ## 12. 未来收口路线 ### 11.1 发布包整理 - 确认哪些 `runtime_assets/` 与 `scene_packs/` 进入正式包； - 清理未归属实验文件； - 固化 release tag； - 生成可复现安装包。 ### 11.2 桌面端体验 - 补视觉统一； - 补空态、加载态、错误态； - 加强状态页与日志页的信息解释； - 做移动宽度或小屏兜底。 ### 11.3 灵魂关切灰度 - 积累真实触达样本； - 观察打扰率； - 增加用户偏好入口； - 明确高风险表达处理策略。 ### 11.4 技能进化飞轮 - 增加真实 skill lesson candidates； - 提高 route outcome 覆盖； - 明确晋升、降级、回滚策略； - 将规则变化接入更清晰的审阅界面。 --- ## 12. 最终定位 HoluBot v1.0.0 的真实价值，不是“又做了一个 Agent”，而是： > 把记忆、关切、成长、执行、治理放进同一个可运行系统里。 这就是当前版本可以发布的理由。 它还不是终点，但已经从概念走到了系统。