HomeAgent/internal/plugins/cmd/plugin.go

package cmd

import (
	"bytes"
	"context"
	"fmt"
	"os/exec"
	"strings"
	"sync"
	"time"

	"gitcode.com/JianFeeeee/HomeAgent/internal/plugin"
	sdk "gitcode.com/JianFeeeee/HomeAgent/internal/sdk"
)

// shellUnquote 拆解命令字符串，处理单引号/双引号包裹的参数
func shellUnquote(s string) []string {
	var args []string
	var cur strings.Builder
	inSingle := false
	inDouble := false
	for i := 0; i < len(s); i++ {
		c := s[i]
		switch {
		case c == '\'' && !inDouble:
			inSingle = !inSingle
		case c == '"' && !inSingle:
			inDouble = !inDouble
		case (c == ' ' || c == '\t') && !inSingle && !inDouble:
			if cur.Len() > 0 {
				args = append(args, cur.String())
				cur.Reset()
			}
		default:
			cur.WriteByte(c)
		}
	}
	if cur.Len() > 0 {
		args = append(args, cur.String())
	}
	return args
}

func init() {
	plugin.RegisterPluginMeta("cmd", "命令执行", "Command")
	plugin.RegisterFactory("cmd", func(name string, config map[string]interface{}) (sdk.Plugin, error) {
		return New(name), nil
	})
}

type cmdRecord struct {
	Timestamp time.Time `json:"timestamp"`
	Command   string    `json:"command"`
	Stdout    string    `json:"stdout"`
	Stderr    string    `json:"stderr"`
	ExitCode  int       `json:"exit_code"`
	Workdir   string    `json:"workdir"`
	Timeout   string    `json:"timeout"`
	Duration  string    `json:"duration"`
	Status    string    `json:"status"`
}

const maxHistory = 100

type Plugin struct {
	name           string
	defaultTimeout string
	maxOutput      int
	mu             sync.Mutex
	history        []cmdRecord
}

func New(name string) *Plugin {
	return &Plugin{name: name}
}

func (p *Plugin) Name() string { return p.name }

func (p *Plugin) Start(s *sdk.PluginSDK) error {
	s.Settings().RegisterDef(sdk.ConfigDef{
		Key: "default_timeout", Type: "string", DisplayName: "默认命令超时",
		Description: "命令执行的默认超时时间，例如 30s, 1m, 5m（默认 30s）",
		Default:     "30s",
	})
	s.Settings().RegisterDef(sdk.ConfigDef{
		Key: "max_output_bytes", Type: "int", DisplayName: "最大输出字节数",
		Description: "命令输出的最大字节数，超出部分将被截断（默认 32000）",
		Default:     "32000",
	})
	p.maxOutput = 32000
	if v, _ := s.Settings().Get("max_output_bytes"); v != nil {
		if s, ok := v.(string); ok && s != "" {
			if n, err := fmt.Sscanf(s, "%d", &p.maxOutput); err == nil && n > 0 {
			}
		}
	}
	p.defaultTimeout = "30s"
	if v, _ := s.Settings().Get("default_timeout"); v != nil {
		if s, ok := v.(string); ok && s != "" {
			p.defaultTimeout = s
		}
	}

	s.RegisterTool("cmd_run", sdk.ToolDef{
		Name:        "cmd_run",
		Description: "执行一条系统命令并返回输出。适用于查询系统信息、运行脚本、操作文件等单次命令场景。命令在临时 shell 中执行，不支持交互。如需交互式终端（如 vim、ssh、top），请使用 terminal_create 相关工具。",
		Parameters: map[string]interface{}{
			"type": "object",
			"properties": map[string]interface{}{
				"command": map[string]interface{}{
					"type":        "string",
					"description": "要执行的命令",
				},
				"timeout": map[string]interface{}{
					"type":        "string",
					"description": "超时时间，例如 10s, 1m, 30s（默认 30s）",
				},
				"workdir": map[string]interface{}{
					"type":        "string",
					"description": "工作目录（可选，默认由 core.agent.workdir 配置决定）",
				},
			},
			"required": []string{"command"},
		},
	}, func(args map[string]interface{}) (interface{}, error) {
		command, _ := args["command"].(string)
		if command == "" {
			return map[string]interface{}{"error": "command is required"}, nil
		}

		timeoutStr, _ := args["timeout"].(string)
		if timeoutStr == "" {
			timeoutStr = p.defaultTimeout
		}
		timeout, err := time.ParseDuration(timeoutStr)
		if err != nil {
			return map[string]interface{}{"error": fmt.Sprintf("invalid timeout %q: %v", timeoutStr, err)}, nil
		}

		workdir, _ := args["workdir"].(string)
		if workdir == "" {
			if sett := s.Settings(); sett != nil {
				if v, _ := sett.GetCore("core.agent.workdir"); v != nil {
					if str, ok := v.(string); ok && str != "" {
						workdir = str
					}
				}
			}
		}

		tStart := time.Now()
		ctx, cancel := context.WithTimeout(context.Background(), timeout)
		defer cancel()

		parts := shellUnquote(command)
		if len(parts) == 0 {
			return map[string]interface{}{"error": "command is required"}, nil
		}
		cmd := exec.CommandContext(ctx, parts[0], parts[1:]...)
		if workdir != "" {
			cmd.Dir = workdir
		}

		var stdout, stderr bytes.Buffer
		cmd.Stdout = &stdout
		cmd.Stderr = &stderr

		rec := cmdRecord{Timestamp: tStart, Command: command, Workdir: workdir, Timeout: timeoutStr}
		exitCode := -1

		if err := cmd.Run(); err != nil {
			if ctx.Err() != nil {
				rec.Status = "timeout"
				rec.Stdout = p.truncateOutput(stdout.String())
				rec.Stderr = p.truncateOutput(stderr.String())
				rec.Duration = time.Since(tStart).Round(time.Millisecond).String()
				p.recordCmd(rec)
				return map[string]interface{}{
					"status": "timeout",
					"stdout": rec.Stdout,
					"stderr": rec.Stderr,
					"error":  fmt.Sprintf("命令执行超时（%s）", timeoutStr),
				}, nil
			}
		}
		if cmd.ProcessState != nil {
			exitCode = cmd.ProcessState.ExitCode()
		}

		rec.Status = "ok"
		rec.Stdout = p.truncateOutput(stdout.String())
		rec.Stderr = p.truncateOutput(stderr.String())
		rec.ExitCode = exitCode
		rec.Duration = time.Since(tStart).Round(time.Millisecond).String()
		p.recordCmd(rec)

		return map[string]interface{}{
			"status":     "ok",
			"stdout":     rec.Stdout,
			"stderr":     rec.Stderr,
			"exit_code":  exitCode,
			"command":    command,
		}, nil
	})

	return nil
}

func (p *Plugin) Stop() error {
	return nil
}

func (p *Plugin) recordCmd(r cmdRecord) {
	p.mu.Lock()
	defer p.mu.Unlock()
	p.history = append(p.history, r)
	if len(p.history) > maxHistory {
		p.history = p.history[len(p.history)-maxHistory:]
	}
}

func (p *Plugin) truncateOutput(s string) string {
	maxLen := p.maxOutput
	if maxLen <= 0 {
		maxLen = 32000
	}
	if len(s) > maxLen {
		return s[:maxLen] + fmt.Sprintf("\n... [输出被截断，共 %d 字节]", len(s))
	}
	return strings.TrimRight(s, "\n")
}