jianf/homeagent-sdk
1
0
Fork 0
mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-09-20 08:58:03 +00:00
Code Issues Packages Projects Releases Wiki Activity
99 Commits 5 Branches 10 Tags
ebd700eaf98ce968edae3d166a17346105ba9e9c
Commit Graph

99 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
JianFeeeee
fc876c5554 feat: 单插件重载等 PluginMgr 能力导出到外部 SDK 
- meta: CORE_PLUGIN_RELOAD_ONE(48) / LIST_LOADED(49) / IS_DISABLED(50)
- sdk: PluginMgrAPI 接口(ReloadOne/ListLoadedPlugins/IsPluginDisabled) +
  PluginSDK.SetPluginMgrAPI/PluginMgr() 访问器
- plugindev 模板: dispatchPluginMgr 桥接注入,走 C ABI 48/49/50
 2026-08-23 19:47:55 +08:00
JianFeeeee
5c5df9cfb9 demo(luademo): pre_action stage 展示写回(llm_text 追加标记) 2026-08-15 18:11:33 +08:00
JianFeeeee
c91739d670 fix(qq): parseIDList 兼容科学计数法存库的历史坏值 
配置里 QQ 号被 WebUI 以科学计数法(2.198972886e+09)存库时,
ParseInt 解析失败导致 adminIDs 为空、老大消息不被标记。
ParseInt 失败后回退 ParseFloat, 整数值转为 int64。
v0.9.0 		2026-08-15 17:24:21 +08:00
JianFeeeee
6527a40539 fix: CABINumMin 恢复为 1 兼容旧 ABI 插件(仅缺 stage 写回) 2026-08-15 16:34:25 +08:00
JianFeeeee
392f391f68 v0.9.0: C ABI v2 stage 写回 + ABI 版本对齐核心版本号 
- meta: ABI 标识版本改为字符串 semver（ABIVersion=CoreVersion="0.9.0"），
  C 层协商用派生整数 CABINum=900（major*100+minor），不再用独立数字编码
- plugindev 模板: invoke_stage 增加 result out 参数（stage 写回），
  插件在 OnInput/AfterToolcall/PostAction 修改 StageContext 后回传内核
- cmd_init: CABIVersion 改用 CABINum
- example/sanitizer: 增强为全链路清洗（坏 UTF-8/U+FFFD/ANSI 转义），
  挂载 OnInput/AfterToolcall/PostAction 三阶段（依赖 stage 写回能力）
 2026-08-15 15:52:10 +08:00
JianFeeeee
cca9fdce9c example: 新增 acp(ACP 代理通信)、vanblog(VanBlog 博客管理) 插件; 多插件工具调用检测与清理改进; weather 移除 onRemove/文本记忆; plugindev 精简 2026-08-15 09:03:05 +08:00
root
b6e30f9279 tools: plugindev 工具链支持公共 IOInjector.InjectInputSync（CORE_INJECT_INPUT_SYNC=47，z_bridge dispatchIO 桥接），重建 bin 预编译二进制；example/memo: plg.json 修复（name_en 去斜杠、去 BOM）；sdk/plugin.go 注释精简 2026-08-02 16:24:59 +08:00
root
8e5610c494 example/memo: 待办与备忘分离（待办提醒、备忘纯记事） 
- 待办（todo_add/todo_complete/todo_list）：保留原有主动提醒能力——
  stagePreAction 注入未完成条数 + periodicCheck 每 5 分钟 InjectInterruptText；
  数据文件 todos.json
- 备忘（memo_create/memo_list/memo_delete）：纯记事用途，不参与任何提醒
  （无 stage 注入、无周期中断）；数据文件 memos.json
- cleanupData 卸载时清理两个数据文件；ID 各自独立递增
 2026-08-02 15:47:37 +08:00
root
1796395668 sdk: 公共 IOInjector 补 InjectInputSync（同步注入并等待回复） 
与主仓 third_party/homeagent-sdk 对齐：IOInjector 接口新增
InjectInputSync(source, channel, text) string + PluginSDK 便捷方法
（通道插件请求-响应流：转发入站消息并取回 agent 回复文本）
 2026-08-02 15:30:22 +08:00
root
f3d87ec35f docs: 生命周期文档补全 onRemove（删除清理）说明 
- README.md/README_EN.md：新增删除清理（onRemove）小节——语义（仅卸载
  触发、重载/禁用不触发，Stop 之后执行）、内核配套清理（工具注册/disabled/
  配置项定义 plugin.<name>.*/配置表 config_<name>）、示例清单与代码片段
- plugindev 模板 README.md.tmpl：新增 Lifecycle 段（RegisterStopHandler 每次
  停止、RegisterOnRemoveHandler 仅卸载）
 2026-08-02 15:23:22 +08:00
root
aee63a4f98 example: 演示插件 onRemove 清理补齐（memo/rss/weather） 
- memo: 卸载时删除 memos.json 数据文件
- rss: 卸载时清理 .homeagent/rss 订阅数据目录
- weather: 卸载时清理 .homeagent/weather 缓存目录
- 与 calendar（events.json）一致：仅删除触发、重载不触发；
  files（filesDir 为用户配置的访问根目录）、bili/qq（用户下载资产）、
  ocr（临时目录函数内自清理）按语义不加入删除回调
 2026-08-02 13:37:59 +08:00
root
fb07081929 插件删除回调（onRemove）与模板/示例同步 
- sdk: RegisterOnRemoveHandler/RunOnRemoveHandlers（仅卸载时触发，重载不触发；
  后注册先执行、幂等），与 RegisterStopHandler/RunStopHandlers 并存
- plugindev: 模板 main.go.tmpl 新增 onRemove 演示（删配置键），templates.go 同步
- example/calendar: RegisterOnRemoveHandler(p.cleanupData) 卸载时清理 events.json
- README/README_EN: 生命周期文档补充 onRemove
- example/calendar/plg.json: 版本对齐
 2026-08-02 13:33:25 +08:00
root
db5d3133ea docs: document pre-built plugindev binaries in bin/ 2026-07-31 13:17:19 +08:00
root
12a8e99892 plugindev: rebuild pre-built binaries with latest toolchain (no local replace, auto go mod download) 2026-07-31 13:16:13 +08:00
root
62447e3952 plugindev: generate go.mod without local absolute replace; auto-download SDK module on first build 
- init 生成的 go.mod 只 require SDK 线上版本（gitcode.com/JianFeeeee/homeagent-sdk v0.8.0），不再写本地绝对路径 replace
- build 仅在显式指定（plg.json sdk_path 或 --sdk-path）时写入 replace
- 首次构建自动执行 go mod download <sdk_module> 生成 go.sum（修复无 go.sum 构建失败）
- 修正 ensureGoMod 模块名解析（支持 require 行与 require 块）
 2026-07-31 13:12:48 +08:00
root
bc1a005885 docs: fix plugindev install endpoint and build output; examples table; fix NewPluginFactory in bridge template 
- README 构建与安装：输出目录为 dist/，安装端点为 pluginmgr POST /plugins（JSON 或 raw body），删除不存在的 /api/plugins/install
- 示例表：weather/luademo 新增、qq 更新 17 工具（补入 2b54814 未提交部分）
- templates.go: go_init_plugin 调用 NewPluginFactory（模板插件仅导出该函数）
 2026-07-31 13:00:09 +08:00
root
2b54814037 examples: update weather with v0.8.0 API surface, add luademo Lua example, fix go.mod replaces 2026-07-31 10:59:13 +08:00
root
429fe9e1b9 plugindev: fall back to git clone when SDK archive download unavailable 2026-07-31 10:32:46 +08:00
root
87136057b1 plugindev: align Lua SDK mock with external plugin surface, refactor debug v0.8.0 2026-07-31 10:28:08 +08:00
root
84bf100a12 example/qq: add typing indicator on private messages 
- setInputStatus helper wrapping NapCat set_input_status API
- startTyping/stopTyping with goroutine-based typing manager
  (5s interval, 30s auto-timeout)
- start typing on webhook private message receipt
- stop typing when output channel sends a response
- fix plg.json UTF-8 BOM that broke plugindev parse
 2026-07-30 09:24:20 +08:00
root
78ef7998c2 docs: add RegisterInputChannel, ChannelDef to SDK README 2026-07-29 15:51:32 +08:00
root
b166697dd7 bump version to v0.8.0 2026-07-29 15:45:33 +08:00
root
4d01e75282 example/qq: use relative replace path, disable bundle mode 2026-07-29 15:24:43 +08:00
root
c5bcae9404 sdk: add RegisterInputChannel + NoMemory/Cleaner support 
- ChannelDef struct: NoMemory bool + Cleaner func(string) string
- InputChannelRegistrar interface + RegisterInputChannel method
- RegisterOutputChannel now takes ChannelDef parameter
- QQ example registers input channel with NoMemory:true + Cleaner
 2026-07-29 14:46:15 +08:00
JianFeeeee
c7c66b8d39 docs: 修正 plugindev 工具链描述 + 补充入口函数/Lua 插件说明 + 补全示例插件列表 2026-07-28 21:56:54 +08:00
JianFeeeee
04837f237d plugindev: 全面 plg.json 持久化 + --replace 支持 + 文档 v0.7.2 2026-07-25 15:47:49 +08:00
JianFeeeee
1fa3c843ab refactor: centralize ABI metadata into meta/meta.go 
- meta/meta.go: add ABIVersion, ABIVersionMin, 45 dispatch method IDs
- tools/plugindev/cmd_init.go: cabiVersion -> meta.ABIVersion
- tools/plugindev/templates.go: C header comments reference meta.go
 2026-07-25 14:42:32 +08:00
JianFeeeee
cb7999ca71 feat: sdk NoMemory/Cleaner + example build fixes 
- sdk/plugin.go: ToolDef adds NoMemory/Cleaner fields
- sdk/plugin_test.go: unit tests for NoMemory/Cleaner
- all example plugins: NoMemory/Cleaner annotated for each tool
- plugindev/templates.go: template shows NoMemory/Cleaner pattern
- plugindev/cmd_build.go: fix ensureGoMod, buildBundle/buildTarget sdkPath param, NewPluginFactory
- example/go.mod: add external dependency declarations (chromedp, gofeed)
- add main.go stubs for all example plugins
 2026-07-25 11:17:21 +08:00
root
34f91ebd1a fix(browser): pre-allocate chromedp context, remove timeout contexts from interactive handlers 
- Pre-allocate browser in handleBrowserStart with chromedp.Run(s.ctx)
  to avoid the first-Run timeout killing the browser process
- Replace all per-action context.WithTimeout with s.ctx in navigate,
  click, type, screenshot, html, scroll handlers
- Add cleanupLoop goroutine for session-level timeout safety
- This matches chromedp docs warning: first Run with timeout context
  stops the entire browser
 2026-07-23 13:53:40 +08:00
root
5e0c8d5a40 feat(qq): download task tracking with qq_get_download_tasks, sync re-added 2026-07-23 10:41:08 +08:00
root
e182b89983 feat(qq): async file download, get_private_file_url, mark-as-read, get_recent_contacts 2026-07-23 10:36:49 +08:00
root
e030a9b9f9 refactor(qq): remove local message cache, direct NapCat query, URL-based file download 2026-07-23 10:27:55 +08:00
root
7705e4eb3b feat(a2a): add management tools (a2a_configure, a2a_restart, a2a_status) for dynamic config 2026-07-22 17:32:28 +08:00
root
ab3c0bfd2d fix(qq): use file_id instead of file field for group file download 
NapCat file messages have file_id in data["file_id"], not data["file"].
data["file"] is the filename, causing get_file API to return empty.
Also pass url field to downloadFile for URL-direct fallback.
 2026-07-21 15:33:41 +08:00
root
1a3e72e899 fix: use short config keys in RegisterDef, remove generics helpers 
- qq, a2a, bili, files, rss: RegisterDef keys changed from
  namespaced (e.g. "plugin.qq.listen") to short flat keys ("listen")
- a2a, bili: Get() calls updated to match short keys
- rss: replaced readCfg generics with getSetting, added SetAutoRestart(true)
- files: already uses short key Get, only RegisterDef needed fixing
 2026-07-21 13:20:13 +08:00
root
52dc22f86f feat: add example plugins (ai_image, calendar, music, rss, weather), fix .gitignore, move gengskill to tools/ 2026-07-21 12:45:17 +08:00
root
75ae2b4692 fix: napcat returns json.RawMessage to avoid double-quoting in C ABI bridge 
go_invoke_tool does json.Marshal(r) on handler results. When r is a string,
the raw JSON gets wrapped in quotes and escapes, causing the core's
json.Unmarshal into map[string]interface{} to fail (displayed as map[]).

Changed return type to json.RawMessage (implements json.Marshaler, outputs
raw bytes inline). Added rawString() helper for callers that need the
string representation.
 2026-07-20 17:51:36 +08:00
jianf
95dad649a8 feat: sdk install downloads from Release archive instead of git clone 
- Replace git clone --branch with HTTP download from GitCode archive URL
- No git dependency needed for SDK installation
- Extracts tar.gz archive in-memory, strips top-level directory
- Fallback for 'latest' still uses git ls-remote (lightweight)
 2026-07-20 11:50:55 +08:00
JianFeeeee
1bdec9507d feat: add NSIS Toolchain installer (plugindev + SDK auto-download) 2026-07-19 23:48:30 +08:00
jianf
1834a66bff feat: plugindev build --bundle for multi-platform .hmap 
- resolveBuild: use plugin.dylib for darwin (was plugin.so)
- --bundle flag: build linux/amd64 + darwin/amd64 + windows/amd64,
  package all binaries into a single .hmap with platforms field
- writePluginJSON: accept platforms []string for bundle manifest
- add createBundleHmap for zip entries with custom names
- add PlgConfig.IsLua() helper
 2026-07-19 12:05:42 +08:00
jianf
348a1447c8 feat: add package/build.sh cross-platform build script for plugindev 
- Supports linux/amd64, linux/arm64, darwin/amd64, darwin/arm64,
  windows/amd64, and 'all' for matrix build
 2026-07-19 11:40:21 +08:00
jianf
4f9e064721 fix: read SDK version from meta/meta.go for plugin go.mod 
- detectSDKInfo now returns SDK version from meta/meta.go
- Generated plugin go.mod uses real version (v0.7.1) instead of v0.0.0
- Tag v0.7.1 created for SDK version management
 2026-07-19 11:17:42 +08:00
jianf
49d19fb13c feat: plugindev sdk version management subcommand 
- Add 'plugindev sdk' subcommand with list/install/use/path/current/latest
- Replace runtime.Caller(0) path detection with managed SDK store
- SDK stored at ~/.homeagent/plugindev/sdk/<version>/
- Active version tracked via current file
- Lazy initialization to avoid blocking other subcommands
v0.7.1 		2026-07-19 11:14:27 +08:00
root
d38d42e57f docs: update output channel interface (payload/meta/type) in SDK docs 2026-07-19 10:35:25 +08:00
root
bf08764c29 refactor: qq output channel to payload/meta/type interface 
- handleChannelOutput: read payload/meta/type instead of content JSON
- Route by type: text/voice/image/file
- buildOutputHelp: show new parameter format
- Remove fixJSON (no longer needed without JSON-within-JSON)
 2026-07-19 10:29:22 +08:00
root
02997a0dca fix: QQ interrupt text explicitly requires output_send__ reply 2026-07-18 21:29:00 +08:00
root
2284d8897c feat: restore bili plugin, merge only web+webfetch into browser plugin 2026-07-18 21:11:18 +08:00
root
0856a9b2c3 feat: merge web/webfetch/bili into single browser plugin (search/fetch/render/video) 2026-07-18 21:06:56 +08:00
root
1762f0c34b docs: 修正全部文档使其与源码实现一致 
- Plugin.Start(sdk *PluginSDK) 接口签名改为指针
- 方法表重写: 移除 CallLLM/QueryKnowledge/SetMemory 等不存在方法
- IOInjector 参数顺序修正为 (source, channel, text)
- 删除虚构 SDKConfig, 替换为实际 New() 构造函数签名
- .hmap 内容描述一致化 (plugin.so + plugin.dll + main.lua)
- 添加 meta/ 包元数据文件
 2026-07-18 20:47:17 +08:00