# HX-41 需求描述：部门制度智能问答台

## 产品定位

一个部署在公网的轻量级 Web 工具，部门员工通过手机或电脑打开链接，在对话框中输入关于公司制度的问题（如"年假有几天""差旅住宿标准是多少"），AI 基于预置的制度文件内容给出准确回答并引用具体条款。

## 核心功能

1. **聊天界面**：用户输入问题，AI 基于制度文件回答；支持多轮对话（上下文延续）；
2. **知识库注入**：制度文件全文作为 system prompt 注入百炼 API，AI 严格依据制度内容回答；
3. **来源标注**：回答中引用具体条款编号（如"根据第三条第 3 项"）；
4. **兜底处理**：制度文件未覆盖的问题，AI 回答"该问题制度文件未覆盖，建议咨询人力资源部"，不得编造；
5. **移动端适配**：员工手机打开即可使用，无需安装 App。

## 技术要求

1. **后端**：Node.js，接收前端 POST 请求 → 组装 messages（system prompt = 制度文件 + 用户问题）→ 调用百炼 API（OpenAI 兼容格式）→ 返回 AI 回复给前端；
2. **前端**：单 HTML 文件（内嵌 CSS/JS），聊天气泡 UI，移动端优先适配，品牌色 #0A4C8C；
3. **安全**：百炼 API key 通过环境变量 `DASHSCOPE_API_KEY` 传入，不硬编码在前端或代码中；
4. **部署**：通过千问办公页面发布能力（qw-pages）以 dynamic 模式部署（Node.js 后端 + 前端页面）。

## 百炼 API 调用格式

```
POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
Headers:
  Content-Type: application/json
  Authorization: Bearer {DASHSCOPE_API_KEY}
Body:
{
  "model": "qwen-plus",
  "messages": [
    { "role": "system", "content": "你是云帆电器的行政制度助手...{制度文件全文}" },
    { "role": "user", "content": "{用户问题}" }
  ]
}
```

## 演示场景

1. 培训现场，AI 从零写完代码并部署为公网链接；
2. 发起人打开手机扫码；
3. 当场提问："试用期年假怎么算"；
4. AI 基于制度第三条回答，并引用条款编号；
5. 500 人同时扫码提问，AI 独立于千问办公持续运行。

## 约束

- 制度文件内容硬编码在后端 server.js 中作为 system prompt（不依赖外部文件读取）；
- 不使用 Express 等外部框架，优先使用 Node.js 内置 http 模块（减少依赖，简化部署）；
- 错误处理：API 超时/网络错误/配额不足时给用户友好提示；
- 页面底部标注："本工具由 AI 从零构建 · 知识库版本 2026-09 · 独立于千问办公运行"。
