Skip to content

test(douyin): 模块化 PR1 —— 契约测试与 test:douyin / test:fast - #142

Merged
Britneycode merged 1 commit into
mainfrom
refactor/douyin-pr1-contract-tests
Nov 18, 2026
Merged

Britneycode merged 1 commit into
mainfrom
refactor/douyin-pr1-contract-tests

Conversation

@Britneycode

Copy link
Copy Markdown
Owner

Why

douyin-adapter-plan.md 已确认要把抖音模块从网关里抽出来。这个 PR 是第一步:把「抖音在网关里承诺的 4 条安全行为」钉成显式契约,后面 PR2~PR5 把实现搬进适配器时,这些断言必须继续绿。CI 上只加、不改旧测试,是最安全的入口。

改动范围

  • 新增 test/douyin-contract.mjs:8 条断言,覆盖 4 条保证。
  • test/parallel.mjs:加 --only <regex> / --skip <regex>,并发数仍取位置参数。默认行为不变。
  • package.json:scripts.test 链最前面追加 node test/douyin-contract.mjs;新增 test:douyin(只跑文件名含 douyin 的)和 test:fast(跳过 douyin / browser)两个本地快捷脚本。

不改行为、不改默认值、不动数据库结构、不改 lib/。

四条契约与反向验证

# 契约 破坏方式 红几条
① 昵称不授权(onDouyinMessage / isMasterChannel / sessionOpenFor) 删掉 isIdentityKey(m?.userId) 拦截 1
② 没有 convId 就拒发(sendDouyin / sendReply) 删掉 /^0:1:\d+:\d+$/ 校验 2
③ 重发带原会话 ID(outbox enqueue / flush) enqueue 落库时丢 convId 2
④ 结果未知不自动重发(outbox 重启时 sending → unknown) sending 改转 queued 1

四条都已手工破坏并确认测试红,然后还原。

验证

  • 全量 npm test:159 套件通过(含新契约测试与 check-test-chain 自指检查)。
  • git diff --stat test/:只有 test/douyin-contract.mjs(新增)和 test/parallel.mjs(改),旧测试一行未改。
  • 模拟验证,未做真机。

回滚

git revert,无数据迁移。

把「抖音在网关里承诺的 4 条安全行为」钉成显式契约,供 PR2~PR5 重构前后对照:

1. 昵称不授权:onDouyinMessage 拒收、isMasterChannel/sessionOpenFor 对抖音恒 false、
   masterUid 没填时 masterDouyinIdentity/masterDouyinConvId 为空
2. 没有 convId 就拒发:sendDouyin 对空 / 格式错 / 群聊形状一律 ok:false 且通道 send 次数为 0;
   sendReply 缺 st.convId 时不发
3. 重发带原会话 ID:outbox.enqueue 落 conv_id,模拟重启后重发仍带同一个 convId
4. 结果未知不自动重发:outbox sending → unknown(不转 queued),conv_id 保留供人工核实

新增 test/douyin-contract.mjs(8 断言);进 scripts.test 链 + CI 自指检查。
test/parallel.mjs 加 --only/--skip <regex>(并发数仍取位置参数)。
package.json 加 test:douyin / test:fast 两个本地快捷脚本。

反向验证(PR 描述里要列):
① 撤掉 sendDouyin 的 /^0:1:\d+:\d+$/ 校验 → 红 2 条
② enqueue 落库时丢 convId → 红 2 条
③ onDouyinMessage 不再拦昵称身份 → 红 1 条
④ 重启时 sending 直接转 queued(不标 unknown)→ 红 1 条

不改行为、不改默认值、不动数据库结构;旧测试一行未改。
全量 npm test:159 套件通过。
@Britneycode
Britneycode merged commit c646bd0 into main Nov 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant