mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-15 12:15:16 +00:00
## 背景 仓库早已迁移到 GitHub(`github.com/JianFeeeee/HomeAgent`,CI/CD 都在那边跑), gitcode 保留为**国内只读镜像**(`ci.yml` 的 sync-gitcode-main 快进推送)。 但 go.mod 的 module 路径一直是 `gitcode.com/JianFeeeee/...` —— 既与权威源 不符,`meta.SourceURL`(AGPL §13 的源码提供入口)也指向镜像而非实际运行的代码。 ## 关键区分(这是本次改动安全的前提) 两个 module 是**不同**的,影响面差一个数量级: | module | 谁依赖 | 改它的后果 | |---|---|---| | `.../HomeAgent`(主仓) | **只有主仓自己** | 内部重构,零外部影响 | | `.../homeagent-sdk`(SDK 仓) | 主仓 49 文件 + 所有外部插件 | 需重编插件 | ★ 实测确认:**插件不 import 主仓 module**(`strings qq/plugin.bin | grep HomeAgent` = 0), 只依赖 SDK 仓。而插件与内核的边界是 **RPC 方法名字符串** (`plugin.init` / `tool.invoke`…,见 proc/protocol.go),**与 Go module 名无关**。 ⇒ module 改名**不改变任何 wire 协议**,现网已装的插件照常运行。 SDK 的 GitHub 仓名是 `homeagentsdk`(无连字符),module 路径必须与之精确匹配, 否则 `go get` 会因路径不符失败,故取 `github.com/JianFeeeee/homeagentsdk`。 ## 改动 - `go.mod` / `go.sum`:两个 module 路径 + require/replace - 277 个 Go 文件 + Makefile + 打包脚本的 import 与 ldflags 路径 - SDK 仓 `meta.CoreModule`、`tools/hmapdev` 的 module 声明与工程模板 - 对外文档/链接的仓库地址(README、PLUGIN_DEV、OVERVIEW 等) ## 明确**保留** gitcode 的地方(镜像机制,不能动) - `GITCODE_TOKEN`、`GC_URL="…@gitcode.com"`(CI 同步 job) - `gitcode.com/api/v5/...`(release 附件上传) - git remote `gitcode`(镜像拉取/推送) - `docs/zh/ci-cd-runbook.md`(整篇讲镜像运维) ## 验证 - `go build ./...` / `go vet ./...` 绿 - `go test ./... -count=1` → 48 包 ok / 0 FAIL - hmapdev 工具链编译通过(`third_party/homeagent-sdk/tools/hmapdev`) - 全仓残留检查:module 形态的 `gitcode.com/JianFeeeee` = 0 - 镜像机制抽验:GC_URL / @gitcode / api/v5 / remote 均完好 ## 顺带修正 `hmapdev/templates.go` 的注释此前写「gitcode 的模块不在 proxy.golang.org 上」—— module 已迁 GitHub,该论断不再成立。改为如实说明**为何仍默认 replace 到本机 SDK**: 离线可构建、避免版本漂移、内网可用。理由与托管地无关,故 replace 保留。
162 lines
4.2 KiB
Go
162 lines
4.2 KiB
Go
package sdk
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
|
||
agentAPI "github.com/JianFeeeee/HomeAgent/internal/agent/api"
|
||
internalConfig "github.com/JianFeeeee/HomeAgent/internal/config"
|
||
luaVM "github.com/JianFeeeee/HomeAgent/internal/lua"
|
||
)
|
||
|
||
type llmImpl struct {
|
||
mgr *agentAPI.ProviderManager
|
||
cfgReg *internalConfig.ConfigRegistry
|
||
lua *luaVM.VM
|
||
baseAPIKey string
|
||
}
|
||
|
||
func NewLLM(mgr *agentAPI.ProviderManager, cfgReg *internalConfig.ConfigRegistry, lua *luaVM.VM, baseAPIKey string) LLMAPI {
|
||
return &llmImpl{mgr: mgr, cfgReg: cfgReg, lua: lua, baseAPIKey: baseAPIKey}
|
||
}
|
||
|
||
func (l *llmImpl) ListSources() []string {
|
||
if l.mgr == nil {
|
||
return nil
|
||
}
|
||
return l.mgr.List()
|
||
}
|
||
|
||
func (l *llmImpl) SetSource(name string) error {
|
||
if l.mgr == nil {
|
||
return nil
|
||
}
|
||
return l.mgr.SetDefault(name)
|
||
}
|
||
|
||
func (l *llmImpl) CurrentSource() string {
|
||
if l.mgr == nil {
|
||
return ""
|
||
}
|
||
p := l.mgr.Default()
|
||
if p == nil {
|
||
return ""
|
||
}
|
||
return p.Name()
|
||
}
|
||
|
||
func (l *llmImpl) Chat(ctx context.Context, req *LLMCompletionRequest) (*LLMCompletionResponse, error) {
|
||
if l.mgr == nil {
|
||
return nil, fmt.Errorf("llm: provider manager not available")
|
||
}
|
||
p := l.mgr.Default()
|
||
if p == nil {
|
||
return nil, fmt.Errorf("llm: no default provider")
|
||
}
|
||
apiReq := &agentAPI.CompletionRequest{
|
||
Model: req.Model,
|
||
Temperature: req.Temperature,
|
||
MaxTokens: req.MaxTokens,
|
||
Stream: req.Stream,
|
||
Tools: req.Tools,
|
||
ToolChoice: req.ToolChoice,
|
||
DisableThinking: req.DisableThinking,
|
||
}
|
||
if len(req.Messages) > 0 {
|
||
apiReq.Messages = make([]agentAPI.Message, len(req.Messages))
|
||
for i, m := range req.Messages {
|
||
msg := agentAPI.Message{
|
||
Role: m.Role,
|
||
Content: m.Content,
|
||
ReasoningContent: m.ReasoningContent,
|
||
ToolCallID: m.ToolCallID,
|
||
}
|
||
// 多模态 Blocks:text/image_url → agentAPI.ContentBlock
|
||
for _, b := range m.Blocks {
|
||
switch b.Type {
|
||
case "text":
|
||
msg.Blocks = append(msg.Blocks, agentAPI.ContentBlock{Type: "text", Text: b.Text})
|
||
case "image_url":
|
||
msg.Blocks = append(msg.Blocks, agentAPI.ContentBlock{
|
||
Type: "image_url",
|
||
ImageURL: &agentAPI.ImageURL{URL: b.ImageURL, Detail: "high"},
|
||
})
|
||
}
|
||
}
|
||
if len(m.ToolCalls) > 0 {
|
||
msg.ToolCalls = make([]agentAPI.ToolCall, len(m.ToolCalls))
|
||
for j, tc := range m.ToolCalls {
|
||
msg.ToolCalls[j] = agentAPI.ToolCall{ID: tc.ID, Name: tc.Name, Arguments: tc.Arguments}
|
||
}
|
||
}
|
||
apiReq.Messages[i] = msg
|
||
}
|
||
}
|
||
resp, err := p.Chat(ctx, apiReq)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
out := &LLMCompletionResponse{
|
||
Content: resp.Content,
|
||
ReasoningContent: resp.ReasoningContent,
|
||
FinishReason: resp.FinishReason,
|
||
TokenUsage: LLMTokenUsage{
|
||
Prompt: resp.TokenUsage.Prompt,
|
||
Completion: resp.TokenUsage.Completion,
|
||
Total: resp.TokenUsage.Total,
|
||
},
|
||
}
|
||
for _, tc := range resp.ToolCalls {
|
||
out.ToolCalls = append(out.ToolCalls, LLMToolCall{ID: tc.ID, Name: tc.Name, Arguments: tc.Arguments})
|
||
}
|
||
return out, nil
|
||
}
|
||
|
||
func (l *llmImpl) ReloadFromConfig() error {
|
||
if l.mgr == nil || l.cfgReg == nil || l.lua == nil {
|
||
return nil
|
||
}
|
||
cfg := l.cfgReg.ToConfig()
|
||
if cfg == nil {
|
||
return nil
|
||
}
|
||
l.mgr.Reset()
|
||
adapterConcurrency := map[string]int{}
|
||
for _, src := range cfg.LLM.Sources {
|
||
if !agentAPI.IsValidSourceConfig(src.Name, src.BaseURL, src.Model, src.Adapter) {
|
||
continue
|
||
}
|
||
key := src.APIKey
|
||
if key == "" {
|
||
key = l.baseAPIKey
|
||
}
|
||
provider := agentAPI.NewLuaAdaptedProvider(agentAPI.BaseConfig{
|
||
Model: src.Model,
|
||
BaseURL: src.BaseURL,
|
||
APIKey: key,
|
||
Temperature: cfg.LLM.Temperature,
|
||
MaxTokens: cfg.LLM.MaxTokens,
|
||
ContextWindow: src.ContextWindow,
|
||
MaxConcurrent: src.MaxConcurrent,
|
||
Priority: src.Priority,
|
||
Vision: src.Vision,
|
||
Audio: src.Audio,
|
||
}, l.lua, src.Name, src.Adapter)
|
||
l.mgr.Register(src.Name, provider)
|
||
if src.Adapter != "" {
|
||
adapterConcurrency[src.Adapter] += src.MaxConcurrent
|
||
}
|
||
}
|
||
if l.lua != nil {
|
||
l.lua.ConfigureConcurrency(adapterConcurrency)
|
||
}
|
||
if cfg.LLM.Provider != "" {
|
||
if l.mgr.Get(cfg.LLM.Provider) != nil {
|
||
_ = l.mgr.SetDefault(cfg.LLM.Provider)
|
||
}
|
||
}
|
||
return nil
|
||
}
|
||
|
||
var _ LLMAPI = (*llmImpl)(nil)
|