root/Neo-ZQYY
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
c43375734a0314b7669964b31ce0f8dfd8e2e79d
Neo-ZQYY/docs/_overview/wave1-findings/F3-2-prompt-files-list.md
Neo b3ad4b8325 docs(ai-prompt): 9 APP system prompt 独立 MD 目录 + ai-app-prompts.md 瘦身改造 (W1 / F3-2C) 
Neo 反馈: 我把百炼 8 APP 的 system prompt 更新到了 ai_system_prompt_by_app.md,
帮我整理成单独 8+1 个文件, 加说明, 放合适目录, 妥善保管。

新增 docs/ai/system-prompts/ 目录:
- _INDEX.md (关系图 + APP ID 映射 + 同步状态表 + SOP)
- 9 份独立 MD: app1_chat / app2_finance / app2a_finance_area /
  app3_clue / app4_analysis / app5_tactics /
  app6_note / app7_customer / app8_consolidation
- 每份带元信息表 + 场景 + 提示词参数 + system prompt 全文 +
  协作关系 + 同步历史 (用 4 反引号 ````text 避免内部 ```json 冲突)

App2a 厘清 (状态 A):
- 与 App2 是两个独立百炼 APP, APP_ID 0ae965029bc54706bcff44f511ac716b
- 显示名 ZQYY-APP2a-指定区域财务洞察, env DASHSCOPE_APP_ID_2A_FINANCE_AREA
- prompt 是 App2 5/5 版本的精细化扩充: H6 新增'助教成本特殊规则'+
  板块 D 新增'助教字段缺失业态判断'(麻将/KTV 缺失=业态正常 /
  大厅/VIP/斯诺克 缺失=业态异常)

改名 + Banner:
- docs/ai/ai_system_prompt_by_app.md
  -> docs/ai/system-prompts/_snapshot-20260505-source.md
  (git mv 保留历史; 文件头加 Banner 说明已被拆分)

A 处置 docs/prd/ai-app-prompts.md (Neo 同意):
- 727 行 -> 110 行 (减 84.9%)
- 标题改为 '百炼平台 AI 应用集成实现规范'
- 删 8 APP system prompt 章节 (已迁移)
- 留 NS2 实现要点 + APP ID 映射 (补 App2a 行) + 前端消费方式 (补 App2a 行) + 附录代码审计对照表

修正认知错误:
- 5/4 F3-2-prompt-files-list.md 给的对照逻辑 (对照 .py 与云端) 是错的
- .py 是 user message 拼装代码, 不是 system prompt 备份
- 5/5 重写该文件: 对照对象改为 docs/ai/system-prompts/*.md

详见 docs/audit/changes/2026-05-05__wave1_f3_2c_system_prompts_split.md
2026-05-05 02:03:20 +08:00

6.7 KiB
Raw Blame History

F3-2B 本地 Prompt 文件清单 — 已收口(2026-05-05)

日期:2026-05-04 创建 / 2026-05-05 收口修正 触发:Neo F3-2B 反馈"给我本地的 Prompt 保存地址,我去检查并更新" 决策:B 云端权威 + git 备份,SDK 调用方式不改(继续用百炼 APP 调用) 本文件已收口:5/5 已建立 docs/ai/system-prompts/ 独立 MD 体系,Neo 已一次性同步 8 APP 最新版

⚠️ 重要修正(2026-05-05)

之前版本(5/4 创建)给出的对照逻辑是错误的:

❌ 旧逻辑:让 Neo 对照 apps/backend/app/ai/prompts/app{2-8}_*_prompt.py 与百炼控制台

真相:apps/backend/app/ai/prompts/app[2-8]_*_prompt.py 文件不是 system prompt 备份,而是 user message(数据载荷)拼装代码:

  • system prompt 在百炼控制台配置(LLM 真正的角色设定)
  • .py 文件只负责把 board_data 等数据翻译成中文、拼接成首条 user message,SDK 上传给百炼
  • 这两层没有对照关系,不应该 diff

证据:apps/backend/app/ai/prompts/app2_finance_prompt.py:7 注释明确写"system prompt 在百炼控制台配置"。

一、System Prompt 真实备份位置(收口后)

目录:docs/ai/system-prompts/

# APP 独立 MD 角色
0 (索引) _INDEX.md 关系图 / APP ID 映射 / 同步状态表 / 同步流程 SOP
1 App1 app1_chat.md 通用对话(SSE 流式)
2 App2 app2_finance.md 财务洞察(已升级"区域业态专员"模式)
2a App2a app2a_finance_area.md 财务洞察(区域,与 App2 关系待 Neo 厘清)
3 App3 app3_clue.md 客户数据维客线索分析
4 App4 app4_analysis.md 关系分析 / 任务建议
5 App5 app5_tactics.md 话术参考
6 App6 app6_note.md 备注分析
7 App7 app7_customer.md 客户分析
8 App8 app8_consolidation.md 维客线索整理
- (5/5 全量快照源) _snapshot-20260505-source.md 2026-05-05 一次性同步快照(回溯参考)

二、User Message 拼装代码(辅助,非 system prompt)

目录:apps/backend/app/ai/prompts/(8 个 .py 文件)

这些文件不需要与百炼控制台对照,它们的职责是:

  • 拼装 user message(数据 JSON + 字段中文翻译)
  • SDK 调用时上传给百炼
  • 改动只在代码逻辑层(数据切片、字段映射调整),与 system prompt 无关
# APP .py 文件 用途
1 App1 (无) App1 SSE 流式由 chat 流式接口直接处理,无独立拼装文件
2 App2 app2_finance_prompt.py 财务洞察(area=all)数据拼装
2a App2a app2a_finance_area_prompt.py 财务洞察(area≠all)数据拼装
3 App3 app3_clue_prompt.py 维客线索数据拼装
4 App4 app4_analysis_prompt.py 关系分析数据拼装
5 App5 app5_tactics_prompt.py 话术参考数据拼装
6 App6 app6_note_prompt.py 备注分析数据拼装
7 App7 app7_customer_prompt.py 客户分析数据拼装
8 App8 app8_consolidation_prompt.py 维客线索整理数据拼装

三、对照核查方法(已收口,适用未来)

每次百炼控制台 system prompt 调整后:

  1. 打开百炼控制台 → 进入对应 APP 设置 → 找到 system prompt
  2. 打开 docs/ai/system-prompts/app<N>_<name>.md § 四 章节
  3. diff 两边内容
  4. 如果云端 = MD → 一致,无需更新
  5. 如果云端 ≠ MD → 云端为权威,用云端版本覆盖 MD 文件 § 四(对齐 Neo 决策"云端权威")
  6. 修改 MD 元信息表"最后同步"为新日期
  7. 在 MD § 同步历史 追加一行
  8. 同步更新 _INDEX.md §四 同步状态表
  9. commit:docs(ai-prompt): 同步 AppN system prompt 至 YYYY-MM-DD

四、对照状态记录(2026-05-05 同步事件)

APP 同步日期 状态 来源
App1 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §1
App2 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §2(prompt 已升级"区域业态专员")
App2a 2026-05-05 ✅ 已同步最新 已确认状态 A:独立 APP;prompt 是 App2 5/5 版本的精细化扩充(H6 + 板块 D 助教成本特殊规则)
App3 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §3
App4 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §4
App5 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §5
App6 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §6
App7 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §7
App8 2026-05-05 ✅ 已同步最新 _snapshot-20260505-source.md §8

五、SDK 调用方式(已确认不改)

Neo 反馈:"SDK 调用不要改,我坚持使用 APP 调用的方式"。

后端继续走百炼 APP 调用(SDK 携带 app_id,云端 prompt 生效),git 文件仅作备份用,不通过 SDK 传 prompt_template。

六、风险提示

云端权威方案的已知风险(P2-6 / F3-2B 已讨论):

  • 不可 git diff / blame(已通过 docs/ai/system-prompts/ 本地备份缓解)
  • 多 AI 调优时云端可能漂移,git 可能滞后

缓解:

  • 重大 prompt 调整后立即同步 git(每个独立 MD 改 §四 + 同步历史 + commit)
  • 5/5 已建立独立 MD 体系,后续 diff 视角清晰
  • (Wave 2-3)考虑加 hook 提醒每月对照云端

七、关联

八、待 Neo 后续处理

  • App2a 厘清(2026-05-05 已确认状态 A:独立 APP,prompt 已同步)
  • App2a APP_ID 补全:在 _INDEX.md §三 表格补 App2a 百炼 APP_ID 和环境变量名
Reference in New Issue View Git Blame Copy Permalink