# WCCGagent开发

**Repository Path**: li-shengcos/wccgagent-development

## Basic Information

- **Project Name**: WCCGagent开发
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-14
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 蓝循智理：垃圾分类与社区治理智能体

一个面向人工智能比赛演示的完整版本。它没有把功能停留在“识别一张图片”，而是形成：

> 图片/文字上报 → 垃圾分类 → 风险研判 → 投放建议 → 社区工单 → 状态跟踪 → 治理复盘

## 功能

- 图片与中文描述融合分类，覆盖可回收物、有害垃圾、厨余垃圾、其他垃圾
- 可选兼容接口大模型图文识别；默认本地运行，失败自动降级
- 输出置信度、判断依据与人工复核机制
- 同时生成居民投放建议和社区处置建议
- 本机数据库工单管理和状态流转
- 类别、区域、风险与治理洞察看板，以及可执行的优先处置队列
- 天空蓝简洁界面，可离线运行核心流程

## 运行

项目使用已创建的运行环境。

```powershell
conda activate WCCGagent
cd C:\WCCGagent
python -m streamlit run app.py
```

也可以双击 `run_app.bat`。

## 可选：启用通用视觉模型

当前系统在没有模型权重时，会明确降级为“文字语义研判 + 人工复核”，不会伪造视觉结果。
如需启用本地通用视觉模型，可在联网状态下执行：

```powershell
conda activate WCCGagent
python scripts/download_model.py
```

首次下载约 10 兆字节。权重缓存后，应用运行不需要联网。

## 可选：安全启用云端大模型

应用不会要求用户在网页中填写密钥。请在本机服务端配置文件中填写服务密钥，并按账号实际可用模型修改模型名称。
该配置文件已加入版本控制排除清单。

当前示例已配置兼容接口地址：

```toml
OPENAI_API_KEY = "你的服务密钥"
OPENAI_BASE_URL = "https://apinebula.ai/v1"
OPENAI_MODEL = "你的账号实际支持的模型名称"
```

大模型能力采用显式授权：只有在识别页勾选后，才会把最多 500 字且经过手机号、邮箱、
身份证号和长编号脱敏的事件描述，以及经过格式校验、图片元数据移除、最长边缩放至 1280 像素并
重新编码的图片发送到兼容接口。详细位置、上报角色和本地工单不会发送；请求设置为不保存。
模型输出必须通过字段白名单校验，意见冲突时强制人工复核，且模型不能直接
写数据库。没有密钥、网络超时或返回异常时自动使用本地流程。

## 比赛演示建议

1. 先在治理看板展示社区已有问题。
2. 上传一张塑料瓶或电池照片，并补充一句现场描述。
3. 可选勾选云端图文识别，讲解“图片清理 + 最少数据发送 + 人工最终确认”的安全设计。
4. 讲解智能体如何给出分类、置信度、风险和处置建议。
5. 确认生成工单，在社区工单页将状态更新为“处理中/已完成”。
6. 返回看板，通过“优先处置队列”说明风险事件如何进入治理闭环。

## 项目边界

这是比赛演示版本，不宣称达到生产级识别准确率。正式落地需要使用本地垃圾图片标注集微调模型，并接入真实社区账号、地图和工单系统。