homeagent-sdk

jianf/homeagent-sdk

Fork 0

mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-10-02 15:14:37 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	5759e58bad	ci: 建立 CI —— 此前 main 的推送与 PR 完全没有检查 ## 缺口本仓此前只有 release.yml（只在 release/ 推送时跑）。也就是说推 main、开 PR 一律无检查，而 SDK 正是外部插件开发者直接依赖的契约面（sdk/plugin.go 接口一破，所有外部插件编译失败）。 ## 四个 job（每条命令都本地实测过） \| job \| 内容 \| 实测耗时 \| \|---\|---\|---\| \| go \| 根模块 build + vet + test \| <1s \| \| hmapdev \| 嵌套 module 测试 + 五平台交叉编译（矩阵） \| ~2s + 编译 \| \| examples \| 构建全部 20 个示例（linux/amd64、darwin/arm64） \| 9s / 21s \| \| consistency \| Lua SDK 三副本一致 + skills 可识别 + mkdocs --strict \| ~2s \| ## 三处「不能想当然」的地方（都有实测依据） 1. 示例不能用 `go build` 验。它们是插件（只有 plugin.go、没有 func main），必须由 hmapdev 注入 main 包装；直接 go build 得到 "function main is undeclared in the main package" —— 那不是缺陷，是方式不对。故与发版走同一个脚本（package/build-examples.sh），避免 CI 与发版路径分叉。 2. tools/hmapdev 是独立 module，根模块的 `go test ./...` 不会进入它 —— 必须单独跑，否则它的测试永远不在 CI 里执行（Go 的模块边界）。 3. 不能用 `yaml.safe_load` 校验 mkdocs.yml**：它含 mkdocs-material 的 `!!python/name:` 标签（配置 emoji 的官方写法），safe_load 报 ConstructorError —— 是校验方式不对。改用 `mkdocs build --strict` （本地实测 2s、0 warning）。 ## 明确不进 CI - `hmapdev skill install` —— 它会写开发者本机的 ~/.claude、~/.codex 等目录 - 需要内核仓在场的检查（本仓独立可测） - 任何网络/真机依赖 CGO_ENABLED=0（SDK 纯 Go，与主仓相反）。 actionlint 全绿（修掉一处 shellcheck SC2012）。	2026-09-29 15:18:58 +08:00
JianFeeeee	56c694cd7c	ci: gh release download 需显式 --repo 回读校验先 cd /tmp/back（非 git 目录），而 gh 默认从当前目录的 git 上下文推断仓库，于是报 "not a git repository" —— 发布本身成功（tag/release/附件齐全），却被这道校验误判为失败。改为 gh release download "$TAG" --repo "$GITHUB_REPOSITORY"。	2026-09-29 14:39:12 +08:00
JianFeeeee	dc9e7d0495	ci: SDK 仓发布流水线 —— release/ 推送即出 hmapdev 五平台产物与主仓 Release 流水线同构，差异只在产物与打包命令： prepare 读 meta.Version；tag 已存在则整轮跳过；go test 门可显式跳过（改 meta 的提交里写 [skip-release-tests]，查该提交而非 HEAD） build go build（硬门）→ go test → build.sh all hmapdev → 验证 5 平台齐全 → 生成 SHA256SUMS → artifact publish 打 tag → gh release create 传附件 → 回读校验 sync-gitcode 有 GITCODE_TOKEN 时同步（无则跳过）产物清单不是猜的，依 gitcode 上 v1.2.0/v1.3.0 的实际附件（各 6 个）： hmapdev_{linux,darwin}_{amd64,arm64} + hmapdev_windows_amd64.exe + SHA256SUMS 两个易错点都有实测依据： 1. 测试要分两处跑：tools/hmapdev 是独立 module，根模块的 `go test ./...` 不会进入它（Go 的模块边界，不是配置问题）。 2. gitcode 上传必须显式列文件名：上传脚本的路径语义是 `os.path.join(ASSET_DIR, name)`，所以要 cd 进目录 + `ASSET_DIR=.` + 裸名；而它按扩展名识别产物的默认扫描对 hmapdev 无效** —— 五个产物里只有 windows 那个有扩展名，自动扫描会静默地一个都不传。故把主仓的 upload_assets.py 一并纳入本仓 scripts/（两仓各自独立可取）。本地已验证：`VERSION=1.4.0 bash package/build.sh all hmapdev` 产出 5 个二进制（各 27–29M），根模块 go test 通过，actionlint 全绿。	2026-09-29 14:09:35 +08:00

Author

SHA1

Message

Date

JianFeeeee

5759e58bad

ci: 建立 CI —— 此前 main 的推送与 PR 完全没有检查

## 缺口

本仓此前**只有 release.yml**（只在 release/** 推送时跑）。也就是说
推 main、开 PR 一律无检查，而 SDK 正是外部插件开发者直接依赖的契约面
（sdk/plugin.go 接口一破，所有外部插件编译失败）。

## 四个 job（每条命令都本地实测过）

| job | 内容 | 实测耗时 |
|---|---|---|
| go | 根模块 build + vet + test | <1s |
| hmapdev | 嵌套 module 测试 + 五平台交叉编译（矩阵） | ~2s + 编译 |
| examples | 构建全部 20 个示例（linux/amd64、darwin/arm64） | 9s / 21s |
| consistency | Lua SDK 三副本一致 + skills 可识别 + mkdocs --strict | ~2s |

## 三处「不能想当然」的地方（都有实测依据）

1. **示例不能用 `go build` 验**。它们是插件（只有 plugin.go、没有 func main），
   必须由 hmapdev 注入 main 包装；直接 go build 得到
   "function main is undeclared in the main package" —— 那不是缺陷，是方式不对。
   故与发版走**同一个脚本**（package/build-examples.sh），避免 CI 与发版路径分叉。
2. **tools/hmapdev 是独立 module**，根模块的 `go test ./...` 不会进入它 ——
   必须单独跑，否则它的测试永远不在 CI 里执行（Go 的模块边界）。
3. **不能用 `yaml.safe_load` 校验 mkdocs.yml**：它含 mkdocs-material 的
   `!!python/name:` 标签（配置 emoji 的官方写法），safe_load 报
   ConstructorError —— 是校验方式不对。改用 `mkdocs build --strict`
   （本地实测 2s、0 warning）。

## 明确不进 CI

- `hmapdev skill install` —— 它会写开发者本机的 ~/.claude、~/.codex 等目录
- 需要内核仓在场的检查（本仓独立可测）
- 任何网络/真机依赖

CGO_ENABLED=0（SDK 纯 Go，与主仓相反）。

actionlint 全绿（修掉一处 shellcheck SC2012）。

2026-09-29 15:18:58 +08:00

JianFeeeee

56c694cd7c

ci: gh release download 需显式 --repo

回读校验先 cd /tmp/back（非 git 目录），而 gh 默认从当前目录的
git 上下文推断仓库，于是报 "not a git repository" —— 发布本身
成功（tag/release/附件齐全），却被这道校验误判为失败。

改为 gh release download "$TAG" --repo "$GITHUB_REPOSITORY"。

2026-09-29 14:39:12 +08:00

JianFeeeee

dc9e7d0495

ci: SDK 仓发布流水线 —— release/** 推送即出 hmapdev 五平台产物

与主仓 Release 流水线同构，差异只在产物与打包命令：

  prepare  读 meta.Version；tag 已存在则整轮跳过；go test 门可显式跳过
           （改 meta 的提交里写 [skip-release-tests]，查该提交而非 HEAD）
  build    go build（硬门）→ go test → build.sh all hmapdev → 验证 5 平台齐全
           → 生成 SHA256SUMS → artifact
  publish  打 tag → gh release create 传附件 → 回读校验
  sync-gitcode  有 GITCODE_TOKEN 时同步（无则跳过）

产物清单不是猜的，依 gitcode 上 v1.2.0/v1.3.0 的实际附件（各 6 个）：
  hmapdev_{linux,darwin}_{amd64,arm64} + hmapdev_windows_amd64.exe + SHA256SUMS

两个易错点都有实测依据：

1. **测试要分两处跑**：tools/hmapdev 是**独立 module**，根模块的
   `go test ./...` 不会进入它（Go 的模块边界，不是配置问题）。
2. **gitcode 上传必须显式列文件名**：上传脚本的路径语义是
   `os.path.join(ASSET_DIR, name)`，所以要 cd 进目录 + `ASSET_DIR=.` + 裸名；
   而它按扩展名识别产物的默认扫描对 hmapdev **无效** —— 五个产物里只有
   windows 那个有扩展名，自动扫描会静默地一个都不传。
   故把主仓的 upload_assets.py 一并纳入本仓 scripts/（两仓各自独立可取）。

本地已验证：`VERSION=1.4.0 bash package/build.sh all hmapdev` 产出 5 个
二进制（各 27–29M），根模块 go test 通过，actionlint 全绿。

2026-09-29 14:09:35 +08:00

3 Commits