# work-agent

**Repository Path**: gooree/work-agent

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Office Agent（脚手架 / Scaffold）

本地优先的办公 AI 同事 —— 新项目脚手架，基于 `PRD-OpenWorker.md` 的产品技术栈生成。
**不改动原 `open-worker` 仓库代码**，本目录为独立产品骨架。

## 技术栈（与 PRD §四 一致）
- **后端**：Python + FastAPI，REST（`/v1/...`）+ WebSocket（`/v1/ws`）
- **持久化**：SQLite（本地单文件，零运维）
- **LLM 接入**：OpenAI 兼容适配层，首期内置国产模板
  - DeepSeek / Qwen(通义) / GLM(智谱) / Kimi(月之暗面) / MiniMax
  - 任意第三方 OpenAI 兼容端点（填 `base_url` + Key + 模型名即可）
  - 海外 provider 默认禁用，受 `region_policy=domestic` 约束
- **知识库 / RAG**：本地向量库（SQLite 向量扩展占位）+ 可插拔嵌入器（默认离线占位，生产可换本地模型/Provider 嵌入）
- **连接器**：仅预留统一适配契约（首期不接海外/国内渠道，海外调用返回未启用，不静默外联）
- **前端**：React + TypeScript（Vite），桌面壳 Tauri（Rust sidecar 拉起 Python 服务）；另含 Textual TUI 规划位
- **客户端缓存**：IndexedDB / localStorage（GUI 缓存会话列表、连接器状态）

## 目录结构
```
office-agent/
├── backend/                 # Python FastAPI 服务
│   ├── app/
│   │   ├── main.py          # 应用装配 + CORS + 路由
│   │   ├── config.py        # 设置（env: OA_ 前缀）
│   │   ├── models/          # Pydantic 数据模型（≈ PRD TS 接口）
│   │   ├── db/sqlite.py     # SQLite 持久化（会话/消息/记忆/KB/审批/关系）
│   │   ├── providers/       # LLM：base + openai_compatible + domestic registry
│   │   ├── knowledge/       # RAG：embedder + vector store + service
│   │   ├── connectors/      # 适配器契约（首期预留）
│   │   ├── skills/          # 文件夹驱动 Markdown 技能存储
│   │   ├── core/            # session_manager / approval / engine / catalog
│   │   ├── routers/         # v1 REST + WS 路由
│   │   └── ws/events.py     # 事件中心（审批/inbox 推送）
│   └── pyproject.toml
├── frontend/                # React + TS GUI（Vite）+ Tauri 壳
│   ├── src/{types.ts,api.ts,App.tsx,main.tsx}
│   └── src-tauri/           # Tauri 最小配置 stub
└── docs/ARCHITECTURE.md
```

## 快速开始
```bash
# 后端
cd backend
python -m venv .venv && source .venv/bin/activate
pip install -e .
uvicorn app.main:app --host 127.0.0.1 --port 8787
# 文档: http://127.0.0.1:8787/docs

# 前端（另开终端）
cd frontend
npm install && npm run dev
```

## 首期范围与排除（详见 PRD §五）
- **做**：本地优先 + 国产 OpenAI 兼容 LLM + 本地知识库 RAG + 无人值守/跨渠道架构 + 三端（GUI/TUI/WS）
- **不做**：海外连接器接入（仅预留）、多租户/SSO、实时多人协作、云端 SaaS、可视化流程编排、预置技能内容、移动端、模型微调