mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-25 11:28:08 +00:00
a2cba0ceb1
## 更正一处实测证伪的断言
`assets/docs/{zh,en}/PLUGIN_DEV.md` 都写着「`PluginMgr()` 仅内置插件可用，
外部动态插件无法直接调用」——**这是错的**。
建 SDK 文档站时对照 `hmapdev` 桥接模板实测：
- `proc_main.go.tmpl:692` 显式 `base.SetPluginMgrAPI(procPluginMgr{})`，即桥接运行时
**为外部插件注入了** PluginMgr；
- 公开 `sdk/plugin.go:282` 的注释本身就写着「PluginMgrAPI 提供插件管理能力
（外部插件可调用）」。
真正的区别是**方法数**，不是有无：
| 接口 | 位置 | 方法数 |
|---|---|---|
| `sdk.PluginMgrAPI` | 公开 SDK | 3（ReloadOne / ListLoadedPlugins / IsPluginDisabled）|
| `internal/sdk.PluginManager` | 内核内部 | 9（另有 Enable/Disable/Remove/ReloadPlugins/IsBuiltinPlugin 等）|
两个接口名字相似但**不是同一个**，这正是混淆的来源。已在中英两版改写为准确描述，
并保留原有的「内置插件 API」代码块（那段示例用的确实全是内部面，加注说明）。
## 挡住新文档站目录
SDK 仓新增了 `docs/`（mkdocs 站点源码）与 `mkdocs.yml`。它们与 `README*`、`tools/`
同类——属于 SDK 仓，核心仓不该跟踪。规则带前导路径限定，核心仓自己的 `docs/`
不受影响（实测 `git check-ignore` 命中，工作区不再出现这两个路径）。
SDK 仓同批提交 0a6e2b7（文档站本体）。
75 lines
2.1 KiB
Plaintext
75 lines
2.1 KiB
Plaintext
/homed
|
||
/waiter
|
||
*.exe
|
||
*.log
|
||
*.test
|
||
build/
|
||
*.so
|
||
*.db
|
||
data/
|
||
.tmp-plugins/
|
||
.go/
|
||
.local/
|
||
|
||
*.hmap
|
||
dev/
|
||
|
||
login.json
|
||
|
||
# GUI
|
||
cmd/gui/node_modules/
|
||
cmd/gui/dist/
|
||
|
||
.gopath/
|
||
|
||
# SDK 工具链 — 核心仓不追踪
|
||
#
|
||
# 外部插件与工具链维护在独立 SDK 仓（决策 sdk_repo_only），
|
||
# 本仓经 go.mod 的 replace => ./third_party/homeagent-sdk 引用。
|
||
# example/ 下已跟踪的 21 个文件（10 个示例的 plg.json + plugin.go，
|
||
# 加 qq/plugin_test.go）早于本规则，
|
||
# 靠「已跟踪文件不受 .gitignore 影响」保留——这是有意的，不要「修」。
|
||
third_party/homeagent-sdk/bin/
|
||
third_party/homeagent-sdk/tools/
|
||
third_party/homeagent-sdk/package/
|
||
third_party/homeagent-sdk/scripts/
|
||
third_party/homeagent-sdk/.gitignore
|
||
third_party/homeagent-sdk/README*
|
||
third_party/homeagent-sdk/example/
|
||
# 文档站（mkdocs.yml + docs/ + 生成器）属于 SDK 仓，与 README* / tools/ 同理。
|
||
# 注意 docs/ 带前导路径限定，够精确：本仓自己的 docs/ 不受影响。
|
||
third_party/homeagent-sdk/docs/
|
||
third_party/homeagent-sdk/mkdocs.yml
|
||
third_party/homeagent-sdk/site_build/
|
||
.codegraph/
|
||
|
||
# codegraph 本地索引配置（含嵌套 SDK 仓放行，仅本地生效）
|
||
codegraph.json
|
||
|
||
# 运行时产物(不提交)
|
||
#
|
||
# ⚠️ 这些必须带前导斜杠。不带斜杠的模式（如 `memory/`）会匹配**任意层级**的
|
||
# 同名目录，把 internal/memory/、internal/knowledge/、deploy/scripts/ 一起吞掉
|
||
# ——24 + 3 + 1 个已跟踪源码文件曾因此落在 ignore 规则下，只靠「已跟踪
|
||
# 文件不受 .gitignore 影响」这条 git 规则兜着，新增文件会默默不入库。
|
||
/adapters/
|
||
/knowledge/
|
||
/memory/
|
||
# 注：/scripts/ **不**忽略。它是作者维护的工具目录（模型导出、侧车、部署校验），
|
||
# 不是运行期产物：deploy/systemd/embed-sidecar.service 直接引用
|
||
# scripts/embed_sidecar.py，忽略它会让那份 unit 在别人的机器上指向不存在的文件。
|
||
# 只忽略其中的缓存。
|
||
/scripts/__pycache__/
|
||
__pycache__/
|
||
terminal_locked_log.txt
|
||
|
||
dist/
|
||
.pi-glla/
|
||
.omo/
|
||
.pi/
|
||
|
||
# HarmonyOS 构建工具链缓存（HVIGOR_USER_HOME / ohpm 生成，非源码）
|
||
.hvigor-home/
|
||
.npm-cache/
|
||
.ohpm/
|