设备代理
WesCraft 的 Electron 桌面应用内置 Device Agent,通过 MCP 协议向 AI 引擎暴露本机能力,让 AI 可以操作截屏、剪贴板、系统通知等设备功能。
什么是 Device Agent
Device Agent 是运行在用户设备上的本地代理程序,它:
- 将本机设备能力封装为标准 MCP 工具
- 通过 MCP 协议注册到当前 Cell,让 AI Agent 可以调用
- 物理串行执行,保证操作安全性
- 随 Electron 应用启动和关闭
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 无法调用。
生命周期
- 启动:Electron 应用启动时自动注册
- 运行:持续响应 AI 的工具调用
- 关闭:Electron 关闭时工具从 Cell 视图消失
隔离性
- 工具仅在当前 Cell 内可见
- 团队版中不同 Cell 的 Agent 不能跨 Cell 调用
- Device Agent 内部互斥保证操作串行
使用示例
让 AI 分析屏幕内容:
请截取当前屏幕,告诉我上面显示了什么错误信息
让 AI 复制内容到剪贴板:
请把刚才生成的摘要复制到剪贴板
AI 完成耗时后台任务后会自动通过 wescraft_notify 发送系统通知。
安全考虑
- 所有操作都经过 wesgine 治理链检查
- 截屏等敏感操作在
locked模式下可能被限制 - 工具调用记录可在观测面板中查看
相关文档
- AI 交互模式 →
ai-interaction.md - 设置 →
settings.md - 架构 →
architecture.md - 数据安全 →
data-security.md