Observer

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Node.js 与 TypeScript 运行环境（项目用 TypeScript 编写）
• 本地推理后端：llama.cpp 或 Ollama 等本地大模型
• 多模态模型（截图分析）或 OCR 能力的模型
• 浏览器需允许屏幕共享、通知、麦克风权限（用到音频传感器时）
• Docker 方式官方已标记为废弃，仅作备选

安装与启动步骤

1. 1获取并启动应用

   README 推荐使用 Observer App 进行本地推理；也可按官网 observer-ai.com 指引获取。Docker 方式已废弃，需另看 docker/DOCKER.md。

2. 2打开 Agent Dashboard

   进入 Agent Dashboard，这是创建和管理微智能体的主界面，创建、测试、上传都在这里完成。

3. 3新建智能体

   在 Dashboard 点击 Create New Agent 新建一个智能体，随后进入 Configuration 标签页填写信息。

4. 4填写基础配置

   在 Configuration 标签页填写名称、描述、所用模型和 loop interval（循环间隔），决定智能体的运行频率。

5. 5设置系统提示词

   为模型编写 system prompt，说明要观察什么、在什么条件下触发什么动作，例如“当我分心时打电话给我”。

6. 6添加传感器

   按需添加 Sensors：$SCREEN 截图、$SCREEN_OCR 屏幕文字、$CAMERA、$CLIPBOARD、$MEMORY 等，在提示词中引用。

7. 7保存并测试

   在 Dashboard 中保存并试运行，确认模型能读到传感器内容并按条件触发通知等工具。

8. 8上传分享（可选）

   调试满意后把智能体上传到社区，供其他人复用；注意其中不要包含个人隐私数据。

关键配置

如何确认成功

在 Dashboard 运行该智能体，能看到它按 loop interval 读取 $SCREEN 等内容并触发通知或输出，即视为工作正常。

常见问题

注意事项

• README 未给出具体安装命令，本教程仅依据其 Dashboard 操作流程整理，请以官网 observer-ai.com 与仓库最新说明为准。
• 涉及屏幕、摄像头、麦克风的传感器需在浏览器中授予对应权限，部分浏览器会拦截通知。
• 通知类工具可能需要账号匹配，例如 sendEmail 必须使用已登录的邮箱。
• 屏幕数据敏感，上传智能体到社区前请确认提示词和记忆中不含隐私内容。