DEMO-AGENT V2
V2 是一个重置后的最小 Django 项目，仅保留基础配置和登录页面。
本地运行
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
访问：
文件汇总依赖
自动汇总文件目录与页数功能使用轻量 Python 库读取 PDF、Word、Excel、PowerPoint 文件。
Docker 或生产环境如需处理 .7z 与 .rar 压缩包，还需要安装系统 7z/p7zip
命令，并确认以下命令可用：
7z
7z i
LibreOffice 不是必需依赖，仅作为未来增强老格式文档解析的可选能力。
上传原始文件、批次工作目录和导出文件默认存储在 Django MEDIA_ROOT 下的
file_summary/users/<user_id>/<conversation_id>/ 或批次 work_dir 目录中。生产环境
需要把 MEDIA_ROOT 挂载到持久化卷，并纳入备份或归档策略。
飞书通知与问答预留
飞书接入使用企业自建应用/智能体的消息 API。敏感信息只允许写入本地 .env
或部署环境变量，不要提交真实 App Secret、tenant token、open_id 或 user_id。
常用环境变量：
| 变量名 | 用途 |
|---|---|
FEISHU_NOTIFY_ENABLED |
是否启用真实飞书通知，未启用时只写未启用记录 |
FEISHU_NOTIFY_CHANNEL |
通知通道，首期使用 feishu_api |
FEISHU_APP_ID |
飞书应用 App ID |
FEISHU_APP_SECRET |
飞书应用 App Secret |
FEISHU_DEFAULT_USER_OPEN_ID |
默认个人接收人的 open_id，优先使用 |
FEISHU_DEFAULT_USER_ID |
默认个人接收人的 user_id，open_id 为空时使用 |
FEISHU_DEFAULT_TARGET_NAME |
默认接收人展示名，用于记录和页面展示 |
FEISHU_TENANT_TOKEN_CACHE_SECONDS |
tenant_access_token 缓存秒数 |
PUBLIC_BASE_URL |
飞书消息中的系统入口根地址，默认 http://127.0.0.1:8000 |
自动化测试会 mock 飞书 token API 和消息 API，不请求真实飞书接口。真实发送只通过 本地手动命令验证：
python manage.py send_test_feishu_notification --username owner
问答预留能力可用本地模拟命令验证：
python manage.py feishu_question_simulate --username owner "查最新法规核查"
集中测试建议在补齐 .env 后执行：
python manage.py check
pytest tests/test_feishu_*.py
pytest tests/test_file_summary_workflow.py tests/test_regulatory_notification.py tests/test_application_form_fill_notification.py