# Argo

**Repository Path**: yr_binary/argo

## Basic Information

- **Project Name**: Argo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-14
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Observer

桌面端可观察 AI Agent 原型。后端使用 FastAPI，前端使用 Three.js，Tauri 打包为桌面应用。

## 运行

```powershell
.\run_backend.ps1
```

打开：

```text
http://127.0.0.1:8765
```

路线编辑器：

```text
http://127.0.0.1:8765/route-editor.html
```

## 目录

```text
agent_runtime/        Agent 规则、规划、工具策略
frontend/             主页面 HTML/CSS/JS 和路线编辑器脚本样式
assets/models/        3D 模型文件
assets/routes/        路线与事件绑定 JSON
docs/                 设计、安全、运行说明文档
scripts/              打包与同步脚本
src-tauri/            Tauri 桌面壳
tests/                自测脚本
```

根目录只保留启动、依赖、配置和入口类文件。

## 本地密钥

- `runtime-config.json` 只保存模型、工作区、知识库等普通配置，不保存 API Key。
- `api-keys.local.json` 只保存 OpenAI/Kimi/豆包等 API Key，位于项目根目录，并已加入 `.gitignore`。
- 在设置页输入并保存 API Key 后，后端会自动生成或更新 `api-keys.local.json`；上传到 Gitee 前不要提交这个文件。

## 关键文件

- `agent_server.py`：FastAPI 后端与 Agent 工具运行时
- `run_backend.ps1`：创建/使用 `.venv` 并启动后端
- `requirements.txt`：Python 依赖
- `package.json`：Tauri 命令
- `frontend/index.html`：主页面
- `frontend/app.js`：前端交互与 2.5D 可视化
- `assets/models/办公室.glb`：办公室模型
- `assets/routes/routes.json`：节点、主线、支线和事件绑定

## 打包同步

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\prepare_tauri_bundle.ps1
```

该脚本会把 `frontend/` 内容复制到 `dist-tauri/` 根部，并复制 `assets/`、`editor/`、`agent_runtime/` 和后端入口文件。

## 文档

- `docs/AGENT_RUNTIME.md`
- `docs/SECURITY_PACKAGING.md`