# ai_know_all

**Repository Path**: codeAlwaysPass/ai_know_all

## Basic Information

- **Project Name**: ai_know_all
- **Description**: 基于LangChain的AI各类业务组合应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai_know_all（H5 + Agent 化服务端）

本仓库当前实现：
- `apps/server`: **FastAPI + LangChain + Chroma** 的 Agent 核心服务端（轻量化，非 Django 运行链路）
- `apps/web-h5`: React + Vite H5 前端
- 已接入业务模块：`上海房价预测`

目录结构（核心与业务分层）：
- `apps/server/app/core`: 基座层（配置、模块注册）
- `apps/server/app/modules/sh_house_price`: 业务模块层（Source、RAG、Agent Chain、Service、Router）
- `apps/web-h5/src/features/sh-house-price`: 前端业务模块（API、hooks、components、page）

## 1. 安装依赖

### 服务端
```bash
cd /Users/lawrenceli/Desktop/ai_know_all/apps/server
pip3 install -r requirements.txt
```

### 前端
```bash
cd /Users/lawrenceli/Desktop/ai_know_all/apps/web-h5
npm install
```

## 2. 启动项目

### 启动服务端（FastAPI）
```bash
cd /Users/lawrenceli/Desktop/ai_know_all/apps/server
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

### 启动前端（H5）
```bash
cd /Users/lawrenceli/Desktop/ai_know_all/apps/web-h5
npm run dev
```

前端默认代理到 `http://127.0.0.1:8000`。

## 3. 本地验证案例（完整链路）

1. 打开 `http://127.0.0.1:5173`
2. 点击“加载示例输入”
3. 点击“生成预测”
4. 验证页面出现：
   - 今日/本周/本月/今年趋势
   - 针对输入偏好的趋势结论
   - 买房时机建议
   - 主要影响因子
   - RAG 证据片段
   - `data_provenance / data_freshness / inference_flags`

## 4. 数据策略说明（真实优先）

服务端采用三类 Source：
- `OfficialMacroSource`: 官方宏观数据（国家统计局/上海统计局/人民银行）
- `OpenListingSource`: MIT 授权上海房源真实样本数据（优先在线拉取）
- `PolicyDocSource`: 政策文本（用于 Chroma RAG 检索）

回退策略：
- 在线失败 -> 本地缓存
- 缓存不存在 -> 内置一次性真实快照
- **默认不自动切 mock**

## 5. 当前哪些部分是 mock / 静态

- 不做实时官方成交网站爬虫（`fangdi.com.cn` 反爬强，MVP 不纳入自动源）
- “每日推荐”是页面展示用模拟能力（不包含推送系统）
- 今日/本周趋势是基于月度统计+政策/LPR信号的推断，并通过 `inference_flags` 显式标注

## 6. 如何替换成真实生产数据源

只需替换 `apps/server/app/modules/sh_house_price/sources.py` 中对应 Source 的抓取与解析逻辑，不需要改前端和主 API：
- 替换 `OpenListingSource` 为合规真实交易/挂牌数据接口
- 替换 `OfficialMacroSource` 为稳定官方 API 或内部数据仓
- 扩充 `PolicyDocSource` 的政策数据接入与文本清洗

## 7. 快速接口检查

```bash
curl http://127.0.0.1:8000/api/health
curl http://127.0.0.1:8000/api/modules
curl http://127.0.0.1:8000/api/modules/sh-house-price/example
```

预测接口：
```bash
curl -X POST http://127.0.0.1:8000/api/modules/sh-house-price/predict \
  -H 'Content-Type: application/json' \
  -d '{
    "budget_min": 280,
    "budget_max": 550,
    "preferred_regions": ["宣桥","泗泾","九亭"],
    "plan_buy_period": "6个月内",
    "room_type": "2室1厅",
    "area_min": 60,
    "area_max": 95
  }'
```