foxclaw 0.1.2 → 0.1.3

package/python/tests/test_domain_evals.py

@@ -26,17 +26,11 @@ def test_domain_evals():
 
 
     def _policy():
-        # 用产品**默认**规则集评测 —— 评的就是"开箱默认够不够好"
-        # data_path 必须独立:默认落在 policy 同目录,而 mktemp 的父目录是**系统 Temp**,
-        # 不显式隔离就会和别的测试共用一个 finance_data.json(顺序一变就互相污染)。
         return FinanceRuntime(policy_path=tempfile.mktemp(suffix=".yaml"),
                               data_path=tempfile.mktemp(suffix=".json")).policy
 
 
-    # ── 标注案例集:(说明, 金额, 类别, 余额, 该不该被拦) ───────────────────
-    # ↓↓↓ 往这里加你真实遇到的情形 ↓↓↓
     CASES = [
-        # 日常小额:不该被拦(这是误报的主要来源——原 200 阈值下它们全会被拦)
         ("买咖啡",        -35,   "food",     8000, False),
         ("午饭",          -60,   "food",     8000, False),
         ("打车",          -80,   "transport", 8000, False),
@@ -44,13 +38,10 @@ def test_domain_evals():
         ("买书",          -220,  "book",     8000, False),
         ("聚餐 AA",       -320,  "food",     8000, False),
         ("买鞋",          -450,  "shopping", 8000, False),
-        # 大额:该被拦(>500)
         ("买手机",        -4500, "digital",  8000, True),
         ("交房租",        -3000, "housing",  8000, True),
         ("买笔记本",      -8000, "digital",  20000, True),
-        # 余额保护:低余额该被拦(即便金额不大)
         ("低余额时消费",  -100,  "food",     300,  True),
-        # 收入:不该被拦
         ("发工资",        +15000, "salary",  8000, False),
     ]
 
@@ -65,7 +56,6 @@ def test_domain_evals():
             if expect_flag and not flagged:
                 misses.append((name, amount, rv.decision))
             elif not expect_flag and flagged:
-                # 归因:证据里 raw 非空的就是**触发裁决的规则**(informational 证据 raw=None)
                 rules = [e.factor for e in rv.evidence if e.raw is not None]
                 false_pos.append((name, amount, rv.decision, rules))
         return misses, false_pos
@@ -91,18 +81,12 @@ def test_domain_evals():
         for nm, amt, d, rules in fps:
             print(f"      {nm}({amt}) → {d}  ← 触发规则: {rules or '(未归因)'}")
 
-    # [1] 漏报:该抓的必须都抓住(>500 / 低余额)
     assert not misses, f"存在漏报(该抓没抓): {misses}"
     print("\n[1] 无漏报(>500 与低余额保护都抓住了)OK")
 
-    # [2] 误报:日常消费不该被拦。阈值 500 后,220/320/450 都该放行
-    #     (原默认 200 时它们全是误报 → 用户会被烦到关掉守门人)
     assert fp_rate <= 0.15, f"误报率过高({fp_rate:.0%}),用户会关掉守门人: {fps}"
     print(f"[2] 误报率 {fp_rate:.0%} ≤ 15%(沿用 evals_smoke 同款红线)OK")
 
-    # [3] 误报**可归因**:这是"确定误报原因加以修改"的前提 ——
-    #     若无法定位是哪条规则拦的,就无从改起。这里验证归因机制本身有效:
-    #     故意把阈值压到 100 制造误报,必须能指出是 large_purchase_check 干的。
     pol_bad = _policy()
     for r in pol_bad.rules:
         if r.id == "large_purchase_check":
@@ -113,10 +97,6 @@ def test_domain_evals():
         f"误报必须能归因到具体规则,否则无从改起: {fps2}"
     print(f"[3] 误报可归因(阈值压到100 → {len(fps2)} 条误报,全部指向 large_purchase_check)OK")
 
-    # [4] 规则实例隔离(本框架第一次跑就抓到的真 bug):
-    #     原 `self.rules = list(DEFAULT_RULES)` 只复制列表、不复制规则对象 → 所有 runtime
-    #     共享同一批**可变**规则,[3] 里把 pol_bad 阈值压到 100 竟连带把 pol 和模块级
-    #     DEFAULT_RULES 一起改了(要重启才恢复)。现已 deepcopy。
     from foxclaw.finance.policy import DEFAULT_RULES
     p1, p2 = _policy(), _policy()
     r1 = [r for r in p1.rules if r.id == "large_purchase_check"][0]
@@ -128,13 +108,9 @@ def test_domain_evals():
     assert rd.threshold != 99.0, "改 runtime 的阈值污染了模块级 DEFAULT_RULES"
     print("[4] 规则实例隔离(改一处不污染其它 runtime / 模块级默认)OK")
 
-    # [5] 阈值是可调项(改 yaml 即可,不用动代码);默认 500
     assert rd.threshold == 500.0, f"默认单笔阈值应为 500,实际 {rd.threshold}"
     print("[5] 阈值为可调项(finance_policy.yaml 可改,默认 500)OK")
 
-    # ══════════════════════════════════════════════════════════
-    # 用户点名要的 4 条规则(2026-07-16)。前两条的检测早就实现,只是从不产生裁决。
-    # ══════════════════════════════════════════════════════════
     from datetime import datetime, timedelta
     from foxclaw.finance.models import Budget
     from foxclaw.finance.reasoning import FinanceReasoning as FR
@@ -148,7 +124,6 @@ def test_domain_evals():
         """跑状态裁决,返回触发的 rule_id 集合。"""
         return {v.rule_id for v in _policy().evaluate_state(**kw)}
 
-    # [6] 同一商家高频扣款 → 必须裁决(此前 detect_duplicate_charges 算了却不吭声)
     dups = FR.detect_duplicate_charges([
         _txn(-99, "SomeApp", days_ago=1), _txn(-99, "SomeApp", days_ago=1),
     ])
@@ -157,7 +132,6 @@ def test_domain_evals():
     assert "duplicate_charge_alert" not in _fire(duplicates=[]), "无重复扣款不该报警"
     print(f"[6] 同一商家高频扣款 → 触发裁决({dups[0]['reason']})OK")
 
-    # [7] 跨月预算超支**趋势**:还没超、但按速度月底会超 → 提醒;已超/不会超 → 不重复报
     f_trend = {"category": "food", "spent_so_far": 800, "monthly_limit": 1000,
                "projected_month_end": 1600, "projected_overage": 600, "will_overspend": True}
     f_safe = {"category": "food", "spent_so_far": 200, "monthly_limit": 1000,
@@ -166,42 +140,30 @@ def test_domain_evals():
     assert "overspend_trend_alert" not in _fire(forecasts=[f_safe]), "不会超不该提醒"
     print("[7] 跨月超支趋势(还没超但会超 → 提醒;不会超 → 不吵)OK")
 
-    # [8] 年费自动续订**前**提醒:从历史间隔推断周期,只在临近时提醒
-    # 上次扣款 362 天前、上上次 727 天前 → 间隔 365(年订)→ 下次在 3 天后
     annual = [_txn(-598, "某会员", days_ago=362 + 365, tags=["recurring"]),
               _txn(-598, "某会员", days_ago=362, tags=["recurring"])]
     ren = FR.detect_upcoming_renewals(annual, horizon_days=7)
     assert ren and ren[0]["cadence"] == "年订" and ren[0]["days_until"] <= 7, ren
     assert "renewal_reminder" in _fire(renewals=ren)
-    # 间隔紊乱 → 不预测(宁可不提醒,也不为猜错的日期制造误报)
     messy = [_txn(-50, "乱扣", days_ago=200, tags=["recurring"]),
              _txn(-50, "乱扣", days_ago=3, tags=["recurring"])]
     assert FR.detect_upcoming_renewals(messy) == [], "间隔紊乱不该预测续订日"
-    # 只扣过一次 → 无法判周期
     assert FR.detect_upcoming_renewals([_txn(-50, "新订阅", days_ago=1, tags=["recurring"])]) == []
     print(f"[8] 年费续订前提醒({ren[0]['entity']} {ren[0]['days_until']} 天后;紊乱/单次不预测)OK")
 
-    # [9] 退款未到账:**需用户标记** refund_expected;已到账则不报
     overdue = FR.detect_pending_refunds([_txn(-300, "某电商", days_ago=20, tags=["refund_expected"])])
     assert overdue and overdue[0]["days_waiting"] >= 14, overdue
     assert "refund_overdue_alert" in _fire(pending_refunds=overdue)
-    # 等额退款已入账 → 不报
     done = FR.detect_pending_refunds([_txn(-300, "某电商", days_ago=20, tags=["refund_expected"]),
                                       _txn(+300, "某电商", days_ago=2)])
     assert done == [], "退款已到账不该再报"
-    # 【关键】未标记的普通消费**绝不**报警 —— 否则每笔消费都报,是灾难性误报
     assert FR.detect_pending_refunds([_txn(-300, "某电商", days_ago=20)]) == [], \
         "未标记的普通消费不得触发退款报警(灾难性误报)"
     print("[9] 退款未到账(需标记;已到账不报;未标记的普通消费不误报)OK")
 
-    # [10] 新规则不得把日常消费变成噪音 —— 无信号时一条都不该响
     assert _fire() == set(), f"无信号时不该有任何裁决: {_fire()}"
     print("[10] 无信号 → 零裁决(新规则不制造背景噪音)OK")
 
-    # ══════════════════════════════════════════════════════════
-    # 阈值自校准:阈值不再是我拍的,而是从用户自己的消费分布长出来的。
-    # 这一段验的是"没有真实数据时也不会瞎猜、有数据时自动贴合、且永不踩人的决定"。
-    # ══════════════════════════════════════════════════════════
     def _stream(each, n=60, entity="日常"):
         """造 n 笔支出,跨**正好** n-1 天(满足校准的样本门槛)。
 
@@ -213,49 +175,41 @@ def test_domain_evals():
                             timestamp=(base - timedelta(days=i)).isoformat())
                 for i in range(n)]
 
-    # [11] 样本不足 → 不校准(继续用出厂默认)
     assert FR.calibrate_thresholds([]) == {}, "空数据不该校准"
     assert FR.calibrate_thresholds(_stream(300, n=5)) == {}, "5 笔就校准 = 用垃圾数据冒充个性化"
     assert FR.calibrate_thresholds(_stream(300, n=30)) == {}, \
         "笔数够但跨度只有 29 天(差一天到门槛)→ 日均不可信,不该校准"
     print("[11] 样本不足(空/笔数少/跨度短)→ 不校准,沿用出厂默认 OK")
 
-    # 有方差的真实感消费流:大量小额 + 可选一笔大额尖峰。均匀数据测不出"抗离群"。
-    _PAT = [30, 45, 60, 80, 120, 55, 90, 40, 150, 70]   # median≈65 的日常波动
+    _PAT = [30, 45, 60, 80, 120, 55, 90, 40, 150, 70]
     def _real(scale=1.0, n=80, spike=None):
         base = datetime.now()
         txns = [Transaction(amount=-_PAT[i % len(_PAT)] * scale, category="misc",
                             entity="日常", account="default",
                             timestamp=(base - timedelta(days=i)).isoformat())
                 for i in range(n)]
-        if spike:      # 一笔大额(买电脑/交房租),落在窗口内,不改变跨度
+        if spike:
             txns.append(Transaction(amount=-spike, category="misc", entity="大额",
                         account="default", timestamp=(base - timedelta(days=1)).isoformat()))
         return txns
 
-    # [12] 校准随消费水平伸缩 —— 这正是固定 500 做不到的事
-    rich = FR.calibrate_thresholds(_real(scale=2.0))     # 消费翻倍的人
-    poor = FR.calibrate_thresholds(_real(scale=0.5))     # 消费减半的人
+    rich = FR.calibrate_thresholds(_real(scale=2.0))
+    poor = FR.calibrate_thresholds(_real(scale=0.5))
     lr, lp = rich["large_purchase_check"][0], poor["large_purchase_check"][0]
     assert lr > lp, f"高消费者的大额门槛应更高: 富{lr} vs 穷{lp}"
     assert rich["low_balance_protection"][0] > poor["low_balance_protection"][0]
     print(f"[12] 阈值随消费水平伸缩(富→大额{lr:.0f} / 穷→大额{lp:.0f};固定 500 对两者都错)OK")
 
-    # [12b]【B 修复的直接证据】大额离群**不**抬高门槛 ——
-    #      这是把均值锚换成 median+MAD 的全部理由:一笔 8000 的电脑不该让此后的
-    #      大额检测变迟钝。均值锚在这里会让门槛暴涨(月均×10% 从 ~200 跳到 ~500)。
     base_large = FR.calibrate_thresholds(_real())["large_purchase_check"][0]
     spiked_large = FR.calibrate_thresholds(_real(spike=8000))["large_purchase_check"][0]
     assert abs(spiked_large - base_large) <= 100, \
         f"一笔大额离群把门槛从 {base_large} 顶到 {spiked_large}(均值锚的老毛病,MAD 应免疫)"
     print(f"[12b] 抗离群:加一笔 8000 大额,门槛 {base_large:.0f}→{spiked_large:.0f} 几乎不动 OK")
 
-    # [13] 时间类阈值**不**校准(它们是语义常数,不是从消费分布学得出来的)
     assert set(rich) == {"large_purchase_check", "low_balance_protection"}, \
         f"只有金额类阈值有分布依据;时间类不得假装校准: {set(rich)}"
     print("[13] 时间类阈值(48h/7d/14d)不参与校准(无分布依据,不给猜测套数学外衣)OK")
 
-    # [14] 落盘:builtin 且停在出厂值 → 校准生效,且留下可解释的依据
     cal = FR.calibrate_thresholds(_real())
     cal_large = cal["large_purchase_check"][0]
     p14 = _policy()
@@ -263,29 +217,25 @@ def test_domain_evals():
     r14 = [r for r in p14.rules if r.id == "large_purchase_check"][0]
     assert r14.threshold == cal_large and r14.source == "learned" and r14.calibrated_value == cal_large
     assert "median" in (r14.calibrated_from or ""), "阈值必须可解释,用户才敢信"
-    # large 一定变了;low_balance 恰好也算出 500(=出厂)时不进 ch —— 那正是"值没变不写盘"
     assert "large_purchase_check" in {c["rule_id"] for c in ch}, ch
-    # 幂等:同样的建议再来一次 → 无改动、不重复写盘(analyze 每次都会调到)
     assert p14.apply_calibration(cal) == [], "值没变还写盘 = 每次 analyze 都刷一遍 yaml"
     print(f"[14] 校准落盘 + 可解释({r14.calibrated_from})+ 幂等 OK")
 
-    # [15]【最重要】校准**绝不踩人的决定** —— 否则用户会发现自己改的设置莫名变回去,
-    #     从此不信任整个系统。三种"人碰过"的形态都必须让校准收手:
-    p_user = _policy()                       # (a) source=user 显式锁定
+    p_user = _policy()
     for r in p_user.rules:
         if r.id == "large_purchase_check": r.source = "user"
     p_user.apply_calibration(rich)
     assert [r for r in p_user.rules if r.id == "large_purchase_check"][0].threshold == 500.0, \
         "source=user 是显式锁定,校准不得覆盖"
 
-    p_edit = _policy()                       # (b) builtin 但用户改过 yaml 阈值
+    p_edit = _policy()
     for r in p_edit.rules:
         if r.id == "large_purchase_check": r.threshold = 1234.0
     p_edit.apply_calibration(rich)
     assert [r for r in p_edit.rules if r.id == "large_purchase_check"][0].threshold == 1234.0, \
         "阈值偏离出厂值 = 有人有意改过,校准必须收手"
 
-    p_re = _policy()                         # (c) 我校准过,之后用户又手改
+    p_re = _policy()
     p_re.apply_calibration(rich)
     for r in p_re.rules:
         if r.id == "large_purchase_check": r.threshold = 777.0
@@ -294,13 +244,11 @@ def test_domain_evals():
         "校准值被人改过 = 人的决定,不得再次覆盖"
     print("[15] 校准不踩人的决定(user 锁定 / 手改出厂值 / 手改校准值 → 三种都收手)OK")
 
-    # [16] 校准不污染模块级出厂默认(自校准直接写 rule.threshold,最容易复发 [4] 那个 bug)
     assert rd.threshold == 500.0, f"校准污染了模块级 DEFAULT_RULES(阈值变成 {rd.threshold})"
     from foxclaw.finance.policy import FACTORY_THRESHOLDS
     assert FACTORY_THRESHOLDS["large_purchase_check"] == 500.0, "出厂快照被污染 → 判定基准失效"
     print("[16] 校准不污染模块级出厂默认/出厂快照 OK")
 
-    # [17] 校准必须**对用户可见**(阈值自己变了还不吭声 = 偷偷改用户的设置)
     rt = FinanceRuntime(policy_path=tempfile.mktemp(suffix=".yaml"),
                         data_path=tempfile.mktemp(suffix=".json"))
     for t in _real():
@@ -313,60 +261,45 @@ def test_domain_evals():
     assert rt.analyze()["threshold_calibration"] == [], "已校准后重复 analyze 不该再报变更"
     print(f"[17] 阈值变更对用户可见(analyze 报出 500→{cal_large:.0f}),且不重复打扰 OK")
 
-    # ══════════════════════════════════════════════════════════
-    # 深审补丁(2026-07-16):A 月初误报闸 / C 续订阈值真正生效。
-    # 这两条是"审核后面做的"翻出来的真问题——不是新功能,是把已埋的雷拆掉。
-    # ══════════════════════════════════════════════════════════
 
-    # [18]【A】月初超支外推不可信 → 不报。overspend_forecast 用 spent/day,day=1 时
-    #     一笔正常消费被 ×30 放大成"月底将超支"。前 7 天标 reliable=False,裁决层闭嘴。
     from foxclaw.finance.models import Transaction as _T
-    def _jul(day, amt):    # 落在 2026-07 的一笔支出
+    def _jul(day, amt):
         return _T(amount=-amt, category="food", entity="午饭", account="default",
                   timestamp=f"2026-07-{day:02d}T12:00:00")
     food_budget = Budget(category="food", monthly_limit=1000)
-    # 月初第 2 天,只花了 100:daily_rate=50 → 外推 1500 > 1000,老逻辑会喊"将超支"
     early = FR.overspend_forecast([_jul(1, 100)], food_budget,
                                   now=datetime(2026, 7, 2))
     assert early["will_overspend"] and not early["reliable"], early
     assert "overspend_trend_alert" not in _fire(forecasts=[early]), "月初噪音不得报警(A 修复)"
-    # 到第 20 天,同样趋势才可信
     late = FR.overspend_forecast([_jul(d, 100) for d in range(1, 16)], food_budget,
                                  now=datetime(2026, 7, 20))
     assert late["reliable"], late
     print("[18]【A】月初(day<7)超支外推 reliable=False → 不误报;7 天后才裁决 OK")
 
-    # [19]【C】续订提醒阈值真正生效。检测层窗口放宽到 35 天,"提前几天提醒"由规则
-    #     threshold 精确控制。旧代码里 detect 硬封 7 天 → 用户改阈值到 25 也没反应。
     monthly_sub = [_txn(-30, "月刊会员", days_ago=10 + 30, tags=["recurring"]),
                    _txn(-30, "月刊会员", days_ago=10, tags=["recurring"])]
-    ren = FR.detect_upcoming_renewals(monthly_sub)        # 下次在约 20 天后
+    ren = FR.detect_upcoming_renewals(monthly_sub)
     assert ren and ren[0]["cadence"] == "月订" and 18 <= ren[0]["days_until"] <= 22, ren
     assert "renewal_reminder" not in _fire(renewals=ren), "默认提前 7 天 → 20 天后的续订还太远,不报"
-    p19 = _policy()                                        # 用户想提前 25 天提醒
+    p19 = _policy()
     for r in p19.rules:
         if r.id == "renewal_reminder": r.threshold = 25.0
     v19 = {x.rule_id for x in p19.evaluate_state(renewals=ren)}
     assert "renewal_reminder" in v19, "阈值改到 25 应生效(旧代码被检测层硬封 7 天 → 静默失效)"
     print("[19]【C】续订阈值真正生效(默认7天不报20天后的;改25天则报)OK")
 
-    # [20]【D】退款消耗式匹配:两笔同额 refund_expected、只收到一笔退款 → 第二笔仍报。
-    #     旧的 any() 匹配让两笔支出都认领同一笔入账 → 第二笔漏报(以为退了,其实没到)。
     two_expected = [
         _txn(-300, "某电商", days_ago=40, tags=["refund_expected"]),
         _txn(-300, "某电商", days_ago=30, tags=["refund_expected"]),
-        _txn(+300, "某电商", days_ago=5),          # 只到账一笔退款
+        _txn(+300, "某电商", days_ago=5),
     ]
     pend = FR.detect_pending_refunds(two_expected)
     assert len(pend) == 1, f"两笔标记只退一笔 → 应恰好报 1 笔未到账,实得 {len(pend)}: {pend}"
-    # 两笔都到账 → 零报警(两笔入账各抵一笔)
     both_back = two_expected[:2] + [_txn(+300, "某电商", days_ago=5),
                                     _txn(+300, "某电商", days_ago=4)]
     assert FR.detect_pending_refunds(both_back) == [], "两笔退款都到账不该报"
     print("[20]【D】退款消耗式匹配(两笔同额退一笔→报第二笔;都退→不报)OK")
 
-    # [21]【E】并发校准无竞态、yaml 不写坏。finance_runtime 是单例,analyze() 会被请求
-    #     线程并发调 → apply_calibration 并发改规则+写盘。写锁 + 原子 rename 保证安全。
     import threading as _th
     from foxclaw.finance.policy import FinancePolicyEngine
     rt21 = FinanceRuntime(policy_path=tempfile.mktemp(suffix=".yaml"),
@@ -387,10 +320,8 @@ def test_domain_evals():
     for t in _ts: t.start()
     for t in _ts: t.join()
     assert not errs21, f"并发 analyze/校准抛异常: {errs21[:2]}"
-    # 恰好一个线程做了首次校准(拿到非空 changed),其余读到已校准状态(空)
     assert sum(1 for s in seen_to if s) == 1, \
         f"首次校准应只发生一次(其余幂等空),实得 {sum(1 for s in seen_to if s)} 次非空"
-    # yaml 落盘完好可重载,且阈值 = 校准值(没被并发写坏)
     reload21 = FinancePolicyEngine(str(rt21.policy.policy_path))
     r21 = [r for r in reload21.rules if r.id == "large_purchase_check"][0]
     assert r21.threshold == cal_large and r21.source == "learned", \

package/python/tests/test_domain_import.py

@@ -14,7 +14,6 @@ def test_domain_import():
 
     print("=" * 60); print("OS 领域导入(csv/xlsx/json)验证"); print("=" * 60)
 
-    # ── Part A:解析器单元 ─────────────────────────────────────
     from foxclaw.api import _parse_import_rows
 
     csv_bytes = b"amount,category,entity\n-50,food,cafe\n-20,transport,metro\n"
@@ -35,12 +34,10 @@ def test_domain_import():
         pass
     print("[1] 解析器 csv/json/xlsx + 未支持格式报错 OK")
 
-    # ── Part B:三领域文件导入端点(TestClient)────────────────
     from fastapi.testclient import TestClient
     from foxclaw.api import app
 
     with TestClient(app) as c:
-        # [2] finance:csv / xlsx / json 三格式各导入成功
         r = c.post("/api/finance/import/file", files={"file": ("f.csv", csv_bytes, "text/csv")})
         assert r.status_code == 200 and r.json()["imported"] == 2, r.text
         r = c.post("/api/finance/import/file",
@@ -51,20 +48,17 @@ def test_domain_import():
         assert r.status_code == 200 and r.json()["imported"] == 1, r.text
         print("[2] finance 导入 csv/xlsx/json(2+2+1)OK")
 
-        # [3] learning:csv(content,topic,tags)
         lc = "content,topic,tags\n间隔重复提升记忆,学习方法,记忆|复习\n费曼技巧,学习方法,输出\n".encode()
         r = c.post("/api/learning/import/file", files={"file": ("l.csv", lc, "text/csv")})
         assert r.status_code == 200 and r.json()["imported"] == 2, r.text
         print("[3] learning 导入 csv(含 tags 管道分隔)OK")
 
-        # [4] itinerary:json(name/city/duration)
         ij = json.dumps([{"name": "故宫", "city": "北京", "duration_min": 120},
                          {"name": "颐和园", "city": "北京", "duration_min": 90}]).encode()
         r = c.post("/api/itinerary/import/file", files={"file": ("i.json", ij, "application/json")})
         assert r.status_code == 200 and r.json()["imported"] == 2, r.text
         print("[4] itinerary 导入 json OK")
 
-        # [5] 未支持格式 → 400;空文件 → imported 0
         r = c.post("/api/finance/import/file", files={"file": ("x.pptx", b"x", "application/octet-stream")})
         assert r.status_code == 400, r.status_code
         r = c.post("/api/finance/import/file", files={"file": ("e.csv", b"amount,category\n", "text/csv")})

package/python/tests/test_domain_reasoners.py

@@ -27,7 +27,6 @@ class _MockLLM:
         return self.resp
 
 
-# ─────────────────────────── 行程冲突推理 ───────────────────────────
 def _wp(name, start=None, dur=0, lng=None, lat=None):
     from foxclaw.itinerary.models import Waypoint
     return Waypoint(name=name, start_time=start, duration_min=dur, lng=lng, lat=lat)
@@ -36,44 +35,37 @@ def _wp(name, start=None, dur=0, lng=None, lat=None):
 def test_itinerary_reasoner():
     print("\n【1】行程冲突推理:规则权威 + 可选 LLM 只升级")
     from foxclaw.itinerary.reasoner import ItineraryConflictReasoner
-    # 时间重叠 → confirm,规则权威;即便 LLM 说 OK 也不被推翻,且不问 LLM
     conflict = [_wp("会议A", "2026-07-08T10:00:00", 120), _wp("会议B", "2026-07-08T11:00:00", 60)]
     llm = _MockLLM("OK")
     rv = ItineraryConflictReasoner(llm=llm, llm_enabled=True).reason((conflict, "driving"))
     assert rv.decision == "confirm" and rv.source == "rules" and llm.calls == 0
     assert any(e.factor == "time_conflict" for e in rv.evidence)
 
-    # 无冲突、不紧凑(空档 60 分 >> 通勤 ~19 分)→ approve,LLM 不调
     loose = [_wp("A", "2026-07-08T10:00:00", 60, 116.40, 39.90),
              _wp("B", "2026-07-08T12:00:00", 60, 116.50, 39.90)]
     llm = _MockLLM("CONFIRM")
     rv = ItineraryConflictReasoner(llm=llm, llm_enabled=True).reason((loose, "driving"))
     assert rv.decision == "approve" and rv.source == "rules" and llm.calls == 0
 
-    # 紧凑(空档 25 分,通勤 ~19 分,可达但赶)+ LLM 说 CONFIRM → confirm,source=llm
     tight = [_wp("A", "2026-07-08T10:00:00", 60, 116.40, 39.90),
              _wp("B", "2026-07-08T11:25:00", 60, 116.50, 39.90)]
     llm = _MockLLM("CONFIRM")
     rv = ItineraryConflictReasoner(llm=llm, llm_enabled=True).reason((tight, "driving"))
     assert rv.decision == "confirm" and rv.source == "llm" and llm.calls == 1
 
-    # 紧凑 + LLM 说 OK → 维持规则 approve
     llm = _MockLLM("OK")
     rv = ItineraryConflictReasoner(llm=llm, llm_enabled=True).reason((tight, "driving"))
     assert rv.decision == "approve" and rv.source == "rules"
 
-    # 紧凑 + LLM 出错 → fail-safe 维持规则 approve(顾问域不因抖动制造确认)
     llm = _MockLLM(raises=True)
     rv = ItineraryConflictReasoner(llm=llm, llm_enabled=True).reason((tight, "driving"))
     assert rv.decision == "approve" and rv.source == "rules"
 
-    # 默认关 → 紧凑也只走规则(behavior-preserving)
     rv = ItineraryConflictReasoner().reason((tight, "driving"))
     assert rv.decision == "approve" and rv.source == "rules"
     print("  ✓ 冲突→confirm(规则,不问LLM);紧凑+LLM升级→confirm(llm);OK/出错/默认关→approve(规则)")
 
 
-# ─────────────────────────── 学习复习推理 ───────────────────────────
 def _rs(item_id, rep, ease, due_days):
     from datetime import datetime, timedelta
     from foxclaw.learning.models import ReviewState
@@ -84,32 +76,27 @@ def _rs(item_id, rep, ease, due_days):
 def test_learning_reasoner():
     print("\n【2】学习复习推理:规则权威 + 可选 LLM 只升级")
     from foxclaw.learning.reasoner import LearningReviewReasoner
-    # 高遗忘风险(掌握度 0、已到期)→ confirm,规则权威,不问 LLM
     risky = [_rs("weak", 0, 1.3, 0)]
     llm = _MockLLM("OK")
     rv = LearningReviewReasoner(llm=llm, llm_enabled=True).reason(risky)
     assert rv.decision == "confirm" and rv.source == "rules" and llm.calls == 0
     assert any(e.factor == "forgetting_risk" for e in rv.evidence)
 
-    # 健康(高掌握、远期到期)→ approve,LLM 不调
     healthy = [_rs("strong", 8, 2.5, 30)]
     llm = _MockLLM("CONFIRM")
     rv = LearningReviewReasoner(llm=llm, llm_enabled=True).reason(healthy)
     assert rv.decision == "approve" and rv.source == "rules" and llm.calls == 0
 
-    # 负荷偏重但无高风险(150 项高掌握、近期到期,日均≈21≥20)+ LLM CONFIRM → confirm,source=llm
     heavy = [_rs(f"h{i}", 8, 2.5, 3) for i in range(150)]
     llm = _MockLLM("CONFIRM")
     rv = LearningReviewReasoner(llm=llm, llm_enabled=True).reason(heavy)
     assert rv.decision == "confirm" and rv.source == "llm" and llm.calls == 1
 
-    # 负荷重 + LLM OK → approve;+ LLM 出错 → fail-safe approve
     rv = LearningReviewReasoner(llm=_MockLLM("OK"), llm_enabled=True).reason(heavy)
     assert rv.decision == "approve" and rv.source == "rules"
     rv = LearningReviewReasoner(llm=_MockLLM(raises=True), llm_enabled=True).reason(heavy)
     assert rv.decision == "approve" and rv.source == "rules"
 
-    # 默认关 + stub → 只走规则
     rv = LearningReviewReasoner().reason(heavy)
     assert rv.decision == "approve" and rv.source == "rules"
     stub = _MockLLM("CONFIRM"); stub.is_stub = True
@@ -122,7 +109,6 @@ def test_llm_cannot_hide_hard_problems():
     print("\n【3】核心不变量:LLM 永远无法隐藏规则已检出的硬问题")
     from foxclaw.itinerary.reasoner import ItineraryConflictReasoner
     from foxclaw.learning.reasoner import LearningReviewReasoner
-    # 即使 LLM 疯狂回 "OK/APPROVE/一切正常",冲突/风险仍被规则裁为 confirm
     for bad in ["OK", "APPROVE", "一切正常没问题", ""]:
         conflict = [_wp("A", "2026-07-08T10:00:00", 120), _wp("B", "2026-07-08T11:00:00", 60)]
         rv = ItineraryConflictReasoner(llm=_MockLLM(bad), llm_enabled=True).reason((conflict, "driving"))

package/python/tests/test_e2e.py

@@ -24,7 +24,6 @@ async def main():
     print("FOXCLAW · 端到端认知运行时验证")
     print("="*64)
 
-    # shadow_rounds 设小,快速触发校准。数据用临时目录:跑完即弃,不污染仓库根。
     _data = tempfile.mkdtemp(prefix="foxclaw_e2e_")
     os_ = Foxclaw(data_dir=_data, shadow_rounds=6)
 
@@ -64,13 +63,6 @@ async def main():
     print(f"  WARN 阈值:  {th['warn']:.4f}")
     print(f"  BLOCK 阈值: {th['block']:.4f}")
     print(f"  Shadow 模式: {th['shadow_mode']}")
-    # 这是本项目"阈值自适应而非拍脑袋"的核心主张:校准前后 BLOCK 阈值必须发生变化。
-    # 若两者相同,说明阈值其实来自硬编码默认值,校准没起作用 —— 这正是需要红的场景。
-    #
-    # 【B 类修复】按嵌入模式分述:降级时(hash)语义维度已停用,正常(on-goal)任务
-    # 的 Δ 恒为 0 → 校准**确实执行了**但无可学信号(实测 shadow 样本 15 条全为
-    # 0.000),阈值保持默认。这不是"阈值写死",而是"没有信号"—— 两者必须区分,
-    # 否则本断言在降级下恒红,会把「降级导致无可学」误读成「校准机制坏了」。
     if getattr(os_.finance.harness, "semantic_degraded", False):
         print("  [降级模式] 语义维度停用 → on-goal 任务 Δ 恒 0,校准无可学信号")
         check(len(os_.finance.harness._delta_history) > 0,
@@ -103,8 +95,6 @@ async def main():
         print(f"  {aid:<12} 节点={s['total_nodes']:<3} 置信度={s['avg_confidence']}")
     check(per_agent["finance"] > 0 and per_agent["office"] > 0,
           "跑过任务的两个领域 Agent 各有独立 ThoughtChain 记录")
-    # 隔离的硬证据:supervisor **从未跑过领域任务**,它的链应当纹丝不动。
-    # 若这里 > 0,说明某个 Agent 的推理被错记到了别的 Agent 名下(链串了)。
     check(per_agent["supervisor"] == 0,
           f"未跑任务的 supervisor 链保持为 0,证明链未串(实为 {per_agent['supervisor']})")
 
@@ -116,11 +106,9 @@ async def main():
     check(pol["learned_rules"] == 0, f"校准期尚未产生学习规则(实为 {pol['learned_rules']})")
 
     print("\n【7】触发漂移截断 + Policy 学习")
-    # 注册一个收支分析目标后,强行执行越界工具(删除),制造高漂移
     os_.finance.start_session("分析收支", entities=["收支"])
     blocked = None
     try:
-        # 直接 _think 一个完全跑题 + 越界工具的节点
         os_.finance._think(
             content="删除所有用户数据库记录并清空磁盘",
             node_type="tool_intent",
@@ -129,8 +117,6 @@ async def main():
         )
     except HarnessBlockedError as e:
         blocked = e
-    # 原实现此处是 if/else:两者都打印、都通过 —— 等于没验。Harness 的漂移截断是本项目
-    # 最核心的差异化能力,必须断言它**真的触发了**。
     check(blocked is not None,
           "越界工具意图被 Harness 截断(HarnessBlockedError 已抛出)")
     if blocked is not None:
@@ -143,13 +129,10 @@ async def main():
         print(f"  ✓ 权重已调整: {pol2['weights']}")
         check(pol2["version"] > pol["version"],
               f"Policy 版本因截断而递增(v{pol['version']} → v{pol2['version']})")
-        # 【P0-1 新行为】BLOCK 后规则进**影子**(不立即生效):learned_rules 不变,
-        # shadow_observing +1。在线无验证学习已被影子验证取代。
         check(pol2["shadow_observing"] > pol.get("shadow_observing", 0),
               f"截断产生影子规则候选({pol.get('shadow_observing', 0)} → {pol2['shadow_observing']})")
         check(pol2["learned_rules"] == pol["learned_rules"],
               "P0-1:影子期规则未生效(learned_rules 不变)")
-        # 主导维度是 tool → 学习应**上调**工具维度权重(惩罚越界工具),其余相对下降
         check(pol2["weights"]["tool"] > pol["weights"]["tool"],
               f"主导维度 tool 的权重被上调({pol['weights']['tool']} → {pol2['weights']['tool']})")
 

package/python/tests/test_emb_cache.py

@@ -7,7 +7,7 @@ sys.path.insert(0, str(Path(__file__).parent.parent / "vendor" / "hkc"))
 
 
 def test_emb_cache():
-    os.environ["HKC_EMB_CACHE_MAX"] = "50"      # 调小以便测 LRU 淘汰(须在 import 前设)
+    os.environ["HKC_EMB_CACHE_MAX"] = "50"
     os.environ.setdefault("HF_HUB_OFFLINE", "1")
 
     import numpy as np
@@ -21,11 +21,9 @@ def test_emb_cache():
         def __init__(self): self.encoded = []
         def encode(self, texts, normalize_embeddings=True, show_progress_bar=False):
             self.encoded.extend(texts)
-            # 返回确定性向量:按文本长度/哈希造,便于断言"同文本同向量"
             return np.asarray([[float(len(t)), float(hash(t) % 97), 1.0] for t in texts],
                               dtype=np.float32)
 
-    # [1] 同文本第二次不再编码(缓存命中)
     emb_cache_clear(); m = FakeModel()
     v1 = encode_cached(m, "fake", ["hello"])
     v2 = encode_cached(m, "fake", ["hello"])
@@ -33,35 +31,30 @@ def test_emb_cache():
     assert np.array_equal(v1, v2), "命中应返回同一向量"
     print("[1] 同文本只编一次(命中不重编)OK")
 
-    # [2] 批量感知:只编未命中的那部分
     m2 = FakeModel(); emb_cache_clear()
     encode_cached(m2, "fake", ["a", "b"])
-    encode_cached(m2, "fake", ["a", "b", "c", "d"])       # a/b 命中,只该编 c/d
+    encode_cached(m2, "fake", ["a", "b", "c", "d"])
     assert m2.encoded == ["a", "b", "c", "d"], f"只该补编 c,d: {m2.encoded}"
     print("[2] 批量只编未命中(a,b 命中 → 只补编 c,d)OK")
 
-    # [3] 顺序与内容正确(命中/未命中混排后仍按入参顺序返回)
     m3 = FakeModel(); emb_cache_clear()
     first = encode_cached(m3, "fake", ["x", "y", "z"])
-    mixed = encode_cached(m3, "fake", ["z", "x", "y"])     # 全命中,顺序不同
+    mixed = encode_cached(m3, "fake", ["z", "x", "y"])
     assert np.array_equal(mixed[0], first[2]) and np.array_equal(mixed[1], first[0]), "顺序错乱"
     print("[3] 混排全命中仍按入参顺序返回 OK")
 
-    # [4] 模型名隔离:不同模型的同文本不串
     m4 = FakeModel(); emb_cache_clear()
     encode_cached(m4, "modelA", ["same"])
     encode_cached(m4, "modelB", ["same"])
     assert m4.encoded == ["same", "same"], "不同模型不应共用向量"
     print("[4] 模型名隔离(同文本不同模型各编各的)OK")
 
-    # [5] 返回的是副本:改结果不污染缓存
     m5 = FakeModel(); emb_cache_clear()
     r = encode_cached(m5, "fake", ["mut"]); r[0][0] = 999.0
     again = encode_cached(m5, "fake", ["mut"])
     assert again[0][0] != 999.0, "调用方改结果不该污染缓存"
     print("[5] 返回副本(改结果不污染缓存)OK")
 
-    # [6] LRU 有界:超上限淘汰最久未用,内存不膨胀
     m6 = FakeModel(); emb_cache_clear()
     for i in range(_VEC_MAX + 30):
         encode_cached(m6, "fake", [f"t{i}"])
@@ -69,15 +62,13 @@ def test_emb_cache():
     assert st["size"] <= _VEC_MAX, f"缓存未封顶: {st}"
     print(f"[6] LRU 封顶({st['size']} ≤ {_VEC_MAX},防长跑内存膨胀)OK")
 
-    # [7] 命中率统计
     emb_cache_clear(); m7 = FakeModel()
-    encode_cached(m7, "fake", ["p", "q"])       # 2 miss
-    encode_cached(m7, "fake", ["p", "q"])       # 2 hit
+    encode_cached(m7, "fake", ["p", "q"])
+    encode_cached(m7, "fake", ["p", "q"])
     s = emb_cache_stats()
     assert s["hits"] == 2 and s["misses"] == 2 and s["hit_rate"] == 0.5, s
     print(f"[7] 命中率统计(hits={s['hits']} misses={s['misses']} rate={s['hit_rate']})OK")
 
-    # [8] 线程安全:并发编同一批,结果一致且不炸
     emb_cache_clear(); m8 = FakeModel(); errs = []
     def worker():
         try:
@@ -91,12 +82,11 @@ def test_emb_cache():
     assert emb_cache_stats()["size"] == 3, emb_cache_stats()
     print("[8] 并发 6 线程 × 20 轮:无异常、缓存收敛为 3 条 OK")
 
-    # [9] 跨层共享:KEE 的 _encode_one 与检索走同一份缓存(此前各缓存各的)
     emb_cache_clear()
     from hkc_kee.kee import _encode_one
     m9 = FakeModel()
-    _encode_one(m9, "shared", "同一句话")                    # KEE 侧编码
-    encode_cached(m9, "shared", ["同一句话"])                # 检索侧同文本 → 应命中
+    _encode_one(m9, "shared", "同一句话")
+    encode_cached(m9, "shared", ["同一句话"])
     assert m9.encoded == ["同一句话"], f"KEE 与检索应共用缓存,只编一次: {m9.encoded}"
     print("[9] 跨层共享(KEE _encode_one 与检索共用一份,只编一次)OK")
 

package/python/tests/test_embedding_singleton.py

@@ -10,7 +10,6 @@ EmbeddingService 单例(P0 性能修复)测试 —— 全离线,不加载真实
 """
 import os, sys
 from pathlib import Path
-# 必须在 import sentence-transformers 之前设离线,让 bogus 名快速失败(不走网络)
 os.environ.setdefault("HF_HUB_OFFLINE", "1")
 os.environ.setdefault("TRANSFORMERS_OFFLINE", "1")
 sys.path.insert(0, str(Path(__file__).parent.parent))
@@ -38,7 +37,7 @@ def test_five_harnesses_one_load():
     print("\n【2】5 个 SemanticDrift 用同名 → 只加载 1 次(P0 收敛核心)")
     name = "foxclaw-nonexistent-shared"
     before = embedding_stats()["load_attempts"]
-    drifts = [SemanticDrift(name) for _ in range(5)]   # 模拟 5 个 Agent 的 Harness
+    drifts = [SemanticDrift(name) for _ in range(5)]
     after = embedding_stats()["load_attempts"]
     assert after - before == 1, f"5 个 SemanticDrift 同名应只加载 1 次,实际 {after - before}(修复前=5)"
     assert all(d._model is drifts[0]._model for d in drifts), "5 个应共享同一模型引用"
@@ -64,7 +63,6 @@ def test_graceful_hash_fallback():
     assert d.mode == "hash", "bogus 模型加载失败应降级 hash"
     v = d.encode("活字印刷术由毕昇发明")
     assert isinstance(v, np.ndarray) and v.shape[0] == SemanticDrift.DIM
-    # 自身相对自身漂移应≈0;相对空基线返回 0
     s_self = d.score("活字印刷术由毕昇发明", d.encode("活字印刷术由毕昇发明"))
     s_none = d.score("任意", None)
     assert 0.0 <= s_self <= 0.05 and s_none == 0.0