设备代理

WesCraft 的 Electron 桌面应用内置 Device Agent,通过 MCP 协议向 AI 引擎暴露本机能力,让 AI 可以操作截屏、剪贴板、系统通知等设备功能。


什么是 Device Agent

Device Agent 是运行在用户设备上的本地代理程序,它:

Device Agent 不是引擎内置功能,而是 WesCraft 作为桌面应用的独有能力。


MCP 工具列表

工具功能说明
wescraft_screenshot截屏捕获屏幕截图并保存到收集箱,AI 可通过 Vision 分析
wescraft_clipboard_read读取剪贴板读取系统剪贴板文本,作为 AI 输入
wescraft_clipboard_write写入剪贴板将 AI 生成的内容写入剪贴板
wescraft_show_file文件定位在系统文件管理器中定位指定文件
wescraft_open_app打开应用启动指定的系统应用程序
wescraft_notify系统通知发送操作系统级别的通知提醒

与 wesgine Cell 的集成

注册方式

WesCraft 启动时,Device Agent 通过 cell.MCPs().Upsert() 将自己注册到当前 Cell。工具在 Cell 内可见,其他 Cell 的 Agent 无法调用。

生命周期

隔离性


使用示例

让 AI 分析屏幕内容:

请截取当前屏幕,告诉我上面显示了什么错误信息

让 AI 复制内容到剪贴板:

请把刚才生成的摘要复制到剪贴板

AI 完成耗时后台任务后会自动通过 wescraft_notify 发送系统通知。


安全考虑


相关文档