ef86b31f6b
宿主机 data 挂载会遮盖镜像内 heaven_knowledge.json；增加不受挂载影响的 seed， 并将缺文件/坏 JSON 转为结构化中文错误，前端展示可读提示而非 Failed to fetch。 Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: multica-agent <github@multica.ai>
280 lines
12 KiB
Python
280 lines
12 KiB
Python
from __future__ import annotations
|
|
|
|
import json
|
|
import tempfile
|
|
import unittest
|
|
from http import HTTPStatus
|
|
from pathlib import Path
|
|
from unittest.mock import patch
|
|
|
|
from backend.features.heaven.engine import build_five_phase_field, hexagram_from_lines
|
|
from backend.features.heaven.http import HeavenHttpMixin
|
|
from backend.features.heaven.knowledge import (
|
|
HeavenKnowledgeError,
|
|
clear_heaven_knowledge_cache,
|
|
prepare_heaven_context,
|
|
resolve_heaven_knowledge_path,
|
|
_knowledge_catalog,
|
|
)
|
|
from backend.features.heaven.six_yao import build_six_yao_chart
|
|
|
|
|
|
class HeavenKnowledgeTests(unittest.TestCase):
|
|
def tearDown(self) -> None:
|
|
clear_heaven_knowledge_cache()
|
|
|
|
def test_catalog_loads_from_trusted_repo_file(self):
|
|
clear_heaven_knowledge_cache()
|
|
path = resolve_heaven_knowledge_path()
|
|
catalog = _knowledge_catalog()
|
|
self.assertTrue(path.is_file())
|
|
self.assertEqual(path.name, "heaven_knowledge.json")
|
|
self.assertTrue(str(catalog.get("version") or "").startswith("2026."))
|
|
self.assertIn("zhouyi", catalog["sources"])
|
|
self.assertIn("neijing", catalog["sources"])
|
|
self.assertEqual(len(catalog["fortune"]["qi"]), 6)
|
|
self.assertEqual(len(catalog["fortune"]["personal_relations"]), 10)
|
|
|
|
def test_missing_knowledge_file_raises_chinese_structured_error(self):
|
|
clear_heaven_knowledge_cache()
|
|
missing = Path(tempfile.mkdtemp()) / "missing-heaven_knowledge.json"
|
|
with patch(
|
|
"backend.features.heaven.knowledge.KNOWLEDGE_FILE", missing
|
|
), patch(
|
|
"backend.features.heaven.knowledge.KNOWLEDGE_SEED_FILE",
|
|
missing.with_name("missing-seed.json"),
|
|
):
|
|
with self.assertRaises(HeavenKnowledgeError) as raised:
|
|
_knowledge_catalog()
|
|
self.assertEqual(raised.exception.error_code, "heaven_knowledge_missing")
|
|
self.assertIn("缺失", str(raised.exception))
|
|
|
|
def test_corrupt_knowledge_json_raises_chinese_structured_error(self):
|
|
clear_heaven_knowledge_cache()
|
|
with tempfile.TemporaryDirectory() as temp_dir:
|
|
broken = Path(temp_dir) / "heaven_knowledge.json"
|
|
broken.write_text("{not-json", encoding="utf-8")
|
|
with patch(
|
|
"backend.features.heaven.knowledge.KNOWLEDGE_FILE", broken
|
|
), patch(
|
|
"backend.features.heaven.knowledge.KNOWLEDGE_SEED_FILE",
|
|
Path(temp_dir) / "unused-seed.json",
|
|
):
|
|
with self.assertRaises(HeavenKnowledgeError) as raised:
|
|
_knowledge_catalog()
|
|
self.assertEqual(raised.exception.error_code, "heaven_knowledge_invalid")
|
|
self.assertIn("损坏", str(raised.exception))
|
|
|
|
def test_interpret_http_returns_structured_chinese_error_for_missing_file(self):
|
|
class FakeHandler(HeavenHttpMixin):
|
|
def __init__(self) -> None:
|
|
self.payload = None
|
|
self.status = None
|
|
self.application_service = type(
|
|
"Svc",
|
|
(),
|
|
{
|
|
"heaven_interpret": staticmethod(
|
|
lambda _body: (_ for _ in ()).throw(
|
|
HeavenKnowledgeError(
|
|
"问天知识文件缺失：未找到 heaven_knowledge.json。",
|
|
code="heaven_knowledge_missing",
|
|
)
|
|
)
|
|
)
|
|
},
|
|
)()
|
|
|
|
def read_json_body(self):
|
|
return {"mode": "trend", "trade_date": "2026-08-04"}
|
|
|
|
def send_json(self, payload, status=HTTPStatus.OK, headers=None):
|
|
self.payload = payload
|
|
self.status = status
|
|
|
|
handler = FakeHandler()
|
|
handler.heaven_interpret()
|
|
self.assertEqual(handler.status, HTTPStatus.BAD_REQUEST)
|
|
self.assertIn("缺失", handler.payload["error"])
|
|
self.assertEqual(handler.payload["code"], "heaven_knowledge_missing")
|
|
|
|
def test_interpret_http_returns_structured_chinese_error_for_corrupt_json(self):
|
|
class FakeHandler(HeavenHttpMixin):
|
|
def __init__(self) -> None:
|
|
self.payload = None
|
|
self.status = None
|
|
self.application_service = type(
|
|
"Svc",
|
|
(),
|
|
{
|
|
"heaven_interpret": staticmethod(
|
|
lambda _body: (_ for _ in ()).throw(
|
|
HeavenKnowledgeError(
|
|
"问天知识文件 JSON 损坏（heaven_knowledge.json），无法解析：第 1 行附近。",
|
|
code="heaven_knowledge_invalid",
|
|
)
|
|
)
|
|
)
|
|
},
|
|
)()
|
|
|
|
def read_json_body(self):
|
|
return {"mode": "trend", "trade_date": "2026-08-04"}
|
|
|
|
def send_json(self, payload, status=HTTPStatus.OK, headers=None):
|
|
self.payload = payload
|
|
self.status = status
|
|
|
|
handler = FakeHandler()
|
|
handler.heaven_interpret()
|
|
self.assertEqual(handler.status, HTTPStatus.BAD_REQUEST)
|
|
self.assertIn("损坏", handler.payload["error"])
|
|
self.assertEqual(handler.payload["code"], "heaven_knowledge_invalid")
|
|
|
|
def test_seed_fallback_when_data_file_missing(self):
|
|
clear_heaven_knowledge_cache()
|
|
with tempfile.TemporaryDirectory() as temp_dir:
|
|
seed = Path(temp_dir) / "seed.json"
|
|
seed.write_text(
|
|
json.dumps(
|
|
{
|
|
"version": "test-seed",
|
|
"sources": {"zhouyi": {"title": "周易"}},
|
|
"trend": {"method": "m", "rules": {"stable": "s", "single": "a", "multiple": "b"}},
|
|
"fortune": {},
|
|
"heart": {},
|
|
},
|
|
ensure_ascii=False,
|
|
),
|
|
encoding="utf-8",
|
|
)
|
|
missing_data = Path(temp_dir) / "data-heaven_knowledge.json"
|
|
with patch(
|
|
"backend.features.heaven.knowledge.KNOWLEDGE_FILE", missing_data
|
|
), patch(
|
|
"backend.features.heaven.knowledge.KNOWLEDGE_SEED_FILE", seed
|
|
):
|
|
catalog = _knowledge_catalog()
|
|
self.assertEqual(catalog["version"], "test-seed")
|
|
|
|
def test_fortune_context_excludes_weighted_summary_and_adds_bounded_industry_symbols(self):
|
|
field = build_five_phase_field("2026-08-04")
|
|
prepared = prepare_heaven_context(
|
|
"fortune",
|
|
{
|
|
"calendar_date": "20260804",
|
|
"five_phase_field": field,
|
|
"personal_profile": {},
|
|
},
|
|
)
|
|
|
|
serialized = str(prepared["calculation"])
|
|
self.assertNotIn("balance", serialized)
|
|
self.assertNotIn("weights", serialized)
|
|
self.assertNotIn("human_field", serialized)
|
|
self.assertNotIn("sector_catalog", serialized)
|
|
industry_symbols = prepared["calculation"]["industry_symbols"]
|
|
self.assertTrue(industry_symbols)
|
|
self.assertTrue(all(item["basis"] and item["industries"] for item in industry_symbols))
|
|
self.assertIn(
|
|
"fortune-industry-boundary",
|
|
{record["id"] for record in prepared["knowledge"]["records"]},
|
|
)
|
|
self.assertEqual(prepared["knowledge"]["retrieval"], "deterministic-keyed")
|
|
self.assertTrue(prepared["knowledge"]["records"])
|
|
|
|
def test_fortune_personal_context_only_exposes_deterministic_stem_relations(self):
|
|
field = build_five_phase_field("2026-08-04")
|
|
prepared = prepare_heaven_context(
|
|
"fortune",
|
|
{
|
|
"calendar_date": "20260804",
|
|
"five_phase_field": field,
|
|
"personal_profile": {
|
|
"day_master": {"stem": "丁", "element": "火", "strength": "偏弱"},
|
|
"current": {
|
|
"pillars": {"year": "丙午", "month": "乙未", "day": "庚戌"},
|
|
"ten_gods": {
|
|
"year": {"pillar": "丙午", "stem": "劫财", "branches": ["比肩"]},
|
|
"month": {"pillar": "乙未", "stem": "偏印", "branches": ["食神"]},
|
|
"day": {"pillar": "庚戌", "stem": "正财", "branches": ["伤官"]},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
)
|
|
|
|
personal = prepared["calculation"]["personal"]
|
|
self.assertEqual(personal["natal_day_master"], {"stem": "丁", "element": "火"})
|
|
self.assertEqual(
|
|
personal["today_relative_to_natal_day_master"]["stem_relations"],
|
|
{"year": "劫财", "month": "偏印", "day": "正财"},
|
|
)
|
|
self.assertEqual(
|
|
prepared["calculation"]["day_trigger"]["summary"],
|
|
next(
|
|
item["summary"]
|
|
for item in field["framework"]["layers"]
|
|
if item["id"] == "day"
|
|
),
|
|
)
|
|
record_ids = {record["id"] for record in prepared["knowledge"]["records"]}
|
|
self.assertIn("fortune-personal-劫财", record_ids)
|
|
self.assertIn("fortune-personal-偏印", record_ids)
|
|
self.assertIn("fortune-personal-正财", record_ids)
|
|
serialized = str(personal)
|
|
self.assertNotIn("strength", serialized)
|
|
self.assertNotIn("branches", serialized)
|
|
|
|
def test_trend_retrieves_only_actual_moving_lines(self):
|
|
hexagram = hexagram_from_lines([6, 7, 8, 9, 7, 8])
|
|
prepared = prepare_heaven_context(
|
|
"trend",
|
|
{
|
|
"data_trade_date": "20260804",
|
|
"selected_focus": {
|
|
"sector": "银行",
|
|
"stock": {"code": "000001", "name": "平安银行", "change": 3.2},
|
|
},
|
|
"hexagram": hexagram,
|
|
"movement": {},
|
|
},
|
|
)
|
|
|
|
self.assertNotIn("selected_focus", prepared["calculation"])
|
|
line_records = [
|
|
record for record in prepared["knowledge"]["records"]
|
|
if str(record.get("id") or "").startswith("zhouyi-line-")
|
|
]
|
|
self.assertEqual([record["position"] for record in line_records], [1, 4])
|
|
|
|
def test_heart_context_contains_question_chart_and_sources(self):
|
|
values = [6, 7, 8, 9, 7, 8]
|
|
prepared = prepare_heaven_context(
|
|
"heart",
|
|
{
|
|
"question": "这笔交易最需要防范什么？",
|
|
"question_preset": "trade",
|
|
"hexagram": hexagram_from_lines(values),
|
|
"six_yao": build_six_yao_chart(values, "2026-08-04T10:30:00+08:00"),
|
|
"ritual": {},
|
|
},
|
|
)
|
|
|
|
self.assertEqual(prepared["calculation"]["question_preset"], "trade")
|
|
self.assertEqual(prepared["calculation"]["six_yao"]["method"], "京房纳甲·八宫世应")
|
|
self.assertEqual(
|
|
{source["id"] for source in prepared["knowledge"]["sources"]},
|
|
{"zhouyi", "jingfang", "huozhulin", "zengshan"},
|
|
)
|
|
record_ids = {record["id"] for record in prepared["knowledge"]["records"]}
|
|
self.assertIn("heart-self-response", record_ids)
|
|
self.assertIn("heart-calendar", record_ids)
|
|
self.assertIn("heart-movement", record_ids)
|
|
self.assertIn("heart-relative-妻财", record_ids)
|
|
self.assertIn("heart-timing-boundary", record_ids)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|