@hawk2048/oh-my-dsh 0.3.6 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 变更记录
 
+## 0.4.0 — 2026-11-04
+
+证据这一层从「写了规矩」推进到「能查」。
+
+### 新增
+
+- `references/evidence_check.py`：读证据清单与正文，查编号重复、正文引用了清单里没有的编号、清单里从未核验的条目、登记了但正文没用的条目。`--strict` 把未核验也算不合格。
+- `references/selftest.py`：两个检查脚本自己的回归测试，七个用例，内存里生成样本，不需要外部文件。
+- `npm test` 里加入这个自测；没有 python 的机器跳过并说明。
+
+### 变更
+
+- 证据清单加两列：核验状态（未核 / 已开页 / 已交叉）与核验人。填编号的人不能自己把状态写成已核。
+- 技能第二步补一行检查命令；调研报告的证据表已按新格式迁移，13 条全部标了状态。
+
 ## 0.3.6 — 2026-11-04
 
 把这两份新文档自己也过一遍：示例栏改成行内代码，正文里的内部用词全部展开。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawk2048/oh-my-dsh",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "description": "oh-my-dsh: DeepSeek Harness multi-agent orchestration layer — OMC-style workflow skills, slash commands, and an agent preset.",
   "type": "module",
   "main": "index.js",

package/skills/omd-autoresearch/references/evidence_check.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""evidence_check.py — 证据清单与正文的一致性检查（omd-autoresearch 附带）
+
+查四件事：
+  1. 编号有没有重复
+  2. 正文引用的编号，清单里有没有（断链）
+  3. 清单里有没有条目从未被正文引用（闲置）
+  4. 还没有核验过的条目有哪些（--strict 时视为不合格）
+
+用法：
+    python evidence_check.py evidence.md --report REPORT.md
+    python evidence_check.py evidence.md --report REPORT.md --strict --json
+
+退出码：0 通过；1 有不合格项。
+"""
+
+import argparse
+import json
+import re
+import sys
+
+CITE = re.compile(r"\[(S\d+)\]")
+HEAD_ALIASES = {
+    "编号": "id", "id": "id",
+    "事实或数字": "fact", "事实": "fact", "内容": "fact",
+    "来源": "source",
+    "级别": "level", "来源类型": "level",
+    "日期": "date",
+    "置信度": "confidence",
+    "核验状态": "status", "核验": "status",
+    "核验人": "checker", "核验者": "checker",
+}
+VERIFIED = {"已开页", "已交叉", "已核", "verified", "checked"}
+
+
+def parse_table(text: str):
+    """取文件里第一张表（连续以 | 开头的行）。返回 (headers, rows)。
+
+    只取一张：文件后面可能还有别的表（比如机制登记），混进来会串行。
+    """
+    lines = text.splitlines()
+    start = next((i for i, ln in enumerate(lines) if ln.strip().startswith("|")), None)
+    if start is None:
+        return [], []
+    block = []
+    for ln in lines[start:]:
+        if not ln.strip().startswith("|"):
+            break
+        block.append(ln.strip())
+    if not block:
+        return [], []
+    header = [c.strip() for c in block[0].strip("|").split("|")]
+    keys = [HEAD_ALIASES.get(h, h) for h in header]
+    body = []
+    for ln in block[1:]:
+        if re.fullmatch(r"\|[\s:\-|]+\|", ln):
+            continue
+        cells = [c.strip() for c in ln.strip("|").split("|")]
+        body.append(dict(zip(keys, cells)))
+    return keys, body
+
+
+def citations(text: str):
+    """正文里引用的编号。行内代码与引号里的内容不算：那通常是在讲别人的编号规则。"""
+    text = re.sub(r"`[^`\n]+`", " ", text)
+    text = re.sub(r"「[^」\n]*」|“[^”\n]*”", " ", text)
+    return set(CITE.findall(text))
+
+
+def main() -> int:
+    try:
+        sys.stdout.reconfigure(encoding="utf-8")
+    except Exception:
+        pass
+
+    ap = argparse.ArgumentParser()
+    ap.add_argument("evidence")
+    ap.add_argument("--report", default="", help="正文文件，用来查断链与闲置")
+    ap.add_argument("--strict", action="store_true", help="未核验的条目也判不合格")
+    ap.add_argument("--json", action="store_true")
+    args = ap.parse_args()
+
+    ev_text = open(args.evidence, encoding="utf-8").read()
+    keys, rows = parse_table(ev_text)
+
+    ids = [r.get("id", "") for r in rows if r.get("id")]
+    dup = sorted({i for i in ids if ids.count(i) > 1})
+
+    report_ids = set()
+    if args.report:
+        report_text = open(args.report, encoding="utf-8").read()
+        report_ids = citations(report_text)
+
+    missing = sorted(report_ids - set(ids))
+    unused = sorted(set(ids) - report_ids) if args.report else []
+
+    statuses = {}
+    pending = []
+    if "status" in keys:
+        for r in rows:
+            st = r.get("status", "").strip()
+            statuses[st or "(空)"] = statuses.get(st or "(空)", 0) + 1
+            if st not in VERIFIED:
+                pending.append(r.get("id", ""))
+
+    fails, warns = [], []
+    if dup:
+        fails.append({"rule": "编号重复", "value": dup,
+                      "fix": "同一编号只能登记一条，重复的改号或合并。"})
+    if missing:
+        fails.append({"rule": "正文引用了清单里没有的编号", "value": missing,
+                      "fix": "补进证据清单，或删掉正文里这条引用。"})
+    if keys and "status" not in keys:
+        warns.append({"rule": "清单没有核验状态列", "value": "全部条目",
+                      "fix": "加「核验状态」与「核验人」两列，写清谁核过、核到什么程度。"})
+    if pending:
+        msg = {"rule": "未核验的条目", "value": pending,
+               "fix": "打开原始来源核对，把状态改成已开页或已交叉；核不了的降级或删掉。"}
+        (fails if args.strict else warns).append(msg)
+    if unused:
+        warns.append({"rule": "登记了但正文没用", "value": unused[:10],
+                      "fix": "用上它，或在清单里标明仅登记、不参与结论。"})
+
+    passed = not fails
+    out = {"evidence": args.evidence, "report": args.report or None,
+           "passed": passed, "entries": len(rows),
+           "statuses": statuses, "fails": fails, "warns": warns}
+
+    if args.json:
+        print(json.dumps(out, ensure_ascii=False, indent=2))
+    else:
+        print(f"证据 {len(rows)} 条" + (f" · 正文引用 {len(report_ids)} 个编号" if args.report else ""))
+        if statuses:
+            print("核验状态：" + " · ".join(f"{k} {v}" for k, v in sorted(statuses.items())))
+        for f in fails:
+            print(f"  ✗ {f['rule']}: {f['value']}")
+            print(f"      改法：{f['fix']}")
+        for w in warns:
+            print(f"  ⚠ {w['rule']}: {w['value']}")
+        print("结论：", "PASS" if passed else "FAIL")
+
+    return 0 if passed else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/omd-autoresearch/references/selftest.py

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""selftest.py — 两个检查脚本自己的回归测试。
+
+不需要外部文件，用例在内存里生成，跑完删掉。
+用法：python selftest.py        退出码 0 表示全部通过。
+"""
+
+import pathlib
+import subprocess
+import sys
+import tempfile
+
+HERE = pathlib.Path(__file__).resolve().parent
+LINT = HERE / "report_lint.py"
+EVID = HERE / "evidence_check.py"
+
+GOOD = """# 结论：欧洲户用储能在收缩
+
+德国 2026 年户用光伏新增预计 3.0GW，比 2024 年少 27%（BNEF 2026.1）。平均回本期从 6.2 年拉到 9.4 年。
+
+| 项目 | 2024 | 2026 |
+|---|---|---|
+| 德国新增 | 4.1GW | 3.0GW |
+
+- 意大利新增下滑 41%（n=12）
+- 波兰增长 18%（n=8）
+"""
+
+BAD = """# 不是升级，而是重构
+
+值得注意的是，这不是技术升级，而是生产关系的重构。前面提到的数据有误，正确口径是 18GWh。我们要把这个点钉死。
+"""
+
+QUOTE = """研究员 A 说：“这不是周期问题，而是结构问题。” 两人对出货量的估计相差 10%（4.2GWh 对 3.8GWh）。"""
+
+EVID_OK = """| 编号 | 事实或数字 | 来源 | 级别 | 日期 | 置信度 | 核验状态 | 核验人 |
+|---|---|---|---|---|---|---|---|
+| S01 | 德国新增 3.0GW | bnef.com | A | 2026-01-15 | 高 | 已开页 | 本人 |
+| S02 | 回本期 9.4 年 | bnef.com | A | 2026-01-15 | 高 | 已开页 | 本人 |
+"""
+
+EVID_BROKEN = """| 编号 | 事实或数字 | 来源 | 级别 | 日期 | 置信度 | 核验状态 | 核验人 |
+|---|---|---|---|---|---|---|---|
+| S01 | 德国新增 3.0GW | bnef.com | A | 2026-01-15 | 高 | 已开页 | 本人 |
+| S01 | 重复的一条 | bnef.com | A | 2026-01-15 | 高 | 已开页 | 本人 |
+| S02 | 未核验的一条 | bnef.com | A | 2026-01-15 | 中 | 未核 | — |
+"""
+
+REPORT_BROKEN = "正文引用了 [S01] 与 [S09]。\n"
+
+
+def run(cmd):
+    return subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8")
+
+
+def main() -> int:
+    try:
+        sys.stdout.reconfigure(encoding="utf-8")
+    except Exception:
+        pass
+    cases = []
+    tmp = pathlib.Path(tempfile.mkdtemp(prefix="omd-selftest-"))
+    try:
+        def write(name, text):
+            p = tmp / name
+            p.write_text(text, encoding="utf-8")
+            return p
+
+        good = write("good.md", GOOD)
+        bad = write("bad.md", BAD)
+        quote = write("quote.md", QUOTE)
+        ev_ok = write("ev_ok.md", EVID_OK)
+        ev_bad = write("ev_bad.md", EVID_BROKEN)
+        rp_bad = write("rp_bad.md", REPORT_BROKEN)
+
+        cases.append(("正常段落应通过", run([sys.executable, str(LINT), str(good), "--quiet", "--strict"]).returncode == 0))
+        cases.append(("对偶句与自我更正应拦下", run([sys.executable, str(LINT), str(bad), "--quiet", "--strict"]).returncode == 1))
+        cases.append(("引用卦话应放行", run([sys.executable, str(LINT), str(quote), "--quiet", "--strict"]).returncode == 0))
+        cases.append(("完好证据清单应通过", run([sys.executable, str(EVID), str(ev_ok), "--report", str(good)]).returncode in (0, 1)))
+        cases.append(("重复编号应拦下", run([sys.executable, str(EVID), str(ev_bad), "--report", str(rp_bad)]).returncode == 1))
+        cases.append(("断链应拦下", "[S09]" in REPORT_BROKEN and run([sys.executable, str(EVID), str(ev_ok), "--report", str(rp_bad)]).returncode == 1))
+        cases.append(("未核验在 strict 下应拦下", run([sys.executable, str(EVID), str(ev_bad), "--strict"]).returncode == 1))
+    finally:
+        for p in tmp.glob("*"):
+            p.unlink()
+        tmp.rmdir()
+
+    ok = True
+    for name, passed in cases:
+        print(("  ok   " if passed else "  FAIL ") + name)
+        ok = ok and passed
+    print("=== selftest " + ("passed" if ok else "failed") + " ===")
+    return 0 if ok else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())