dsh-crwu-workbench 0.0.10

package/skills/crwu/crwu-audit-datacheck/scripts/test_recalc_check.py

@@ -0,0 +1,419 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""`recalc_check.py` 契约测试（C7 计算链重算验证）。
+
+自洽：只用 openpyxl 造临时 fixture，可随技能安装运行。每条对应真实/风险场景。
+"""
+from __future__ import annotations
+
+import importlib.util
+import json
+import os
+import re
+import subprocess
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+SCRIPTS_DIR = Path(__file__).resolve().parent
+
+
+def _load():
+    spec = importlib.util.spec_from_file_location("recalc_check_for_test",
+                                                  SCRIPTS_DIR / "recalc_check.py")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+def _inject_cell(data, coord, val):
+    """给指定公式格注入缓存值 `<v>`（字符串结果加 `t="str"`），模拟真实 Excel 已计算文件。"""
+    # openpyxl 写公式格为 `<c r=".."><f>..</f><v /></c>`（空缓存）；把 `<v />` 替换为真实缓存值。
+    pat = re.compile(rb'(<c r="%s"[^>]*?>)(<f>.*?</f>).*?(</c>)' % coord.encode())
+
+    def repl(m):
+        c = m.group(1)
+        if isinstance(val, str):
+            c = c[:-1] + b' t="str">'
+        v = ("<v>%s</v>" % val).encode("utf-8")
+        return c + m.group(2) + v + m.group(3)
+
+    return pat.sub(repl, data, count=1)
+
+
+def _inject_cached(path, cached):
+    """`cached`: {(sheet_title, coord): value}。openpyxl 不写缓存值，故手术注入。"""
+    import shutil
+    import zipfile
+    tmp = path.with_suffix(path.suffix + ".tmp")
+    with zipfile.ZipFile(path) as z:
+        wbxml = z.read("xl/workbook.xml").decode("utf-8")
+        rels = z.read("xl/_rels/workbook.xml.rels").decode("utf-8")
+    name_rid = {}
+    for m in re.finditer(r"<sheet\b([^>]*?)/>", wbxml):
+        attrs = m.group(1)
+        nm = re.search(r'name="([^"]+)"', attrs)
+        rid = re.search(r'r:id="([^"]+)"', attrs)
+        if nm and rid:
+            name_rid[nm.group(1)] = rid.group(1)
+    rid_target = {}
+    for m in re.finditer(r"<Relationship\b([^>]*?)/>", rels):
+        attrs = m.group(1)
+        rid = re.search(r'Id="([^"]+)"', attrs)
+        tgt = re.search(r'Target="([^"]+)"', attrs)
+        if rid and tgt:
+            rid_target[rid.group(1)] = tgt.group(1)
+    sheet_file = {n: rid_target[r].lstrip("/") for n, r in name_rid.items()}
+    with zipfile.ZipFile(path) as z, zipfile.ZipFile(tmp, "w") as out:
+        for item in z.infolist():
+            data = z.read(item.filename)
+            if item.filename in sheet_file.values():
+                sheet = next(n for n, f in sheet_file.items() if f == item.filename)
+                for (s, coord), val in cached.items():
+                    if s == sheet:
+                        data = _inject_cell(data, coord, val)
+            out.writestr(item, data)
+    shutil.move(str(tmp), str(path))
+
+
+class RecalcCheckContractTest(unittest.TestCase):
+    def setUp(self):
+        import openpyxl  # noqa: F401
+        self.module = _load()
+        self.tmp = tempfile.TemporaryDirectory()
+        self.dir = Path(self.tmp.name)
+
+    def tearDown(self):
+        self.tmp.cleanup()
+
+    def _run(self, wb, name="t.xlsx"):
+        import openpyxl
+        p = self.dir / name
+        wb.save(p)
+        return self.module.run(str(p))
+
+    def _run_cached(self, wb, cached, name="t.xlsx"):
+        p = self.dir / name
+        wb.save(p)
+        _inject_cached(p, cached)
+        return self.module.run(str(p))
+
+    def test_arithmetic_and_absolute_ref_match(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"], wb.active["B1"], wb.active["C1"] = 3, 4, "=$A$1*B1"
+        r = self._run_cached(wb, {("Sheet", "C1"): 12})
+        self.assertEqual(1, r["summary"]["matched"], r["differences"])
+        self.assertEqual([], r["differences"])
+
+    def test_mismatch_is_reported(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"], wb.active["A2"] = 2, 3
+        wb.active["A3"] = "=A1+A2"       # 公式=5，但缓存值故意写成 6
+        wb.active["A3"].value = "=A1+A2"
+        # 用 zip 手术注入缓存值 6
+        import zipfile
+        p = self.dir / "m.xlsx"
+        wb.save(p)
+        with zipfile.ZipFile(p) as z, zipfile.ZipFile(p.with_suffix(".tmp"), "w") as out:
+            for item in z.infolist():
+                data = z.read(item.filename)
+                if item.filename.startswith("xl/worksheets/sheet") and b"<f>A1+A2</f>" in data:
+                    data = data.replace(b"<f>A1+A2</f>", b"<f>A1+A2</f><v>6</v>", 1)
+                out.writestr(item, data)
+        import shutil
+        shutil.move(str(p.with_suffix(".tmp")), str(p))
+        r = self.module.run(str(p))
+        self.assertEqual(1, r["summary"]["mismatched"], r)
+        self.assertEqual(5, r["differences"][0]["recalculated"])
+
+    def test_sum_and_product_and_round(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"], wb.active["A2"], wb.active["A3"] = 2, 3, 4
+        wb.active["A4"] = "=SUM(A1:A3)"
+        wb.active["A5"] = "=PRODUCT(A1:A3)"
+        wb.active["A6"] = "=ROUND(1.235,2)"
+        r = self._run_cached(wb, {("Sheet", "A4"): 9, ("Sheet", "A5"): 24, ("Sheet", "A6"): 1.24})
+        self.assertEqual(3, r["summary"]["matched"], r)
+        self.assertEqual([], r["differences"])
+
+    def test_if_chain_reproduces_real_case(self):
+        """真实场景：描述词匹配 IF 链——匹配词错误时算 0（重算应复现该 0）。"""
+        import openpyxl
+        wb = openpyxl.Workbook()
+        ws = wb.active
+        ws["D22"] = "较完善"
+        ws["V22"] = '=IF(D22="完善",5,IF(D22="较完善",4,IF(D22="一般",3,0)))'  # 应为 4
+        ws["V23"] = '=IF(D23="方便",5,IF(D23="较方便",4,0))'                     # D23 空 → 0
+        r = self._run_cached(wb, {("Sheet", "V22"): 4, ("Sheet", "V23"): 0})
+        self.assertEqual(2, r["summary"]["matched"], r)
+        self.assertEqual([], r["differences"])
+
+    def test_if_returns_correct_branch_and_lazy(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        ws = wb.active
+        ws["A1"] = 10
+        ws["B1"] = '=IF(A1>5, "高", "低")'
+        ws["A2"] = 3
+        ws["B2"] = '=IF(A2>5, "高", "低")'
+        r = self._run_cached(wb, {("Sheet", "B1"): "高", ("Sheet", "B2"): "低"})
+        self.assertEqual(2, r["summary"]["matched"], r)
+
+    def test_hidden_dependency_is_not_recomputable(self):
+        """引用隐藏列 → 标「未重算」，绝不读隐藏值。"""
+        import openpyxl
+        wb = openpyxl.Workbook()
+        ws = wb.active
+        ws["A1"] = "=N10*2"
+        ws["N10"] = 999999
+        ws.column_dimensions["N"].hidden = True
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("隐藏", r["notRecomputable"][0]["reason"])
+
+    def test_cross_sheet_reference(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = 5
+        s2 = wb.create_sheet("表2")
+        s2["B2"] = "=Sheet!A1*2"   # 用工作表名（默认表名是 Sheet）
+        r = self._run_cached(wb, {("表2", "B2"): 10})
+        self.assertEqual(1, r["summary"]["matched"], r["differences"])
+
+    def test_unsupported_function_is_not_recomputable(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = "=VLOOKUP(B1,C1:D5,2,FALSE)"
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("不支持的函数", r["notRecomputable"][0]["reason"])
+
+    def test_external_workbook_reference_is_not_recomputable(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = "='[29]投资性房地产-房屋公允模式'!W31"
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("外部工作簿", r["notRecomputable"][0]["reason"])
+
+    def test_division_by_zero_is_not_recomputable(self):
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = "=1/0"
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("除零", r["notRecomputable"][0]["reason"])
+
+    def test_unsupported_operator_inside_function_arg_is_not_silently_dropped(self):
+        """函数参数里的未实现运算符（`&`）必须报「未重算」，**不得被静默丢弃后猜值**。
+
+        真实失效（2026-302150-LX9757-BG8677）：`ev()` 丢弃了 `_expr` 返回的消费位置，
+        于是 `IF(A1&B1="x", 111, 222)` 只解析 `A1` 就返回，条件走错分支、给出 222。
+        隐患不止假阳性——若该错误值恰好等于缓存值，就会被记成"已核"（假阴性）。
+        """
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = '=IF(""&"x"="x",111,222)'
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("未消费的片段", r["notRecomputable"][0]["reason"])
+        self.assertEqual(0, r["summary"]["mismatched"], "不得拿猜出来的值参与比对")
+        self.assertEqual(0, r["summary"]["matched"], "更不得把猜出来的值记成已核")
+
+    def test_percent_operator_inside_function_arg_is_not_recomputable(self):
+        """`%` 同样未实现，出现在函数参数里也必须报「未重算」。"""
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = "=SUM(50%,10%)"
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("未消费的片段", r["notRecomputable"][0]["reason"])
+
+    def test_type_mismatch_is_not_recomputable_and_does_not_crash(self):
+        """类型不匹配（日期 − 文本）→ 标「未重算(类型不匹配)」，**不得打穿整表**。
+
+        真实失效（2026-302135-LX9619-BG8634 的 3-资产基础法.xlsx）：
+        `_arith` 抛裸 `TypeError: unsupported operand type(s) for -: 'datetime.datetime'
+        and 'str'`，而 `run()` 只捕获 `Unavailable` → 整个 datacheck 崩溃、该表完全不可用。
+        Excel 对同式报 `#VALUE!`，故这属"该格不可重算"，不是引擎缺陷。
+        """
+        import datetime
+        import openpyxl
+        wb = openpyxl.Workbook()
+        ws = wb.active
+        ws["A1"] = datetime.datetime(2024, 1, 1)
+        ws["B1"] = "文本"
+        ws["C1"] = "=A1-B1"
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("类型不匹配", r["notRecomputable"][0]["reason"])
+        self.assertEqual(0, r["summary"]["engineErrors"], "类型问题是该格不可重算，不该计成引擎异常")
+        self.assertEqual(0, r["summary"]["mismatched"], "不得猜值比对")
+
+    def test_sum_over_non_numeric_is_not_recomputable_and_does_not_crash(self):
+        """SUM 聚合到非数值（文本/日期）→ 标「未重算」，不得崩溃（`float()` 转换路径）。"""
+        import openpyxl
+        wb = openpyxl.Workbook()
+        ws = wb.active
+        ws["A1"] = "文本"
+        ws["A2"] = 1
+        ws["B1"] = "=SUM(A1:A2)"
+        r = self._run(wb)
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertIn("类型不匹配", r["notRecomputable"][0]["reason"])
+
+    def test_unexpected_engine_error_is_counted_and_never_swallowed(self):
+        """非预期异常 → 记 engineError 并入摘要 engineErrors，**不伪装成普通未重算**。
+
+        这是防"兜底把代码缺陷静默化"的反向断言：既有可见的计数，也有逐格标记。
+        """
+        import openpyxl
+        wb = openpyxl.Workbook()
+        wb.active["A1"] = "=1+1"
+        p = self.dir / "boom.xlsx"
+        wb.save(p)
+
+        original = self.module.Evaluator.eval
+        self.module.Evaluator.eval = lambda self, f: (_ for _ in ()).throw(
+            RuntimeError("模拟引擎缺陷"))
+        try:
+            r = self.module.run(str(p))
+        finally:
+            self.module.Evaluator.eval = original
+
+        self.assertEqual(1, r["summary"]["notRecomputable"], r)
+        self.assertEqual(1, r["summary"]["engineErrors"], "非预期引擎异常必须计数暴露")
+        entry = r["notRecomputable"][0]
+        self.assertTrue(entry.get("engineError"))
+        self.assertIn("引擎异常 RuntimeError", entry["reason"])
+
+
+_RUNNER_TEMPLATE = """\
+import importlib.abc
+import importlib.util
+import pathlib
+import runpy
+import sys
+
+PRUNE = set({prune!r})
+PROBE = set({probe!r})
+
+
+def _prune(names):
+    dropped = []
+    for entry in list(sys.path):
+        if not entry:
+            continue
+        base = pathlib.Path(entry)
+        if any((base / n).is_dir() or (base / (n + ".py")).is_file() for n in names):
+            dropped.append(entry)
+    sys.path[:] = [e for e in sys.path if e not in dropped]
+    for name in names:
+        sys.modules.pop(name, None)
+    importlib.invalidate_caches()
+
+
+class _ProbeRaiser(importlib.abc.MetaPathFinder):
+    def find_spec(self, fullname, path=None, target=None):
+        if fullname.split(".")[0] in PROBE:
+            raise ModuleNotFoundError("No module named " + repr(fullname), name=fullname)
+        return None
+
+
+_prune(PRUNE)
+sys.meta_path.insert(0, _ProbeRaiser())
+sys.argv = {argv!r}
+runpy.run_path({script!r}, run_name="__main__")
+"""
+
+
+class MissingOpenpyxlBehaviorTest(unittest.TestCase):
+    """OPT-005-R1/-R2：`recalc_check.py` 对 openpyxl 也要区分三态，且都 fail closed。
+
+    - `missing`：`find_spec` 返回 None（`prune`）
+    - `import_failed`：spec 在、import 抛错（`shadow`）
+    - `probe_failed`：`find_spec` 自身抛异常（`probe`）
+
+    三者都必须 exit=3、不读值、不重算、**不产出差异文件**，错误文本必须准确。
+    模拟都在**子进程**里做，不动本机包。
+    """
+
+    def _run(self, case: Path, workbook: Path, out: Path, *, prune=(), probe=(), shadow=None):
+        runner = case / "_runner.py"
+        runner.write_text(
+            _RUNNER_TEMPLATE.format(
+                prune=tuple(prune),
+                probe=tuple(probe),
+                argv=[str(SCRIPTS_DIR / "recalc_check.py"), "--workbook", str(workbook),
+                      "--out", str(out)],
+                script=str(SCRIPTS_DIR / "recalc_check.py"),
+            ),
+            encoding="utf-8",
+        )
+        env = dict(os.environ)
+        paths = []
+        if shadow:
+            shadow_dir = case / "_shadow"
+            shadow_dir.mkdir(exist_ok=True)
+            for module, body in shadow.items():
+                (shadow_dir / f"{module}.py").write_text(body, encoding="utf-8")
+            paths.append(str(shadow_dir))
+        if env.get("PYTHONPATH"):
+            paths.append(env["PYTHONPATH"])
+        if paths:
+            env["PYTHONPATH"] = os.pathsep.join(paths)
+        env["PYTHONDONTWRITEBYTECODE"] = "1"
+        proc = subprocess.run(
+            [sys.executable, str(runner)], capture_output=True, text=True, env=env, cwd=str(case)
+        )
+        return proc, (proc.stdout or "") + (proc.stderr or "")
+
+    def _workbook(self, name: str = "表.xlsx"):
+        temp = tempfile.TemporaryDirectory()
+        self.addCleanup(temp.cleanup)
+        case = Path(temp.name)
+        book = case / name
+        book.write_bytes(b"PK\x03\x04")            # 内容无关：依赖问题在 import 阶段就暴露
+        return case, book
+
+    def test_missing_openpyxl_fails_loudly_without_writing_a_diff(self):
+        case, book = self._workbook()
+        out = case / "差异.json"
+        proc, combined = self._run(case, book, out, prune=("openpyxl",))
+        self.assertEqual(3, proc.returncode, f"缺包必须 exit=3：{combined[:200]}")
+        self.assertIn("openpyxl", combined)
+        self.assertIn("缺少第三方运行时依赖", combined)
+        self.assertNotIn("Traceback", combined, "不得以裸 traceback 代替明确错误")
+        self.assertFalse(out.exists(), "缺包时不得产生伪差异结果文件")
+
+    def test_import_failed_openpyxl_says_import_failure_not_missing(self):
+        case, book = self._workbook()
+        out = case / "差异.json"
+        proc, combined = self._run(
+            case, book, out, shadow={"openpyxl": 'raise ImportError("模拟：openpyxl 已损坏")\n'}
+        )
+        self.assertEqual(3, proc.returncode, f"导入失败也必须 exit=3：{combined[:200]}")
+        self.assertIn("openpyxl", combined)
+        self.assertIn("导入失败", combined)
+        self.assertNotIn("缺少", combined, f"import_failed 不得说成缺少：{combined[:200]}")
+        self.assertNotIn("Traceback", combined)
+        self.assertFalse(out.exists())
+
+    def test_probe_failed_openpyxl_says_probe_failure_not_missing(self):
+        case, book = self._workbook()
+        out = case / "差异.json"
+        proc, combined = self._run(case, book, out, probe=("openpyxl",))
+        self.assertEqual(3, proc.returncode, f"探测失败也必须 exit=3：{combined[:200]}")
+        self.assertIn("openpyxl", combined)
+        self.assertIn("探测失败", combined)
+        self.assertNotIn("缺少", combined, f"probe_failed 不得伪装成缺少：{combined[:200]}")
+        self.assertNotIn("Traceback", combined)
+        self.assertFalse(out.exists())
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

package/skills/crwu/crwu-audit-datacheck/scripts/test_skill_self_containment.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+"""Source contract test: this Skill must not depend on sibling Skill internals."""
+
+from pathlib import Path
+import re
+import unittest
+
+
+SKILL_ROOT = Path(__file__).resolve().parents[1]
+SKILL_NAME = SKILL_ROOT.name
+
+# Match private paths written directly (``name/references/...``) or with a
+# short prose bridge (``name 技能的 `scripts/...```) while allowing references
+# to this Skill itself.
+PRIVATE_SKILL_PATH = re.compile(
+    r"(?P<skill>crwu-[a-z0-9-]+)(?:/|[^\n]{0,40}?)"
+    r"(?:SKILL\.md|references/|scripts/)"
+)
+
+
+class SkillSelfContainmentTests(unittest.TestCase):
+    def test_markdown_does_not_reference_sibling_skill_internals(self):
+        violations = []
+        for path in sorted(SKILL_ROOT.rglob("*.md")):
+            for line_number, line in enumerate(
+                path.read_text(encoding="utf-8").splitlines(), start=1
+            ):
+                for match in PRIVATE_SKILL_PATH.finditer(line):
+                    if match.group("skill") != SKILL_NAME:
+                        violations.append(
+                            f"{path.relative_to(SKILL_ROOT)}:{line_number}: "
+                            f"{match.group(0)}"
+                        )
+
+        self.assertEqual(
+            [],
+            violations,
+            "Skill runtime documentation references sibling private files:\n"
+            + "\n".join(violations),
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/crwu/crwu-audit-external-data/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: crwu-audit-external-data
+description: Use when crwu-audit routes a report whose methods[] includes 收益法 or 市场法 and its external public-data claims may require iFinD verification.
+---
+
+# crwu-audit-external-data（外部数据核验 · 能力型）
+
+> **单一事实源分工**
+> **知识库 = 口径**：表 A 触发范围、表 B 数据项触及、表 C 组合映射、结论档位、
+> 数据留痕要求、未检查项与缺口记录、员工补录机制——全部在库内正文，本技能不复制。
+> 库内表 D（取数失败与降级）按**单源**执行：本技能只以同花顺 iFinD 取数，不作双源复核
+> （见「数据源与两条取数路径」）。
+> **本技能 = 能力**：数据项抽取、取数入口发现与调用、口径标准化、比对留痕、交付字段产出。
+
+> **KB 逻辑装配表**：本技能 `references/00-KB装配表.md` = 库内层级路径寻址键表（命中本技能 →
+> 该表路径并入本次审核下载清单 → 经 crwu-dws 实时下载正文、只读引用、出处 = 本次下载文件:行号 +
+> exportedAt；每次审核重新下载、零正文缓存；改知识库内容不动技能）。
+
+## ⚠️ 调用前置条件
+
+本技能是跨方向**能力型**技能：**仅经 `crwu-audit` router 编排调用，禁止单独调用**——默认由总路由
+在 `methods[]` 命中 **收益法 / 市场法** 时叠加调用，**禁止 Agent 脱离编排直接调用并据其输出下审核判断**。
+例外：用户明确只要「外部数据核验结果」且不做审核判断时，可独立执行——输出仅限核验结果，并注明
+"仅外部数据核验，未做审核判断，待方法轴技能/人工判读"。
+
+## 定位与触发
+
+- 何时用：`route_profile.methods[]` 含 `收益法` 或 `市场法`；是否真正取数仍按库内 **表 A** 三条
+  （业务线 × 资产线 × 方法线）同时成立判定，缺一即不核验、记"不在本模块范围"。
+- 与知识库口径：全部核验口径、数据项取舍与结论档位以库内 `M-外部数据核验` 模块规程为准；
+  本技能只提供能力与执行规程，并叠加"单源（同花顺 iFinD）、不启用万得"这一环境事实。
+- 与非本技能职责的边界：报告内部与跨表数字勾稽 → `crwu-audit-datacheck`；披露完整性通用检查 →
+  `crwu-audit-public-general-standards`；参数合理性与方法判断 → 方法轴技能与人工。
+
+## 必读 references
+
+按下列分工理解所有权；运行时只读对应文件：
+
+1. [00-KB装配表.md](references/00-KB装配表.md)：本技能装配的库内层级路径寻址键表（见上方 KB 逻辑装配表说明）。
+2. [01-connector-access.md](references/01-connector-access.md)：**取数入口发现与调用**——宿主边界、发现顺序、降级与留痕契约；两宿主入口的判定结论一律以它为准。
+3. [02-verification-workflow.md](references/02-verification-workflow.md)：**执行前必读**——前置适用性门禁、基准日锚定三档、核验步骤 0–7、口径标准化与结论边界、`externalDataVerification` 字段契约与详细禁止事项。
+
+## 数据源与两条取数路径（同花顺 iFinD）
+
+本技能的唯一外部数据源是**同花顺 iFinD**，但宿主不同，取数入口不同——**不要假定另一个宿主的入口存在**：
+
+- 两条宿主入口取的是**同一上游 iFinD 服务**，但调用方式与凭据来源不同：不要拿 WorkBuddy 的连接器声明
+  去推断 DSH 可用，也不要在 DSH 里去找 WorkBuddy 的连接器目录。
+- **取数入口发现与调用细则**（发现顺序、降级、留痕契约、各宿主入口的判定结论）统一见
+  `references/01-connector-access.md`。
+- `scripts/connector_probe.py` 是 **WorkBuddy 专用**的只读预检：只在 WorkBuddy 会话未直接暴露
+  iFinD MCP 工具时读宿主连接器声明，**不是**两宿主通用的可用性探测器。运行口径：
+  `<WorkBuddy 宿主可用的绝对 Python 路径> scripts/connector_probe.py --format json`
+  （只读，不读凭据值）。**禁止**裸 `python3` 名字、任何解释器查找，以及静默降级到系统解释器
+  （缺包就记 capability gap 并停下）。
+- **DeepSeek Harness 不运行 `connector_probe.py` 判断可用性**，也没有可读的宿主声明：DSH 侧入口
+  就是结构化 Tool `crwu_audit_ifind_query` 对当前 Agent 的可见性；可见后以一次真实的
+  `operation=list_tools` 成功返回为准（详见 `references/01-connector-access.md` §4）。
+- **万得不参与本技能的取数**：库内表 B/C 的源统一为同花顺 iFinD；表 D 的双源复核条件不适用，
+  按单源（D1–D4）降级执行。
+
+## 输入
+
+1. router 冻结的 `route_profile`（须含 `methods[]`，以及 `record_context.base_date`——**所有取数的基准日锚点**）；
+2. router 已准备并隔离的报告、评估说明、测算明细表等材料路径；
+3. router 已验证的本次 DWS manifest，至少含 `references/00-KB装配表.md` 的路径键对应正文。
+
+缺少任一项即记录 capability gap，不自行补取、不沿用上一轮材料。不得接收复核记录。
+
+## 输出与边界门禁
+
+- 输出交付层 `externalDataVerification`（供 HTML《外部数据核验》区渲染）；字段契约与逐项核验要求见 [02-verification-workflow.md](references/02-verification-workflow.md)，意见条目结构以本次实时下载的库内正文为准。
+- **门禁**（详细规则见 01 / 02）：不得跨宿主推断取数入口；不得把外部数据用作规则依据；不得声称双源复核；**口径无法统一时不得作数值判定**；需要核验而取数路径不可用时，按库内降级口径降级并在交付件中显式声明，不得静默跳过。

package/skills/crwu/crwu-audit-external-data/references/00-KB/350/243/205/351/205/215/350/241/250.md

@@ -0,0 +1,38 @@
+# references/00 · KB 逻辑装配表（crwu-audit-external-data）
+
+> 本表 = 库内层级路径寻址键表（路径 = crwu-dws 查询到的知识库内路径；不写知识库名称 / 本地根路径 / 节点 nodeId）。
+> 使用：命中本技能 → 本表路径并入本次审核下载清单 → 经 crwu-dws 按路径实时下载正文（下载时刻即最新）→
+> 只读引用，出处 = 本次下载文件:行号 + exportedAt。文件零缓存：每次审核重新下载，不做任何正文缓存。
+> 分工（单一事实源）：**本技能 = 能力**——数据项抽取、连接器发现与调用、口径标准化、比对留痕；
+> **知识库 = 口径**——表 A 触发范围、表 B 数据项触及、表 C 组合映射、表 D 源启用条件与降级、结论档位、
+> 留痕要求、未检查项、员工补录机制；正文经 crwu-dws 实时下载获得，技能与知识库互不复制正文。
+> 本环境的取数路径与"不启用万得"的落地方式见本技能 `references/01-connector-access.md`。
+> 索引/校验工具：`crwu-dev-audit-skill-maintainer` 技能的 `scripts/kb_tool.py`（随该技能安装）。
+> 路径键写法：逐字使用库内节点名（`by_path` 键 = 原样精确名，不折叠大小写/全半角）；**单文件路径不带 `.md`**；
+> 目录路径以 `/` 结尾并递归下载。清单外零下载。
+> 知识库文件名 / 结构 / 装配范围变更 → 同步本表路径键并跑 `crwu-dev-audit-skill-maintainer` 技能的
+> `scripts/kb_tool.py validate`。
+
+| 需要 | 库内层级路径（寻址键；经 crwu-dws 实时下载后只读引用） |
+| --- | --- |
+| 外部数据核验模块规程（表 A 触发范围 / 表 B 数据项触及 / 表 C 组合映射 / 表 D 源启用条件与降级 / 结论档位 / 留痕 / 未检查项 / 员工补录机制） | `06-规则库/M-外部数据核验/01-模块-外部数据核验` |
+| 模块标签登记（`modules` 词表，供装配筛选与校验） | `00-总纲/治理/标签词典` |
+| 防幻觉与证据纪律 | `00-总纲/执行契约/02-防幻觉协议执行细则` |
+| 统计口径与台账（未检查项、数据核验条目的统计口径） | `00-总纲/执行契约/03-审核统计与台账规范` |
+| 术语一致性（口径、主源/副源等） | `00-总纲/治理/同义术语表` |
+
+## 不由本表登记的内容
+
+- **方法准则与对象/业务规则**：属 method / asset / business 轴，由 router 按各轴叶子装配；
+  本技能只在其被加载时叠加外部数据核验，不复制其他轴的根映射。
+- **交付/送达层规范**：`crwu-audit/references/11-html-delivery-spec.md` 为本技能族内正式规范，
+  不经知识库下载（《外部数据核验》区定义见该文件）。
+- **数据源连接与凭据**：属宿主连接器、Harness 技能与部署配置，见本技能
+  `references/01-connector-access.md`；知识库只规定"哪个数据项用什么源"，不规定技术调用方式。
+  本环境不启用万得；库内表 D 为取数失败与降级口径，按单源（D1–D4）执行。
+
+## 失败与出处
+
+下载零命中、多命中、类型不符、跳过或失败时，以 manifest 状态记录对应 gap，不猜测近似路径，
+也不凭缓存补正文。最终出处由 manifest 与本次下载物共同形成：本次下载文件、实际行号、库内路径、
+运行时 `nodeId` 与 `exportedAt`；运行时值不得写回本文件。