# 百炼 AI 应用 System Prompt 集中管理

> 8 个百炼 AI 应用的 system prompt 在云端权威、本地 git 备份。
> 维护人:Neo / 创建日期:2026-05-05 / 来源拆分:`docs/prd/ai-app-prompts.md`

## 一、为什么有这个目录

历史上 8 个 AI 应用的 system prompt **集中**在 `docs/prd/ai-app-prompts.md` 一个文件里(2026-03-21 最后同步,内容已 stale 40+ 天)。
为方便**逐 APP 独立维护、独立 commit、独立 diff**,2026-05-05 拆成本目录下 8 份独立文件。

## 二、三层关系(关键澄清)

```
[云端权威]
  百炼控制台 8 APP system prompt + 角色设定
        │
        ↓ Neo 人工同步(对照后粘贴)
[本地 MD 快照 — 本目录]
  docs/ai/system-prompts/
  ├─ app1_chat.md
  ├─ app2_finance.md          (引用 ../app2_finance_system_prompt_20260422_v5_1.md)
  ├─ app2a_finance_area.md    (引用 ../app2a_finance_area_system_prompt_20260422_v1.md)
  ├─ app3_clue.md
  ├─ app4_analysis.md
  ├─ app5_tactics.md
  ├─ app6_note.md
  ├─ app7_customer.md
  ├─ app8_consolidation.md
  └─ _industry-context-by-app.md  (8 APP 行业背景片段汇总,粘贴到 system prompt 顶部用)
        │
        × 不是同一份内容
        │
[本地 .py 代码 — 不要混淆]
  apps/backend/app/ai/prompts/app[2-8]_*_prompt.py
  → 这些 .py 是 **user message(数据载荷)拼装代码**,
    不是 system prompt。SDK 调用时上传给百炼,
    百炼云端的 system prompt 才是 LLM 真正读到的角色设定。
```

**结论**:
- ✅ MD 文件 ↔ 云端 system prompt:**有对照关系**(本文档要追的就是这个)
- ❌ `.py` 文件 ↔ 云端 system prompt:**没有对照关系**(不要 diff)
- ⚠️ 不存在 `app1_chat_prompt.py`(App1 是 SSE 流式,user message 直接由 chat 流处理,无独立拼装文件)

## 三、APP ID 与环境变量映射(2026-03-22,P14 DashScope 迁移)

| APP | 中文名 | 环境变量 | 百炼 APP ID | 模型 | temperature | 独立 MD |
|---|---|---|---|---|---|---|
| 1 | 通用对话 | `DASHSCOPE_APP_ID_1_CHAT` | `979dabe6f22a43989632b8c662cac97c` | Qwen3.5-Plus | 0.7 | [app1_chat.md](app1_chat.md) |
| 2 | 财务洞察 | `DASHSCOPE_APP_ID_2_FINANCE` | `1dcdb5f39c3040b6af8ef79215b9b051` | Qwen3-Max-Preview | 0 | [app2_finance.md](app2_finance.md) |
| 2a | 财务洞察(区域)`ZQYY-APP2a-指定区域财务洞察` | `DASHSCOPE_APP_ID_2A_FINANCE_AREA` | `0ae965029bc54706bcff44f511ac716b` | Qwen3-Max-Preview | 0 | [app2a_finance_area.md](app2a_finance_area.md) |
| 3 | 客户数据维客线索分析 | `DASHSCOPE_APP_ID_3_CLUE` | `708bf45439cd48c7ab9a514d03482890` | Qwen3-Max-Preview | 0 | [app3_clue.md](app3_clue.md) |
| 4 | 关系分析 / 任务建议 | `DASHSCOPE_APP_ID_4_ANALYSIS` | `ea7b1c374f574b9a925a2fb5789a9b90` | Qwen3-Max-Preview | 0 | [app4_analysis.md](app4_analysis.md) |
| 5 | 话术参考 | `DASHSCOPE_APP_ID_5_TACTICS` | `46f54e6053df4bb0b83be29366025cf6` | Qwen3.5-Plus | 0.8 | [app5_tactics.md](app5_tactics.md) |
| 6 | 备注分析 | `DASHSCOPE_APP_ID_6_NOTE` | `025bb344146b4e4e8be30c444adab3b4` | Qwen3-Max-Preview | 0 | [app6_note.md](app6_note.md) |
| 7 | 客户分析 | `DASHSCOPE_APP_ID_7_CUSTOMER` | `df35e06991b24d49971c03c6428a9c87` | Qwen3-Max-Preview | 0 | [app7_customer.md](app7_customer.md) |
| 8 | 维客线索整理 | `DASHSCOPE_APP_ID_8_CONSOLIDATE` | `407dfb89283b4196934eec5fefe3ebc2` | Qwen3-Max-Preview | 0 | [app8_consolidation.md](app8_consolidation.md) |

## 四、同步状态表(Neo 维护)

| APP | 最后同步 | 状态 | 同步人 | 备注 |
|---|---|---|---|---|
| 1 (chat) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |
| 2 (finance) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md);prompt 已升级为"区域业态专员"模式 |
| 2a (finance_area) | **2026-05-05** | ✅ 最新 | Neo | 已确认状态 A:与 App2 是两个独立百炼 APP;App2a 是 App2 5/5 版本的精细化扩充(H6 + 板块 D 助教成本特殊规则) |
| 3 (clue) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |
| 4 (analysis) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |
| 5 (tactics) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |
| 6 (note) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |
| 7 (customer) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |
| 8 (consolidation) | **2026-05-05** | ✅ 最新 | Neo | 内容来源 [`_snapshot-20260505-source.md`](_snapshot-20260505-source.md) |

> ✅ 9 APP(含 App2a)system prompt 已于 2026-05-05 全部从百炼控制台同步到位。
> ⚠️ App2a 百炼 APP_ID 待 Neo 补全(本目录 §三 表格)。

## 五、同步流程(SOP)

每次云端 prompt 调整后:

1. 打开百炼控制台 → 进入对应 APP → 配置页 → 复制 system prompt 全文
2. 打开本目录对应 MD 文件(如 `app3_clue.md`)
3. 替换 `## System Prompt(云端快照)` 章节内容
4. 修改元信息表里的"最后同步"日期 + "同步人"
5. 在"同步历史"章节追加一行
6. 修改本文件 §四 同步状态表对应行
7. `git add docs/ai/system-prompts/<file>.md _INDEX.md && git commit -m "docs(ai-prompt): 同步 AppN system prompt 至 YYYY-MM-DD"`

## 六、前端消费方式速查

| APP | 展示位置 | 数据来源 | 备注 |
|---|---|---|---|
| 1 | chat 页面 | SSE 流式 + `ai_messages` | 实时对话 |
| 2 | board-finance | `ai_cache (app2_finance)` | 洞察卡片 |
| 2a | board-finance(area≠all) | `ai_cache (app2a_finance_area)` | 区域洞察 |
| 3 | 不展示 | `ai_cache (app3_clue)` | 供 App8 整合 |
| 4 | task-detail + task-list 卡片摘要 | `ai_cache (app4_analysis)` | summary 在卡片显示 |
| 5 | task-detail | `ai_cache (app5_tactics)` | 话术列表 |
| 6 | task-detail 备注卡片(打星) | `ai_cache (app6_note_analysis)` | 线索供 App8 |
| 7 | customer-detail | `ai_cache (app7_customer_analysis)` | 策略+总结 |
| 8 | customer-detail + task-detail | `member_retention_clue` | By:系统/By:备注 |

## 七、关联文档

- **行业背景片段汇总**:[`_industry-context-by-app.md`](_industry-context-by-app.md)(8 APP system prompt **顶部**粘贴的"行业背景"块,与各自 system prompt 内容**不重合**)
- **F3-2B Prompt 文件清单**:[`docs/_overview/wave1-findings/F3-2-prompt-files-list.md`](../../_overview/wave1-findings/F3-2-prompt-files-list.md)
- **App2 历史多版本**(已封存,仅作回溯):
  - [`../app2_finance_system_prompt_v3.md`](../app2_finance_system_prompt_v3.md)
  - [`../app2_finance_system_prompt_20260422.md`](../app2_finance_system_prompt_20260422.md)
  - [`../app2_finance_system_prompt_20260422_v4_concise.md`](../app2_finance_system_prompt_20260422_v4_concise.md)
  - [`../app2_finance_system_prompt_20260422_v5.md`](../app2_finance_system_prompt_20260422_v5.md)
  - [`../app2_finance_system_prompt_20260422_v5_1.md`](../app2_finance_system_prompt_20260422_v5_1.md) ← App2 当前最新
  - [`../app2_finance_prompt_version_history.md`](../app2_finance_prompt_version_history.md)
- **App2a 当前最新**:[`../app2a_finance_area_system_prompt_20260422_v1.md`](../app2a_finance_area_system_prompt_20260422_v1.md)
- **App2 设计文档**:[`../app2_finance_multi_app_design.md`](../app2_finance_multi_app_design.md)
- **AI 应用验收 spec**:[`../ai_apps_feature_acceptance_spec.md`](../ai_apps_feature_acceptance_spec.md)
- **运行时实现要点**(NS2 后端):见 [`docs/prd/ai-app-prompts.md`](../../prd/ai-app-prompts.md) NS2 章节
- **代码 user message 拼装**:`apps/backend/app/ai/prompts/app[2-8]_*_prompt.py`

## 八、后续待办

- [x] ~~App2a 厘清~~(2026-05-05 已确认状态 A:独立 APP,prompt 已同步)
- [ ] **App2a APP_ID 补全**:在本目录 §三 表格中填 App2a 的百炼 APP ID 和环境变量名(Neo 从百炼控制台抄)
- [ ] (可选)搭定时机制:每月初 hook 提醒检查云端 prompt 是否有调整
