homeagent-sdk

jianf/homeagent-sdk

Fork 0

mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-10-15 12:15:11 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	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
JianFeeeee	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
JianFeeeee	83a54f321e	fix(hmapdev): 工具链能报出版本（此前 -ldflags -X meta.Version 静默无效）两个缺口叠加：既没有 `version` 子命令，构建时的 `-ldflags "-X gitcode.com/JianFeeeee/homeagent-sdk/meta.Version=…"` 也因为 meta 包根本没被工具链引用而完全不生效（链接器不会保留未被引用的符号， rodata 里连那个字符串都没有）——于是「手里是哪一版 hmapdev」无从判断，而插件产物与内核是协议绑定的，这恰恰是最需要判断的一件事（v0.8.0 SDK 陈旧目录导致模板编译失败那次就是靠猜）。 - main.go 引用 meta 包并新增 `version`（以及 `-v/--version`）子命令，输出工具链版本 / SDK 模块 / 构建提交 / 构建时间 / 构建用 Go / 可执行文件路径； - 未注入（源码默认值）时也照常报，unknown 字段不打印（避免噪声）； - usage 里补上 `hmapdev version`； - 加测试钉住两件事：注入值必须出现在输出里（-X 一旦失效立刻变红）、未注入时也要能报出源码默认版本。验证：`go build` 默认输出 1.3.0（主干默认值）；`-X …meta.Version=1.2.1 -X …meta.Commit=abc1234` 后输出 1.2.1 + 提交号，且二进制内精确匹配到该串（说明注入真的进了镜像）；`go test -run PrintVersion` 2/2 PASS。	2026-09-12 15:08:56 +08:00

Author

SHA1

Message

Date

JianFeeeee

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

JianFeeeee

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

JianFeeeee

83a54f321e

fix(hmapdev): 工具链能报出版本（此前 -ldflags -X meta.Version 静默无效）

两个缺口叠加：既没有 `version` 子命令，构建时的
`-ldflags "-X gitcode.com/JianFeeeee/homeagent-sdk/meta.Version=…"` 也因为
**meta 包根本没被工具链引用**而完全不生效（链接器不会保留未被引用的符号，
rodata 里连那个字符串都没有）——于是「手里是哪一版 hmapdev」无从判断，
而插件产物与内核是协议绑定的，这恰恰是最需要判断的一件事（v0.8.0 SDK 陈旧目录
导致模板编译失败那次就是靠猜）。

- main.go 引用 meta 包并新增 `version`（以及 `-v/--version`）子命令，
  输出工具链版本 / SDK 模块 / 构建提交 / 构建时间 / 构建用 Go / 可执行文件路径；
- 未注入（源码默认值）时也照常报，unknown 字段不打印（避免噪声）；
- usage 里补上 `hmapdev version`；
- 加测试钉住两件事：注入值必须出现在输出里（-X 一旦失效立刻变红）、
  未注入时也要能报出源码默认版本。

验证：`go build` 默认输出 1.3.0（主干默认值）；`-X …meta.Version=1.2.1
-X …meta.Commit=abc1234` 后输出 1.2.1 + 提交号，且二进制内精确匹配到该串
（说明注入真的进了镜像）；`go test -run PrintVersion` 2/2 PASS。

2026-09-12 15:08:56 +08:00

3 Commits