{"openapi":"3.1.0","info":{"title":"玄枢.玄空 API","description":"基于 470 部先秦至民国原典构建的周易/五行/命理/风水/占筮知识库。\n\n**四层能力**\n1. **符号层计算** —— 干支、五行生克、十神、藏干、纳音、十二长生、64 卦、24 山、三元、九星、神煞\n2. **混合检索** —— BM25 关键词 + bge-small-zh 语义向量，236,119 个检索单元\n3. **原典全文** —— 分章分节回溯，繁简双向归一\n4. **理论体系** —— 6 层结构、86 个概念、13 项矛盾裁决，123 条原书实证\n\n**使用建议**：`/docs` 为交互式文档，`/api/v1/guide` 为中文上手手册。","version":"1.1.0"},"paths":{"/api/v1/health":{"get":{"tags":["系统"],"summary":"健康检查","operationId":"health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/meta":{"get":{"tags":["系统"],"summary":"知识库总览与覆盖边界","operationId":"library_meta_api_v1_meta_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/guide":{"get":{"tags":["系统"],"summary":"中文上手手册（HTML）","operationId":"guide_api_v1_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/books":{"get":{"tags":["典籍"],"summary":"典籍列表（可筛选/分页）","operationId":"list_books_api_v1_books_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"subfield","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subfield"}},{"name":"grade","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grade"}},{"name":"copyright","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Copyright"}},{"name":"script","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(cjk|title|path)$","default":"cjk","title":"Order By"}},{"name":"desc","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Desc"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/books/{book_id}":{"get":{"tags":["典籍"],"summary":"典籍详情（含审计信息）","operationId":"get_book_api_v1_books__book_id__get","parameters":[{"name":"book_id","in":"path","required":true,"schema":{"type":"integer","title":"Book Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/books/by-path/{path}":{"get":{"tags":["典籍"],"summary":"按相对路径取典籍","operationId":"get_book_by_path_api_v1_books_by_path__path__get","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/books/{book_id}/text":{"get":{"tags":["典籍"],"summary":"典籍全文（分页）","operationId":"get_book_text_api_v1_books__book_id__text_get","parameters":[{"name":"book_id","in":"path","required":true,"schema":{"type":"integer","title":"Book Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200000,"description":"每次返回的汉字数上限","default":20000,"title":"Limit"},"description":"每次返回的汉字数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/books/{book_id}/chapters":{"get":{"tags":["典籍"],"summary":"典籍章节/检索单元目录","operationId":"get_book_chapters_api_v1_books__book_id__chapters_get","parameters":[{"name":"book_id","in":"path","required":true,"schema":{"type":"integer","title":"Book Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search":{"get":{"tags":["检索"],"summary":"混合检索（关键词 + 语义）","operationId":"search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"查询串（简体或繁体皆可）","title":"Q"},"description":"查询串（简体或繁体皆可）"},{"name":"mode","in":"query","required":false,"schema":{"type":"string","pattern":"^(hybrid|keyword|semantic)$","description":"hybrid=混合 / keyword=仅BM25 / semantic=仅向量","default":"hybrid","title":"Mode"},"description":"hybrid=混合 / keyword=仅BM25 / semantic=仅向量"},{"name":"top_k","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":10,"title":"Top K"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"subfield","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subfield"}},{"name":"book_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Book Id"}},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","default":0.0,"title":"Min Score"}},{"name":"w_keyword","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"混合时关键词权重","default":0.5,"title":"W Keyword"},"description":"混合时关键词权重"},{"name":"w_semantic","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"混合时语义权重","default":0.5,"title":"W Semantic"},"description":"混合时语义权重"},{"name":"include_text","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Text"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search/similar":{"get":{"tags":["检索"],"summary":"相似段落（以库中某段为查询）","operationId":"search_similar_api_v1_search_similar_get","parameters":[{"name":"passage_id","in":"query","required":true,"schema":{"type":"integer","title":"Passage Id"}},{"name":"top_k","in":"query","required":false,"schema":{"type":"integer","maximum":50,"default":8,"title":"Top K"}},{"name":"exclude_same_book","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Exclude Same Book"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search/context":{"get":{"tags":["检索"],"summary":"命中段落的上下文（前后若干单元）","operationId":"search_context_api_v1_search_context_get","parameters":[{"name":"passage_id","in":"query","required":true,"schema":{"type":"integer","title":"Passage Id"}},{"name":"before","in":"query","required":false,"schema":{"type":"integer","default":2,"title":"Before"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","default":2,"title":"After"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ganzhi":{"get":{"tags":["符号层"],"summary":"天干/地支全表","operationId":"ganzhi_api_v1_ganzhi_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(gan|zhi)$"},{"type":"null"}],"title":"Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ganzhi/{symbol}":{"get":{"tags":["符号层"],"summary":"单个天干/地支","operationId":"get_ganzhi_api_v1_ganzhi__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wuxing":{"get":{"tags":["符号层"],"summary":"五行属性与生克","operationId":"wuxing_api_v1_wuxing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/wuxing/relations":{"post":{"tags":["符号层"],"summary":"两五行（或两干支）的生克关系","operationId":"wuxing_relations_api_v1_wuxing_relations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/shishen":{"get":{"tags":["符号层"],"summary":"十神全矩阵（10 日主 × 10 目标）","operationId":"shishen_api_v1_shishen_get","parameters":[{"name":"day_gan","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Day Gan"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/shishen/of/{day}/{target}":{"get":{"tags":["符号层"],"summary":"求某目标干相对日主的十神","operationId":"shishen_of_api_v1_shishen_of__day___target__get","parameters":[{"name":"day","in":"path","required":true,"schema":{"type":"string","title":"Day"}},{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/canggan":{"get":{"tags":["符号层"],"summary":"地支藏干","operationId":"canggan_api_v1_canggan_get","parameters":[{"name":"zhi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zhi"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/canggan/{zhi}":{"get":{"tags":["符号层"],"summary":"按地支取藏干","operationId":"canggan_of_api_v1_canggan__zhi__get","parameters":[{"name":"zhi","in":"path","required":true,"schema":{"type":"string","title":"Zhi"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nayin":{"get":{"tags":["符号层"],"summary":"六十甲子纳音","operationId":"nayin_api_v1_nayin_get","parameters":[{"name":"gan_zhi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gan Zhi"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nayin/{gan_zhi}":{"get":{"tags":["符号层"],"summary":"按干支取纳音（繁简皆可）","operationId":"nayin_of_api_v1_nayin__gan_zhi__get","parameters":[{"name":"gan_zhi","in":"path","required":true,"schema":{"type":"string","title":"Gan Zhi"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/changsheng":{"get":{"tags":["符号层"],"summary":"十二长生","operationId":"changsheng_api_v1_changsheng_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/changsheng/of/{gan}/{zhi}":{"get":{"tags":["符号层"],"summary":"某干在某支的长生状态","operationId":"changsheng_of_api_v1_changsheng_of__gan___zhi__get","parameters":[{"name":"gan","in":"path","required":true,"schema":{"type":"string","title":"Gan"}},{"name":"zhi","in":"path","required":true,"schema":{"type":"string","title":"Zhi"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/zhi-relations":{"get":{"tags":["符号层"],"summary":"地支关系（六合/六冲/三合/三会/六害）","operationId":"zhi_relations_api_v1_zhi_relations_get","parameters":[{"name":"zhi","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zhi"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/hexagrams":{"get":{"tags":["符号层"],"summary":"六十四卦列表","operationId":"hexagrams_api_v1_hexagrams_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"wuxing","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wuxing"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/hexagrams/{num}":{"get":{"tags":["符号层"],"summary":"按卦序取卦（1–64）","operationId":"hexagram_api_v1_hexagrams__num__get","parameters":[{"name":"num","in":"path","required":true,"schema":{"type":"integer","title":"Num"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/hexagrams/by-name/{name}":{"get":{"tags":["符号层"],"summary":"按卦名取卦（繁简皆可）","operationId":"hexagram_by_name_api_v1_hexagrams_by_name__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ershi-shan":{"get":{"tags":["符号层"],"summary":"二十四山（角度/五行/三元）","operationId":"ershi_shan_api_v1_ershi_shan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/najia":{"get":{"tags":["符号层"],"summary":"八卦纳甲（六爻装卦）——已迁至 /api/v1/liuyao/najia","operationId":"najia_api_v1_najia_get","parameters":[{"name":"gua","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gua"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jiuxing":{"get":{"tags":["符号层"],"summary":"九星（紫白飞星）","operationId":"jiuxing_api_v1_jiuxing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/shensha":{"get":{"tags":["符号层"],"summary":"神煞表","operationId":"shensha_api_v1_shensha_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/shensha/{name}":{"get":{"tags":["符号层"],"summary":"按名取神煞","operationId":"shensha_by_name_api_v1_shensha__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao":{"get":{"tags":["六爻"],"summary":"六爻总览（纳甲/六亲/六神/世应）","operationId":"liuyao_overview_api_v1_liuyao_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liuyao/najia":{"get":{"tags":["六爻"],"summary":"八卦纳甲（装卦六爻地支）","operationId":"liuyao_najia_api_v1_liuyao_najia_get","parameters":[{"name":"gua","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gua"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/liuqin":{"get":{"tags":["六爻"],"summary":"六亲（生克映射）","operationId":"liuyao_liuqin_api_v1_liuyao_liuqin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liuyao/liushen":{"get":{"tags":["六爻"],"summary":"六神（六兽），可按日干取序列","operationId":"liuyao_liushen_api_v1_liuyao_liushen_get","parameters":[{"name":"day_gan","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"日干，如 甲/丙/戊","title":"Day Gan"},"description":"日干，如 甲/丙/戊"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/shiying":{"get":{"tags":["六爻"],"summary":"世应安法 + 京房八宫六十四卦序","operationId":"liuyao_shiying_api_v1_liuyao_shiying_get","parameters":[{"name":"gua","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"卦名；填则返回该卦宫序与世应","title":"Gua"},"description":"卦名；填则返回该卦宫序与世应"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/terms":{"get":{"tags":["六爻"],"summary":"六爻术语表（用神/旬空/月破/飞伏/进退…）","operationId":"liuyao_terms_api_v1_liuyao_terms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liuyao/cast":{"post":{"tags":["六爻"],"summary":"六爻装卦（纳甲+六亲+六神+世应+旬空月破旺衰）","operationId":"liuyao_cast_api_v1_liuyao_cast_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiuyaoCastIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/yongshen":{"get":{"tags":["六爻"],"summary":"用神取用（占何事取何六亲）","operationId":"liuyao_yongshen_api_v1_liuyao_yongshen_get","parameters":[{"name":"matter","in":"query","required":true,"schema":{"type":"string","description":"所问事项，如 '求财' '功名' '疾病'","title":"Matter"},"description":"所问事项，如 '求财' '功名' '疾病'"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/xunkong":{"get":{"tags":["六爻"],"summary":"旬空查询（六十甲子旬空）","operationId":"liuyao_xunkong_api_v1_liuyao_xunkong_get","parameters":[{"name":"gan_zhi","in":"query","required":true,"schema":{"type":"string","description":"干支日，如 '甲子' '甲午'","title":"Gan Zhi"},"description":"干支日，如 '甲子' '甲午'"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/yuepo":{"get":{"tags":["六爻"],"summary":"月破查询（定月建所冲之支）","operationId":"liuyao_yuepo_api_v1_liuyao_yuepo_get","parameters":[{"name":"month_zhi","in":"query","required":true,"schema":{"type":"string","description":"月建地支，如 '辰'","title":"Month Zhi"},"description":"月建地支，如 '辰'"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liuyao/wangxiang":{"get":{"tags":["六爻"],"summary":"五爻在某月建的旺相休囚死","operationId":"liuyao_wangxiang_api_v1_liuyao_wangxiang_get","parameters":[{"name":"month_zhi","in":"query","required":true,"schema":{"type":"string","description":"月建地支","title":"Month Zhi"},"description":"月建地支"},{"name":"wuxing","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"五行；不填返回全表","title":"Wuxing"},"description":"五行；不填返回全表"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/calc/ganzhi":{"get":{"tags":["计算器"],"summary":"公历日期→干支历（日/月/年柱+旬空+辟卦月）","description":"干支历换算：日柱（含旬空两支）、节气月柱、立春界年柱，\n及十二辟卦月（按最近已过中气，依《周易启蒙翼传》十二月卦）。\n干支锚点经 v22 校验（1949-10-01=甲子日等独立锚点）。","operationId":"calc_ganzhi_api_v1_calc_ganzhi_get","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","description":"YYYY-MM-DD[ HH:MM]，缺省时刻 12:00","title":"Date"},"description":"YYYY-MM-DD[ HH:MM]，缺省时刻 12:00"},{"name":"hour","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":23,"minimum":0},{"type":"null"}],"title":"Hour"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/calc/bazi":{"post":{"tags":["计算器"],"summary":"四柱排盘（节气精确，以 lunar-python 天文算法）","description":"月柱按**节气**划分（立春/惊蛰/…），非日历月——这是子平法「月令」的真正含义。\n日柱以 1949-10-01 甲子日为锚（开国大典日柱，已交叉验证）。","operationId":"calc_bazi_api_v1_calc_bazi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/server__BaziIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/calc/meihua":{"post":{"tags":["计算器"],"summary":"梅花易数起卦（单数法）","operationId":"calc_meihua_api_v1_calc_meihua_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeihuaIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/calc/feixing":{"post":{"tags":["计算器"],"summary":"玄空飞星排盘（向盘/山盘）","description":"玄空飞星**符号层框架**：坐山/向 → 本卦 → 九宫盘位。\n\n刻意**不臆造**完整飞星算法：沈氏玄空学的替卦、城门、旺山旺向推演\n需依《沈氏玄空学》原书逐章手工推演，本库不提供未经原书验证的自动化判吉凶。","operationId":"calc_feixing_api_v1_calc_feixing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeixingIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/convert/s2t":{"get":{"tags":["工具"],"summary":"简体→繁体","operationId":"s2t_api_v1_convert_s2t_get","parameters":[{"name":"text","in":"query","required":true,"schema":{"type":"string","title":"Text"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/convert/t2s":{"get":{"tags":["工具"],"summary":"繁体→简体","operationId":"t2s_api_v1_convert_t2s_get","parameters":[{"name":"text","in":"query","required":true,"schema":{"type":"string","title":"Text"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/concepts":{"get":{"tags":["理论"],"summary":"理论概念列表（6 层）","operationId":"concepts_api_v1_concepts_get","parameters":[{"name":"layer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Layer"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/concepts/graph":{"get":{"tags":["理论"],"summary":"概念关系图（节点+边）","operationId":"concept_graph_api_v1_concepts_graph_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/concepts/{cid}":{"get":{"tags":["理论"],"summary":"概念详情（含相关概念与矛盾）","operationId":"concept_api_v1_concepts__cid__get","parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","title":"Cid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/contradictions":{"get":{"tags":["理论"],"summary":"矛盾登记与裁决","operationId":"contradictions_api_v1_contradictions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/contradictions/{cid}":{"get":{"tags":["理论"],"summary":"单条矛盾裁决详情","operationId":"contradiction_api_v1_contradictions__cid__get","parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","title":"Cid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/evidence":{"get":{"tags":["理论"],"summary":"原书实证引文（123 条，逐条可回查原书）","operationId":"evidence_api_v1_evidence_get","parameters":[{"name":"proposition","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposition"}},{"name":"book_path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Book Path"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/theory":{"get":{"tags":["理论"],"summary":"理论体系全文（Markdown）","operationId":"theory_api_v1_theory_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/audit":{"get":{"tags":["理论"],"summary":"典籍审计报告（Markdown）","operationId":"audit_report_api_v1_audit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/verification":{"get":{"tags":["理论"],"summary":"六爻典籍核实报告（Markdown）","operationId":"verification_api_v1_verification_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/audit/json":{"get":{"tags":["理论"],"summary":"典籍审计结果（JSON）","operationId":"audit_json_api_v1_audit_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/glyph":{"get":{"tags":["图形"],"summary":"图形类型清单","description":"列出全部可生成的图形。","operationId":"glyph_list_api_v1_glyph_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/glyph/{kind}":{"get":{"tags":["图形"],"summary":"取图形（SVG）","operationId":"glyph_api_v1_glyph__kind__get","parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}},{"name":"num","in":"query","required":false,"schema":{"type":"integer","maximum":64,"minimum":1,"description":"卦序（kind=hexagram / najia 时必填）","default":1,"title":"Num"},"description":"卦序（kind=hexagram / najia 时必填）"},{"name":"day_gan","in":"query","required":false,"schema":{"type":"string","pattern":"^[甲乙丙丁戊己庚辛壬癸]$","description":"日干（kind=najia 时决定六神排布）","default":"甲","title":"Day Gan"},"description":"日干（kind=najia 时决定六神排布）"},{"name":"month_zhi","in":"query","required":false,"schema":{"type":"string","pattern":"^[子丑寅卯辰巳午未申酉戌亥]$","description":"月支（kind=najia 时决定旺衰）","default":"辰","title":"Month Zhi"},"description":"月支（kind=najia 时决定旺衰）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/glyph/{kind}/data":{"get":{"tags":["图形"],"summary":"取图形对应的结构化数据（JSON）","description":"图形背后的数据——便于调用方自行渲染，不依赖本库的 SVG 排版。","operationId":"glyph_data_api_v1_glyph__kind__data_get","parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}},{"name":"num","in":"query","required":false,"schema":{"type":"integer","maximum":64,"minimum":1,"default":1,"title":"Num"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/graph":{"get":{"tags":["知识图谱"],"summary":"知识图谱全图（分层节点 + 关系边）","description":"概念图谱：节点 = 概念，边 = related 关系。层号见 layer_desc。","operationId":"graph_api_v1_graph_get","parameters":[{"name":"layer","in":"query","required":false,"schema":{"type":"string","description":"只取某层，空为全部","default":"","title":"Layer"},"description":"只取某层，空为全部"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/graph/layer/{layer}":{"get":{"tags":["知识图谱"],"summary":"按层取概念","description":"取某一层的全部概念及其定义。","operationId":"graph_layer_api_v1_graph_layer__layer__get","parameters":[{"name":"layer","in":"path","required":true,"schema":{"type":"string","title":"Layer"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/graph/path":{"get":{"tags":["知识图谱"],"summary":"概念关系路径（相关概念逐跳展开）","description":"从某概念出发，沿 related 关系展开 depth 层，返回可达节点。","operationId":"graph_path_api_v1_graph_path_get","parameters":[{"name":"cid","in":"query","required":true,"schema":{"type":"string","title":"Cid"}},{"name":"depth","in":"query","required":false,"schema":{"type":"integer","maximum":4,"minimum":1,"default":2,"title":"Depth"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search/exact":{"get":{"tags":["检索"],"summary":"中文精确全文检索（SQLite FTS5 二元组索引）","description":"短语级精确检索，走 SQLite FTS5，**不加载向量索引**（毫秒级返回）。\n\n与 `/api/v1/search` 的分工：\n  - 本端点：**短语精确匹配**，适合「某书名」「某术语是否在库中」这类查证\n  - /search：BM25 + 512 维语义向量的混合检索，适合探索式查找\n\n实现说明：FTS5 内置的 `unicode61` 会把整句连续中文并成单个 token，\n查「骨法」会 0 命中。本库另存 `passages.bigrams`（去重 CJK 二元组）\n并索引该列，2 字词与长词均可精确命中。","operationId":"search_exact_api_v1_search_exact_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"查询串（简体或繁体皆可）","title":"Q"},"description":"查询串（简体或繁体皆可）"},{"name":"top_k","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Top K"}},{"name":"book","in":"query","required":false,"schema":{"type":"string","description":"限定书名（部分匹配）","default":"","title":"Book"},"description":"限定书名（部分匹配）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/decide/chain":{"get":{"tags":["裁决与排盘"],"summary":"择一链（主据 + 退路顺序）","description":"各主题采用哪家为主据、退路如何排列。","operationId":"decide_chain_api_v1_decide_chain_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/decide/{topic}":{"get":{"tags":["裁决与排盘"],"summary":"某主题的择一链","operationId":"decide_topic_api_v1_decide__topic__get","parameters":[{"name":"topic","in":"path","required":true,"schema":{"type":"string","title":"Topic"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/judge/bazi":{"post":{"tags":["裁决与排盘"],"summary":"八字裁决：格局 / 用神 / 吉凶（滴天髓主）","description":"取用神与断吉凶。\n\n择一链：**《滴天髓》→《穷通宝鉴》→《子平真诠》→《神峰通考》**。\n返回值含每条裁决的 `school`（最终采用的一家）、`quote`（原书文句）\n与 `alternatives`（其余各家说法），调用方可自行核对。","operationId":"judge_bazi_api_v1_judge_bazi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/decision_routes__BaziIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/judge/liuyao":{"post":{"tags":["裁决与排盘"],"summary":"六爻裁决：应期 / 吉凶（卜筮正宗主）","description":"断应期与吉凶。\n\n择一链：**《卜筮正宗》→《增删卜易》→《断易天机》→《黄金策》**。\n主据《卜筮正宗》卷四「各门类应期总注」第十四论六条规则全部可计算；\n卷六千金赋直解给吉凶总纲。返回带完整证据链与原书文句。","operationId":"judge_liuyao_api_v1_judge_liuyao_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiuyaoIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/judge/liqi":{"get":{"tags":["裁决与排盘"],"summary":"玄空理气：三盘 + 旺山旺向（沈氏为主）","description":"三盘挨星（运盘/向盘/山盘）+ 旺山旺向 + 三合参考层。\n\n裁决：**以沈氏《玄空学》为准**；三合法列为参考层，冲突点如实标出。","operationId":"judge_liqi_api_v1_judge_liqi_get","parameters":[{"name":"shan","in":"query","required":true,"schema":{"type":"string","description":"坐山，二十四山之一","title":"Shan"},"description":"坐山，二十四山之一"},{"name":"xiang","in":"query","required":true,"schema":{"type":"string","description":"朝向，二十四山之一","title":"Xiang"},"description":"朝向，二十四山之一"},{"name":"yun","in":"query","required":false,"schema":{"type":"integer","maximum":9,"minimum":1,"description":"元运 1–9","default":9,"title":"Yun"},"description":"元运 1–9"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/judge/liqi/full":{"get":{"tags":["裁决与排盘"],"summary":"玄空理气全格局：十四类格局逐项判定（沈氏《玄空学》全）","description":"沈氏玄空**全部格局**总汇。\n\n覆盖：三元九运／地盘／三盘下卦／合十／生成／父母三般卦与三般卦／\n七星打劫（真·假）／令星入囚（含 24 山地运年数）／四十八局／反伏吟／\n兼向出卦／替卦（坤壬乙诀）／直向（错卦·互卦）／城门诀／零神。\n\n每项均附**《沈氏玄空学》原书 seq 段号**，可用\n`GET /api/v1/books/244/chapters` 回查原文。\n原书为图版而无文字表格者（打劫 24 局、城门全表），输出中以\n`底本缺口` 字段显式标注，**不虚构全表**。","operationId":"judge_liqi_full_api_v1_judge_liqi_full_get","parameters":[{"name":"shan","in":"query","required":true,"schema":{"type":"string","description":"坐山，二十四山之一","title":"Shan"},"description":"坐山，二十四山之一"},{"name":"xiang","in":"query","required":true,"schema":{"type":"string","description":"朝向，二十四山之一","title":"Xiang"},"description":"朝向，二十四山之一"},{"name":"yun","in":"query","required":false,"schema":{"type":"integer","maximum":9,"minimum":1,"description":"元运 1–9","default":9,"title":"Yun"},"description":"元运 1–9"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liqi/ju216":{"get":{"tags":["裁决与排盘"],"summary":"原书 216 局挨星图直查（《沈氏玄空学》卷四总断+逐运）","description":"按山向+元运直取原书下卦条目：总断原文（地运/当旺运/合十/打劫/城门/\n吉方/反伏吟）与该运挨星说明（到山到向星/顺逆/上山下水/吉凶）。\n\n- 精确命中二十四山对宫键（如 乾巽、子午）→ 原书原条目；\n- 键未精确命中而经同宫归一命中（如 壬丁→壬丙）→ 返回条目带\n  「非正局近似: true」，调用方须按近似处理；\n- 完全未收（非对宫组合）→ 404，说明原书 216 图未收该组。\n2026-10-10 修复 ju_key 键错位后新增（此前 16 组总断取错同宫兄弟条目）。","operationId":"liqi_ju216_api_v1_liqi_ju216_get","parameters":[{"name":"shan","in":"query","required":true,"schema":{"type":"string","description":"坐山，二十四山之一","title":"Shan"},"description":"坐山，二十四山之一"},{"name":"xiang","in":"query","required":true,"schema":{"type":"string","description":"朝向，二十四山之一","title":"Xiang"},"description":"朝向，二十四山之一"},{"name":"yun","in":"query","required":true,"schema":{"type":"integer","maximum":9,"minimum":1,"description":"元运 1–9","title":"Yun"},"description":"元运 1–9"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liqi/tables":{"get":{"tags":["裁决与排盘"],"summary":"玄空格局常数表（地盘/替卦/合十/四十八局/地运年数…）","description":"直接取用《沈氏玄空学》的各格局常数表，便于前端建模与核对。","operationId":"liqi_tables_api_v1_liqi_tables_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pan/ziwei":{"post":{"tags":["裁决与排盘"],"summary":"紫微斗数排盘（十二宫 / 主星 / 四化 / 三方四正）","description":"依《安星诀》安十二宫、安紫微系、安天府系、安四化、定三方四正。","operationId":"pan_ziwei_api_v1_pan_ziwei_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZiweiIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ziwei/miao":{"get":{"tags":["裁决与排盘"],"summary":"紫微庙旺落陷定表（《紫微諸星廟陷訣》）","description":"逐星定庙的原书定表。原书未列之宫位标「原书未载」，不以「平」充数。","operationId":"ziwei_miao_table_api_v1_ziwei_miao_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/ziwei/miao/{star}":{"get":{"tags":["裁决与排盘"],"summary":"判某星在某宫的庙陷","operationId":"ziwei_miao_one_api_v1_ziwei_miao__star__get","parameters":[{"name":"star","in":"path","required":true,"schema":{"type":"string","title":"Star"}},{"name":"zhi","in":"query","required":true,"schema":{"type":"string","pattern":"^[子丑寅卯辰巳午未申酉戌亥]$","title":"Zhi"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pan/qizheng":{"get":{"tags":["裁决与排盘"],"summary":"七政四余排盘（七政黄经 + 二十八宿 + 十二宫）","description":"日月五星实际黄经 + 罗睺计都 + 分野。\n\n星历用 pymeeus 内置 VSOP87 级数，**完全离线**（黄经误差约 1″–1′）。\n四余取月之交点，依传统作「虚点」处理——见矛盾 #C-3。","operationId":"pan_qizheng_api_v1_pan_qizheng_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":3000,"minimum":-2000,"title":"Year"}},{"name":"month","in":"query","required":true,"schema":{"type":"integer","maximum":12,"minimum":1,"title":"Month"}},{"name":"day","in":"query","required":true,"schema":{"type":"integer","maximum":31,"minimum":1,"title":"Day"}},{"name":"hour","in":"query","required":false,"schema":{"type":"integer","maximum":23,"minimum":0,"default":12,"title":"Hour"}},{"name":"minute","in":"query","required":false,"schema":{"type":"integer","maximum":59,"minimum":0,"default":0,"title":"Minute"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pan/qizheng/xiu":{"get":{"tags":["裁决与排盘"],"summary":"二十八宿分野表","operationId":"qizheng_xiu_api_v1_pan_qizheng_xiu_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liqi/jian":{"get":{"tags":["裁决与排盘"],"summary":"兼向起星图：216 局替卦/出卦判据（沈氏卷五原文）","description":"**兼向（补救之向）**的起星图，原书 216 局（24 组兼向对 × 9 运）。\n\n返回四项原书判据：\n  · 向盘替换 / 山盘替换：到盘星 → 所临字（及其元）→ 替星 →\n    「仍原数入中」（视为无替）或「改以某数入中」（真正替换）→ 顺逆\n  · 结论标签：用替到山到向 / 全局合十 / 全局生成 / 无替可寻 / 可用城门\n  · 城门方：原书指明可用城门诀的卦\n  · 入囚\n\n原文：「要知直達之向，下卦已足，補救之向，非起星不可。何謂起星？\n卦爻之變而已。」（seq=245《起星立成图》序）","operationId":"liqi_jian_api_v1_liqi_jian_get","parameters":[{"name":"shan","in":"query","required":true,"schema":{"type":"string","description":"正山，二十四山之一","title":"Shan"},"description":"正山，二十四山之一"},{"name":"xiang","in":"query","required":true,"schema":{"type":"string","description":"兼向，二十四山之一","title":"Xiang"},"description":"兼向，二十四山之一"},{"name":"yun","in":"query","required":false,"schema":{"type":"integer","maximum":9,"minimum":1,"description":"元运 1–9","default":9,"title":"Yun"},"description":"元运 1–9"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liqi/duan":{"get":{"tags":["裁决与排盘"],"summary":"章仲山《宅断》案例检索（原书 40 例，含仲山断语与沈注）","description":"**原书案例检索，不作吉凶推断。**\n\n《宅断》为章仲山所著、沈祖绵增注，收于《沈氏玄空学》卷三（seq=154–207），\n共 40 例，每例载山向、元运、仲山断语与沈注。","operationId":"liqi_duan_api_v1_liqi_duan_get","parameters":[{"name":"yun","in":"query","required":false,"schema":{"type":"integer","maximum":9,"minimum":1,"description":"按元运过滤","title":"Yun"},"description":"按元运过滤"},{"name":"shan","in":"query","required":false,"schema":{"type":"string","description":"按坐山过滤","title":"Shan"},"description":"按坐山过滤"},{"name":"xiang","in":"query","required":false,"schema":{"type":"string","description":"按朝向过滤","title":"Xiang"},"description":"按朝向过滤"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liqi/ju":{"get":{"tags":["裁决与排盘"],"summary":"卷六诸诀常数表（紫白吉星/月三煞/禽星穿宫/八门加临…）","description":"卷六《玄空辑要》的可计算各诀：月上紫白吉星、月三煞、太岁七煞、\n禽星穿宫 24 山、八门加临、门宫生克四等、九星五行、统临专临、日紫白起例。\n原书为图版者（如逐年月紫白表）已在 `图版缺失` 字段注明。","operationId":"liqi_ju_api_v1_liqi_ju_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liqi/zibai/yue":{"get":{"tags":["裁决与排盘"],"summary":"逐年月紫白吉星表（原书图版，依推算法实算）","description":"**逐年月紫白入中星**。\n\n原书此表为图版（seq=413「子午卯酉年月上紫白图」等三表），\n但同段给出完整推算法：\n  「子午卯酉为旺年，正月起八白；辰戌丑未为墓年，正月起五黄；\n    寅申巳亥为生年，正月起二黑。俱从中宫起，随月星逆数。\n    凡子午卯酉年正月，八白入中，二月七赤入中，至十月仍八白入中，周而复始。」\n本端点**依该算法实算**，非凭空补录；`自校` 字段给出与原书样例的比对结果。","operationId":"zibai_yue_api_v1_liqi_zibai_yue_get","parameters":[{"name":"year_zhi","in":"query","required":false,"schema":{"type":"string","description":"生年地支，二十四支之一","default":"子","title":"Year Zhi"},"description":"生年地支，二十四支之一"},{"name":"month","in":"query","required":false,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"农历月","default":1,"title":"Month"},"description":"农历月"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/liqi/zibai/qixing":{"get":{"tags":["裁决与排盘"],"summary":"起星立成图：24 山 → 替卦星（以星代卦）","description":"**起星立成图**（原书星盘为图版，内容即《坤壬乙一诀》）。\n\n依 seq=273 歌诀「子癸甲申贪狼寻，坤壬乙卯未巨门，乾巽六位皆武曲，\n艮丙辛酉丑破军，若向寅午庚丁上，一律挨来是弼星」建 24 山映射，\n并以卷五 216 局兼向起星图逐局反查**交叉验证**。","operationId":"zibai_qixing_api_v1_liqi_zibai_qixing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liqi/zibai/shijia":{"get":{"tags":["裁决与排盘"],"summary":"时家白星起例（冬至三时顺、夏至三时逆）","operationId":"zibai_shijia_api_v1_liqi_zibai_shijia_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liqi/zibai/ri":{"get":{"tags":["裁决与排盘"],"summary":"逐日紫白顺逆局起例（上中下元 × 顺逆）","operationId":"zibai_ri_api_v1_liqi_zibai_ri_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/liqi/dajie":{"get":{"tags":["裁决与排盘"],"summary":"七星打劫二十四局全表（依《沈氏玄空学》判据实算并经局数反验）","description":"**七星打劫 24 局全表**。\n\n原书「北斗七星打劫表」为图版（seq=85，全库仅存表名），本表**依判据实算**：\n\n  「凡旺星到向者，乾上飞星，与离宫相合，为真打劫；若旺星到向，\n    巽上飞星，与坎宫相合，为假打劫。相合者，即一四七、二五八、\n    三六九之三般卦也。」（seq=81）\n\n**自校验**（可在本端点 `自校验` 字段看到）：\n  · 该判据实算得**恰好 24 局**，与 seq=85/86 两次「以上二十四局」字面吻合\n  · 真说剔 3 局、假说剔 3 局，六局全在该 24 局内，各得 **21 局**，\n    与 seq=86「除反伏吟不用外，各得二十一局」字面吻合\n\n真/假为**同一批局的两种判法**（原书两次说「以上二十四局」），\n沈氏云「须按虚实形势、生克制化而用之，在人心眼敏活而已」，真伪不硬性裁定。","operationId":"liqi_dajie_api_v1_liqi_dajie_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/copyright/boundary":{"get":{"tags":["版权"],"summary":"版权边界书清单（可一键剔除）","description":"列出版权处于边界情形的典籍。\n\n本库按需求方指示暂不限制收录，但**必须可追溯、可剔除**：\n重新发布前调用本端点即可拿到应删除清单，不需人工翻库。","operationId":"copyright_boundary_api_v1_copyright_boundary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/divine":{"post":{"tags":["推演"],"summary":"断吉凶（统一入口：八字 / 六爻 / 两盘合参）","description":"按事项断吉凶，给出**分项评分 + 逐条依据 + 置信度**。\n\n- 给 `year/month/day` → 排八字\n- 给 `gua` → 装六爻\n- 两者皆给 → 两盘合参\n\n`matter` 决定用神取法：求财取妻财、功名取官鬼、疾病取官鬼、\n婚姻取妻财、行人出行取父母等（依《增删卜易》用神章）。\n\n输出不是「必吉/必凶」断言，而是**可复算的加权合成**：\n`分项` 字段列出每项得分与依据，调用方可自行改权重复算。","operationId":"divine_api_v1_divine_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DivineIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/divine/matters":{"get":{"tags":["推演"],"summary":"支持断吉凶的事项与用神对照","operationId":"divine_matters_api_v1_divine_matters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pan/ziwei/full":{"post":{"tags":["推演"],"summary":"紫微斗数完整排盘（14 主星 + 16 辅星 + 宫干 + 大限）","description":"依库内《安星訣》全诀排盘。\n\n- **主星十四**：《安星訣》两诀，紫微安星法经书文三例验证全部吻合\n- **辅星十八**：左辅右弼、文昌文曲、地空地劫、天魁天钺、禄存擎羊陀罗、天马、\n  火星铃星（依《安星訣·安火鈴》四句安法）\n- **宫干**：五虎遁\n- **大限**：命宫起，阳男阴女顺行、阴男阳女逆行，每十年过一宫\n- **庙陷**：依《紫微諸星廟陷訣》；该诀只列庙位，未列者标「原书未载」\n\n`month/day` 取**农历**；传阳历请用 `calendar=\"阳历\"`，接口自动换算。","operationId":"pan_ziwei_full_api_v1_pan_ziwei_full_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZiweiFullIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pan/ziwei/stars":{"get":{"tags":["推演"],"summary":"紫微安星表（主星/辅星安法与出处）","description":"列出全部安星规则及其《安星訣》出处，便于核对与复现。","operationId":"pan_ziwei_stars_api_v1_pan_ziwei_stars_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pan/qizheng/full":{"post":{"tags":["推演"],"summary":"七政四余完整排盘（躔度 / 命身宫 / 十二宫星曜分布）","description":"日月五星实际黄经 + 罗睺计都 + 二十八宿躔度 + 命身宫 + 十二宫星曜落宫。\n\n**躔度**为本端点核心：星命家以「某星躔某宿某度」定位天体，\n`躔度 = 星黄经 − 该宿距度起点`。此前接口只返回宿名与宫名，不算数。\n\n星历用 pymeeus 内置 VSOP87 级数，**完全离线**（黄经误差约 1″–1′）。\n四余取月之升降交点，依传统作「虚点」——见矛盾 #C-3。","operationId":"pan_qizheng_full_api_v1_pan_qizheng_full_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QizhengIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pan/qizheng/chandu":{"get":{"tags":["推演"],"summary":"星命躔度计算（任意时刻的七政四余躔度）","description":"只取躔度（轻量）：返回每星的黄经、宿、宿内度数与十二宫次。","operationId":"pan_qizheng_chandu_api_v1_pan_qizheng_chandu_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":3000,"minimum":-2000,"title":"Year"}},{"name":"month","in":"query","required":true,"schema":{"type":"integer","maximum":12,"minimum":1,"title":"Month"}},{"name":"day","in":"query","required":true,"schema":{"type":"integer","maximum":31,"minimum":1,"title":"Day"}},{"name":"hour","in":"query","required":false,"schema":{"type":"integer","maximum":23,"minimum":0,"default":12,"title":"Hour"}},{"name":"minute","in":"query","required":false,"schema":{"type":"integer","maximum":59,"minimum":0,"default":0,"title":"Minute"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pan/qizheng/gong":{"get":{"tags":["推演"],"summary":"十二宫（黄道十二等分）起讫度数","operationId":"pan_qizheng_gong_api_v1_pan_qizheng_gong_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/ephemeris/precision":{"get":{"tags":["推演"],"summary":"星历精度自证：与 IMCCE 官方 vsop87.chk 逐项比对","description":"**不假称**精度：现场调用本库 VSOP87 引擎，与 IMCCE 官方校验基准\n`vsop87.chk`（Bureau des Longitudes PBGF9502）逐项比对后返回真实偏差。\n\nVSOP87 由 JPL **DE200** 数值积分拟合而来，故其精度与 JPL 历表同级；\n但本端点只报告**实测**数字，不作推断。","operationId":"ephemeris_precision_api_v1_ephemeris_precision_get","parameters":[{"name":"verbose","in":"query","required":false,"schema":{"type":"boolean","description":"是否打印完整比对明细","default":false,"title":"Verbose"},"description":"是否打印完整比对明细"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/academy/status":{"get":{"tags":["教材系统"],"summary":"教材路由自检","operationId":"status_api_v1_academy_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Status Api V1 Academy Status Get"}}}}}}},"/api/v1/academy/curriculum":{"get":{"tags":["教材系统"],"summary":"全量课程总纲","operationId":"curriculum_api_v1_academy_curriculum_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Curriculum Api V1 Academy Curriculum Get"}}}}}}},"/api/v1/academy/lessons":{"get":{"tags":["教材系统"],"summary":"课时清单","operationId":"lessons_api_v1_academy_lessons_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Lessons Api V1 Academy Lessons Get"}}}}}}},"/api/v1/academy/evidence":{"get":{"tags":["教材系统"],"summary":"原书实证命题检索","operationId":"evidence_api_v1_academy_evidence_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Evidence Api V1 Academy Evidence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/academy/symbols/match":{"post":{"tags":["教材系统"],"summary":"两干（或两行）的关系：十神与生克","description":"直接查符号表，不经过任何模型：答案唯一、可复现。","operationId":"symbols_match_api_v1_academy_symbols_match_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MateIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Symbols Match Api V1 Academy Symbols Match Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/academy/matters":{"get":{"tags":["教材系统"],"summary":"六爻取用事项表","operationId":"matters_api_v1_academy_matters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Matters Api V1 Academy Matters Get"}}}}}}},"/api/v1/academy/tutor/ask":{"post":{"tags":["教材系统"],"summary":"AI 导师问答（先检索后作答）","description":"检索优先：先把库内证据找出来，再交给可选模型解释。\n\n- 课时优先：给定 lesson_id 时，先把该课时的知识原子挂载的原典拉出来，再做全局检索补齐。\n- 引用强制：每个被送进 prompt 的原文段落必须附 passage_id 与书名；\n  没有 passage_id 的不进入证据。\n- 未配置模型时如实返回 retrieval_only，**绝不**用任何方式“补一句”。","operationId":"tutor_ask_api_v1_academy_tutor_ask_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Tutor Ask Api V1 Academy Tutor Ask Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/liuyao":{"post":{"tags":["周易测股"],"summary":"六爻占个股（象义倾向 + 变盘观察窗口）","description":"按求财占古法装卦断股：妻财=价格收益、子孙=多头源泉、兄弟=抛压、\n父母=消息扰动、官鬼=风险利空（映射为**后人概括**，响应内声明）。\n\n输出：分项评分（每项带原书依据）→ 多空**象义倾向**（偏多/略偏多/中性/\n略偏空/偏空）→ 应期规则的变盘观察窗口。**非买卖指令。**","operationId":"stock_liuyao_api_v1_stock_liuyao_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockLiuyaoIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/meihua":{"post":{"tags":["周易测股"],"summary":"梅花易数测大盘（体用生克 + 主互变三段）","description":"农历年月日时起卦：体卦=大盘自身，用卦=行情之事；\n体克用吉/用克体凶/用生体进益/体生用耗失/比和顺遂（《梅花易数》体用总诀）；\n主卦=开盘、互卦=盘中、变卦=终局。输出强/偏强/震荡/偏弱/弱**象义档位**。","operationId":"stock_meihua_api_v1_stock_meihua_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockMeihuaIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/sectors":{"get":{"tags":["周易测股"],"summary":"五行板块轮动榜（月建旺衰 → 行业强弱象义）","description":"月建定纲、日辰为辅（《五行大义》四时休王），五行 → 行业板块旺衰排名。\n排名为季节象义，**非板块荐股、非轮动交易指令**。","operationId":"stock_sectors_api_v1_stock_sectors_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","description":"YYYY-MM-DD，缺省今日","title":"Date"},"description":"YYYY-MM-DD，缺省今日"}],"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/cycle":{"get":{"tags":["周易测股"],"summary":"辟卦干支周期钟（年月级阴阳消长背景）","description":"十二辟卦配中气（《周易启蒙翼传》）：复→乾阳长为息、姤→坤阴长为消，\n「息卦主禄，消卦主刑」（《易纬稽览图》）。输出周期位置象义，\n**非牛熊判断、非仓位指令**。","operationId":"stock_cycle_api_v1_stock_cycle_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","description":"YYYY-MM-DD，缺省今日","title":"Date"},"description":"YYYY-MM-DD，缺省今日"}],"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/quote":{"get":{"tags":["周易测股"],"summary":"行情快照（三源容灾，仅位置参照）","operationId":"stock_quote_api_v1_stock_quote_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"6位代码或指数名，如 600519 / 上证指数","title":"Code"},"description":"6位代码或指数名，如 600519 / 上证指数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/mappings":{"get":{"tags":["周易测股"],"summary":"行业五行八卦映射表（全量公开）","operationId":"stock_mappings_api_v1_stock_mappings_get","responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}}}}},"/api/v1/stock/interpret":{"post":{"tags":["周易测股"],"summary":"解卦（典籍解卦 + 综合解读可选）","description":"对**已起之卦**做解卦（原样复装，不重起卦——同一卦解一次）。\n\n- 典籍解卦：本卦/变卦卦辞大象、求财总纲原书引文、多空之据、应期窗口，\n  全部从知识库原文组装、确定性可溯源，离线可用。\n- AI 综合解读（`use_ai=true`）：将典籍材料与**股票自身行情位置**\n  （现价/60日区间分位/均线关系）交大模型做象义对照串写，\n  硬约束为易学文献研究视角：禁止交易指令/目标价/收益预测。\n  AI 调用会把卦象数据与股票代码发送至火山方舟，不含个人信息。","operationId":"stock_interpret_api_v1_stock_interpret_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockInterpretIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/interpret/meihua":{"post":{"tags":["周易测股"],"summary":"解卦·梅花测大盘（典籍 + 综合解读可选）","description":"对同一起卦参数复算梅花盘并解卦（时间/数字起卦皆为确定性函数，同参同卦）。","operationId":"stock_interpret_meihua_api_v1_stock_interpret_meihua_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockInterpretMeihuaIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/interpret/sectors":{"post":{"tags":["周易测股"],"summary":"解卦·五行板块榜（典籍 + 综合解读可选）","description":"对同一日期的五行旺衰榜做解卦（季节象义串写，非荐股）。","operationId":"stock_interpret_sectors_api_v1_stock_interpret_sectors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockInterpretDateIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stock/interpret/cycle":{"post":{"tags":["周易测股"],"summary":"解卦·辟卦周期钟（典籍 + 综合解读可选）","description":"对同一日期的辟卦周期位置做解卦（背景象义串写，非牛熊判断）。","operationId":"stock_interpret_cycle_api_v1_stock_interpret_cycle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockInterpretDateIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json; charset=utf-8":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AskIn":{"properties":{"question":{"type":"string","maxLength":500,"minLength":1,"title":"Question"},"lesson_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lesson Id"},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":6}},"type":"object","required":["question"],"title":"AskIn"},"DivineIn":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"day":{"type":"integer","title":"Day"},"hour":{"type":"integer","title":"Hour","default":12},"minute":{"type":"integer","title":"Minute","default":0},"gua":{"type":"string","title":"Gua"},"shi":{"type":"integer","title":"Shi"},"day_gan":{"type":"string","title":"Day Gan","default":"甲"},"day_zhi":{"type":"string","title":"Day Zhi","default":"子"},"month_zhi":{"type":"string","title":"Month Zhi","default":"辰"},"matter":{"type":"string","title":"Matter","default":"求财"}},"type":"object","title":"DivineIn"},"FeixingIn":{"properties":{"shan":{"type":"string","title":"Shan","description":"坐山，如 '子' '乾' '癸'"},"xiang":{"type":"string","title":"Xiang","description":"朝向，如 '午' '坤' '壬'"}},"type":"object","required":["shan","xiang"],"title":"FeixingIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LiuyaoCastIn":{"properties":{"gua":{"type":"string","title":"Gua","description":"卦名或卦序，如 '乾' 或 1"},"day_gan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Day Gan","description":"日干（定六神），如 '甲'"},"day_zhi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Day Zhi","description":"日支（定旬空），如 '午'"},"month_zhi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Month Zhi","description":"月建地支（定旺衰月破），如 '辰'"},"shi":{"anyOf":[{"type":"integer","maximum":6.0,"minimum":1.0},{"type":"null"}],"title":"Shi","description":"世爻爻位；不填按八纯卦默认六爻"},"matter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matter","description":"所问事项，如 '求财' '功名'；填则自动取用神并标注"}},"type":"object","required":["gua"],"title":"LiuyaoCastIn"},"LiuyaoIn":{"properties":{"gua":{"type":"string","title":"Gua"},"shi":{"type":"integer","title":"Shi"},"day_gan":{"type":"string","title":"Day Gan","default":"甲"},"day_zhi":{"type":"string","title":"Day Zhi","default":"子"},"month_zhi":{"type":"string","title":"Month Zhi","default":"辰"},"matter":{"type":"string","title":"Matter","default":"求财"},"matter_liuqin":{"type":"string","title":"Matter Liuqin"}},"type":"object","required":["gua"],"title":"LiuyaoIn"},"MateIn":{"properties":{"a":{"type":"string","title":"A","description":"五行或天干之一"},"b":{"type":"string","title":"B","description":"五行或天干之一"}},"type":"object","required":["a","b"],"title":"MateIn"},"MeihuaIn":{"properties":{"number":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Number","description":"起卦数字（时间/物数/声响数皆可）"},"mod":{"type":"integer","maximum":64.0,"minimum":2.0,"title":"Mod","description":"先天数除数，默认 8（八卦）","default":8},"mod_y":{"type":"integer","maximum":32.0,"minimum":2.0,"title":"Mod Y","description":"爻数除数，默认 6","default":6}},"type":"object","required":["number"],"title":"MeihuaIn"},"QizhengIn":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"day":{"type":"integer","title":"Day"},"hour":{"type":"integer","title":"Hour","default":12},"minute":{"type":"integer","title":"Minute","default":0},"gender":{"type":"string","title":"Gender","default":"男"}},"type":"object","required":["year","month","day"],"title":"QizhengIn"},"RelIn":{"properties":{"a":{"type":"string","title":"A","description":"A（五行或干支）"},"b":{"type":"string","title":"B","description":"B"}},"type":"object","required":["a","b"],"title":"RelIn"},"StockInterpretDateIn":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"use_ai":{"type":"boolean","title":"Use Ai","default":false}},"type":"object","title":"StockInterpretDateIn"},"StockInterpretIn":{"properties":{"gua":{"type":"string","title":"Gua"},"dong":{"items":{},"type":"array","title":"Dong","default":[]},"day_gan":{"type":"string","title":"Day Gan"},"day_zhi":{"type":"string","title":"Day Zhi"},"month_zhi":{"type":"string","title":"Month Zhi"},"name":{"type":"string","title":"Name","default":""},"code":{"type":"string","title":"Code","default":""},"term":{"type":"string","title":"Term","default":"短线"},"use_ai":{"type":"boolean","title":"Use Ai","default":false},"with_market":{"type":"boolean","title":"With Market","default":true}},"type":"object","required":["gua","day_gan","day_zhi","month_zhi"],"title":"StockInterpretIn"},"StockInterpretMeihuaIn":{"properties":{"dt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dt"},"n1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"N1"},"n2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"N2"},"index":{"type":"string","title":"Index","default":"上证指数"},"use_ai":{"type":"boolean","title":"Use Ai","default":false},"with_market":{"type":"boolean","title":"With Market","default":true}},"type":"object","title":"StockInterpretMeihuaIn"},"StockLiuyaoIn":{"properties":{"name":{"type":"string","title":"Name","default":""},"code":{"type":"string","title":"Code","default":""},"dt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dt"},"n1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"N1"},"n2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"N2"},"lines":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Lines"},"term":{"type":"string","title":"Term","default":"短线"},"with_market":{"type":"boolean","title":"With Market","default":true}},"type":"object","title":"StockLiuyaoIn"},"StockMeihuaIn":{"properties":{"dt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dt"},"n1":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"N1"},"n2":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"N2"},"index":{"type":"string","title":"Index","default":"上证指数"},"with_market":{"type":"boolean","title":"With Market","default":true}},"type":"object","title":"StockMeihuaIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ZiweiFullIn":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"day":{"type":"integer","title":"Day"},"hour":{"type":"integer","title":"Hour","default":12},"minute":{"type":"integer","title":"Minute","default":0},"gender":{"type":"string","title":"Gender","default":"男"},"calendar":{"type":"string","title":"Calendar","default":"阳历"},"lunar_leap":{"type":"boolean","title":"Lunar Leap","default":false},"miao":{"type":"boolean","title":"Miao","default":true}},"type":"object","required":["year","month","day"],"title":"ZiweiFullIn"},"ZiweiIn":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"day":{"type":"integer","title":"Day"},"hour":{"type":"integer","title":"Hour","default":12},"minute":{"type":"integer","title":"Minute","default":0},"use_lunar":{"type":"boolean","title":"Use Lunar","default":true}},"type":"object","required":["year","month","day"],"title":"ZiweiIn"},"decision_routes__BaziIn":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"day":{"type":"integer","title":"Day"},"hour":{"type":"integer","title":"Hour","default":12},"minute":{"type":"integer","title":"Minute","default":0}},"type":"object","required":["year","month","day"],"title":"BaziIn"},"server__BaziIn":{"properties":{"year":{"type":"integer","maximum":2100.0,"minimum":1900.0,"title":"Year"},"month":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month"},"day":{"type":"integer","maximum":31.0,"minimum":1.0,"title":"Day"},"hour":{"type":"integer","maximum":23.0,"minimum":0.0,"title":"Hour","description":"0-23；23 点后归次日子时"},"minute":{"type":"integer","maximum":59.0,"minimum":0.0,"title":"Minute","default":0},"ganzhi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ganzhi","description":"可选：直接指定四柱，如 '戊午 丁巳 戊寅 庚申'（优先于日期）"}},"type":"object","required":["year","month","day","hour"],"title":"BaziIn"}}}}