@hawk2048/oh-my-dsh 0.3.6 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # 变更记录
 
+## 0.4.1 — 2026-11-06
+
+按一次真实写作的反馈改的两处。
+
+- `evidence_check.py`：不再取文件里第一张表，改为找带「编号」表头的那张。之前来源表放在文末、正文另有特征表时，会读错表并报出空结果。
+- `omd-plain-writing`：新增「读者凭什么认定这是 AI 写的」一节，把五个特征按被识破的容易程度排成表，对偶句排第一，并补一条反向检查：如果读者要用这五条指认我，他会指向哪几句。
+
+## 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.1",
   "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,154 @@
+#!/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 table_blocks(text: str):
+    """把文件里所有连续的表行切成块，每块是一组行。"""
+    blocks, cur = [], []
+    for ln in text.splitlines():
+        if ln.strip().startswith("|"):
+            cur.append(ln.strip())
+        elif cur:
+            blocks.append(cur)
+            cur = []
+    if cur:
+        blocks.append(cur)
+    return blocks
+
+
+def parse_table(text: str):
+    """找带「编号」表头的那张表。返回 (headers, rows)。
+
+    文件里常有别的表（特征表、对比表），按第一张取会读错表。
+    """
+    for block in table_blocks(text):
+        header = [c.strip() for c in block[0].strip("|").split("|")]
+        keys = [HEAD_ALIASES.get(h, h) for h in header]
+        if "id" not in keys:
+            continue
+        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
+    return [], []
+
+
+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())

package/skills/omd-plain-writing/SKILL.md

@@ -15,6 +15,24 @@ description: "说人话：生成期的写作纪律——落笔前先定具体事
 2. **判断句用动词，不用比喻**。写「成本降了 18%」，不写「成本打了个翻身仗」。
 3. **一段只讲一件事**，段首句就是这件事。
 
+## 读者凭什么认定这是 AI 写的
+
+五条，按被识破的容易程度排。写的时候一条一条避开。
+
+| 特征 | 人写的样子 | 怎么改 |
+|---|---|---|
+| 对偶拔高 | 只留成立的那半句 | 「不是 A，而是 B」删掉否定半句 |
+| 句长均匀 | 上一句八个字，下一句六十个字 | 长句拆开，短句留着，别都压到二十来字 |
+| 段尾必总结 | 事实写完就停 | 删掉每段最后一句，还成立就别加回去 |
+| 专名缺席 | 有公司名、人名、日期 | 每个判断至少落到一个能查的主体 |
+| 名词化 | 「改顺了」「快了三成」 | 「进行了优化」改成动词 |
+
+排第一的是对偶句。它一句话里做两次断言，读者要读完后半句才知道作者想说什么。
+
+第四条最伤可信度。一句「头部厂商正在加速布局」，换成任何行业都成立，读者立刻知道作者没查过。
+
+写完之后倒过来检查一遍：如果读者要用这五条指认我，他会指向哪几句。指到的那几句就是该改的。
+
 ## 不写这四种句式
 
 句式比词更要紧：词能换，句式会反复长出新词。