jianf/homeagent-sdk
1
0
Fork 0
mirror of https://gitcode.com/JianFeeeee/homeagent-sdk.git synced 2026-10-15 12:15:11 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
e0ee0c43bbfb20261552f8e50af9842d022922ec
homeagent-sdk/example/ai_image
History
JianFeeeee b6a6168e65 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 产物
2026-10-09 07:25:25 +08:00
..
go.mod
chore(module)!: module 路径随托管地迁移 gitcode → github
2026-10-09 07:25:25 +08:00
main.go
chore(module)!: module 路径随托管地迁移 gitcode → github
2026-10-09 07:25:25 +08:00
plg.json
feat(sdk): SettingsAPI.DataDir() + plugindev dispatchSettings 补 DataDir
2026-08-26 21:41:28 +08:00
plugin.go
chore(module)!: module 路径随托管地迁移 gitcode → github
2026-10-09 07:25:25 +08:00
README.md
docs(example): 为每个插件补 README
2026-09-20 00:43:06 +08:00

README.md

ai_image · 文生图

按文字提示生成图片，下载到本地并返回文件路径。

工具

工具 说明
ai_image_generate 按 prompt 生成图片

返回值是本地文件路径（永久，不过期）。要把图给用户看，再用导出的通道 以 type=image、payload=<该路径> 发送。

配置项

键 默认 说明
api_key 空 OpenAI / Stable Diffusion 的 API Key
base_url 空 自定义 OpenAI 兼容网关（不带 /v1 尾缀，如 http://127.0.0.1:8081）。留空走官方 https://api.openai.com
provider openai 服务方：openai / stability
model dall-e-3 模型名（如 dall-e-3、sd-xl）
size 1024x1024 默认尺寸，也可 1024x1792 / 1792x1024

实现要点

  • 返回本地路径而不是远端 URL：远端图床链接会过期，写进记忆就成了悬空指针。 下载到本地后路径稳定，可交给媒体存储做内容寻址。
  • 配了 base_url 就能指向自建/兼容网关，不必依赖官方接口。

构建

hmapdev build