# DevOS

**Repository Path**: ai-learning_3/dev-os

## Basic Information

- **Project Name**: DevOS
- **Description**: The AI Operating System for Developers
开发者 AI 操作系统，包含 Python 后端、Flutter 移动端、Vue3 Web 控制台。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevOS

**语言 / Language**: [中文](README.md) | [English](README.en.md)

开发者 AI 操作系统，包含 Python 后端、Flutter 移动端、Vue3 Web 控制台。  
主 README 仅保留核心导航；实现细节与案例说明统一下沉到子模块文档。

## 核心模块（6）

| 模块 | 核心职责 | 代表接口 |
|---|---|---|
| AI Chat | 对话编排、流式回复、需求理解 | `/chat`、`/chat/stream` |
| RAG Knowledge | 文档解析、知识检索、知识补充 | `/rag/ask`、`/rag/retrieve`、`/rag/doc-parsing/*` |
| Agent System | 智能体管理、任务拆解、协作执行 | `/agent/*`、`/agent/collab/*` |
| Dev Tools | 工具发现、协议化调用（MCP） | `/agent/tool/invoke`、`/mcp/tools`、`/mcp/invoke` |
| Workflow Automation | DAG 编排、调度、执行与重试 | `/automation/*` |
| Project Runtime | 运行验证、闭环交付、自动修复 | `/devos/*`（兼容 `/ai-dev-os/*`） |

## 仓库结构

```text
ai_chat/
├── python/            # 后端与 Agent 能力
├── web/               # Web 控制台
├── flutter_ai_chat/   # Flutter 客户端
├── docs/              # 架构/功能/流程文档
└── scripts/           # 启动、检查、冒烟脚本
```

## 快速开始

```bash
# 1) 启动后端
./scripts/start_api.sh

# 2) 启动 Web
./scripts/start_web.sh

# 3) 启动 Flutter（可选）
./scripts/start_flutter.sh
```

常用重启：

- `./scripts/restart_web.sh`
- `./scripts/restart_dev.sh`

## 常用检查

```bash
# 全量检查（规则校验 + 冒烟 + 构建）
./scripts/check_all.sh

# Agent 模块全链路冒烟
sh ./scripts/smoke_agent_module.sh

# AI 助手（轻量案例）页面冒烟
cd web && npm run smoke:ai-assistant-lite

# Assistant 迁移案例集合冒烟
cd web && npm run smoke:assistant-cases

# 清理本地产物
sh ./scripts/clean_runtime_artifacts.sh

# OpenClaw 对标回归（需 API 已启动）
make openclaw-smoke

# 一体化检查 + OpenClaw 回归（跳过 web/flutter）
make check-all-openclaw

# 聚合 OpenClaw 指标（生成 json+md）
make openclaw-metrics
```

CI:
- 已提供 GitHub Actions 工作流：`.github/workflows/openclaw-smoke.yml`

## 最近更新（Web）

- AI 助手（轻量案例）重构为聊天中心布局：`选 Agent -> 一键测试 -> 持续对话`，上下文压缩与代码索引统一到右侧能力面板。
- 代码索引上下文支持按文件链路：`加载文件清单 -> 选择具体文件 -> 文件内语义检索 -> 一键加入聊天上下文并提问`。
- AI 助手（轻量案例）已整合 `AI聊天（流式）` 与 `知识库问答（RAG）`，作为默认对话入口。
- Workflow 页面移除说明型模块（实战案例库映射 / 系统进阶学习路径 / 专题联动导航），保留核心执行工作区。
- Workflow 独立页面已下线并整合到案例中心，统一由“自动任务案例”承载模板切换、执行与调度能力。
- Agent 模块收敛为单一高级控制台（`/agent`），移除重复子页入口，减少维护与跳转成本。
- 工具调用与自动任务能力已迁移至案例中心独立案例，Agent 页面聚焦高级配置、轨迹诊断与 Automation 调度。
- 案例中心已收敛 Workflow 入口：`Git Ops` / `DevOps Auto` / `Enterprise Full` 三个壳页并入 `自动任务` 单入口，按场景预设切换执行。
- 案例中心入口改为按业务链路分组展示，并对常用入口增加轻量“推荐”标识，降低首次使用的选择成本。

## 文档导航

### 技术模块

- Python Backend: [`python/README.md`](python/README.md)
- Web Console: [`web/README.md`](web/README.md)
- Flutter App: [`flutter_ai_chat/README.md`](flutter_ai_chat/README.md)

### 功能与架构

- Agent System: [`docs/features/agent.md`](docs/features/agent.md)
- RAG Knowledge: [`docs/features/rag.md`](docs/features/rag.md)
- Workflow: [`docs/features/workflow.md`](docs/features/workflow.md)
- Architecture Overview: [`docs/architecture/overview.md`](docs/architecture/overview.md)
- API Contract: [`docs/architecture/api-contract.md`](docs/architecture/api-contract.md)
- Testing Guide: [`docs/guides/testing.md`](docs/guides/testing.md)

---

如果你是首次接入本项目，建议顺序：`README.md -> python/README.md -> web/README.md -> docs/guides/testing.md`。