# NXDevHub

**Repository Path**: grlgit/nxdev-hub

## Basic Information

- **Project Name**: NXDevHub
- **Description**: 面向 UG/NX 二次开发者的技术社区与 AI 编程平台。

核心能力：严格版本锚定的 AI 编程（Web 端 + 本地客户端）、UG 全版本 API 手册、开发者社区（论坛/专栏/通知/积分）、skill 生态（接入 Claude Code / Codex / Trae 等 AI 编码工具）。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-21
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NXDevHub

面向 UG/NX 二次开发者的技术社区与 AI 编程平台。

核心能力：**严格版本锚定的 AI 编程**（Web 端 + 本地客户端）、**UG 全版本 API 手册**、**开发者社区**（论坛/专栏/通知/积分）、**skill 生态**（接入 Claude Code / Codex / Trae 等 AI 编码工具）。

## 功能总览

### 论坛社区（CSDN 风格）

- 内容信息流：推荐 / 最新 / 热榜（热度公式加权）/ 问答 / 文章，每页 20 条
- 提问与文章双形态，草稿箱、审核流、版主体系、举报闭环
- 附件五级权限（公开 / 登录 / 回复可见 / 积分 / VIP）、正文隐藏内容标记
- 通知中心（被回复 / 引用 / @ / 点赞 / 加精 / 审核结果，偏好可配置）、签到积分、VIP

### API 手册

- UG 8.5 全量 API 数据（58211 条：UFUN 函数 + NXOpen 类方法），由 UGOPEN 头文件经 tree-sitter-cpp 解析生成
- 版本 / 语言双筛选 + 函数名搜索 + 头文件树导航，重载函数 `(2/4)` 样式区分
- 函数详情：签名高亮、参数表、官方英文说明 + 中文说明（可 AI 生成）
- 管理端：上传 UGOPEN 头文件自动解析、重新解析、函数说明编辑与发布

### AI 编程（工程模式）

- 对话式开发：描述需求 → AI 生成业务代码（版本锚定检索注入 + 生成后 API 存在性校验）
- 工程模式：AI 直接创建完整 VS 工程（mode-a 模板）并写回文件
- **本地客户端**（Windows 便携版，双击即用）：AI 直接读写本地工程目录，编译报错贴回即修，形成"生成 → 编译 → 反馈 → 修复"闭环
- 模型接口：OpenAI 兼容协议（DeepSeek / 通义等均可），key 自行配置

### 图标设计

文字 / 图片 / Emoji 三模式生成 Favicon 包（android-chrome、apple-touch-icon、favicon.ico、site.webmanifest），并输出 UG 工具位图按钮专用的 64x64 24 位 BMP。

### 下载中心

- 本地客户端安装包（Windows 便携版，双击即用）
- UG/NX 开发 skill 包（接入 Claude Code / Codex CLI / Trae / Cursor）

分发仓库：https://gitee.com/grlgit/nxdev-hub-releases

## 技术栈

Next.js 15 (App Router) · React 19 · TypeScript · Tailwind CSS 4 · shadcn/ui · Prisma · PostgreSQL · tree-sitter-cpp (WASM) · OpenAI 兼容模型接口

## 快速开始

```bash
# 环境要求：Node.js 18+、PostgreSQL 15+
npm install

# 配置环境变量（数据库与模型接口）
cp .env.example .env
# 编辑 .env：DATABASE_URL、AGENT_API_BASE_URL / AGENT_API_KEY / AGENT_API_MODEL、STORAGE_DRIVER=local

# 初始化数据库并写入种子数据
npx prisma db push
npm run db:seed

# 开发
npm run dev

# 生产
npm run build && npm start

# 一键启停（Linux）：start.sh 自动按需生产构建、Node 限堆启动、端口健康检查，重复执行幂等
# 注意：脚本默认以 /workspace 为项目目录，部署到其他路径时修改脚本开头的 APP_DIR
bash start.sh
bash stop.sh   # 停止服务、清理残留进程
```

## 本地客户端

无需 Web 端即可使用的桌面形态：AI 直接读写本地工程目录，支持工程模式写回与版本转换。

下载与使用说明见 [nxdev-hub-releases](https://gitee.com/grlgit/nxdev-hub-releases)（内置 Node 运行时，解压双击即用）。

## 目录结构

```
├── src/app/(site)/        页面（论坛/API 手册/AI 编程/下载中心/设置/admin 后台…）
├── src/app/api/           Route Handlers（对话 SSE/上传下载/工程交付/图标生成…）
├── src/actions/           Server Actions（thread/post/user/vip/admin/apiDoc/column…）
├── src/components/        组件（agent 对话/forum 论坛/api-doc/tools/admin…）
├── src/lib/agent/         AI 编排层（llm/orchestrator/retrieval/validator/workspace）
├── src/lib/api-doc/       API 手册（tree-sitter 解析器/检索/共享常量）
├── client/                本地客户端（独立 npm 包，A 形态：本地 Node 服务）
├── skills/                UG/NX 开发 skill 源（SKILL.md + 指南 + 模板 + 生成脚本）
└── prisma/                数据模型与种子数据
```

## 相关文档

- 设计文档：`NXDevHub 设计文档 v4.5`（架构 / 数据模型 / AI 编排 / 部署约束）
- 交互说明：`NXDevHub 页面交互说明文档 v1.5`（各页面元素与操作定义）
- 需求与任务：`.cosmocode/specs/nxdevhub/`

## 说明

- 本项目面向 UG/NX 二次开发技术交流，API 数据由官方头文件解析生成，版权归 Siemens 所有
- 移动端提供基础可用适配（响应式 + 汉堡导航），复杂交互以桌面端为主