天赐范式第192天：让接口开始能调 —— v0.2.0 落地与三仓库最小复现

天赐范式第192天·第一篇：让接口开始能调 ------ v0.2.0 落地与三仓库最小复现

摘要

兑现 190-1 §2.2"能读 ≠ 能调"------反向方案三硬要求（脱离文章载体 / 可 import 模块 / 术语锚定表）已在 tianci-paradigm v0.2.0 落地，推 GitHub / Gitee / AtomGit 三仓库。最小复现：pip install + import tianci + 四项调用核验全通过（自跑）。路由接口自跑核验：dag_route.route() 调通（自跑，非 T1，T1 仍挂账），f3/f4 未定义已诚实标出。

---

〇、引言：把 ≠ 变成 =

沿用 190-1 的角色约定：正文"我"指主刀（AI 伙伴），不是作者。190-1 §2.2 写的是"能读 ≠ 能调"------八万六千字的 API 白皮书里找不到一句"输入域"。今天把那个 ≠ 换成 =。

---

一、反向方案三硬要求兑现

190-1 §2.2 原文：

CSDN 是印刷厂，不是运行时。 文章能被读，接口必须被调用。能读 ≠ 能调。

反向方案三硬要求：

#	硬要求	兑现
①	脱离文章载体	pip install git+https://gitee.com/windsnowmichael/tianci-framework@6e4c826 --- 从 git 仓库装，不靠 CSDN 文章
②	可 import 模块	import tianci 成功，tianci.__version__ = 0.2.0，94 导出（dir()）
③	术语锚定表	lookup_term('TC-SYS-006c') → {'zh': '存在性熔断', 'en': 'existence fuse', ...}

3/3 兑现。

---

二、三仓库 + 最小复现

2.1 三仓库地址

仓库	地址	用途
GitHub（主仓）	https://github.com/windsnowmichael/tianci-framework	海外
Gitee（镜像）	https://gitee.com/windsnowmichael/tianci-framework	国内
AtomGit（镜像）	https://atomgit.com/gcw_lwUf3sWj/tianci-framework	备份

三仓库一致性核验（git ls-remote）：

6e4c8267d4a72a3df345b1b0f6d25cf4cd3be18c        HEAD  (GitHub)
6e4c8267d4a72a3df345b1b0f6d25cf4cd3be18c        HEAD  (Gitee)
6e4c8267d4a72a3df345b1b0f6d25cf4cd3be18c        HEAD  (AtomGit)

三端 HEAD 指向同一 commit 6e4c826，已对齐。

2.2 最小复现四要素

1. 基线：三仓库 stars/fork/外部调用 = 0（发布时点读数，新建，无历史调用记录）
2. "有效调用"定义 ：import + 函数调用 + 返回值正确------三者齐才算一次有效调用
3. 观察窗口：如实播报，不写"预计验证"
4. 安装命令 ：pip install "git+https://gitee.com/windsnowmichael/tianci-framework@6e4c826"

2.3 四项调用核验

[1] import tianci → version 0.2.0                    ✓
[2] lookup_term('TC-SYS-006c') → zh='存在性熔断'      ✓
[3] existence_fuse(0.70, 'S0', 0.01) → ('S1锁定', 0.005)  ✓
[4] save_state → load_state → TianCiRuntimeV2 恢复（同进程）    ✓
    genome keys (7): genome_version, kind, beta, strategy, equilibrium, restore_force, history
    无 norm、无 conv

四项全通过。

---

三、路由接口自跑核验

本次为自跑，非 T1（T1 = 陌生者凭纯 API 文档调通，仍挂账）。

dag_route.route() 签名：route(f1, f2, f3, f4, f5, name="")

FEATURE_DIMS = ["f1物理实体", "f2时间演化", "f3?", "f4?", "f5有终止"]

f3/f4 诚实标注 ：语义未定义（标"?"），路由逻辑只用 f1/f2/f5。调用时传 False（不激活），与标注一致。f3/f4 为 FEATURE_DIMS 中预留维度位，当前版本未赋予语义------不藏。

本核验为自跑，非外部第三方验证。本文"能调"指自跑可调，外部第三方可调待记录。

---

四、降调栏

降调值：4

接口债务 安装命令已固定为 commit @6e4c826，非语义版本 tag；偿还条件 ：打 tag v0.2.0。预计：第194天。

占位债务 dag_route f3/f4 为预留维度位，当前版本未赋予语义；偿还条件 ：定义 f3/f4 语义，或明确标注为"保留位，永不启用"；预计：第194天。

验证债务 自跑可调已验，外部第三方可调未验；偿还条件 ：真第三方凭 API 文档独立调通并记录；预计：第194天。

制度债务 189-1-D3（三卷积独立性/耦合误差估界）今日未兑现，原因：192 聚焦接口落地未涉及该主题；新 due：第194天。

---

附录：最小复现核验脚本（tianci_192a.py）

# -*- coding: utf-8 -*-
"""
天赐范式 第192天 第一篇
让接口开始能调 ------ v0.2.0 落地与三仓库最小复现

PID: TC-192A-V3.3.30.0
V3.3.30.0 · 2026-10-11

兑现 190-1 §2.2 "能读 ≠ 能调"：
  v0.2.0 已推三仓库，pip install 可装，import tianci 可调。
  三硬要求：脱离文章载体 / 可 import 模块 / 术语锚定表 --- 3/3。

本脚本：最小复现核验（import / version / lookup_term / existence_fuse / save-load 七键）
核验口径：v0.2.0（发文时点已推送版本）。f3/f4 在 v0.2.0 为占位参数
（语义未定义，标 '?'），route(T,T,F,F,T,'CFD') 占位期恒装配 ζ-EKF/Ψ 并行支路 = 9 步。
"""
import sys
sys.stdout.reconfigure(encoding="utf-8")


def bar(s=""):
    print("=" * 74)
    if s:
        print("  " + s)
        print("=" * 74)


def main():
    bar("天赐范式 第192天 第一篇  让接口开始能调")

    # ---------- Part 1  反向方案三硬要求兑现

    bar("Part 1  反向方案三硬要求兑现")

    print("  190-1 §2.2 原文：")
    print("    CSDN 是印刷厂，不是运行时。文章能被读，接口必须被调用。能读 ≠ 能调。")
    print()
    print("  三硬要求：")
    print("    ① 脱离文章载体 --- pip install 从 git 仓库装（@6e4c826，v0.2.0），不靠 CSDN 文章")
    print("    ② 可 import 模块 --- import tianci 成功")
    print("    ③ 术语锚定表 --- lookup_term 按编号查术语")
    print()

    # ---------- Part 2  最小复现（四要素）

    bar("Part 2  最小复现（四要素）")

    print("  要素1 基线：三仓库 stars/fork/外部调用 = 0（发布时点读数，新建）")
    print("  要素2 有效调用定义：import + 函数调用 + 返回值正确")
    print("  要素3 观察窗口：如实播报，不写'预计验证'")
    print("  要素4 安装命令（固定 commit @6e4c826）：")
    print("    pip install git+https://gitee.com/windsnowmichael/tianci-framework@6e4c826")
    print()

    # [1] import + version
    print("  [1] import + version")
    import tianci
    print(f"      import tianci → version {tianci.__version__}")
    assert tianci.__version__ == "0.2.0"
    print("      ✓")
    print()

    # [2] lookup_term
    print("  [2] lookup_term（术语锚定表）")
    r = tianci.lookup_term("TC-SYS-006c")
    print(f"      lookup_term('TC-SYS-006c') → zh='{r['zh']}', en='{r['en']}'")
    assert r["zh"] == "存在性熔断"
    print("      ✓")
    print()

    # [3] existence_fuse
    print("  [3] existence_fuse（存在性熔断算子）")
    result = tianci.existence_fuse(0.70, "S0", 0.01)
    print(f"      existence_fuse(0.70, 'S0', 0.01) → {result}")
    assert result[0] == "S1锁定"
    print("      ✓")
    print()

    # [4] save_state / load_state
    print("  [4] save_state / load_state（基因持久化七键）")
    import tempfile
    import os
    import json
    rt = tianci.TianCiRuntimeV2()
    path = os.path.join(tempfile.gettempdir(), "tianci_192a_genome.json")
    tianci.save_state(rt, path)
    rt2 = tianci.load_state(path)
    with open(path, "r") as f:
        data = json.load(f)
    keys = list(data.keys())
    print(f"      save_state → load_state → {type(rt2).__name__}")
    print(f"      genome keys ({len(keys)}): {', '.join(keys)}")
    assert len(keys) == 7
    assert "norm" not in keys
    assert "conv" not in keys
    print("      ✓ 七键，无 norm 无 conv")
    print()

    # ---------- Part 3  路由接口自跑核验

    bar("Part 3  路由接口自跑核验（dag_route）")

    print("  本次为自跑，非 T1（T1 = 陌生者凭纯 API 文档调通，仍挂账）。")
    print()
    print("  dag_route.route() 签名：route(f1, f2, f3, f4, f5, name='')")
    print("  FEATURE_DIMS = ['f1物理实体', 'f2时间演化', 'f3?', 'f4?', 'f5有终止']")
    print()
    print("  f3/f4 诚实标注：v0.2.0 为占位参数，语义未定义（标'?'），不消费、不承诺。")
    print("  本核验为自跑，非外部第三方验证（B4 双列记录见仓库内 known-gaps.md §6）")
    print()

    # v0.2.0 语义：f3/f4 占位期恒装配 ζ-EKF/Ψ 并行支路 → 9 步
    dag, steps, note = tianci.route(True, True, False, False, True, name="CFD")
    print(f"  route(True, True, False, False, True, 'CFD') → {steps}步")
    print(f"    DAG: {dag}")
    print(f"    注: {note}")
    print()

    # ---------- 收尾

    bar("收尾")
    print("  190-1 §2.2 '能读 ≠ 能调' → 192 '能读 = 自跑可调'（pip install + import + call）")
    print("  三硬要求 3/3，最小复现 4/4，路由接口自跑核验 dag_route 调通。")
    print("  T1（陌生者凭纯 API 文档调通）仍挂账，待真第三方执行。")
    print("  核验对象：v0.2.0（已推送三仓库，pip install @6e4c826 可装）。")


if __name__ == "__main__":
    main()

版本 ：v3.3.30.0 ｜ 日期 ：2026-10-11 ｜ 新算子 ：0

一句话：能读 ≠ 能调 → 能读 = 自跑可调，三硬要求 3/3，最小复现 4/4。

系列还在逐步建设中，完善是我们与伙伴们共同努力的方向。