- 更新项目名称与简介,详细说明 ARS 的愿景与功能 - 描述 Demo 的功能组件和用户交互流程 - 添加源码目录说明,展示主要模块路径 - 提供快速启动指引,包括依赖安装和开发运行步骤
1.9 KiB
1.9 KiB
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)
快速开始
- 安装依赖:
npm install - 启动开发:
npm run dev - 可选:配置后端基址
VITE_API_BASE=http://localhost:8000/api
默认对接 ars-backend 接口(接口文档见 ../ars-backend/docs)。登录后可体验会话与用户管理流程;如需真实消息收发,请在 ChatView 中接入后端消息接口。***