- 大多数框架先写功能再补边界。HomeAgent 反过来：先把 - 边界和调度定死，再往上加能力。 +
+ 先定边界与调度，再加能力。
- 内核不直接读写任何外部世界。收发消息、文件操作、网络请求、硬件交互 - 全部由插件经 PluginSDK 实现。于是「内核有多可信」与「某个插件有多安全」 - 成为两个可独立评估的问题。 + 内核不碰任何外部世界。消息、文件、网络、硬件全部由插件经 + PluginSDK 实现。于是「内核是否可信」与「某个插件是否安全」 + 可以分开评估。
- 外部插件编译成普通 Go 二进制，由内核 spawn 为子进程，经 - stdio JSON-RPC（控制）+ 共享内存段（数据）+ 事件环（通知）通信。 - 插件崩溃不影响内核，换掉 plugin.bin 即真热重载。 + 插件是普通 Go 二进制，由内核 spawn 为子进程，经 stdio JSON-RPC + （控制）、共享内存段（数据）、事件环（通知）通信。插件崩溃不牵连内核， + 换掉 plugin.bin 即热重载。
- 输入先进调度器，分「排队」与「中断」两类，中断再按“有多不能等”分 L1–L4。 - 高优先级可抢占并保存现场，同级不抢占。L4 只归内核 - —— 所以“停止”按钮真的能立刻停下。 + 输入分「排队」与「中断」两类，中断再按紧迫度分 L1–L4。 + 高级可抢占并保存现场，同级不抢占。L4 归内核独占 + —— 所以「停止」真的能立刻停下。
@@ -897,9 +1064,9 @@- 主 agent 执行长任务时，后来的消息不会干等十几分钟：内核把积压交给 - 临时分诊助手 —— 简单的直接办完，需要主 agent 的立刻回 - 「忙碌中，请稍候」。 + 主 agent 忙长任务时，积压交给临时分诊助手： + 能办的直接办，需要主 agent 的立刻回「忙碌中，请稍候」。 + 不必干等十几分钟。
@@ -911,8 +1078,8 @@- 不是一个向量库包打天下，而是三层各司其职、逐层衰减与整合。 - 品牌的蓝 / 青 / 金三色，对应的就是这三层。 + 不是一个大向量库包打天下，而是三层各司其职、逐层下沉。 + 蓝 / 青 / 金三色对应的就是这三层。
- 内存中的事件窗口，按与当前输入的相关性评分排序（预训练词向量 → 余弦相似度， - TF-IDF 回退），并保护最近若干条。低分事件自动下沉。 + 内存中的事件窗口。按与当前输入的相关性排序（预训练词向量 → 余弦相似度， + TF-IDF 回退），最近若干条受保护。低分事件自动下沉。
- JSON + TF-IDF 索引的中间层。支持显式提交与隐式归档； - 冷数据按时间下沉，蒸馏成三元组进入图谱。 + JSON + TF-IDF 索引的中间层。支持显式提交与隐式归档， + 冷数据下沉后蒸馏成三元组进入图谱。
- SQLite 持久化实体与关系，BFS 遍历召回。蒸馏管道从对话里提取三元组， - 越用越准；这是“几个月前的事还记得”的落点。 + SQLite 持久化实体与关系，BFS 遍历召回。三元组从对话中蒸馏而来， + 越用越准 —— 「几个月前的事还记得」靠的就是这层。
- 图片/音频不是附件，而是三层里的一类节点：内容寻址存储（相同字节只存一份）、 + 图片、音频不是附件，而是三层里的一类节点：内容寻址（相同字节只存一份）、 引用计数 GC（有引用绝不删）。
- 视觉模型生成的描述以 [mime digest] 描述 写进纯文本记忆并参与检索； - blob 只是可被淘汰的缓存。所以几个月后“那张三色图”仍能搜到。 + 视觉模型生成的描述以 [mime digest] 描述 写入纯文本记忆并参与检索， + blob 只是可淘汰的缓存。所以几个月后「那张三色图」仍搜得到。
- 文本与图像落在同一向量空间（默认 Chinese-CLIP）， - 因此可以用一句话搜图，也可以用图找相关记忆。 + 文本与图像落在同一向量空间（默认 Chinese-CLIP）： + 可以用一句话搜图，也可以用图找记忆。
- 输入先过调度器，再进处理管道；管道有 7 个阶段钩子，插件可在此改写或短路。 + 输入先过调度器，再进处理管道。管道有 7 个阶段钩子，插件可改写或短路。
- 依赖 Go 1.25+ 与 CGo（sqlite3）。内核需 Linux —— Windows 上 - homed 跑在 WSL2 里，只构建 waiter.exe。 + 依赖 Go 1.25+ 与 CGo（sqlite3）。内核需 Linux；Windows 上 + homed 跑在 WSL2 里，仅需构建 waiter.exe。
- WebUI 与 API 密钥在 http://localhost:8080 配置，持久化在 SQLite。 + WebUI 与 API 密钥在 http://localhost:8080 配置，持久化到 SQLite。
外部插件经 hmapdev 构建为独立二进制，可单独安装、卸载、热重载。
+外部插件经 hmapdev 构建为独立二进制，可单独装卸、热重载。点任意插件看它能做什么。
点上方任一插件查看用途
+a2av1.3.1Agent-to-Agent 协议通信插件，支持双向 A2A 通信：可查询其他 Agent 并回复其请求。提供 HTTP 服务端暴露本 Agent 能力。
+acpv1.2.1Agent Client Protocol 通信插件：充当 ACP 服务端接受其他 Agent 的任务请求，同时提供客户端工具向远程 ACP Agent（如 opencode）发起会话并读取回复
+biliv1.2.0B站视频下载工具，基于 yt-dlp 引擎。支持查看视频清晰度列表、指定格式下载、可配置下载目录。
+browserv2.4.1统一浏览器插件：搜索、HTTP抓取(quick)、无头渲染(normal)、交互式浏览器(interactive/CDP)
+calendarv1.1.0日历事件管理，支持提醒和重复事件
+deepsearchv1.1.2为 agent 提供真正的联网信息检索：本地 SearXNG 聚合多引擎（返回标题/URL/摘要/时间），支持新闻、时间范围、指定引擎；并提供网页正文抽取与「搜索+读前K篇」的深检索
+editdocv2.0.0全能办公插件：新建/读取/编辑/转换 docx·xlsx·pptx·md·csv·txt（基于 python-docx / openpyxl / python-pptx / soffice / pandoc）
+homeagent-mail-bridgev0.2.2HomeAgent 接入 AgentMail：邮件驱动的多智能体协作
+mcv0.1.8把 mineflayer 虚拟 MC 客户端封装为 HomeAgent 的 chan:mc IO 通道（两阶段激活 + 动作工具）
+memov1.1.0待办与备忘录插件。待办（todo_add/todo_complete/todo_list）会主动提醒；备忘录（memo_create/memo_list/memo_delete）纯记事不提醒。
+musicv0.1.0音乐搜索插件，支持搜索歌曲和查看歌词（基于网易云音乐）
+ocrv1.0.0图片文字识别工具，基于 Tesseract OCR 引擎。支持从 URL 或 base64 图片中提取文字内容。
+plugindevv1.0.0把 hmapdev 工具链封装成 Agent 可调用的工具：脚手架生成插件工程、构建打包 .hmap、管理 SDK 版本。配合 plugin_install 即可让 Agent 自己做完「新建插件 → 构建 → 安装」全流程。
+qqv1.4.1QQ 消息收发插件，通过 NapCat 协议桥接
+recoverydiagv0.2.0快速检查/崩溃取证工具集：diag_triage（退出码/信号/存活粗分）、diag_db（config.db 完整性 + LLM 源解析校验）、diag_log_scan（日志签名命中）、diag_delta（last-good 快照 vs 现状 diff）、diag_loc（正交综合定位）。全部返回结论而非原文，确定性、不消耗 LLM token，供 guard / failback 恢复决策使用。
+rssv1.1.0RSS/Atom 订阅监控插件，自动检测更新并推送通知
+sanitizerv0.1.0清洗 LLM 输出中的工具调用残留（思维泄漏）
+vanblogv1.0.0管理 VanBlog 开源博客系统：文章的增删改查、分类标签管理、草稿发布、备份导出等
+vikunjav1.0.1Vikunja 待办/任务管理：任务增删改查、项目与看板桶、标签、指派、评论、关联、附件、保存筛选器、团队与分享、通知、订阅、Webhook、时间跟踪、数据导入、实例管理；并附通用 API 直通工具兜底
+weatherv1.0.0天气查询插件（基于 wttr.in），支持实时天气和未来预报
+这些是设计上最容易引起误解的地方。
+最容易引起误解的六个地方。
- 恰恰相反——零 IO 是为了让内核能专注做难的部分：输入调度（四级中断、 - 抢占与现场保存）、上下文预算、三层记忆的蒸馏与召回。 - 把 IO 挪出去之后，这些才有清晰的所有权。 + 恰恰相反。零 IO 是为了让内核专注做难的部分：输入调度（四级中断、抢占与 + 现场保存）、上下文预算、三层记忆的蒸馏与召回。IO 挪出去之后，这些才有 + 清晰的所有权。
- 不会。从 v1.0.0 起外部插件是独立子进程，与内核只通过 - stdio JSON-RPC、共享内存段、事件环三个面通信。插件崩溃后内核摘除其 - 注册面（工具/阶段/通道）并按退避重启它，其余插件与内核不受影响。 + 不会。外部插件是独立子进程，与内核只通过 stdio JSON-RPC、共享内存段、 + 事件环通信。插件崩溃后，内核摘除它注册的工具、阶段与通道，按退避重启， + 其余部分不受影响。
- 因为同一时刻只应该有一个任务在改上下文。同级中断不抢占同级任务—— - 抢了会让两边都做一半。需要立刻插队的场景请用更高级别的中断 - （如 L4：内核与内核级插件），而不是让所有消息都变成抢占者。 + 因为同一时刻只应有一个任务在改上下文。同级抢占会让两边都做一半。 + 需要立刻插队时用更高级别的中断（如 L4：内核与内核级插件）， + 而不是让所有消息都变成抢占者。
- 这正是「分诊助手」要解决的。主 agent 忙超过阈值（默认 5 分钟）且积压够多时， - 内核会拉起一个临时驻留子接手积压：能直接办的办完并回复， - 需要主 agent 的立刻回一句「忙碌中，请稍候」。 + 这正是「分诊助手」的用途。主 agent 忙超阈值且积压够多时，内核拉起临时 + 驻留子接手：能办的直接办，需要主 agent 的立刻回「忙碌中，请稍候」。
- 不会。三层是迁移关系而不是复制：上下文事件被裁剪后归档成文档， - 文档冷掉后蒸馏成图谱三元组。图谱有去重与 UNIQUE 约束， - 媒体则靠引用计数 GC 回收无主内容。 + 不会。三层是迁移而非复制：上下文事件裁剪后归档成文档，文档冷掉后蒸馏成 + 图谱三元组。图谱有去重与 UNIQUE 约束，媒体靠引用计数 GC 回收无主内容。
- 可以。内核不绑定任何厂商：每个 LLM 源对应一个 Lua 脚本负责请求/响应转换， - 仓库内置 10 个适配器（OpenAI、Anthropic、Gemini、DeepSeek、Groq、Ollama 等）， - 也可以自己写一个接任意兼容 API。 + 可以。内核不绑定厂商：每个 LLM 源对应一个 Lua 脚本负责请求与响应转换。 + 内置 9 个适配器（OpenAI、Anthropic、Gemini、DeepSeek、Groq、Mistral、 + Ollama、GitHub、KimiCode），也可自己写一个接任意兼容 API。
- AI 辅助编程声明：本项目代码、文档与提交历史中，部分内容由 AI 辅助生成或修改。 - 人工已审阅关键改动，使用时请自行评估与验证。 + AI 辅助声明：本项目代码、文档与提交历史含 AI 生成或修改的内容。 + 关键改动经人工审阅，使用前请自行评估验证。
- HomeAgent 以 AGPL-3.0-only 发布：通过 HTTP 提供交互式服务时， - 须向使用者提供完整对应源码（§13）。 + AGPL-3.0-only。通过 HTTP 提供交互式服务时，须向使用者提供完整对应源码（§13）。