# 云帆电器 · 部门制度智能问答台（HX-41）

一个从零编写的 Node.js Web 应用：聊天界面提问，AI 基于内置的制度文件全文作答，并引用具体条款编号。

## 项目结构

```
source/
  package.json        # 零依赖声明（仅需 Node.js >= 18）
  server.js           # 后端：静态页托管 + /api/ask 接口 + 百炼（DashScope）调用
  public/index.html   # 前端：单页聊天 UI（内嵌 CSS/JS，无外部资源）
```

## 本地运行

```bash
# 1. 准备百炼 API Key（阿里云百炼控制台获取，OpenAI 兼容模式）
export DASHSCOPE_API_KEY=sk-你的key

# 2. 启动（默认 8081 端口）
node server.js

# 3. 浏览器访问 http://localhost:8081
```

## 环境变量

| 变量 | 必填 | 说明 |
|---|---|---|
| `DASHSCOPE_API_KEY` | 自部署必填 | 百炼 API Key，经环境变量注入，代码中不硬编码 |
| `PORT` | 否 | 监听端口，默认 8081 |
| `HOST` | 否 | 监听地址，默认 0.0.0.0 |
| `DASHSCOPE_BASE_URL` | 否 | 仅本地联调用（指向 mock 上游），生产环境勿设置 |
| `SUPABASE_URL` / `SUPABASE_ANON_KEY` | 否 | 仅千问办公 Pages 部署时由平台自动注入，勿手工设置 |

### API Key 的两种供给方式

1. **自部署（推荐给客户）**：设置环境变量 `DASHSCOPE_API_KEY` 后启动即可。
2. **千问办公 Pages 托管**：Pages 运行时无环境变量注入通道，此时本服务会从页面专属数据库的
   `app_settings` 表（`key = 'dashscope_api_key'`）读取密钥，仅驻留服务端内存；
   密钥不进源码、不进前端、不出现在任何可下载文件中。

## 接口

`POST /api/ask`，请求体 `{"question": "你的问题"}`（≤500 字），
成功返回 `{"ok": true, "answer": "Markdown 格式回答"}`，失败返回 `{"ok": false, "error": "友好提示"}`。

## 技术说明

- **零外部依赖**：仅用 Node.js 内置 `http`/`fs`/`path` 模块与全局 `fetch`（Node ≥ 18 自带），下载后无需 `npm install` 直接运行。
- **上下文注入**：制度文件全文（约 3500 字）逐字嵌入 system prompt，随每次提问一并发送；制度未覆盖的问题按预设口径回答"建议咨询人力资源部"。
- **安全**：API Key 只走环境变量；请求体限长 8KB、问题限 500 字；上游调用 60s 超时；错误信息对用户友好、不泄露内部细节。
- 知识库版本：2026-09（制度文件全文内置于 `server.js` 的 `POLICY_TEXT` 常量，替换制度内容后重启即完成知识库更新）。
