# StructMat

**Repository Path**: cotangent0424/struct-mat

## Basic Information

- **Project Name**: StructMat
- **Description**: StructMat平台以及前端界面
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# StructMat Console 前端

StructMat 人机协同研究平台的网页控制台。基于 Next.js 15 + React 19 + TypeScript，
通过 HTTP API 与 StructMat 后端（FastAPI）通信。

## 功能概览

- 会话式研究任务交互（草稿 → 校验 → 确认 → 执行）
- 结构化结果面板：研究任务草稿、候选能力、输入参数校验、路由建议、治理信息
- 能力参数表单：由插件声明的 console form 自动渲染，支持示例默认值预填、
  参数来源标注、分组示意图（支持离线静态副本）
- 建模产物展示与 Abaqus 作业状态跟踪

## 环境要求

- Node.js 18 或更高版本
- StructMat 后端（主仓库 `services/web_api/`，FastAPI）

## 快速启动

### 1. 启动后端（在主仓库中）

```bash
# 主仓库根目录，Python 3.10+
pip install -r requirements.txt
python -m uvicorn services.web_api.main:app --host 127.0.0.1 --port 8765
```

也可以使用主仓库提供的脚本（Windows）：

```bat
scripts\start_structmat_console.bat
```

### 2. 启动前端（在本仓库中）

```bash
npm install
npm run dev
```

前端默认监听 `http://127.0.0.1:3100`，默认连接后端 `http://127.0.0.1:8765`，
本地使用时无需任何配置。

### 3. 打开浏览器

访问 `http://127.0.0.1:3100/`。

## 后端地址配置

如需连接其他地址的后端，设置环境变量：

```bash
# Windows PowerShell
$env:NEXT_PUBLIC_STRUCTMAT_API_URL = "http://192.168.1.10:8765"
npm run dev
```

```bash
# Linux / macOS
NEXT_PUBLIC_STRUCTMAT_API_URL=http://192.168.1.10:8765 npm run dev
```

## 常用命令

```bash
npm run dev        # 开发模式（端口 3100）
npm run build      # 生产构建
npm run typecheck  # TypeScript 类型检查
npm run lint       # ESLint
```

## 目录结构

```text
src/
  components/console/   控制台组件（消息、表单、结构化面板、示意图）
  lib/                  API 客户端与类型定义（types.ts 与后端契约对应）
  stores/               Zustand 状态管理
public/images/          静态资源（含表单分组示意图离线副本）
```

## 与后端的关系

本仓库只包含前端。完整运行需要 StructMat 主仓库提供的后端
（`services/web_api/`）。前端的类型定义、表单渲染和示意图加载均遵循
主仓库的平台契约（capability 元数据、console form schema），
不包含领域硬编码。

## 说明

- 控制台内的智能体会话需要本机安装并登录 Claude Code CLI。
- Abaqus 仅在实际执行建模任务时需要，不安装不影响控制台启动和浏览。