zhimingge/README.md

知命阁（zhimingge）

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

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

功能模块

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

文档

• 产品说明文档（SPEC） — 功能规格、架构、实施分期
• Ubuntu 部署文档（DEPLOY） — PM2 部署至 /opt/zhimingge

环境变量

复制 .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

生产部署（摘要）

cd /opt/zhimingge
pnpm install --frozen-lockfile
pnpm run build
pm2 start ecosystem.config.cjs
pm2 save && pm2 startup

完整步骤见 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