Files
tdc-rs/scripts/upstream-test-ledger.tsv
adminandClaude Code 1a0fdbf879 feat(upstream-parity): 移植上游测试用例 —— 29 条对位用例 + 第五把尺子
**影响**
- 生产档弱密钥守卫从「只比默认值」升级为上游 `ProdGuard` 的**六条判据**(纯函数),
  弱令牌用「默认值加后缀」绕过、弱标记词、长度下限三类都拦得住;`CIPHER_KEY`(协议共享值)**不受管**。
- 出向 TDS 超时**外置到 env**(`SSW_TDS_CONNECT_TIMEOUT_MS` / `SSW_TDS_READ_TIMEOUT_MS`),
  且**只有 cause 链里真有超时**才改写文案 ⇒ 连接被拒 / DNS 失败不再被误报成「超时」(排查方向不被带偏)。
- 上游 15 个测试类全部**登记在册**:3 个已移植(29 条对位用例)、12 个判定超范围(逐条记理由)。
- 新增第五把尺子 `scripts/check-upstream-tests.sh`:台账 ⇄ 代码 ⇄ 上游测试类集合三向对账,
  上游新增测试类而台账没登记 ⇒ **红**(不靠"记得看"防漂移)。
- 回归网:`cargo test` 246 → **278**(+32),其余四把尺子与引用自检**全绿**。

**改动**
- `src/platform/guard.rs`(新):上游 `ProdGuard.violations` 的纯函数移植(弱值清单 / 弱标记词整体词匹配 / `MIN_LEN=12` / 逐条点名)。
- `src/platform/config.rs`:`check_secret_guard` 改走守卫判据;新增 `guard_values`(只放本部署真有的键)
  与出向超时两项配置(非法值回落默认,不让连接器起不来)。
- `src/tdc/client/tds.rs`:新增 `cause_chain_has_timeout` / `timeout_text_or_null`(cause 链遍历**有界** `depth<16`),
  `TdsClient::with_timeouts` 接受超时。
- `tests/upstream_guard_parity.rs`(新 · 19 条)+ `tests/upstream_tds_timeout_parity.rs`(新 · 10 条)。
- `scripts/upstream-test-ledger.tsv`(台账真源)+ `scripts/upstream-test-census.py`(上游测试类普查/对账)
  + `scripts/check-upstream-tests.sh`(第五把尺子)。
- 文档:`docs/UPSTREAM-TEST-PARITY.md`(新)+ `docs/known-limitations.md` L8 + `docs/decisions.md` D22/D23
  + `CLAUDE.md` 同步(尺子表 / 目录树 / 命令速查 / 实现细节 22–23 / 坑位表)。

**设计**
- 上游 hop 1 的「反射读 socket 工厂」**抄不了**(`reqwest::Client` 不暴露超时 getter)⇒ 改用**行为级**判别
  (同一延迟 TCP 服务器:短超时⇒超时错、长超时⇒成功)⇒ 结论等价且更强(真跑 socket 层)。
- 上游 `*SelfTest.java` **surefire 不跑**(无统一入口)⇒ 判据落成 `cargo test` 常规用例(纯函数 ⇒ 可离线断言)。
- 超范围判定原则:**本仓没有对应功能 ⇒ 不搬**(硬搬只会是假绿);「机制」已覆盖的(P2P 那条)按机制记账。

Co-Authored-By: Claude Code <[email protected]>
2026-10-27 09:04:08 +08:00

7.6 KiB

1# 上游测试用例台账(tdc-rs ↔ 上游 TDC/TDS/ssw-common)
2#
3# 🔴 **本文件是「上游有哪些测试用例、我们搬没搬」的唯一真源** ⇒
4# `scripts/check-upstream-tests.sh` 对账(上游新增一个测试类而台账没记 ⇒ 红)。
5#
6# 列(制表符分隔):
7# 1 upstream_class 上游全限定类名(ssw.common.guard.ProdGuardSelfTest …)
8# 2 upstream_repo TDC | TDS | COMMON(ssw-common 两侧都有 ⇒ 记 COMMON)
9# 3 upstream_file 相对**克隆根目录**的路径(克隆根可用环境变量覆盖)
10# 4 kind JUNIT(有 @Test,surefire 跑)| SELFTEST(纯 main,**surefire 不跑**)
11# 5 assertions 上游断言条数(`-` = 未逐条计数)
12# 6 tdc_counterpart 本仓对位用例:`文件::fn1+fn2+…`(`-` = 无对位)
13# 7 status PORTED | OUT-OF-SCOPE
14# 8 reason 搬法说明(PORTED)/ 不搬的理由(OUT-OF-SCOPE)
15#
16# ⚠️ 上游的 `*SelfTest.java` **没有 runner 接线**(surefire 只跑 junit 的 `@Test`)
17# ⇒ 上游仓库自己靠 `tools/run-java-selftests.sh` 人工跑
18# ⇒ 本仓把它们落成 `cargo test` 的常规用例(判据是纯函数 ⇒ 可离线断言)。
19#
20# ⚠️ 台账里的 `upstream_file` 只在**上游克隆在场**时才校验;克隆不在 ⇒ 跳过该校验(不判红)。
21ssw.common.guard.ProdGuardSelfTestCOMMONboot/ssw-common/ssw-common-biz/src/test/java/ssw/common/guard/ProdGuardSelfTest.javaSELFTEST10tests/upstream_guard_parity.rs::prod_guard_cipher_key_is_not_guarded+prod_guard_default_weak_values_are_still_blocked+prod_guard_strong_values_are_all_allowed+prod_guard_blank_value_is_named+prod_guard_default_value_with_suffix_is_blocked+prod_guard_too_short_value_is_blocked+prod_guard_violation_message_names_the_key+prod_guard_absent_key_is_not_falsely_blocked+prod_guard_exact_weak_value_is_blocked+prod_guard_weak_marker_word_is_blocked+prod_guard_weak_marker_is_whole_word_only+prod_guard_min_len_is_enforcedPORTED六条判据逐条照抄上游 ProdGuard.violations(缺一即空检查):①键不在map⇒跳过 ②值为null/空白⇒违规 ③精确等于弱值⇒违规 ④含弱值片段⇒违规(反绕过)⑤含弱标记词⇒违规 ⑥长度<12⇒违规;上游⓪「security.security-key 不再受管」映射为「CIPHER_KEY(协议共享值)不受管」
22ssw.tds.controller.SswProdRuntimeGuardSelfTestTDSboot/ssw-tds/ssw-tds-controller/src/test/java/ssw/tds/controller/SswProdRuntimeGuardSelfTest.javaSELFTEST12tests/upstream_guard_parity.rs::runtime_guard_non_prod_never_violates+runtime_guard_prod_with_empty_token_violates+runtime_guard_prod_with_null_token_violates_without_panic+runtime_guard_prod_with_default_token_violates+runtime_guard_prod_with_strong_token_passes+runtime_guard_is_discriminable_on_the_prod_switch+runtime_guard_no_deployment_flag_unlocks_a_weak_tokenPORTED10 条里搬了 7 条;未搬的 3 条(② prod+codeDev / ⑧ 未声明测试环境 / ⑨ 已声明测试环境)全属**门户验证码通道**(ssw.portal.code-dev)⇒ 本仓无该通道 ⇒ 记 OUT-OF-SCOPE-PART(见 docs/known-limitations.md L8)
23ssw.tdc.client.ProviderInvokeTimeoutsSelfTestTDCboot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/ProviderInvokeTimeoutsSelfTest.javaSELFTEST11tests/upstream_tds_timeout_parity.rs::hop1_injected_timeout_actually_reaches_the_socket_layer+hop1_changing_the_injected_value_changes_the_client+hop2_read_timeout_is_rewritten_and_names_current_values+hop2_connect_timeout_is_rewritten+hop2_connection_refused_is_not_rewritten+hop2_dns_failure_is_not_rewritten+hop2_no_cause_is_not_rewritten+hop2_multilevel_wrapped_cause_is_still_detected+hop2_cause_chain_walk_is_bounded+hop2_end_to_end_connection_refused_stays_unreachablePORTED第1跳(配置值⇒socket工厂)用**行为级**判别替代反射(Rust 的 reqwest::Client 不暴露超时):短超时⇒超时、长超时⇒成功 ⇒ 结论等价且更强;第2跳照抄(只有 cause 链里有超时才改写文案,被拒/DNS/无cause⇒不改写)
24ssw.tdc.service.impl.P2pTransferTimeoutsSelfTestTDCboot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/service/impl/P2pTransferTimeoutsSelfTest.javaSELFTEST--OUT-OF-SCOPE与 ProviderInvokeTimeoutsSelfTest **同一机制**(反射读 socket 工厂),但判据对象是 **P2P 传输客户端**(P2pTransferClient)⇒ 本仓**没有 P2P 出向通道**(P2P 属上游跨端传输能力,不在本仓范围)⇒ 无判据对象可搬;机制本身已由 ProviderInvoke 那条覆盖
25ssw.tdc.support.ExecNfsSupportTestTDCboot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/support/ExecNfsSupportTest.javaJUNIT10-OUT-OF-SCOPE执行侧 **NFS 通道**(ExecNfsSupport.subPath / 拒绝判据)⇒ 属隐私计算执行面,依赖 Nax 引擎 ⇒ 本仓明确不做(见 CLAUDE.md「明确不在本仓库范围」)
26ssw.tdc.engine.NaxPodSupportTestTDCboot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/engine/NaxPodSupportTest.javaJUNIT13-OUT-OF-SCOPE**Nax 隐私计算引擎** + K8s 拓扑(NodePort 派生 / 探针源码 / tar.gz 投递物)⇒ 本仓不做
27ssw.tdc.client.NaxExecRenderTestTDCboot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/NaxExecRenderTest.javaJUNIT4-OUT-OF-SCOPENax 执行 **Pod 模板渲染契约**(YAML 空值删行陷阱)⇒ 依赖 K8s + Nax ⇒ 本仓不做
28ssw.tdc.client.K8sSandboxClientRenderTestTDCboot/ssw-tdc/ssw-tdc-biz/src/test/java/ssw/tdc/client/K8sSandboxClientRenderTest.javaJUNIT2-OUT-OF-SCOPE沙箱执行 **Pod 模板渲染契约** ⇒ 依赖 K8s ⇒ 本仓不做
29ssw.tds.support.MaxkeyRegisterPrecheckSelfTestTDSboot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/support/MaxkeyRegisterPrecheckSelfTest.javaSELFTEST--OUT-OF-SCOPE**MaxKey SSO** 的应用注册预检 ⇒ 本仓不实现 MaxKey SSO(`/Auth/SsoConfig` 恒 `enabled:false`,见 docs/known-limitations.md L2)
30ssw.tds.service.MaxkeyAppRegistrarLogicSelfTestTDSboot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/service/MaxkeyAppRegistrarLogicSelfTest.javaSELFTEST--OUT-OF-SCOPEMaxKey 应用登记**编排判据**(人工优先 / 不抛异常 / 预检先于调用)⇒ 同上:本仓无 MaxKey 侧
31ssw.tds.client.MaxkeyMgtClientLiveSelfTestTDSboot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/client/MaxkeyMgtClientLiveSelfTest.javaSELFTEST--OUT-OF-SCOPE**实机**打真 MaxKey(登录→建应用→授权→回读→退租;未配环境变量 ⇒ 退出码 4 = UNVERIFIED)⇒ 本仓无 MaxKey 侧,且该用例本质是**平台侧**实机联调
32ssw.tds.crypto.CertSignerStrictSelfTestTDSboot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/crypto/CertSignerStrictSelfTest.javaSELFTEST--OUT-OF-SCOPE**CA 签发严格模式**(prod 档缺根证书必抛 / 合法 SM2 根必放行)⇒ 本仓不做 CA 签发(软 PKI 由上游 scard 安全平面承担)
33ssw.tds.service.GuardAlertTypeSelfTestTDSboot/ssw-tds/ssw-tds-biz/src/test/java/ssw/tds/service/GuardAlertTypeSelfTest.javaSELFTEST--OUT-OF-SCOPE**守门告警类型名长度不变式**(`GUARD_` + 原因 ≤ 列宽;实测曾 33 > varchar(30) ⇒ 告警静默丢库)⇒ 该告警表在 TDS 侧,本仓无对应表
34ssw.common.util.IpWhitelistUtilTestCOMMONboot/ssw-common/ssw-common-biz/src/test/java/ssw/common/util/IpWhitelistUtilTest.javaJUNIT13-OUT-OF-SCOPE**IP 白名单**(CIDR / 全放 / 归一 / 畸形 fail-closed)⇒ 本仓**没有**该功能(入向鉴权只认内部令牌 + 会话令牌)
35ssw.common.util.SswLLMClientTestCOMMONboot/ssw-common/ssw-common-biz/src/test/java/ssw/common/util/SswLLMClientTest.javaJUNIT17-OUT-OF-SCOPE**LLM 客户端**(内部代理 URL 解析 / OpenAI / Anthropic 后缀 / 业务错误 JSON)⇒ 本仓**没有** LLM 客户端