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 产物

.github/workflows/ci.yml

@@ -113,7 +113,7 @@ jobs:
           set -euo pipefail
           out="hmapdev_${{ matrix.goos }}_${{ matrix.goarch }}${{ matrix.ext }}"
           go build -trimpath \
-            -ldflags "-X gitcode.com/JianFeeeee/homeagent-sdk/meta.Version=0.0.0-ci" \
+            -ldflags "-X github.com/JianFeeeee/homeagentsdk/meta.Version=0.0.0-ci" \
             -o "/tmp/$out" .
           test -s "/tmp/$out" || { echo "ERROR: 未产出 $out"; exit 1; }
           printf "  ✓ %-28s %s 字节\n" "$out" "$(stat -c %s "/tmp/$out")"

example/a2a/go.mod

@@ -2,6 +2,6 @@ module a2a
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/a2a/go.sum

@@ -1,2 +1,2 @@
-gitcode.com/JianFeeeee/homeagent-sdk v0.7.1 h1:2XEtUgV200uOqbGGEiKT5QyBmZ5aIfNiwm/Ozrm9AOg=
-gitcode.com/JianFeeeee/homeagent-sdk v0.7.1/go.mod h1:G48Rgpw9ReTkCf0qBHf50jb5CSeNR2c4OWcgcEm0plo=
+github.com/JianFeeeee/homeagentsdk v0.7.1 h1:2XEtUgV200uOqbGGEiKT5QyBmZ5aIfNiwm/Ozrm9AOg=
+github.com/JianFeeeee/homeagentsdk v0.7.1/go.mod h1:G48Rgpw9ReTkCf0qBHf50jb5CSeNR2c4OWcgcEm0plo=

example/a2a/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/a2a/plugin.go

@@ -12,7 +12,7 @@ import (
 	"sync"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/acp/go.mod

@@ -2,6 +2,6 @@ module acp
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/acp/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/acp/plugin.go

@@ -13,7 +13,7 @@ import (
 	"sync"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 // acpPlugin 实现 Agent Client Protocol (ACP) 0.0.x 子集：

example/ai_image/go.mod

@@ -2,6 +2,6 @@ module ai_image
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/ai_image/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/ai_image/plugin.go

@@ -13,7 +13,7 @@ import (
 	"strings"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/bili/go.mod

@@ -2,6 +2,6 @@ module bili
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/bili/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/bili/plugin.go

@@ -13,7 +13,7 @@ import (
 	"syscall"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/browser/go.mod

@@ -3,7 +3,7 @@ module browser
 go 1.25.0
 
 require (
-	gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+	github.com/JianFeeeee/homeagentsdk v0.0.0
 	github.com/chromedp/chromedp v0.9.5
 	github.com/chromedp/cdproto v0.0.0-20240202021202-6d0b6a386732
 	github.com/chromedp/sysutil v1.0.0
@@ -17,10 +17,10 @@ require (
 	golang.org/x/sys v0.16.0
 )
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/browser/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/browser/plugin.go

@@ -22,7 +22,7 @@ import (
 	"time"
 	"unicode"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 
 	"github.com/chromedp/chromedp"
 )

example/calendar/go.mod

@@ -2,6 +2,6 @@ module calendar
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/calendar/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/calendar/plugin.go

@@ -11,7 +11,7 @@ import (
 	"sync"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 const (

example/deepsearch/go.mod

@@ -2,7 +2,7 @@ module deepsearch-plugin
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
 
 
@@ -18,4 +18,4 @@ require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
 
 
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/deepsearch/plugin.go

@@ -40,7 +40,7 @@ import (
 	"sync"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 const (

example/editdoc/go.mod

@@ -2,6 +2,6 @@ module editdoc
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/editdoc/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/editdoc/plugin.go

@@ -9,7 +9,7 @@ import (
 	"os/exec"
 	"path/filepath"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/files/go.mod

@@ -2,6 +2,6 @@ module files
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/files/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/files/plugin.go

@@ -10,7 +10,7 @@ import (
 	"strings"
 	"sync"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/memo/go.mod

@@ -2,6 +2,6 @@ module memo
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/memo/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/memo/plugin.go

@@ -10,7 +10,7 @@ import (
 	"sync"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 // Todo 待办条目：会被主动提醒

example/music/go.mod

@@ -2,6 +2,6 @@ module music
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/music/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/music/plugin.go

@@ -9,7 +9,7 @@ import (
 	"strings"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/ocr/go.mod

@@ -2,6 +2,6 @@ module ocr
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/ocr/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/ocr/plugin.go

@@ -13,7 +13,7 @@ import (
 	"strings"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/plugindev/go.mod

@@ -2,6 +2,6 @@ module plugindev
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/plugindev/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/plugindev/plugin.go

@@ -26,7 +26,7 @@ import (
 	"strings"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 const (

example/qq/go.mod

@@ -2,6 +2,6 @@ module qq
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/qq/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/qq/plugin.go

@@ -22,7 +22,7 @@ import (
 	"sync"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type ForwardRule struct {

example/qq/plugin_test.go

@@ -9,7 +9,7 @@ import (
 	"testing"
 	"time"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func newPermissionTestPlugin(t *testing.T) *Plugin {

example/recoverydiag/go.mod

@@ -2,6 +2,6 @@ module recoverydiag
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/recoverydiag/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/recoverydiag/plugin.go

@@ -14,7 +14,7 @@ import (
 	"strings"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 // Plugin 快速检查/崩溃取证工具集。全部确定性检出，返回结论而非原文，供 guard / failback 决策。

example/rss/go.mod

@@ -3,15 +3,15 @@ module rss
 go 1.25.0
 
 require (
-	gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+	github.com/JianFeeeee/homeagentsdk v0.0.0
 	github.com/mmcdole/gofeed v1.4.0
 	github.com/mmcdole/goxpp/v2 v2.0.0
 	golang.org/x/net v0.56.0
 	golang.org/x/text v0.38.0
 )
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/rss/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/rss/plugin.go

@@ -12,7 +12,7 @@ import (
 	"sync"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 	"github.com/mmcdole/gofeed"
 )
 

example/sanitizer/go.mod

@@ -2,6 +2,6 @@ module sanitizer
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/sanitizer/main.go

@@ -3,7 +3,7 @@
 package main
 
 import (
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 func NewPlugin(name string, config map[string]interface{}) (sdk.Plugin, error) {

example/sanitizer/plugin.go

@@ -23,7 +23,7 @@ import (
 	"strings"
 	"unicode/utf8"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 var (

example/vanblog/go.mod

@@ -2,6 +2,6 @@ module vanblog-plugin
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/vanblog/plugin.go

@@ -12,7 +12,7 @@ import (
 	"strings"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

example/vikunja/go.mod

@@ -2,7 +2,7 @@ module vikunja-plugin
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
 // 与同目录其它示例一致：SDK 指向仓库内的 vendored 副本
 
@@ -12,4 +12,4 @@ require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
 
 
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

example/vikunja/plugin.go

@@ -38,7 +38,7 @@ import (
 	"strings"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 // ======== 配置键 ========

example/weather/go.mod

@@ -2,7 +2,7 @@ module weather
 
 go 1.25.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../
 

example/weather/plugin.go

@@ -9,7 +9,7 @@ import (
 	"strings"
 	"time"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

go.mod

@@ -1,3 +1,3 @@
-module gitcode.com/JianFeeeee/homeagent-sdk
+module github.com/JianFeeeee/homeagentsdk
 
 go 1.21.0

meta/meta.go

@@ -4,7 +4,7 @@ package meta
 
 var (
 	// Version 是 HomeAgent SDK 版本号。
-	// 通过 `-ldflags="-X gitcode.com/JianFeeeee/homeagent-sdk/meta.Version=vX.Y.Z"` 注入。
+	// 通过 `-ldflags="-X github.com/JianFeeeee/homeagentsdk/meta.Version=vX.Y.Z"` 注入。
 	//
 	// 版本号语义：**SDK 版本跟随核心的中版本，patch 位恒为 .0**。
 	// 整条核心 1.1.x 线（1.1.0、1.1.1、1.1.7…）共用 SDK 1.1.0；
@@ -60,7 +60,12 @@ var (
 	SDKName = "HomeAgent SDK"
 
 	// CoreModule 是核心仓的 Go module path，供 hmapdev 生成 go.mod 时使用。
-	CoreModule = "gitcode.com/JianFeeeee/HomeAgent"
+	//
+	// ★ 2026-10-08 随主仓托管地迁移而更新：仓库在 GitHub
+	//   （github.com/JianFeeeee/HomeAgent），module 路径同步。
+	//   注意它与 SDKModule 不是同一个仓：插件只依赖 SDK，**不依赖主仓**，
+	//   所以改本常量不影响任何已有插件。
+	CoreModule = "github.com/JianFeeeee/HomeAgent"
 
 	// CoreVersion 是此 SDK 所兼容的最低核心版本。
 	//

package/build.sh

@@ -56,7 +56,7 @@ build_hmapdev() {
 
   echo "[BUILD] hmapdev ${GOOS:-linux}/${GOARCH:-amd64} → $out"
   cd "$PROJECT_ROOT/$src"
-  "$GO" build -trimpath -ldflags "-X gitcode.com/JianFeeeee/homeagent-sdk/meta.Version=${VERSION}" \
+  "$GO" build -trimpath -ldflags "-X github.com/JianFeeeee/homeagentsdk/meta.Version=${VERSION}" \
     -o "$out" .
   echo "  OK ($(du -h "$out" | cut -f1))"
   cd "$PROJECT_ROOT"

sdk/plugin.go

@@ -3,7 +3,7 @@ package sdk
 import (
 	"sync"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/meta"
+	"github.com/JianFeeeee/homeagentsdk/meta"
 )
 
 // SDKVersion 是对外暴露的 SDK 版本号。

tools/hmapdev/cmd_debug.go

@@ -7,7 +7,7 @@ import (
 	"path/filepath"
 	"strings"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/tools/hmapdev/yaegi"
+	"github.com/JianFeeeee/homeagentsdk/tools/hmapdev/yaegi"
 )
 
 // tmplLuaDebug is the temporary Lua debug script template

tools/hmapdev/cmd_sdk.go

@@ -50,8 +50,8 @@ func sdkVersionDir(version string) string {
 	return filepath.Join(sdkStore(), version)
 }
 
-const sdkRepoURL = "https://gitcode.com/JianFeeeee/homeagent-sdk.git"
-const sdkDownloadURL = "https://gitcode.com/JianFeeeee/homeagent-sdk/-/archive/%s/homeagent-sdk-%s.tar.gz"
+const sdkRepoURL = "https://github.com/JianFeeeee/homeagentsdk.git"
+const sdkDownloadURL = "https://github.com/JianFeeeee/homeagentsdk/-/archive/%s/homeagent-sdk-%s.tar.gz"
 
 func cmdSDK(args []string) {
 	if len(args) < 1 {

tools/hmapdev/go.mod

@@ -1,9 +1,9 @@
-module gitcode.com/JianFeeeee/homeagent-sdk/tools/hmapdev
+module github.com/JianFeeeee/homeagentsdk/tools/hmapdev
 
 go 1.21.0
 
-require gitcode.com/JianFeeeee/homeagent-sdk v0.0.0
+require github.com/JianFeeeee/homeagentsdk v0.0.0
 
 require github.com/traefik/yaegi v0.16.1
 
-replace gitcode.com/JianFeeeee/homeagent-sdk => ../../
+replace github.com/JianFeeeee/homeagentsdk => ../../

tools/hmapdev/main.go

@@ -6,7 +6,7 @@ import (
 	"os"
 	"runtime"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/meta"
+	"github.com/JianFeeeee/homeagentsdk/meta"
 )
 
 func main() {
@@ -47,7 +47,7 @@ func printVersion() {
 // printVersionTo 把版本身份写到 w（抽出来是为了能被测试钉住）。
 func printVersionTo(w io.Writer) {
 	fmt.Fprintf(w, "hmapdev %s\n", meta.Version)
-	fmt.Fprintf(w, "  SDK 模块: %s\n", "gitcode.com/JianFeeeee/homeagent-sdk")
+	fmt.Fprintf(w, "  SDK 模块: %s\n", "github.com/JianFeeeee/homeagentsdk")
 	if meta.Commit != "" && meta.Commit != "unknown" {
 		fmt.Fprintf(w, "  构建提交: %s\n", meta.Commit)
 	}

tools/hmapdev/main_version_test.go

@@ -5,7 +5,7 @@ import (
 	"strings"
 	"testing"
 
-	"gitcode.com/JianFeeeee/homeagent-sdk/meta"
+	"github.com/JianFeeeee/homeagentsdk/meta"
 )
 
 // 工具链必须能报出自己的版本。

tools/hmapdev/stagediff_test.go

@@ -4,10 +4,11 @@ import (
 	"encoding/json"
 	"testing"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
-// 本测试验证 tmplLinuxBridge 中 snapshotWritable + changedFieldsOnly 的语义（plan.md 11.3）。
+// 本测试验证 tmplLinuxBridge 中 snapshotWritable + changedFieldsOnly 的语义。
+// 该语义于 2026-09 落地并经本测试锁定（历史依据见 git log --grep=hmapdev）。
 // 模板字符串本身无法直接单测，这里以同一份逻辑复刻，防止回归。
 // ❗ 模板与本文件须同步修改。
 //

tools/hmapdev/templates.go

@@ -23,9 +23,15 @@ go {{.GoVersion}}
 
 require {{.SDKModule}} {{.SDKVersion}}
 {{if .SDKLocalPath}}
-// SDK 指向本机源码。gitcode 的模块不在 proxy.golang.org 上，
-// 没有这条 replace 就需要 go.sum 条目，而那个条目无处可拉。
-// 若你已有可访问的私有 proxy，可删掉本行。
+// SDK 指向本机源码。
+//
+// ★ 为何默认走 replace 而不是直接拉模块（2026-10-08 更新）：
+//   SDK 已从 gitcode 迁到 GitHub（module 路径 github.com/JianFeeeee/homeagentsdk）。
+//   仓库虽在 GitHub，但本工程模板仍默认指向**本机源码**，原因与托管地无关：
+//   （1）hmapdev 装的是本机 SDK（~/.homeagent/hmapdev/sdk），离线也能构建；
+//   （2）插件必须与内核的 SDK 版本严格一致，走网络拉会引入版本漂移；
+//   （3）内网/受限出口环境拉不到公共 proxy。
+//   若你已有可访问的私有 proxy 或愿意走公网，可删掉本行。
 replace {{.SDKModule}} => {{.SDKLocalPath}}
 {{end}}`
 
@@ -33,7 +39,7 @@ const tmplPluginGo = `package main
 
 import (
 	"fmt"
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

tools/hmapdev/templates/main.go.tmpl

@@ -3,7 +3,7 @@ package main
 import (
 	"encoding/json"
 	"fmt"
-	"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	"github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 type Plugin struct {

tools/hmapdev/templates/proc_main.go.tmpl

@@ -20,7 +20,7 @@ import (
 	"os"
 	"sync"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 // ---- 协议常量（须与内核 internal/plugin/proc/protocol.go 一致）----

tools/hmapdev/yaegi/interp.go

@@ -13,7 +13,7 @@ import (
 
 	"github.com/traefik/yaegi/interp"
 	"github.com/traefik/yaegi/stdlib"
-	"gitcode.com/JianFeeeee/homeagent-sdk/tools/hmapdev/yaegi/mocksdk"
+	"github.com/JianFeeeee/homeagentsdk/tools/hmapdev/yaegi/mocksdk"
 )
 
 type YaegiDebugger struct {
@@ -155,7 +155,7 @@ func NewYaegiDebugger(dir string, replaces []string) (*YaegiDebugger, error) {
 		pkg[name] = reflect.ValueOf(t)
 	}
 
-	sdkExports["gitcode.com/JianFeeeee/homeagent-sdk/sdk"] = pkg
+	sdkExports["github.com/JianFeeeee/homeagentsdk/sdk"] = pkg
 	i.Use(sdkExports)
 
 	return &YaegiDebugger{

tools/hmapdev/yaegi/mocksdk/parity_test.go

@@ -11,7 +11,7 @@ import (
 	"strings"
 	"testing"
 
-	sdk "gitcode.com/JianFeeeee/homeagent-sdk/sdk"
+	sdk "github.com/JianFeeeee/homeagentsdk/sdk"
 )
 
 // structFields 解析 file 中的指定 struct，返回其字段名集合。