# Fluens

**Repository Path**: ubml/fluens

## Basic Information

- **Project Name**: Fluens
- **Description**: 基于Fluens Design AI 原生交互设计原则的智能体工作台
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 16
- **Created**: 2026-03-18
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Farris X

基于 Vue 的前端项目，使用 pnpm 进行 monorepo 管理。

## 项目结构

```
farris-x/
├── packages/
│   └── conversation/  # 对话组件
├── package.json
├── pnpm-workspace.yaml
└── README.md
```

## 依赖

- **@farris/ui-vue**：本项目通过 `link` 引用本地 farris-vue 仓库，便于联调调试。需在 farris-x 的**同级目录**下 clone farris-vue 项目，使路径 `../farris-vue/packages/ui-vue` 可访问。
- Node.js 18+
- pnpm

### 配置 farris-vue 本地仓库

```bash
# 进入 farris-x 的上级目录
cd /path/to/parent-of-farris-x

# 克隆 farris-vue（若尚未克隆）
git clone git@gitee.com:ubml/farris-vue.git

# 进入farris-vue目录
cd farris-vue

# 打包@farris/ui-vue
pnpm --filter ui-vue build:lib

# 目录结构应类似：
# parent-dir/
# ├── farris-x/      # 本项目
# └── farris-vue/    # UI 组件库
```

克隆完成后，在 farris-x 中执行 `pnpm install` 即可自动建立 link 关联。

## 服务端环境变量（`.env.server.example`）

本地跑 **`pnpm dev:api`**（Hono API、tRPC、Better Auth）以及 **`pnpm db:migrate`** 等脚本时，会在仓库根目录加载 `.env`、`.env.local`、`.env.server`（见服务端入口对 dotenv 的配置）。

1. 将根目录的 **`.env.server.example`** 复制为 **`.env.server`**（不要提交含真实密钥的文件）。
2. 按文件内注释填写，主要有：
   - **`DATABASE_URL`**：PostgreSQL 连接串（库名在路径中；密码若含 `@`、`#` 等需对密码段做 URL 编码）。
   - **`AUTH_SECRET`**、**`APP_URL`**：与 Better Auth 一致，供 `/api/auth` 与 tRPC 鉴权。
   - 可选：**`DATABASE_CREATE_IF_MISSING`**（迁移前自动建库）、**`PORT`**（API 端口，默认示例为 3210）、**`JWKS_KEY`**（OIDC 验签等）。

具体键名与示例格式以 **`.env.server.example`** 为准。

## 快速开始

```bash
# 安装依赖
pnpm install

# 开发 conversation 组件
pnpm dev:conversation

# 构建 conversation
pnpm build:conversation
```

## 包说明

### @farris/x-conversation

可复用的 AI 对话组件，支持多种消息类型（文本、代码、待办、文件操作、应用预览等）。