知命阁（zhimingge）

融合《周易》原文学习与 AI 智能解读的 Web 应用。

代码仓库：https://git.bz121.com/dekun/zhimingge.git

功能模块

模块	路由	状态
易经学习	/learn	规划中
六爻算卦	/liuyao	已有基础（首页）
生辰八字	/bazi	规划中
综合测算	/combined	规划中

文档

• 产品说明文档（SPEC） — 功能规格、架构、实施分期
• Docker 部署文档（DOCKER） — 推荐 生产部署
• Ubuntu PM2 部署文档（DEPLOY） — 备选方案

环境变量

复制 .env.example 为 .env.local 并填写：

OPENAI_API_KEY=你的密钥
OPENAI_BASE_URL=https://op.bz121.com/v1
OPENAI_MODEL=huihui_ai/gemma-4-abliterated:e4b

本地开发

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）

生产部署（Docker，推荐）

cd /opt/zhimingge
cp .env.example .env.local && nano .env.local   # 填写 OPENAI_API_KEY
docker compose build
docker compose up -d

服务监听 3130 端口。完整说明见 docs/DOCKER.md。

日常更新：bash scripts/docker-deploy.sh

PM2 部署（备选）

见 docs/DEPLOY.md。

目录说明

zhimingge/
├── app/              # Next.js 应用
├── components/       # UI 组件
├── content/zhouyi/   # 64 卦 Markdown 原文
├── docs/             # 项目文档
├── lib/              # 工具与数据
├── Dockerfile            # Docker 生产镜像
├── docker-compose.yml    # Docker Compose 配置
├── ecosystem.config.cjs  # PM2 配置（备选）
├── scripts/docker-deploy.sh  # Docker 更新脚本
└── scripts/deploy.sh         # PM2 更新脚本（备选）

技术栈

Next.js 15 · React 18 · Tailwind CSS · Vercel AI SDK · PM2