|
|
e0ee0c43bb
|
fix(hmapdev): SDK 模块识别要认新旧两个 module 名（迁移漏改的逻辑判定）
上一提交（b6a6168）只替换了 import 路径，**漏了用旧 module 名做逻辑判定
的五处**。CI 当场抓到一处（`TestPrintVersionReportsInjectedVersion`），
但那是测试断言；另外三处是**产品逻辑**，CI 抓不到，是静默失效。
## 漏改的地方
| 位置 | 原判定 | 失效后果 |
|---|---|---|
| `cmd_build.go` | `Contains(mod,"homeagent-sdk")` | 认不出 SDK 依赖 ⇒ **不写 replace** |
| `cmd_skill.go` | `Contains(gm,"homeagent-sdk")` | 认不出 SDK 仓 ⇒ 不安装 skills |
| `yaegi/interp.go` ×2 | `Contains(line,"homeagent-sdk")` | `findSDKGoPath` 找不到 SDK ⇒ 退化到兜底 |
迁移后这些 `Contains` **恒为假**（新名是 `homeagentsdk`，没有连字符）。
三者都**不报错**，只是行为悄悄变成另一条分支——比直接崩更难发现。
## 关键：不能只认新名
本机实测存量插件工作区的 go.mod **全部仍是旧名**：
```
/home/program/qq-plugin (无 go.mod)
/home/program/vanblog-plugin require gitcode.com/JianFeeeee/homeagent-sdk
/home/program/mcquery-plugin require gitcode.com/JianFeeeee/homeagent-sdk
/home/program/fileproc-plugin require gitcode.com/JianFeeeee/homeagent-sdk
/home/program/agentmail/plugins/ require gitcode.com/JianFeeeee/homeagent-sdk
```
用户已创建的项目不会因为我们改仓就自动更新。所以判定必须
**两种都接受**，而不是把旧名换成新名（那只是把 bug 从"认不出新"换成"认不出旧"）。
## 改动
- `meta` 补 `SDKModule` / `LegacySDKModule` 常量（原注释引用了 `SDKModule`
但常量并不存在——注释先于实现）
- 新增 `tools/hmapdev/sdkmodule.go`：`isSDKModule` / `sdkModulePath` /
`containsSDKModule`
- 新增 `tools/hmapdev/yaegi/sdkmodule.go`：同语义的最小副本
（yaegi 是独立子包，不能 import 父包）
- 三处逻辑判定改用上述助手
## 判据（可杀变异，逐个实测）
`sdkmodule_test.go` + `yaegi/sdkmodule_test.go`：覆盖新名/旧名/带版本号的
旧名/空串/核心仓（`HomeAgent`，不是 SDK）/无关模块。
这三个判定点**此前零测试覆盖**——这正是它们能静默失效的原因。
变异验证：
- 只认新名 → FAIL「旧名漏认会让存量插件静默走错分支」
- `containsSDKModule` 只认新名 → FAIL「必须认旧名」
## 验证
- SDK 根 module + hmapdev module：`go build` / `go test` 全通过
- 20 个 example `go vet` 全通过
- `go mod verify` → all modules verified
|
2026-10-09 07:32:00 +08:00 |
|
|
|
b6a6168e65
|
chore(module)!: module 路径随托管地迁移 gitcode → github
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 产物
|
2026-10-09 07:25:25 +08:00 |
|
|
|
1d7c330cfc
|
fix(hmapdev): mocksdk 补齐 ToolDef 声明项，并加字段/类型一致性判据
## 问题
mocksdk（yaegi 解释执行时的替身 SDK）的 ToolDef 只有 6 个字段，
公共 SDK 已有 10 个 —— 缺 RecallPolicy / ParallelSafe / Serial。
★ 危害不在编译期，而在**调试期**：插件作者用 hmapdev 在本地解释执行时，
写了 ParallelSafe:true 照常跑、不报错；直到编译安装后才发现声明根本没
被内核读到。这类不一致不会让任何现有测试失败。
这正是"黑名单不会自动跟上新执行能力"的又一次复现：主 SDK 每加一个声明项，
替身不会自动跟上。
## 修复
① mocksdk/plugin.go 补齐 RecallPolicy / ParallelSafe / Serial 三个字段，
注释写明"主 SDK 先加、mocksdk 没跟上"这段历史，避免后人再漂移。
② 新增 yaegi/mocksdk/parity_test.go：
- TestMockSDKToolDefMatchesSDK 比对**字段名**集合，双向都查
（少字段 = 声明静默失效；多字段 = 替身比本体还多，必有一方理解错了）
- TestMockSDKToolDefTypesMatch 比对**字段类型**，逐个断言
★ 归一化必须抹掉所有空白：gofmt 打印 "interface{}" 而反射给
"interface {}"，这是打印格式差异。我第一版没抹空白，
结果每个复合类型都被误报成"类型不符" —— 判据自己制造假警报。
判据放在 tools/hmapdev 模块内（它是独立 module，主模块不包含它），
跑法：cd tools/hmapdev && go test ./yaegi/mocksdk/
|
2026-09-27 16:17:04 +08:00 |
|
|
|
b237787c90
|
refactor(toolchain)!: 工具链 plugindev 更名为 hmapdev，module path 改回 gitcode
- 目录 tools/plugindev → tools/hmapdev，可执行文件名/平台产物名同步
（hmapdev_linux_amd64 等；包格式仍叫 .hmap）
- module path github.com/JianFeeeee/homeagent-sdk/tools/... → gitcode.com/...
（与仓库实际托管一致；核心仓不依赖该 path，改动无外部影响）
- SDK 存储目录 ~/.homeagent/plugindev/sdk → ~/.homeagent/hmapdev/sdk
新目录不存在而旧目录存在时沿用旧目录 → 已装 SDK 版本不会丢失
- 命令表/usage/--help/生成项目 README/示例 README/NSIS 安装器/
package/build.sh/build-examples.sh 全部同步；PLUGINDEV 环境变量保留兼容
- sdk/ 目录零改动（公开接口不变）
验证：
- go build ./... ok；go test ./tools/hmapdev/ ok（含模板接线守卫 TestProcTemplate_CoversAllCoreMethods）
- bash -n package/{build,build-examples}.sh ok
- 端到端：hmapdev init demo && hmapdev build → dist/demo_bundle.hmap（linux+darwin）
- 本机安装 /usr/local/bin/hmapdev，旧名以软链保留；sdk list/current 正常
|
2026-09-12 12:30:20 +08:00 |
|
