dekun
fff77dac3f
Add liuyao/bazi/combined flows with shared calc and AI infrastructure, 64-gua learn routes, and update Ubuntu PM2 deployment docs for port 3130. Co-authored-by: Cursor <cursoragent@cursor.com>
76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
# 知命阁（zhimingge）
|
||
|
||
融合《周易》原文学习与 AI 智能解读的 Web 应用。
|
||
|
||
**代码仓库**：[https://git.bz121.com/dekun/zhimingge.git](https://git.bz121.com/dekun/zhimingge.git)
|
||
|
||
## 功能模块
|
||
|
||
| 模块 | 路由 | 状态 |
|
||
|------|------|------|
|
||
| 易经学习 | `/learn` | 规划中 |
|
||
| 六爻算卦 | `/liuyao` | 已有基础（首页） |
|
||
| 生辰八字 | `/bazi` | 规划中 |
|
||
| 综合测算 | `/combined` | 规划中 |
|
||
|
||
## 文档
|
||
|
||
- [产品说明文档（SPEC）](./docs/SPEC.md) — 功能规格、架构、实施分期
|
||
- [Ubuntu 部署文档（DEPLOY）](./docs/DEPLOY.md) — PM2 部署至 `/opt/zhimingge`
|
||
|
||
## 环境变量
|
||
|
||
复制 `.env.example` 为 `.env.local` 并填写：
|
||
|
||
```env
|
||
OPENAI_API_KEY=你的密钥
|
||
OPENAI_BASE_URL=https://op.bz121.com/v1
|
||
OPENAI_MODEL=huihui_ai/gemma-4-abliterated:e4b
|
||
```
|
||
|
||
## 本地开发
|
||
|
||
```bash
|
||
git clone https://git.bz121.com/dekun/zhimingge.git
|
||
cd zhimingge
|
||
pnpm install
|
||
cp .env.example .env.local
|
||
pnpm run dev
|
||
```
|
||
|
||
访问 http://localhost:3000（`pnpm run dev` 默认端口；生产 PM2 为 **3130**）
|
||
|
||
## 生产部署（摘要）
|
||
|
||
```bash
|
||
cd /opt/zhimingge
|
||
cp .env.example .env.local && nano .env.local # 填写 OPENAI_API_KEY，PORT=3130
|
||
pnpm install --frozen-lockfile
|
||
pnpm run build
|
||
pm2 start ecosystem.config.cjs
|
||
pm2 save && pm2 startup
|
||
```
|
||
|
||
服务监听 **3130** 端口：`http://服务器IP:3130`
|
||
|
||
日常更新：`bash scripts/deploy.sh`
|
||
|
||
完整步骤见 [docs/DEPLOY.md](./docs/DEPLOY.md)。
|
||
|
||
## 目录说明
|
||
|
||
```
|
||
zhimingge/
|
||
├── app/ # Next.js 应用
|
||
├── components/ # UI 组件
|
||
├── content/zhouyi/ # 64 卦 Markdown 原文
|
||
├── docs/ # 项目文档
|
||
├── lib/ # 工具与数据
|
||
├── ecosystem.config.cjs # PM2 配置
|
||
└── scripts/deploy.sh # 服务器更新脚本
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
Next.js 15 · React 18 · Tailwind CSS · Vercel AI SDK · PM2
|