# cc_ds_wl_mini

**Repository Path**: 23745038/cc_ds_wl_mini

## Basic Information

- **Project Name**: cc_ds_wl_mini
- **Description**: AI物流助手ClaudeCode优化
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cc_ds_wl_mini

#### 介绍
AI物流助手ClaudeCode优化

# 代码库分析报告

## 项目概述

这是一个**微信小程序 - AI物流助手**，用于司机调度、提货/卸货队列管理和物流操作。

## 项目结构

```
cc_ds_wl_mini/
├── app.js                    # 主应用入口 (16KB) - HTTP请求封装、认证逻辑
├── app.json                  # 主配置 - 页面注册、subpackages配置
├── app2.json                 # 备用配置 - 包含微信SI语音插件
├── pages/                    # 主包页面
│   ├── login/                # 登录页
│   ├── my/                   # 个人中心
│   └── agreementView/        # 协议查看页
├── subPackages/packageA/     # 独立分包
│   └── pages/index/          # AI聊天主页 (89KB - 最大最核心的页面)
├── utils/
│   ├── RFConst.js           # API端点、常量、消息、验证正则
│   └── util.js              # 工具函数 (dialog, formatToTime, base64src)
└── towxml/                   # Markdown/HTML渲染库
```

## 页面关系

| 页面 | 路径 | 功能 |
|------|------|------|
| 登录 | `pages/login/login` | 手机号验证码 + 微信一键登录 |
| AI聊天(主) | `subPackages/packageA/pages/index/index` | AI物流助手、语音、文件上传、图表 |
| 我的 | `pages/my/my` | 用户信息、退出登录 |

**启动流程**: App Launch → `autoLogin()` → 有token则去AI聊天，否则去登录页

## 核心模块分析

### 1. API层 (app.js + RFConst.js)

- **基础URL**: `http://61.156.58.253:30064/scs-wl-ds/`
- **认证**: Bearer token + Session Cookie
- **请求方法**: `requestHttp()`, `loginRequestHttp()`, `requestfromHttp()` (文件上传)
- **流式响应**: AI聊天使用 `enableChunked: true` + `TextDecoder` 处理SSE

### 2. 认证流程

- 支持: 手机号+短信验证码 / 微信一键登录
- Token存储: `wx.setStorageSync("user/token/sessionId")`
- 401/405错误: 清除存储并跳转登录页

### 3. AI聊天特性 (index/index.js - 89KB)

- 流式响应渲染 (特殊分隔符: `§`图表, `€`链接, `[END]`结束)
- Markdown/HTML渲染 (towxml)
- 语音输入 (WechatSI插件)
- 文件/图片上传
- ECharts图表展示

### 4. 第三方库

| 库 | 位置 | 用途 |
|----|------|------|
| towxml | towxml/ | Markdown/HTML渲染 |
| ec-canvas | subPackages/packageA/ec-canvas/ | ECharts图表 |
| amap-wx | subPackages/packageA/lib/ | 高德地图 |
| bmap-wx | subPackages/packageA/lib/ | 百度地图 |
| WechatSI | app2.json配置 | 语音识别/TTS |

## 关键代码模式

### Singleton App对象

```javascript
var app = getApp();
App({ ... })
```

### 请求封装

```javascript
app.requestHttp(url, data, success, fail, complete)
```

### 防止重复触发

```javascript
preventActive(fn) // 2秒冷却
```

### 流式AI响应处理

- `enableChunked: true` 启用分块传输
- 按 `\n\n` 分隔完整JSON消息
- `TextDecoder` 解码ArrayBuffer

## 主要功能

1. AI智能客服（流式对话）
2. 提货/卸货队列管理
3. 司机注册
4. 物流公司查询
5. 地址管理（仓库、供应商等）
6. 文件上传
7. 地图定位
8. 语音识别/TTS

## API端点 (RFConst.js)

| 端点 | 用途 |
|------|------|
| `login` | 用户登录 |
| `basic/resDriver/addMini` | 司机注册 |
| `basic/resDistributor/queryDistributor` | 获取物流商 |
| `basic/resAddress/queryAddressATT` | 获取地址 |
| `appointQueue/appointLoadQueue/*` | 提货队列操作 |
| `appointQueue/appointUnloadQueue/*` | 卸货队列操作 |
| `ds/api/chatStreamGet` | AI聊天流式 |
| `ds/api/reCreateStream` | 重新生成AI响应 |
| `system/sysAttach/uploadFiles` | 文件上传 |
| `agreement/userservice.html` | 用户协议 |

## 配置文件说明

### app.json
- 主包页面: login, my
- 分包: packageA (独立分包)
- 权限: 录音
- 网络超时: request 60s, upload 60s, download 3s

### app2.json
- 额外页面: register
- 微信SI插件配置 (version 0.3.6)

### project.private.config.json
```json
{
  "setting": {
    "compileHotReLoad": true,
    "urlCheck": false,
    "useApiHook": true,
    "useApiHostProcess": true
  },
  "libVersion": "3.14.2"
}
```