# keeper

**Repository Path**: code-me/keeper

## Basic Information

- **Project Name**: keeper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Local Manus Agent

在本地沙箱目录中运行的通用 Agent 应用：对齐 `docs/工具集.md` 中的工具能力（文件、Shell、浏览器、网络搜索、规划、用户消息等），通过 OpenAI 兼容 API 进行工具调用循环；界面参考 Manus / Cursor 风格的深色三栏布局。

## 运行方式

1. **配置环境变量**（复制 `backend/.env.example` 为 `backend/.env`）：

   - `OPENAI_API_KEY`：调用 OpenAI 官方时必填。
   - **阿里云百炼**：可使用 `DASHSCOPE_API_KEY` 代替 `OPENAI_API_KEY`（二选一），并将 `OPENAI_BASE_URL` 设为百炼 **OpenAI 兼容模式** 地址（例如北京：`https://dashscope.aliyuncs.com/compatible-mode/v1`），`MODEL` 设为千问模型名（如 `qwen-flash`）。各地域端点见 `backend/.env.example` 注释。
   - `MODEL`：可选，默认 `gpt-4o-mini`。
   - `SANDBOX_ROOT`：可选，沙箱根目录，默认为仓库下的 `sandbox_workspace`。

2. **安装后端依赖**：

   ```bash
   cd backend && pip install -r requirements.txt
   ```

3. **启动 API**（默认 `http://127.0.0.1:8765`）：

   ```bash
   cd backend && python -m uvicorn app.main:app --host 127.0.0.1 --port 8765
   ```

4. **前端**（开发时热更新，已配置代理到 8765）：

   ```bash
   cd frontend && npm install && npm run dev
   ```

   浏览器打开 Vite 提示的地址（一般为 `http://localhost:5173`）。

5. **仅后端 + 内置前端**：先执行 `cd frontend && npm run build`，再启动 uvicorn，然后访问 `http://127.0.0.1:8765/`。

## 可选：浏览器工具

安装 Playwright 浏览器内核（体积较大）：

```bash
pip install playwright && playwright install chromium
```

## 说明

- 会话与消息默认持久化到 `.local/sessions.json`，重启后端后可恢复。
- `数据接口.md` 中的云端 Manus API 仅作产品参考；本应用不调用这些接口。