HomeAgent

jianf/HomeAgent

Fork 0

mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-10-02 23:33:58 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	df872b9e86	chore(vendor): 主仓不再跟踪 SDK 示例代码（决策 A） ## 背景 `.gitignore` 第 26-45 行早已写明「外部插件与工具链维护在独立 SDK 仓（决策 sdk_repo_only），本仓经 go.mod 的 replace 引用」，并忽略了 example/、tools/、docs/、site_build/、package/、scripts/。但有 29 个文件早于该规则被跟踪，靠「已跟踪文件不受 .gitignore 影响」留着，注释还特意写了「这是有意的，不要『修』」。本轮修 example/bili 时踩到了：那 87 行改动先落在主仓、再手动同步到 SDK 仓 —— 同一份代码两个仓各改一遍，正是这个遗留结构的成本。 ## 核实：主仓到底需要什么 - 主仓 Go 代码只 import 两个包：`homeagent-sdk/sdk`（插件入口）、 `homeagent-sdk/meta`（版本号） - `remotedevice/` 是 C 库，主仓 C 侧明确「不链接任何外部库」，只有注释里提到它 - `tools/hmapdev/yaegi` 的 import 出现在 SDK 仓自己的文件之间（yaegi/interp.go → yaegi/mocksdk），不是主仓依赖；且 tools/ 本就在 .gitignore 里，从未被跟踪所以 29 个文件全部可以删。实际仓库负担也只有 42 个文件 / 0.6MB （工作树里那 971MB 绝大部分是未跟踪的构建产物，不是仓库体积）。 ## 改动 - 删 21 个 example/ 文件（10 个示例的 plg.json + plugin.go + qq/plugin_test.go） - 删 8 个 remotedevice/ C 文件 - 工作树里一并清掉（不受跟踪的构建产物顺带回收）构建与全量测试均通过。 ## 判据：3 条 + 变异（internal/meta/vendored_sdk_test.go） - TestVendoredSDKHasNoExampleOrRemotedevice：防止示例代码被重新提交进来 - TestVendoredSDKKeepsRequiredPackages：反向保护，防止为省事把 sdk/ 与 meta/ 也删掉（上一条只防"多了"，删过头要靠这条） - TestGoModStillReplacesSDKToVendoredPath：决策 A 依赖 replace 指向 vendored 路径 ★ 判据自己踩了两个坑，都靠实跑抓出来： 1. `git ls-files` 的路径参数相对当前目录解析，而测试跑在 internal/meta/ 下 ⇒ 就地执行返回空，表现为「必需包全都不在」的假红。改用 `git -C <仓库根>`。 2. 把 tools/hmapdev/yaegi 当成主仓依赖写进必需清单 ⇒ 又一次假红。根因是把 SDK 内部的引用误当成主仓依赖（它本就在 .gitignore 里）。变异验证：塞一个 example 文件进版本控制 → 判红。	2026-09-26 17:18:41 +08:00
JianFeeeee	d4da999d35	feat(sdk): SettingsAPI.DataDir() 插件专属数据目录 + ai_image 本地交付【SDK DataDir API】 - SettingsAPI 新增 DataDir() string：返回插件专属数据目录 <data>/plugin_data/<name>（内核保证存在），解决此前插件只能靠 GetCore("daemon.data_dir") 手工解析的缺陷 - settingsImpl 新增 dataDir 字段 + SetDataDir；Registry buildSDK 注入（<data>/plugin_data/<name> 并 MkdirAll）；main.go 接线 - cabi 新增 CORE_SETTINGS_DATA_DIR (id 51)；plugindev dispatchSettings 模板补 DataDir() 实现【ai_image 交付本地路径】 - 生成后下载临时 S3 URL 到插件数据目录，返回本地文件路径（永久不过期），而非 1 小时过期的 S3 URL。带 UA 规避图床对无 UA 客户端拦截（此前 agent 裸 curl 验证被拒导致误报失败） - 返回 local_paths 字段 + 提示用 output_send(type=image) 展示端到端：ai_image_generate → plugin_data/ai_image/*.png 有效 PNG(1024²)，经 llmsproxy→siliconflow 生成。	2026-08-26 21:40:29 +08:00
JianFeeeee	31a348de37	feat(ai_image): base_url 设置项支持自定义 OpenAI 兼容网关 v1.1.0 generateOpenAI 原硬编码上游为 https://api.openai.com，无法接入本机 llmsproxy(ModelRouter) 等标准 OpenAI 兼容网关。新增： - 设置项 base_url（string，默认空）：为空保持官方直连；非空时上游改为 {base_url}/v1/images/generations（约定不带 /v1 尾缀，拼接时自动去重避免 /v1/v1） - Plugin.baseURL 字段 Start 时读入；注册 ConfigDef（category ai_image）供 WebUI 配置页展示部署：plugindev 打包 1.1.0 → pluginmgr overwrite:true 升级安装 config_kept=true → plgreload 热加载。配置（category ai_image）：api_key=sk-gw-local-0001, base_url=http://127.0.0.1:8081, provider=openai, model=Kwai-Kolors/Kolors, size=1024x1024 验收：agent 实调 ai_image_generate 出图成功——llmsproxy audit 记录 type=image src=siliconflow model=AUTO ok=true（经网关非直连），返回临时 S3 URL 下载为有效 PNG (1024x1024)。	2026-08-26 19:46:59 +08:00

Author

SHA1

Message

Date

JianFeeeee

df872b9e86

chore(vendor): 主仓不再跟踪 SDK 示例代码（决策 A）

## 背景

`.gitignore` 第 26-45 行早已写明「外部插件与工具链维护在独立 SDK 仓
（决策 sdk_repo_only），本仓经 go.mod 的 replace 引用」，并忽略了
example/、tools/、docs/、site_build/、package/、scripts/。

但有 29 个文件**早于该规则**被跟踪，靠「已跟踪文件不受 .gitignore
影响」留着，注释还特意写了「这是有意的，不要『修』」。

本轮修 example/bili 时踩到了：那 87 行改动先落在主仓、再手动同步到
SDK 仓 —— 同一份代码两个仓各改一遍，正是这个遗留结构的成本。

## 核实：主仓到底需要什么

- 主仓 Go 代码只 import 两个包：`homeagent-sdk/sdk`（插件入口）、
  `homeagent-sdk/meta`（版本号）
- `remotedevice/` 是 C 库，主仓 C 侧明确「不链接任何外部库」，
  只有注释里提到它
- `tools/hmapdev/yaegi` 的 import 出现在 **SDK 仓自己的文件之间**
  （yaegi/interp.go → yaegi/mocksdk），不是主仓依赖；
  且 tools/ 本就在 .gitignore 里，从未被跟踪

所以 29 个文件全部可以删。实际仓库负担也只有 42 个文件 / 0.6MB
（工作树里那 971MB 绝大部分是未跟踪的构建产物，不是仓库体积）。

## 改动

- 删 21 个 example/ 文件（10 个示例的 plg.json + plugin.go + qq/plugin_test.go）
- 删 8 个 remotedevice/ C 文件
- 工作树里一并清掉（不受跟踪的构建产物顺带回收）

构建与全量测试均通过。

## 判据：3 条 + 变异（internal/meta/vendored_sdk_test.go）

- TestVendoredSDKHasNoExampleOrRemotedevice：防止示例代码被重新提交进来
- TestVendoredSDKKeepsRequiredPackages：**反向**保护，防止为省事把
  sdk/ 与 meta/ 也删掉（上一条只防"多了"，删过头要靠这条）
- TestGoModStillReplacesSDKToVendoredPath：决策 A 依赖 replace 指向 vendored 路径

★ 判据自己踩了两个坑，都靠实跑抓出来：
1. `git ls-files` 的路径参数**相对当前目录**解析，而测试跑在
   internal/meta/ 下 ⇒ 就地执行返回空，表现为「必需包全都不在」的假红。
   改用 `git -C <仓库根>`。
2. 把 tools/hmapdev/yaegi 当成主仓依赖写进必需清单 ⇒ 又一次假红。
   根因是把 SDK 内部的引用误当成主仓依赖（它本就在 .gitignore 里）。

变异验证：塞一个 example 文件进版本控制 → 判红。

2026-09-26 17:18:41 +08:00

JianFeeeee

d4da999d35

feat(sdk): SettingsAPI.DataDir() 插件专属数据目录 + ai_image 本地交付

【SDK DataDir API】
- SettingsAPI 新增 DataDir() string：返回插件专属数据目录
  <data>/plugin_data/<name>（内核保证存在），解决此前插件只能
  靠 GetCore("daemon.data_dir") 手工解析的缺陷
- settingsImpl 新增 dataDir 字段 + SetDataDir；Registry buildSDK
  注入（<data>/plugin_data/<name> 并 MkdirAll）；main.go 接线
- cabi 新增 CORE_SETTINGS_DATA_DIR (id 51)；plugindev dispatchSettings
  模板补 DataDir() 实现

【ai_image 交付本地路径】
- 生成后下载临时 S3 URL 到插件数据目录，返回本地文件路径（永久不
  过期），而非 1 小时过期的 S3 URL。带 UA 规避图床对无 UA 客户端拦截
  （此前 agent 裸 curl 验证被拒导致误报失败）
- 返回 local_paths 字段 + 提示用 output_send(type=image) 展示

端到端：ai_image_generate → plugin_data/ai_image/*.png 有效 PNG(1024²)，
经 llmsproxy→siliconflow 生成。

2026-08-26 21:40:29 +08:00

JianFeeeee

31a348de37

feat(ai_image): base_url 设置项支持自定义 OpenAI 兼容网关 v1.1.0

generateOpenAI 原硬编码上游为 https://api.openai.com，无法接入
本机 llmsproxy(ModelRouter) 等标准 OpenAI 兼容网关。新增：

- 设置项 base_url（string，默认空）：为空保持官方直连；非空时
  上游改为 {base_url}/v1/images/generations（约定不带 /v1 尾缀，
  拼接时自动去重避免 /v1/v1）
- Plugin.baseURL 字段 Start 时读入；注册 ConfigDef（category
  ai_image）供 WebUI 配置页展示

部署：plugindev 打包 1.1.0 → pluginmgr overwrite:true 升级安装
config_kept=true → plgreload 热加载。

配置（category ai_image）：api_key=sk-gw-local-0001,
base_url=http://127.0.0.1:8081, provider=openai,
model=Kwai-Kolors/Kolors, size=1024x1024

验收：agent 实调 ai_image_generate 出图成功——llmsproxy audit
记录 type=image src=siliconflow model=AUTO ok=true（经网关非直连），
返回临时 S3 URL 下载为有效 PNG (1024x1024)。

2026-08-26 19:46:59 +08:00

3 Commits