homeagent-sdk

jianf/homeagent-sdk

Fork 0

mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-10-31 14:27:30 +00:00

Commit Graph

Author	SHA1	Message	Date
root	c63bce8304	fix(examples): cmd/localuse/mcp 对齐仓内示例规约 —— 相对 replace、不声明 sdk CI 红（run 39265187807）根因：这三个工程用了 `hmapdev init` 的本机脚手架格式（replace => /root/.homeagent/...，plg.json 带 "sdk":"1.4.0"），而仓内 22 个存量示例的规约（example_gomod_test.go 的两条判据 + hmapdev 构建逻辑）是： - go.mod：require v0.0.0 + replace => ../../（相对仓库根） - plg.json：不声明 sdk 字段 —— 声明了会让 hmapdev 去本地 SDK store 找该版本，干净 CI 上必然失败（"存储里还没有任何 SDK"）外部开发者拿 init 模板在本机构建没问题（init 面向本机 store），但仓内示例面向的是 checkout 即可构建的 CI/发版路径，两者规约不同。修后本地复验：example_gomod_test 3 条判据全绿； build-examples.sh linux/amd64 与 darwin/arm64 均 25/25 成功。	2026-10-20 07:00:53 +08:00
root	e849f39663	feat(examples): 内置插件外置化 —— cmd/localuse/mcp 迁入 example + files 新增按行号精确编辑 ## 背景主仓按「只有必须使用内部 SDK 能力的插件才内置」的判定标准（见主仓 ARCHITECTURE「内置插件的判定标准」）把纯公开 SDK 插件移出编译期内置清单。本仓为它们提供外部插件工程（example/ 下，hmapdev 可直接构建）。 ★ 终审翻案：kbtree 与 multimodal 不在本次外置之列 —— 逐方法对照公开 SDK 后发现它们依赖内部专有能力（kbtree 要 KnowledgeAPI 的 Subtree/CategoryCounts/SearchIn/Categories 与树视图类型；multimodal 要 LLMAPI.Chat 与多模态消息类型），公开面没有，已加回主仓内置清单。 ## 新增工程（全部对齐当前模板 + 随用随起契约） \| 工程 \| 工具 \| auto_start \| 说明 \| \|---\|---\|---\|---\| \| cmd \| cmd_run \| false（按需） \| 沙箱执行 shell 命令 \| \| localuse \| screensee/screensue/camerasue/speakeruse/clipboardsee/clipboardsue/computeruse \| false（按需） \| 本机外设 \| \| mcp \| mcp_add/list/remove/restart_server \| false（按需） \| MCP 服务器接入（stdio/SSE） \| 每工程：plg.json（含 sdk 字段声明）+ skill/<name>-tools/SKILL.md + README。按 auto_start 契约（sdk/autostart.go 的 OnDemandNeedsSkill）， auto_start=false 必须配 skill，否则工具不出现在初始清单 ⇒ 模型不知道它存在 ⇒ 永远不会被拉起，等于没装还占地方。 ## 移植要点 - 注册：内置版 init()+RegisterFactory → 外部版导出 NewPluginFactory； RegisterPluginMeta 的显示名进 plg.json/plugin.json。 - mcp：本地 rpcRequest/rpcResponse/rpcError 与 hmapdev 生成的 z_proc_gen.go 同名冲突（构建期生成物与本目录源码同包编译），本地类型改名 mcpRPC*；internal/safeclose 内联为 safeCloseChan （外部插件不能引 internal 包，close-of-closed-channel 纪律随之带过来）。 - module 名：cmd 的 go.mod 用 homeagent-cmd（避免与标准库 cmd 混淆）； name_en 对齐插件名，hmapdev 以 toSnake(name_en) 命名产物（此前误写 Command/Local，产物成了 command_/local_）。 ## files：新增 files_edit_line（按行号精确编辑） files_edit 要求 old 文本全文件唯一，改「第三个 case 的 break」这类非唯一文本时只能退化为整文件重写（有损）。files_edit_line 按行号定位，op=replace/insert/delete，支持： - 多条 edit 从后往前应用（前面行号不漂移） - expect 安全闸：行内容与预期不符则整体拒绝（防行号过期改错位置） - CRLF/末尾换行保真 skill 同步补 edit_line 行。测试 5 条（含 expect 拒绝路径）。 ## 验证 hmapdev build 四工程全过：cmd/localuse/mcp/files 产物齐； go test files 全绿。	2026-10-19 22:01:07 +08:00

Author

SHA1

Message

Date

root

c63bce8304

fix(examples): cmd/localuse/mcp 对齐仓内示例规约 —— 相对 replace、不声明 sdk

CI 红（run 39265187807）根因：这三个工程用了 `hmapdev init` 的本机
脚手架格式（replace => /root/.homeagent/...，plg.json 带 "sdk":"1.4.0"），
而仓内 22 个存量示例的规约（example_gomod_test.go 的两条判据 + hmapdev
构建逻辑）是：

  - go.mod：require v0.0.0 + replace => ../../（相对仓库根）
  - plg.json：不声明 sdk 字段 —— 声明了会让 hmapdev 去本地 SDK store
    找该版本，干净 CI 上必然失败（"存储里还没有任何 SDK"）

外部开发者拿 init 模板在本机构建没问题（init 面向本机 store），
但**仓内示例**面向的是 checkout 即可构建的 CI/发版路径，两者规约不同。

修后本地复验：example_gomod_test 3 条判据全绿；
build-examples.sh linux/amd64 与 darwin/arm64 均 25/25 成功。

2026-10-20 07:00:53 +08:00

root

e849f39663

feat(examples): 内置插件外置化 —— cmd/localuse/mcp 迁入 example + files 新增按行号精确编辑

## 背景

主仓按「只有必须使用内部 SDK 能力的插件才内置」的判定标准（见主仓
ARCHITECTURE「内置插件的判定标准」）把纯公开 SDK 插件移出编译期内置清单。
本仓为它们提供外部插件工程（example/ 下，hmapdev 可直接构建）。

★ 终审翻案：kbtree 与 multimodal **不**在本次外置之列 —— 逐方法对照
公开 SDK 后发现它们依赖内部专有能力（kbtree 要 KnowledgeAPI 的
Subtree/CategoryCounts/SearchIn/Categories 与树视图类型；multimodal 要
LLMAPI.Chat 与多模态消息类型），公开面没有，已加回主仓内置清单。

## 新增工程（全部对齐当前模板 + 随用随起契约）

| 工程 | 工具 | auto_start | 说明 |
|---|---|---|---|
| cmd | cmd_run | false（按需） | 沙箱执行 shell 命令 |
| localuse | screensee/screensue/camerasue/speakeruse/clipboardsee/clipboardsue/computeruse | false（按需） | 本机外设 |
| mcp | mcp_add/list/remove/restart_server | false（按需） | MCP 服务器接入（stdio/SSE） |

每工程：plg.json（含 sdk 字段声明）+ skill/<name>-tools/SKILL.md +
README。按 auto_start 契约（sdk/autostart.go 的 OnDemandNeedsSkill），
**auto_start=false 必须配 skill**，否则工具不出现在初始清单 ⇒ 模型不知道
它存在 ⇒ 永远不会被拉起，等于没装还占地方。

## 移植要点

- 注册：内置版 init()+RegisterFactory → 外部版导出 NewPluginFactory；
  RegisterPluginMeta 的显示名进 plg.json/plugin.json。
- mcp：本地 rpcRequest/rpcResponse/rpcError 与 hmapdev 生成的
  z_proc_gen.go 同名冲突（构建期生成物与本目录源码同包编译），
  本地类型改名 mcpRPC*；internal/safeclose 内联为 safeCloseChan
  （外部插件不能引 internal 包，close-of-closed-channel 纪律随之带过来）。
- module 名：cmd 的 go.mod 用 homeagent-cmd（避免与标准库 cmd 混淆）；
  name_en 对齐插件名，hmapdev 以 toSnake(name_en) 命名产物
  （此前误写 Command/Local，产物成了 command_/local_）。

## files：新增 files_edit_line（按行号精确编辑）

files_edit 要求 old 文本全文件唯一，改「第三个 case 的 break」这类
非唯一文本时只能退化为整文件重写（有损）。files_edit_line 按行号
定位，op=replace/insert/delete，支持：
- 多条 edit 从后往前应用（前面行号不漂移）
- expect 安全闸：行内容与预期不符则整体拒绝（防行号过期改错位置）
- CRLF/末尾换行保真

skill 同步补 edit_line 行。测试 5 条（含 expect 拒绝路径）。

## 验证

hmapdev build 四工程全过：cmd/localuse/mcp/files 产物齐；
go test files 全绿。

2026-10-19 22:01:07 +08:00

2 Commits