executor

package
v0.0.0-...-66f2c83 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 19, 2026 License: Apache-2.0 Imports: 41 Imported by: 0

Documentation

Overview

Package executor 在这台电脑上执行服务端派发的操作:命令、文件读写、本机 MCP 工具调用、技能读取、浏览器与桌面动作,以及交给本机 Agent 的任务, 并以电脑身份连接服务端领取操作、上报过程与结果、提交本机 Agent 的权限请求与上报执行能力。

Index

Constants

This section is empty.

Variables

View Source
var ErrCredentialInvalid = errors.New("computer credential invalid")

ErrCredentialInvalid 表示服务端不再接受电脑凭据:电脑已撤销、主人已不是工作区的有效成员或凭据已更换。

View Source
var ErrExecutorOutdated = errors.New("executor version does not match the server")

ErrExecutorOutdated 表示服务端不接受这个版本的执行器,需要升级到与服务端一致的版本。

Functions

func Platform

func Platform() (domain.ComputerPlatform, bool)

Platform 返回当前运行平台对应的电脑平台,平台不能作为电脑时返回 false。

func ProbeMCPServer

func ProbeMCPServer(ctx context.Context, server localmcp.Server, environment localworkspace.Environment, dir string) error

ProbeMCPServer 试启动本地 MCP 服务并读取工具目录后关闭,失败时返回原因与服务最后的错误输出。

Types

type BrowserDriver

type BrowserDriver interface {
	// Do 在会话的浏览器上下文中执行一个动作,失败原因作为错误返回交给模型;session 是会话默认文件夹的名称。
	Do(ctx context.Context, session string, action domain.BrowserAction, arguments json.RawMessage) (domain.ComputerOutcome, error)
}

BrowserDriver 在这台电脑的浏览器中执行动作,每个会话使用独立的浏览器上下文,执行器保证同一会话同一时刻只执行一个浏览器动作。

type DesktopDriver

type DesktopDriver interface {
	// Do 执行一个桌面动作,失败原因作为错误返回交给模型。
	Do(ctx context.Context, action domain.DesktopAction, arguments json.RawMessage) (domain.ComputerOutcome, error)
}

DesktopDriver 在这台电脑的桌面上执行动作,执行器保证同一时刻只执行一个桌面动作。

type Host

type Host struct {
	// contains filtered or unexported fields
}

Host 在这台电脑上执行操作并汇总执行能力,同一台电脑注册到的全部工作区共用。

func NewHost

func NewHost(options HostOptions) *Host

NewHost 创建本机执行环境,本机 MCP 服务在首次读取能力时连接。

func (*Host) Capabilities

func (h *Host) Capabilities(ctx context.Context) (domain.ComputerCapabilities, error)

Capabilities 返回这台电脑当前的执行能力;本机 MCP 服务尚未连接时先连接并读取工具目录。

func (*Host) Close

func (h *Host) Close()

Close 关闭全部本机 MCP 服务连接。

func (*Host) Execute

func (h *Host) Execute(ctx context.Context, operation domain.ComputerOperation) domain.ComputerOutcome

Execute 在 ctx 的时限内执行一次操作,失败原因写入结果的 Error 交给模型,超过时限而失败时写入超时原因。

func (*Host) Refresh

func (h *Host) Refresh()

Refresh 在本机 MCP 配置、技能或运行环境变化后重新连接本机 MCP 服务并读取工具目录,完成后通知观察者重新上报能力。

func (*Host) Subscribe

func (h *Host) Subscribe(observer func()) func()

Subscribe 登记执行能力变化的观察者并返回取消登记的函数;观察者必须尽快返回。

type HostOptions

type HostOptions struct {
	// FolderRoot 是各会话默认文件夹的上级目录。
	FolderRoot string
	// Toolchain 返回命令与本机 MCP 服务使用的运行环境,以及托管的 uv、Node.js 与 Python 是否可用。
	Toolchain func() (localworkspace.Environment, bool)
	MCP       *localmcp.Store
	Skills    *localskill.Store
	// Browser 执行浏览器动作,为空表示这台电脑不支持浏览器操作。
	Browser BrowserDriver
	// Desktop 执行桌面动作,为空表示这台电脑不支持桌面操作。
	Desktop DesktopDriver
	// LocalAgents 读取配置的本机 Agent,为空表示只识别常见 Agent。
	LocalAgents *localagent.Store
}

HostOptions 定义执行操作使用的本机资源。

func NewHostOptions

func NewHostOptions(config LocalConfig) HostOptions

NewHostOptions 在数据目录中打开本机 MCP 与本机 Agent 配置、按技能目录打开技能存储,并带上平台给出的运行环境与驱动。

type Link struct {
	// contains filtered or unexported fields
}

Link 以电脑身份连接一个工作区:维持 Jetcast 通知与独立 HTTP 心跳,领取派发给这台电脑的操作并上报结果,执行能力变化时重新上报。

func StartLink(options LinkOptions) (*Link, error)

StartLink 建立执行器连接并开始实时通知、HTTP 心跳、领取与能力上报循环;服务器地址无效时返回错误。

func (*Link) Stop

func (l *Link) Stop()

Stop 结束连接、取消能力变化登记,等待执行中的操作退出并关闭本机 Agent 会话。

type LinkOptions

type LinkOptions struct {
	ServerURL           string
	Credential          string
	Host                *Host
	Concurrency         int
	OnCredentialInvalid func()
}

LinkOptions 定义一条执行器连接:服务器地址、电脑凭据、执行环境与同时执行的操作上限,上限为零时使用默认值,凭据失效时调用 OnCredentialInvalid。

type LocalConfig

type LocalConfig struct {
	// FolderRoot 是各会话默认文件夹的上级目录。
	FolderRoot string
	// DataDir 是本机 MCP 配置与本机 Agent 配置文件所在的目录。
	DataDir string
	// SkillDirs 是读取技能的目录,安装的技能写入第一个目录。
	SkillDirs []localskill.Dir
	// Toolchain 返回命令与本机 MCP 服务使用的运行环境,以及托管的 uv、Node.js 与 Python 是否可用。
	Toolchain func() (localworkspace.Environment, bool)
	// Browser 执行浏览器动作,为空表示这台电脑不支持浏览器操作。
	Browser BrowserDriver
	// Desktop 执行桌面动作,为空表示这台电脑不支持桌面操作。
	Desktop DesktopDriver
	// OnChange 在本机 MCP 配置或技能变化后调用。
	OnChange func()
}

LocalConfig 定义本机执行环境的数据位置与平台能力,桌面端与无界面执行器各自给出。

Directories

Path Synopsis
Package cli 是无界面执行器程序的命令行入口。
Package cli 是无界面执行器程序的命令行入口。
Package localagent 读取这台电脑上可以接受委派的本机 Agent:配置文件中添加的 Agent,与按已安装的命令行工具识别的常见 Agent。
Package localagent 读取这台电脑上可以接受委派的本机 Agent:配置文件中添加的 Agent,与按已安装的命令行工具识别的常见 Agent。
Package localmcp 保存这台电脑上由负责人的个人 AI 员工共用的本地 MCP 服务配置。
Package localmcp 保存这台电脑上由负责人的个人 AI 员工共用的本地 MCP 服务配置。
Package localskill 读取、安装与删除这台电脑上的 Agent Skills 技能。
Package localskill 读取、安装与删除这台电脑上的 Agent Skills 技能。
Package localworkspace 提供本机文件的读写与命令执行,相对路径与命令工作目录以会话默认文件夹为起点,模型看到的是本机绝对路径。
Package localworkspace 提供本机文件的读写与命令执行,相对路径与命令工作目录以会话默认文件夹为起点,模型看到的是本机绝对路径。
Package toolchain 在本机准备 Agent 命令与本地 MCP 服务使用的 uv、Node.js 与默认 Python,并给出命令的环境变量。
Package toolchain 在本机准备 Agent 命令与本地 MCP 服务使用的 uv、Node.js 与默认 Python,并给出命令的环境变量。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL