61 lines
3.1 KiB
JSON
61 lines
3.1 KiB
JSON
{
|
||
"module": "prompts",
|
||
"version": "1.0",
|
||
"purpose": "LLM 提示词版本管理系统。管理知微使用的所有 LLM prompt，支持版本历史、效果追踪和 A/B 测试。",
|
||
|
||
"human_help": {
|
||
"title": "提示词管理",
|
||
"description": [
|
||
"集中管理 MoFin 系统中知微 LLM 使用的所有提示词模板。",
|
||
"每个提示词支持多版本管理，可以激活/回滚/废弃版本。",
|
||
"内置效果追踪：记录每个提示词版本被调用时的成功率和关联策略数。"
|
||
],
|
||
"usage": [
|
||
"GET /api/prompts — 获取所有提示词列表（含当前版本和版本数）",
|
||
"GET /api/prompts/<id> — 获取单个提示词的完整信息（含所有版本和历史）",
|
||
"POST /api/prompts — 创建新提示词",
|
||
"POST /api/prompts/<id>/versions — 添加新版本",
|
||
"POST /api/prompts/<id>/activate — 激活指定版本",
|
||
"GET /api/prompts/effectiveness — 获取各版本有效性统计",
|
||
"GET /api/prompts/report — 获取版本有效性报告",
|
||
"GET /api/prompts/associations/<code> — 获取某股票关联的提示词"
|
||
],
|
||
"troubleshooting": [
|
||
"提示词列表为空 → 运行 init_registry.py 初始化注册表",
|
||
"版本激活不生效 → 检查版本号是否存在，确认不是已废弃状态"
|
||
]
|
||
},
|
||
|
||
"ai_spec": {
|
||
"apis": [
|
||
{"method": "GET", "path": "/api/prompts", "returns": "{prompts[{id, name, category, current_version, versions[]}], categories{}}"},
|
||
{"method": "GET", "path": "/api/prompts/<id>", "returns": "{prompt{...}, version_history[{version, label, status, created_at, changelog}]}"},
|
||
{"method": "POST", "path": "/api/prompts", "returns": "{status:'ok', prompt_id}"},
|
||
{"method": "POST", "path": "/api/prompts/<id>/versions", "returns": "{status:'ok', version}"},
|
||
{"method": "POST", "path": "/api/prompts/<id>/activate", "returns": "{status:'ok'}"},
|
||
{"method": "GET", "path": "/api/prompts/stats", "returns": "统计信息"},
|
||
{"method": "GET", "path": "/api/prompts/effectiveness", "returns": "各版本成功率统计"},
|
||
{"method": "GET", "path": "/api/prompts/report", "returns": "{report: 版本有效性报告文本}"},
|
||
{"method": "GET", "path": "/api/prompts/associations/<code>", "returns": "股票关联的提示词列表"}
|
||
],
|
||
"dependencies": [
|
||
"prompt_manager/init_registry.py — 初始化提示词注册表",
|
||
"prompt_manager/registry.py — 提示词注册管理",
|
||
"prompt_manager/models.py — 数据模型",
|
||
"prompt_manager/tracking.py — 效果追踪",
|
||
"prompt_manager/analytics.py — 分析统计"
|
||
],
|
||
"constraints": [
|
||
"提示词内容必须遵守 DEVELOPMENT_STANDARDS.md 中的 LLM Prompt 规范",
|
||
"不引用 JSON 文件名（S1规则）",
|
||
"港股价格标注 (HKD)（S2规则）",
|
||
"不在 prompt 里硬编码路径（S5规则）"
|
||
],
|
||
"related_files": [
|
||
"prompt_manager/dashboard_views.py — API 路由",
|
||
"prompt_manager/init_registry.py — 注册表初始化",
|
||
"docs/DEVELOPMENT_STANDARDS.md — Prompt 规范"
|
||
]
|
||
}
|
||
}
|