他山信源前端（Next.js）

本地开发

npm install
npm run dev

默认地址：http://localhost:3000

构建与检查

npm run lint
npm run build

后端接口约定

前端统一从 lib/api 调用接口，支持两种模式：

• 未配置远端地址：自动使用本地 mock 数据。
• 配置远端地址：请求真实后端，失败时回退 mock（保证页面可用）。

环境变量：

NEXT_PUBLIC_TASHAN_API_BASE_URL=https://your-api-domain.com

接口契约定义在：

• lib/api/contracts.ts

当前约定端点：

• GET /feed：返回 FeedResponse
• POST /chat/reply：请求体 ChatRequest，返回 ChatResponse
• POST /podcast/generate：请求体 PodcastGenerateRequest，返回 PodcastGenerateResponse

目录说明

• app/：页面与路由
• components/：UI 与业务组件
• lib/api/：后端接口调用与 mock 适配
• lib/store/：zustand 持久化状态
• lib/mock/：演示数据