JSHQCM 应用

🚀

JSHQCM 应用是构建在 JSHQCM Harness 之上的完整 Super Agent 应用。它将运行时能力打包成一个可部署的产品，包含 Web 界面、API Gateway 和运维工具。

JSHQCM 应用是 JSHQCM 生产体验的参考实现。它将 Harness 运行时、基于 Web 的对话工作区、API Gateway 和反向代理组合成一个可部署的完整系统。

应用提供什么

能力	描述
Web 工作区	浏览器对话界面，支持线程、产出物、文件上传和技能选择
自定义 Agent	创建和管理具有不同模型、技能和工具集的命名 Agent
线程管理	带检查点和历史记录的持久化对话线程
流式响应	实时 token 流式传输，带思考步骤和工具调用可见性
产出物查看器	Agent 生成文件和输出的浏览器内预览和下载
扩展界面	无需编辑配置文件即可启用/禁用 MCP 服务器和技能
Gateway API	桥接前端和 LangGraph 运行时的基于 FastAPI 的 REST API

架构

JSHQCM 应用以四个服务的形式运行，通过单个 nginx 反向代理提供：


                ┌──────────────────┐
     浏览器 → │  nginx :2026      │
                └──────────────────┘
                  │          │
         ┌────────┘          └────────┐
         ▼                            ▼
┌──────────────────┐       ┌──────────────────────┐
│  前端 :3000      │       │  Gateway API :8001    │
│  (Next.js)       │       │  (FastAPI)            │
└──────────────────┘       └──────────────────────┘
                                      │
                            ┌─────────┘
                            ▼
                  ┌──────────────────────┐
                  │  LangGraph :2024     │
                  │  (JSHQCM Harness)  │
                  └──────────────────────┘

nginx：路由请求——/api/* 到 Gateway，LangGraph 流式端点到 LangGraph，其余到前端。
前端（Next.js + React）：浏览器界面，与 Gateway 和 LangGraph 通信。
Gateway（FastAPI）：处理 API 操作——模型列表、Agent CRUD、记忆、扩展管理、文件上传。
LangGraph：JSHQCM Harness 运行时，管理线程状态、Agent 执行和流式传输。

技术栈

层次	技术
前端	Next.js 16、React 19、TypeScript、pnpm
Gateway	FastAPI、Python 3.12、uvicorn
Agent 运行时	LangGraph、LangChain、JSHQCM Harness
反向代理	nginx
状态持久化	LangGraph Server（默认）+ 可选 SQLite/PostgreSQL 检查点

快速上手部署指南