# ARS 前端 Demo

本仓库是 **ARS（Agent Runtime Server）** 的无头后端默认前端。ARS 的愿景是为智能体提供“可治理、可观测、可组合”的运行时：解耦大模型与工具链，标准化会话/消息模型，让团队能安全、可审计地落地 Agent 能力。更多背景可参考博文：https://blog.roog-code.cn/posts/roog-agent-handler/roog-agent-handler/

## 我们在解决什么
- **安全与治理**：OPEN/LOCKED/CLOSED 状态门禁，幂等键（dedupe_key）、权限与审计，避免重复执行与越权调用。
- **可观测性**：会话 + 消息序列（seq）统一建模，便于追踪、回放和问题定位。
- **可扩展性**：面向多模态（文本/文件/图片）与插件/工具调用，作为“无头”运行时嵌入业务。
- **落地效率**：默认 UI 与接口示例，让团队快速验证 Agent 能力并迭代。

## Demo 包含
- 登录/欢迎页：获取 JWT，查看运行概览。
- 会话侧边栏：ChatGPT 风格常驻列表，新建会话、分页“加载更多”、快速切换。
- 会话详情页（演示数据）：历史消息、文件/图片附件展示，自适应输入区 + 附件槽。
- 用户管理：列表、编辑/新建、启用/禁用等后台常见操作。

## 目录速览
- 源码入口：`src/`
- 路由与页面：`src/router/index.js`、`src/views/*`
- 会话侧边栏：`src/components/SessionSidebar.vue`
- 会话详情 UI（假数据演示）：`src/views/ChatView.vue`
- 测试：`tests/`（Vitest + Vue Test Utils）

## 快速开始
1. 安装依赖：`npm install`
2. 启动开发：`npm run dev`
3. 可选：配置后端基址 `VITE_API_BASE=http://localhost:8000/api`

默认对接 `ars-backend` 接口（接口文档见 `../ars-backend/docs`）。登录后可体验会话与用户管理流程；如需真实消息收发，请在 `ChatView` 中接入后端消息接口。***