mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-15 12:15:11 +00:00
b6a6168e65
SDK 仓已迁到 GitHub 作为权威源，go module 路径同步： `gitcode.com/JianFeeeee/homeagent-sdk` → `github.com/JianFeeeee/homeagentsdk` ## 范围 74 个文件：71 个 Go 源码 + go.mod/go.sum + hmapdev 模板 + CI 与打包脚本。 主仓（HomeAgent）侧对应改动是 6d38a164。本仓这些文件当时**不在工作树上** （见下），所以那次的批量替换扫不到它们——这里是补偿。 ## 为何这批文件当时不在工作树上（事故与恢复） 10-08 07:58 主仓做 checkout/cherry-pick 序列时，把本仓工作树的 20 个文件 误清理了（`example/*/plugin.go` + `plg.json`，10 个示例）。 根因是**结构误判**：本仓是「一目录两仓库」结构下主仓 `third_party/` 里的 **独立 git 仓库**，而主仓 .gitignore 忽略了 `example/`，于是它在主仓 `git status` 里不可见 —— 看着像「不受跟踪的构建产物」，实际是本仓受跟踪的源码。 已全部恢复（`git checkout -- <D 文件>`，只恢复删除、不动迁移改动）， 20 个文件与 HEAD 逐字节一致。 **破坏的连锁后果**：恢复出来的 `plugin.go` 仍写着旧 module 路径， 因为迁移时它们已不在工作树上。所以这次补偿是必须的，不是可选优化。 ## 保留 gitcode 引用 以下位置的 `gitcode` **有意保留**，不要"顺手清掉"： - README.md / docs 里「二进制实际分发地址目前是 gitcode」的说明 - mkdocs.yml 的 gitcode 镜像链接（国内直连更快） - `tools/hmapdev/templates.go` 里「SDK 已从 gitcode 迁到 GitHub」的注释 gitcode 仍是**只读镜像**（源码同步；release 附件暂时仍在那边）。 ## 验证 - 本仓根 module：`go build ./...` + `go test ./...` 全通过 - 全部 20 个 example：`go vet` 通过（补偿前 10 个因旧 module 路径失败） - example/qq：`go test` 通过，且能从源码 build 出可用 plugin 产物
recoverydiag · 快速检查 / 崩溃取证
给 guard 与 failback 用的确定性诊断工具集。
设计基调（源码原话）：返回结论而非原文，确定性检出，不消耗 LLM token。 崩溃后最忌讳的是把几万行日志塞进模型上下文让它"看看"，那既慢又不可靠 —— 这里每个工具都在本地算出结论再返回。
工具
| 工具 | 说明 |
|---|---|
recoverydiag_diag_triage |
快速分诊：按退出码 / 信号 / 存活状态粗分类别（进程死亡 vs 配置类不可达 vs 正常） |
recoverydiag_diag_db |
config.db 完整性（PRAGMA integrity_check）+ LLM 源解析校验（core.llm.sources.* 必备字段），逐项 ok/fail |
recoverydiag_diag_log_scan |
在日志目录的时间窗内统计已知错误签名（panic / OOM / 网络不可达 / provider 失败 / sql / 致命）出现次数，给出主导结论 |
recoverydiag_diag_delta |
对比 baseline（上次 good 快照/目录）与现状，列出 created / modified / deleted 清单与摘要，判定"改了什么" |
recoverydiag_diag_loc |
综合前四项结论，按因果强度正交排序定位根因并给出推荐恢复动作 |
用法顺序
diag_triage → diag_db → diag_log_scan → diag_delta → diag_loc
（各自独立，可只跑需要的） （要传前四项的结论）
diag_loc 需要你把它余下的结论作为参数传进去（triage / db / log / delta 四个对象），
它不自己去调 —— 这样它只做归因，不重复执行。
配置项
| 键 | 默认 | 说明 |
|---|---|---|
db_check_cmd |
auto |
diag_db 用的 sqlite3 命令。留空=auto：可用时用 sqlite3，缺失则回退读内核 Settings |
recovery_kb_dir |
空 | diag_loc 结论 JSON 的落盘目录。缺省 <data_dir>/recovery_kb |
不注册通道与钩子
本插件只提供工具，不订阅输入、不挂阶段钩子 —— 它是被 guard 或 agent 主动调用的， 不做后台干预。
测试
go test -count=1 ./...
diag_test.go 覆盖各诊断项的判定逻辑。
构建
hmapdev build