Documentation
¶
Overview ¶
Package executor 在这台电脑上执行服务端派发的操作:命令、文件读写、本机 MCP 工具调用、技能读取、浏览器与桌面动作,以及交给本机 Agent 的任务, 并以电脑身份连接服务端领取操作、上报过程与结果、提交本机 Agent 的权限请求与上报执行能力。
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ErrCredentialInvalid = errors.New("computer credential invalid")
ErrCredentialInvalid 表示服务端不再接受电脑凭据:电脑已撤销、主人已不是工作区的有效成员或凭据已更换。
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 (*Host) Capabilities ¶
Capabilities 返回这台电脑当前的执行能力;本机 MCP 服务尚未连接时先连接并读取工具目录。
func (*Host) Execute ¶
func (h *Host) Execute(ctx context.Context, operation domain.ComputerOperation) domain.ComputerOutcome
Execute 在 ctx 的时限内执行一次操作,失败原因写入结果的 Error 交给模型,超过时限而失败时写入超时原因。
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 ¶
type Link struct {
// contains filtered or unexported fields
}
Link 以电脑身份连接一个工作区:维持 Jetcast 通知与独立 HTTP 心跳,领取派发给这台电脑的操作并上报结果,执行能力变化时重新上报。
func StartLink ¶
func StartLink(options LinkOptions) (*Link, error)
StartLink 建立执行器连接并开始实时通知、HTTP 心跳、领取与能力上报循环;服务器地址无效时返回错误。
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 定义本机执行环境的数据位置与平台能力,桌面端与无界面执行器各自给出。
Source Files
¶
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,并给出命令的环境变量。 |