mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-03 15:53:56 +00:00
docs: 全面按当前源码更新文档 + 删除已过时文档
## 删除(内容已落地/已被替换,保留只会误导)
- demo.md ................... failback 与 recoverydiag 均已实现,0 引用
- docs/defect-qq-output-send-loop.md .. 已修复(本身也标了「已修复」),0 引用
- docs/embedding-comparison.md ....... 一次性选型报告,仅被 agent 产物引用
- docs/zh/plan.md ............ 描述的旧 nav 布局已重写、死配置已清,全部完成
- docs/zh/plugin-migration-plan.md ... 迁移已上生产,纯过程稿(Part 0~6 全完成)
## 更新(按当前源码核对)
- assets/docs/{zh,en}/ARCHITECTURE.md(README 指向的用户文档,最重要):
把只讲 cancel/intercept 的旧「中断机制」章节重写为「输入调度器与中断机制」——
补上两类别 + 四级中断(L1~L4,默认 L1、外部插件 L4 夹到 L3)+ 抢占/挂起/中断栈
+ 饥饿防护(PreemptCount 提升,封顶 L4)+ 抢占冷却(2s)+ 停止语义(cancelBudget)
+ 驻留子/分诊助手/残余任务;新增「上下文预算」章节(窗口 ≠ 工作面,600K 封顶,
预算是上限非填充目标)。中英章节数现已对齐(各 13 节)。
- assets/docs/{zh,en}/PLUGIN_DEV.md:插件示例表补 6 个缺失项
(acp/deepsearch/plugindev/recoverydiag/vanblog/vikunja);qq 工具数 17 → 20(实测)。
- README.md / README_EN.md:补 v1.3.x 线(此前只到 v1.2.0,而 1.3.x 已发布 12 个 patch)——
驻留式子 agent、输出通道寻址、输入调度器、轻量内核 profile、积压及时反馈。
- plan.md:开头两个「⚠️ 紧急/正在持续污染」是过期告警(实测 残留 = 0),
改为「已解决」并加文档定位说明;§13 仍是活跃路线图故保留。
- docs/zh/plugin-interface-matrix.md + 两处源码注释:清理指向已删文档的断链。
全仓 md 断链检查:仅剩 1 处,位于 third_party 的 oh_modules(第三方依赖,非本项目)。
This commit is contained in:
22
plan.md
22
plan.md
@ -1,5 +1,11 @@
|
||||
# HomeAgent 生产问题修复计划
|
||||
|
||||
> **文档定位(2026-09-19 核)**:本文是**历史工单 + 仍活跃路线图**的混合档。
|
||||
> 开头 §0.1/§0.2 的两个「紧急」项与 §1~§11 的历史条目**均已解决**(见各节勾选),
|
||||
> 下方 §13 是**仍活跃**的推进路线图。想知道当前架构请读
|
||||
> `assets/docs/zh/ARCHITECTURE.md`;想知道当前调度/驻留子设计请读
|
||||
> `docs/zh/input-scheduler-design.md` 与 `docs/zh/resident-subagent-design.md`。
|
||||
|
||||
## 设计意图备忘(核心架构原则)
|
||||
|
||||
本框架的两大核心设计意图,贯穿所有插件/记忆/工具设计,**所有改动必须符合**:
|
||||
@ -14,9 +20,13 @@
|
||||
|
||||
---
|
||||
|
||||
## 0.1 紧急:healthcheck 健康检查污染真实存储 ⚠️ 正在持续污染
|
||||
## 0.1 ~~紧急~~ 已解决:healthcheck 健康检查污染真实存储
|
||||
|
||||
**现象**(2026-08-11 22:02 起,每 30 分钟一次):日志反复出现
|
||||
> **状态:已修复(2026-09-19 实测确认)**。本文保留为定位过程记录。
|
||||
> 验证方式:`ls /home/newqqagent/knowledge/ | grep -c _hc_` = 0;
|
||||
> `memory/graph.db` 内 `_hc_` 表/行 = 0(用 sqlite3 查 sqlite_master)。
|
||||
|
||||
**当时的现象**(2026-08-11 22:02 起,每 30 分钟一次):日志反复出现
|
||||
`[knowledge] added: _hc_knowledge_test_<ts>`,且知识库出现 `gotest`、`luatest`、`_hc_knowledge_test_*` 等测试残留。
|
||||
|
||||
**根因**:`internal/plugins/healthcheck/plugin.go` 的三个"写入通道"自检**全部在真实生产存储上写入再删除**:
|
||||
@ -41,7 +51,7 @@
|
||||
|
||||
---
|
||||
|
||||
## 0.2 紧急:QQ 消息被无视(agentcli 幽灵终端自喂送风暴)⚠️ 优先处理
|
||||
## 0.2 ~~紧急~~ 已解决:QQ 消息被无视(agentcli 幽灵终端自喂送风暴)
|
||||
|
||||
**现象**(2026-08-11 20:4x):用户发 QQ 私聊消息,agent 不回应。日志显示 agent 被 `agentcli` 终端 echo 洪水完全阻塞。
|
||||
|
||||
@ -923,7 +933,8 @@ context 累积导致的内存增长。
|
||||
> 三项合入门禁**已全部通过**:`make test` 零失败、`go vet ./...` 无告警、
|
||||
> `git diff main -- third_party/homeagent-sdk/sdk/` 为空(接口冻结不变量)。
|
||||
>
|
||||
> 详细执行记录见 `docs/zh/plugin-migration-plan.md`(Part 0~6 全部标记完成)。
|
||||
> 迁移的执行记录(Part 0~6 过程稿)已随迁移完成而删除;论证与实验数据仍见
|
||||
> `docs/zh/架构迁移评估.md`。
|
||||
|
||||
### 12.1 ✅ 已完成:合并到 main + 发布分支(2026-09-03 ~ 09-06)
|
||||
|
||||
@ -956,8 +967,7 @@ SDK 仓 `v1.0.0` / `v1.1.0`。main 的版本路牌现为 `1.2.0`(尚无 tag)
|
||||
|
||||
### 12.2 验收清单里两项**未达成**的目标
|
||||
|
||||
这两项在 `docs/zh/plugin-migration-plan.md` 的最终验收清单里如实标了 ⚠️,
|
||||
不是遗漏而是明确的未兑现承诺。
|
||||
这两项在迁移过程稿的最终验收清单里如实标了 ⚠️,不是遗漏而是明确的未兑现承诺。
|
||||
|
||||
#### 12.2.1 `SetToolBlocks` 仍是未实现(承诺未兑现)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user