2026Technology-Competition/tests/test-cases.md

测试用例清单

来源：tests/*.test.ts 中 suite() / test() 声明。共 24 个测试文件、179 条用例。

1. adapter.test.ts — Adapter Tests（6）

#	用例	覆盖点
1	ESLintAdapter has correct id and languages	适配器标识与支持语言
2	StylelintAdapter has correct id and languages	适配器标识与支持语言
3	ESLintAdapter check returns AdapterResult structure	静态分析返回结构
4	ESLintAdapter surfaces octal literal as eslint:parse-error	八进制字面量解析错误上报
5	ESLintAdapter surfaces \8 escape as eslint:parse-error	非法转义解析错误上报
6	ESLintAdapter parses JSX in .js without parse error	JSX 语法解析

2. ai-empty-response.test.ts — AI Empty Response Handling（6）

#	用例	覆盖点
7	parseJsonResponse throws empty-response error on blank input	空响应识别
8	parseJsonResponse parses valid JSON normally	正常 JSON 解析
9	chatWithRetry retries once on EmptyContentError	空内容自动重试
10	chatWithRetry propagates error when retry also returns empty	重试仍空则抛错
11	chatWithRetry does not retry on non-empty-content errors	非空内容错误不重试
12	openai-compatible reports max_tokens truncation clearly	token 截断提示

3. ai-fix-engine.test.ts — AI FixEngine Tests（4）

#	用例	覆盖点
13	aiFixDiagnostic applies AI fix and converges	AI 修复收敛
14	aiFixDiagnostic returns ai-match-failed when originalText not found	原文未匹配
15	aiFixDiagnostic returns ai-no-fix when AI provides empty fix	AI 无修复
16	aiFixDiagnostic retries until issue resolved within maxIterations	迭代上限内收敛

4. config.test.ts — Config Tests（4）

#	用例	覆盖点
17	getAIConfig returns default values	AI 配置默认值
18	AI individual getters return defaults	单项配置 getter
19	getLinterForLanguage returns configured linter	语言→linter 映射
20	getFixMaxIterations returns default	修复迭代默认值

5. customFixEngine.test.ts — Custom FixEngine Tests（5）

#	用例	覆盖点
21	aiFixReviewIssue applies AI fix and converges after verify	自定义规则 AI 修复收敛
22	aiFixReviewIssue returns ai-match-failed when originalText not found	原文未匹配
23	aiFixReviewIssue retries until verify passes within maxIterations	验证驱动重试
24	aiFixReviewIssue accepts last fix when verify never passes	验证不过时接受最后修复
25	aiFixReviewIssue retries empty fix once then fails with ai-no-fix	空修复重试一次后失败

6. dedup-prompt.test.ts — Dedup Prompt Tests（3）

#	用例	覆盖点
26	buildDedupOnlyPrompt 同时提供静态规则与自定义规则	去重 prompt 组装
27	自定义规则时包含静态规则	去重 prompt 规则合并
28	buildKnownRulesSection 生成的规则包含全部	已知规则段完整性

7. diagnostics.test.ts — DiagnosticMarkers Tests（6）

#	用例	覆盖点
29	toVscodeDiagnostics maps severity correctly	严重级别映射
30	toVscodeDiagnostics preserves range	范围保留
31	toVscodeDiagnostics prefixes message with plugin and linter	消息前缀
32	toVscodeDiagnostics handles ruleId without linter prefix	无前缀 ruleId
33	toVscodeDiagnostics sets source and code for quick fix hover	hover 修复来源/代码
34	toVscodeDiagnostics returns empty array for empty input	空输入

8. fixEngine.test.ts — FixEngine Tests（5）

#	用例	覆盖点
35	ESLint adapter attaches fix object for autofixable issues	可自动修复诊断挂 fix
36	fixDiagnostic multi-round convergence produces applied fixes	多轮修复收敛
37	fixDiagnostic returns not-autofixable for non-fixable rule	不可修复规则
38	fixDiagnostic no-change returns no-change	无变化场景
39	fixDiagnostic fixes only the targeted issue, not adjacent same-rule instance	定点修复不误伤相邻同类

9. fixSession.test.ts — FixSession Tests（6）

#	用例	覆盖点
40	add/get/has roundtrip	会话读写
41	get returns undefined for missing key	缺失键
42	getEntries filters per uri	按 uri 过滤
43	clear removes entries for uri only	按 uri 清理
44	recordFixes merges multi-round fixes under same key	多轮修复合并
45	undo restores original text via workspace edit	撤销恢复原文

10. import-dedup.test.ts — Import Dedup Tests（25）

#	用例	覆盖点
46	重复规则：全局检查并标注	全局重复检查
47	全局 exact：全部标注	exact 去重
48	全局 overlap：全部检查并标注	overlap 去重
49	跨规则 exact 标注（overlap 归 none）	跨规则 exact 归属
50	用户指定 exact 后取消标注	用户决策 exact
51	用户标注 overlap 将标注加 # 前缀	overlap 标注头
52	用户标注 none 加 # 前缀	none 标注头
53	已标注 duplicateLevel/duplicateOf/duplicateReason 剔出标注	已标注剔除
54	标注规则 duplicateReason 标注头回填原由	原因回填
55	编辑 description 确认 YAML 使用该值	description 编辑
56	编辑 severity 确认 YAML 使用该 severity	severity 编辑
57	编辑 languages 确认 YAML 有 languages	languages 编辑
58	编辑切换为标注、标注转为编辑值	编辑/标注互转
59	无编辑时保留原始 yamlContent	原始内容保留
60	severity 缺失默认为 warning	severity 默认
61	severity 非法值默认为 warning	severity 兜底
62	id 缺失生成 rule-N	id 自动命名
63	多个 id 缺失依次 rule-1, rule-2...	递增命名
64	description 缺失时使用 message（中文存在）	双语回退
65	message 缺失时使用 description（中文存在）	双语回退
66	description 与 message 同时缺失时兜底	全缺失兜底
67	重复规则的重复校验回归	去重回归
68	id 带引号、字段带引号保留 id	引号 id
69	scalar 字段带引号、保留引号	引号 scalar

11. merger.test.ts — Merger Tests（12）

#	用例	覆盖点
70	mergeResults counts correctly	计数正确
71	mergeResults marks degraded when AI fails	AI 失败降级
72	mergeResults sorts diagnostics by severity then line	排序
73	mergeResults marks fixable only diagnostics with fix object	可修复标记
74	mergeResults converts aiFindings line to 0-based	行号 0 基化
75	mergeResults pairs translations by originalRuleId not index	按规则 id 配对翻译
76	mergeResults handles duplicate ruleId translations in order	重复 id 有序
77	mergeResults matches translations by normalized ruleId when prefix missing	缺前缀归一化匹配
78	mergeResults matches translations by normalized ruleId with slash variant	斜杠变体匹配
79	mergeResults prefers exact ruleId match over normalized	精确匹配优先
80	mergeResults computes aiFixableLinterIndices excluding native fix and sqlfluff	AI 可修复索引
81	mergeResults aiFixableLinterIndices empty when AI unavailable	AI 不可用置空

12. messages.test.ts — I18n Tests（9）

#	用例	覆盖点
82	all message keys have values for all three languages	三语 key 完整
83	default language is zh-CN	默认语言
84	setLanguage changes current language	语言切换
85	t() falls back to key when key does not exist	缺失 key 回退
86	t() returns zh-CN string in zh-CN language	中文翻译
87	t() returns English string in en language	英文翻译
88	t() returns Japanese string in ja language	日文翻译
89	t() with template variables	模板变量
90	t() with multiple template variables	多模板变量

13. pipeline.test.ts — Pipeline Tests（1）

#	用例	覆盖点
91	Full pipeline: linter check + merge	全链路（linter + 合并）

14. rule-filter.test.ts — Rule Filter Tests（15）

#	用例	覆盖点
92	规则匹配当前语言	语言匹配
93	规则未匹配被过滤	不匹配过滤
94	规则为空：全部保留	空规则集
95	规则缺失：全部保留	缺失过滤
96	规则按语言匹配后去重	去重
97	规则未匹配语言则去除	语言不匹配去除
98	规则为空时去重	空集去重
99	规则 + 语言映射匹配时过滤结果优先	优先级
100	typescriptreact 同源映射到 typescript	TSX 映射
101	plsql 同源映射到 sql	PL/SQL 映射
102	JSP 映射 java 规则	JSP→Java
103	JSP 不映射 css 规则	JSP→CSS 排除
104	普通 HTML 触发 JSP 过滤 java 规则	HTML→JSP
105	全部过滤触发 skippedRequestA=true	全过滤标记
106	部分过滤触发 skippedRequestA=false	部分过滤标记

15. sqlfluff-prs.test.ts — SqlFluff PRS Tests（4）

#	用例	覆盖点
107	buildPRSMessage extracts fragment from description	PRS 片段提取
108	buildPRSMessage flattens newlines in fragment	换行压平
109	buildPRSMessage truncates long fragments	长片段截断
110	buildPRSMessage falls back to description when pattern missing	无匹配回退

16. sqlfluff-range.test.ts — SqlFluff Range Tests（6）

#	用例	覆盖点
111	full positions convert to zero-based range	完整位置 0 基化
112	missing end positions fall back to start (comment JJ01 case)	缺终点回退（JJ01）
113	legacy line_no/line_pos keys are honored	旧版 key 兼容
114	null positions fall back to defaults	null 兜底
115	zero positions are clamped to valid values	零值钳制
116	missing all positions produce a safe zero range	全缺失安全范围

17. jsp-extractor.test.ts — JspExtractor Tests（9）

#	用例	覆盖点
117	extracts script block as javascript	script 块提取
118	extracts style block as css	style 块提取
119	extracts statement scriptlet with line offset	语句型 scriptlet
120	extracts declaration scriptlet	声明型 scriptlet
121	extracts expression scriptlet	表达式型 scriptlet
122	skips directives and comments	指令/注释跳过
123	reports sourceStart/sourceEnd positions	源区间定位
124	returns empty array for plain html	纯 HTML 无段落
125	collects script, style and scriptlet sections	多段落收集

18. report.test.ts — Report Tests（7）

#	用例	覆盖点
126	renders header metadata	报告头元数据
127	renders empty report with no-problems banner	空报告无问题提示
128	renders linter diagnostics with severity emoji and suggestion	严重级 emoji 与建议
129	renders custom rule diagnostics	自定义规则段
130	renders ai findings with category and suggestion	AI 发现段
131	renders degraded banner and errors section	降级横幅与错误区
132	omits tools line when no adapters	无工具时不显示

19. method-extractor.test.ts — MethodExtractor Tests（9）

#	用例	覆盖点
133	fallback regex finds js function declarations and arrow functions	JS 方法兜底正则
134	fallback regex finds java methods	Java 方法兜底正则
135	fallback regex returns empty for unsupported language	不支持语言返回空
136	extractMethodScope returns code, signature and callers	方法作用域+调用者
137	extractMethodScope identifies callees	被调用者识别
138	expandToMethodBody ignores braces inside strings and comments	括号配对（跳过字符串/注释）
139	extractSignature strips leading comments	签名去注释
140	inferRole maps getter, process and generic names	角色推断
141	extractMethodScope returns null when range matches no method	无命中返回 null

20. fix-prompt.test.ts — FixPrompt Tests（10）

#	用例	覆盖点
142	buildFixSystemPrompt defaults to Chinese	中文系统提示词
143	buildFixSystemPrompt returns English variant	英文系统提示词
144	buildFixSystemPrompt returns Japanese variant	日文系统提示词
145	buildFixUserPrompt includes issue, message and context	用户提示词组装
146	buildFixUserPrompt includes suggestion when present	建议追加
147	buildFixUserPrompt omits suggestion when blank	空建议省略
148	buildFixContext windows around line with padding	上下文窗口+对齐
149	buildFixContext clamps at document boundaries	边界钳制
150	buildVerifySystemPrompt has language variants	校验系统提示词
151	buildVerifyUserPrompt includes issue and code	校验用户提示词

21. registry.test.ts — Provider Registry Tests（7）

#	用例	覆盖点
152	returns empty when no extension uri	无 URI 返回空
153	loads builtin providers from extension providers.json	内置 Provider 加载
154	caches providers across calls	注册表缓存
155	invalidateProviderCache forces reload	缓存失效
156	returns empty for missing or invalid providers.json	缺失/非法文件
157	getProviderById finds or misses	按 ID 查询
158	getAllProviderMeta returns name and models	Provider 元数据

22. provider-chat.test.ts — Provider Chat Tests（11）

#	用例	覆盖点
159	openai chat returns content with bearer auth	OpenAI 兼容协议成功
160	openai 401 throws invalid key error	401 无效密钥
161	openai truncation raises EmptyContentError	token 截断空响应
162	openai empty content raises EmptyContentError	空内容错误
163	openai other status throws	其他状态报错
164	gemini chat returns text	Gemini 协议成功
165	gemini empty content raises EmptyContentError	Gemini 空响应
166	gemini non-ok throws	Gemini 报错
167	claude chat returns text with api key header	Claude 协议成功
168	claude 401 throws	Claude 401
169	claude empty content raises EmptyContentError	Claude 空响应

23. import-service.test.ts — ImportService Tests（7）

#	用例	覆盖点
170	parseImportableYaml handles arrays and quoted ids	YAML 数组/引号
171	parseImportableYaml fills message from description and vice versa	字段互填
172	buildFinalYaml uses edited rules when present	编辑规则分支
173	buildFinalYaml comments exact duplicates and strips duplicate metadata	精确重复注释
174	buildFinalYaml keeps all when no overrides	无覆盖全保留
175	applyConversion writes final yaml to nested target path	写入目标文件
176	convert throws for unsupported extension	不支持格式报错

24. yaml-parser.test.ts — YamlParser Tests（3）

#	用例	覆盖点
177	returns empty when rules dir missing	目录缺失
178	loads rules from yaml files with severity normalization	规则加载与严重级归一
179	skips incomplete rules and non-yaml files	不完整规则/非 yaml 跳过

统计

文件	用例数
adapter.test.ts	6
ai-empty-response.test.ts	6
ai-fix-engine.test.ts	4
config.test.ts	4
customFixEngine.test.ts	5
dedup-prompt.test.ts	3
diagnostics.test.ts	6
fixEngine.test.ts	5
fixSession.test.ts	6
import-dedup.test.ts	25
merger.test.ts	12
messages.test.ts	9
pipeline.test.ts	1
rule-filter.test.ts	15
sqlfluff-prs.test.ts	4
sqlfluff-range.test.ts	6
jsp-extractor.test.ts	9
report.test.ts	7
method-extractor.test.ts	9
fix-prompt.test.ts	10
registry.test.ts	7
provider-chat.test.ts	11
import-service.test.ts	7
yaml-parser.test.ts	3
合计	179