ZhiWenCraft（智文坊）

智能文本处理平台，基于 Dify + NLG→DSL 管道实现自然语言驱动的智能体工作流自动生成。

项目结构

zhiwenfang-v1.0.1/
├── packages/
│   ├── client/          # 前端 — React 19 + TypeScript + Ant Design 5 + Vite
│   └── server/          # 后端 — Express + Prisma + PostgreSQL
├── nlg-to-dsl/          # Python NLG→DSL 管道服务（FastAPI）
├── docker-compose.yml   # PostgreSQL 数据库
├── init-db.sql          # 数据库初始化脚本
└── .env.example         # 环境变量模板

技术栈

层	技术
前端	React 19, TypeScript, Ant Design 5, Zustand, Vite
后端	Express, Prisma ORM, JWT 认证, WebSocket
NLG 管道	Python, FastAPI, Jinja2, YAML DSL 生成
数据库	PostgreSQL 15（Docker）
AI 平台	Dify（智能体编排与运行）

功能模块

• 资产管理 — 文件上传、解析（docx/pdf/xlsx/csv/OCR）、文件夹组织、回收站
• 任务管理 — 批量/单文件处理任务，支持即时执行与定时调度，实时进度追踪
• 智能体管理 — Dify 智能体注册、在线检测、API 密钥加密存储
• 智能体生成器 — 自然语言描述 → Dify DSL 工作流自动生成（NLG→DSL 管道）
• 模板广场 — 预置智能体模板
• Dify 配置 — 平台连接配置与状态检测

部署方式

1. 本地开发

# 克隆仓库
git clone https://www.gitlink.org.cn/caoweiqiong/zwf.git
cd zwf

# 启动 PostgreSQL
docker compose up -d

# 配置环境变量
cp .env.example packages/server/.env
# 编辑 packages/server/.env 填入实际值

# 安装依赖
npm install

# 初始化数据库
npm run db:migrate
npm run db:seed

# 启动前后端（开发模式）
npm run dev

2. NLG→DSL 管道服务

cd nlg-to-dsl

# 安装依赖
pip install -r dify-dsl-builder/requirements.txt

# 启动服务（默认端口 5000）
cd ..
python -m nlg-to-dsl.web_app

3. 生产部署（Linux 服务器）

# 构建前端
cd packages/client
npx vite build

# 构建后端
cd ../server
npx tsc

# 使用 systemd 管理服务
# 后端服务（端口 3001）
# NLG 管道服务（端口 5000）

# Nginx 反向代理示例
# location / { root /path/to/packages/client/dist; try_files $uri /index.html; }
# location /api { proxy_pass http://localhost:3001; }

4. 环境变量

变量	说明	默认值
DATABASE_URL	PostgreSQL 连接串	postgresql://difyflow:password@localhost:15432/difyflow
JWT_SECRET	JWT 签名密钥	—
ENCRYPTION_KEY	API 密钥加密密钥（64 字符 hex）	—
PORT	后端端口	3001
UPLOAD_DIR	上传目录	./uploads
MAX_FILE_SIZE	最大文件大小（字节）	52428800（50 MB）

API 路由

所有 /api 前缀，需 JWT 认证（除 /auth 外）：

路径	说明
/auth	登录/注册
/dify-config	Dify 平台连接管理
/agents	智能体 CRUD
/assets	文件上传与管理
/folders	文件夹管理
/tasks	任务管理
/templates	模板管理
/generator/chat	NLG→DSL 对话（代理至 Python 服务）

许可证

本项目仅供学习和研究使用。