import { describe, it, expect, vi, beforeEach } from 'vitest' const mockOpenURL = vi.fn().mockResolvedValue(true) vi.mock('react-native', () => ({ Linking: { openURL: (...args: any[]) => mockOpenURL(...args), }, StyleSheet: { create: (s: any) => s, hairlineWidth: 1, }, })) import { sanitizeAndValidateHref, isCitationLink, formatDisplayUrl, classifyMarkdownLink, openSafeExternalUrl, decodeSessionMentionUri, decodeBase64ToBytes, decodeUtf8Bytes, parseDshFileLink, classifyDshWebBrand, classifyDshLinkPath, } from '../src/ui/link-helpers' describe('会话链接排版与交互系统 (Link & Citation System)', () => { beforeEach(() => { mockOpenURL.mockClear() }) describe('1. 严格协议白名单校验与安全清洗 (sanitizeAndValidateHref)', () => { it('阻断危险伪协议 (javascript:, data:, vbscript:, file:, blob: 等)', () => { const dangerous = [ 'javascript:alert(1)', 'JAVASCRIPT:console.log(document.cookie)', 'data:text/html;base64,PHNjcmlwdD5hbGVydCgxKTwvc2NyaXB0Pg==', 'vbscript:msgbox("hello")', 'file:///etc/passwd', 'FILE:///sdcard/Download/test.apk', 'blob:https://example.com/uuid', 'intent:#Intent;scheme=bad;end', 'content://contacts/people', ] for (const uri of dangerous) { const res = sanitizeAndValidateHref(uri) expect(res.isBlocked).toBe(true) expect(res.safeHref).toBeNull() expect(res.reason).toBe('unsafe_protocol') } }) it('防御不可见控制字符拆写绕过 (如 java\\u0000script:, java\\tscript:)', () => { const obfuscated = [ 'java\u0000script:alert(1)', 'java\tscript:alert(1)', 'java\nscript:alert(1)', 'java\rscript:alert(1)', ] for (const item of obfuscated) { const res = sanitizeAndValidateHref(item) expect(res.isBlocked).toBe(true) expect(res.safeHref).toBeNull() } }) it('协议相对 URL (以 // 开头) 优先于相对路径正确规范化为 https', () => { const res = sanitizeAndValidateHref('//example.com/path') expect(res.isBlocked).toBe(false) expect(res.safeHref).toBe('https://example.com/path') expect(res.protocol).toBe('https:') }) it('拒绝畸形协议相对 URL (如 ///, //\\)', () => { expect(sanitizeAndValidateHref('///example.com').isBlocked).toBe(true) expect(sanitizeAndValidateHref('//\\example.com').isBlocked).toBe(true) }) it('隐式将 www. 前缀提升为 https:// 并完成规范化', () => { const res = sanitizeAndValidateHref('www.example.com/guide') expect(res.isBlocked).toBe(false) expect(res.safeHref).toBe('https://www.example.com/guide') }) it('校验处理正常 HTTP/HTTPS/mailto URL', () => { const res = sanitizeAndValidateHref('https://Example.COM:8443/docs/overview?ref=test#section') expect(res.isBlocked).toBe(false) expect(res.safeHref).toBe('https://Example.COM:8443/docs/overview?ref=test#section') const mail = sanitizeAndValidateHref('mailto:developer@example.com') expect(mail.isBlocked).toBe(false) expect(mail.safeHref).toBe('mailto:developer@example.com') }) it('拒绝非法/畸形 HTTP URL (无 host 或缺少斜杠)', () => { expect(sanitizeAndValidateHref('https:example.com').isBlocked).toBe(true) expect(sanitizeAndValidateHref('http://').isBlocked).toBe(true) }) it('内部协议强校验有效载荷', () => { // 空或未识别载荷被阻断 expect(sanitizeAndValidateHref('dsh-session:').isBlocked).toBe(true) expect(sanitizeAndValidateHref('dsh-session:invalid-base64!@#').isBlocked).toBe(true) expect(sanitizeAndValidateHref('workspace:').isBlocked).toBe(true) // 拒绝 workspace 伪装的 UNC、nested scheme、盘符及路径穿越 expect(sanitizeAndValidateHref('workspace://server/share').isBlocked).toBe(true) expect(sanitizeAndValidateHref('workspace:https://example.com').isBlocked).toBe(true) expect(sanitizeAndValidateHref('workspace:../secret.txt').isBlocked).toBe(true) expect(sanitizeAndValidateHref('workspace:..\\secret.txt').isBlocked).toBe(true) expect(sanitizeAndValidateHref('workspace:src/..').isBlocked).toBe(true) expect(sanitizeAndValidateHref('workspace:C:/secret.txt').isBlocked).toBe(true) // 拒绝非法的 Base64 padding 与非法的 UTF-8 编码 expect(sanitizeAndValidateHref('dsh-session:IsCvIg').isBlocked).toBe(true) // 非法 UTF-8 (overlong 0xc0 0xaf) expect(sanitizeAndValidateHref('dsh-session:Ingi====').isBlocked).toBe(true) // 异常 padding expect(sanitizeAndValidateHref('dsh-session:Zh==').isBlocked).toBe(true) // 未使用尾位非零的非规范 Base64 // 有效的 session payload 正常放行 // "session-123" -> JSON.stringify("session-123") -> base64url const validSessionPayload = Buffer.from(JSON.stringify('session-123')).toString('base64url') const validSessionHref = `dsh-session:${validSessionPayload}` expect(decodeSessionMentionUri(validSessionHref)).toBe('session-123') expect(sanitizeAndValidateHref(validSessionHref).isBlocked).toBe(false) // 有效 workspace 相对路径正常放行 expect(sanitizeAndValidateHref('workspace:src/ui/markdown.tsx').isBlocked).toBe(false) }) it('空值与非字符串类型边界安全处理', () => { expect(sanitizeAndValidateHref('' as any).isBlocked).toBe(true) expect(sanitizeAndValidateHref(' ' as any).isBlocked).toBe(true) expect(sanitizeAndValidateHref(null as any).isBlocked).toBe(true) expect(sanitizeAndValidateHref(undefined as any).isBlocked).toBe(true) }) it('回退环境与严格 UTF-8 校验均阻断非法编码与过长序列', () => { // 1. 原生 TextDecoder 路径 expect(decodeSessionMentionUri('dsh-session:IsCvIg')).toBeUndefined() // 2. 强制屏蔽 TextDecoder 触发纯 JS 回退实现 const origDecoder = (globalThis as any).TextDecoder try { ;(globalThis as any).TextDecoder = undefined // 测试过长字节 0xC0 0xAF (本应是 ASCII '/') expect(decodeUtf8Bytes(new Uint8Array([0x22, 0xc0, 0xaf, 0x22]))).toBeUndefined() // 测试非法 UTF-16 代理项 expect(decodeUtf8Bytes(new Uint8Array([0xed, 0xa0, 0x80]))).toBeUndefined() // 测试超出 Unicode 上限 expect(decodeUtf8Bytes(new Uint8Array([0xf4, 0x90, 0x80, 0x80]))).toBeUndefined() // 测试合法多字节 UTF-8 正常解码 expect(decodeUtf8Bytes(new Uint8Array([0xe4, 0xbd, 0xa0, 0xe5, 0xa5, 0xbd]))).toBe('你好') expect(decodeSessionMentionUri('dsh-session:IsCvIg')).toBeUndefined() } finally { ;(globalThis as any).TextDecoder = origDecoder } }) it('严格拒绝非零 Base64 尾位,同时接受规范编码', () => { expect(decodeBase64ToBytes('Zg==')).toEqual(new Uint8Array([0x66])) expect(decodeBase64ToBytes('Zg')).toEqual(new Uint8Array([0x66])) expect(decodeBase64ToBytes('Zh==')).toBeUndefined() expect(decodeBase64ToBytes('Zh')).toBeUndefined() // 两者在宽松解码器下均可解码为 JSON 字符串 "ab"; // 非规范形式必须在 Base64 校验阶段被拒绝。 expect(decodeSessionMentionUri('dsh-session:ImFiIg==')).toBe('ab') expect(decodeSessionMentionUri('dsh-session:ImFiIh==')).toBeUndefined() }) }) describe('2. 引用角标检测 (isCitationLink)', () => { it('识别成对括号的引用角标 ([1], [^2], ^3)', () => { expect(isCitationLink('[1]')).toEqual({ isCitation: true, index: '1' }) expect(isCitationLink('[^2]')).toEqual({ isCitation: true, index: '2' }) expect(isCitationLink('^3')).toEqual({ isCitation: true, index: '3' }) expect(isCitationLink('[12]')).toEqual({ isCitation: true, index: '12' }) }) it('识别中文命名引用标记 ([来源 1], [参考:2], [cite: 3])', () => { expect(isCitationLink('[来源 1]')).toEqual({ isCitation: true, index: '1' }) expect(isCitationLink('[来源: 4]')).toEqual({ isCitation: true, index: '4' }) expect(isCitationLink('[参考:2]')).toEqual({ isCitation: true, index: '2' }) expect(isCitationLink('[cite: 5]')).toEqual({ isCitation: true, index: '5' }) }) it('通过合法锚点识别引用 (#cite-1, #fn-2)', () => { expect(isCitationLink('来源说明', '#cite-1')).toEqual({ isCitation: true, index: '1' }) expect(isCitationLink('详情', '#fn-2')).toEqual({ isCitation: true, index: '2' }) }) it('排除普通文本与词组,杜绝误识别', () => { expect(isCitationLink('[React Native]').isCitation).toBe(false) expect(isCitationLink('[100MB]').isCitation).toBe(false) expect(isCitationLink('[v1.2.0]').isCitation).toBe(false) expect(isCitationLink('[1').isCitation).toBe(false) expect(isCitationLink('1]').isCitation).toBe(false) expect(isCitationLink('A').isCitation).toBe(false) expect(isCitationLink('B').isCitation).toBe(false) }) it('防御长字符串回溯灾难 (二次方回溯防护)', () => { const malicious = '[来源' + ' '.repeat(500) + 'x]' const start = Date.now() expect(isCitationLink(malicious).isCitation).toBe(false) const duration = Date.now() - start expect(duration).toBeLessThan(100) }) }) describe('3. 长 URL 格式化与防撑破排版 (formatDisplayUrl)', () => { it('去除协议头与 www. 前缀', () => { expect(formatDisplayUrl('https://www.example.com/docs')).toBe('example.com/docs') expect(formatDisplayUrl('http://github.com/org/repo')).toBe('github.com/org/repo') }) it('超过 maxLen 时保留首尾域名和路径,中间以省略号折叠', () => { const longUrl = 'https://www.example.com/deeply/nested/article/path/to/some/very/long/document' const formatted = formatDisplayUrl(longUrl, 32) expect(formatted.length).toBeLessThanOrEqual(32) expect(formatted).toContain('…') expect(formatted.startsWith('example.com/')).toBe(true) }) }) describe('4. 多态分类器与优先级 (classifyMarkdownLink)', () => { it('优先识别内部工作区链接,防止被角标规则误识别', () => { const info = classifyMarkdownLink('./src/ui/markdown.tsx', '[1]') expect(info.kind).toBe('workspace') expect(info.filePath).toBe('src/ui/markdown.tsx') expect(info.displayText).toBe('[1]') expect(info.iconKind).toBe('code') }) it('正确分类 session 内部会话引用', () => { const href = `dsh-session:${Buffer.from(JSON.stringify('session-456')).toString('base64url')}` const info = classifyMarkdownLink(href, '对话456') expect(info.kind).toBe('session') expect(info.sessionId).toBe('session-456') expect(info.displayText).toBe('对话456') expect(info.iconKind).toBe('code') }) it('正确分类 external 外部链接并提取域名与品牌图标', () => { const info = classifyMarkdownLink('https://github.com/liguobao/ds-harness-remote', '项目仓库') expect(info.kind).toBe('external') expect(info.isBlocked).toBe(false) expect(info.domain).toBe('github.com') expect(info.displayText).toBe('项目仓库') expect(info.iconKind).toBe('github') const googleInfo = classifyMarkdownLink('https://www.google.com/search?q=dsh', 'Google') expect(googleInfo.iconKind).toBe('google') const mdnInfo = classifyMarkdownLink('https://developer.mozilla.org/zh-CN/', 'MDN') expect(mdnInfo.iconKind).toBe('mdn') const generalInfo = classifyMarkdownLink('https://deepseek.com', 'DeepSeek') expect(generalInfo.iconKind).toBe('globe') }) it('对裸长外部链接文本自动执行格式化截断', () => { const raw = 'https://www.google.com/search?q=react+native+markdown+styling+and+citations' const info = classifyMarkdownLink(raw, raw) expect(info.kind).toBe('external') expect(info.displayText.length).toBeLessThanOrEqual(42) expect(info.displayText).toContain('…') }) it('正确识别引用来源角标并提取编号', () => { const info = classifyMarkdownLink('#cite-3', '[3]') expect(info.kind).toBe('citation') expect(info.citationIndex).toBe('3') expect(info.displayText).toBe('3') }) it('阻断危险协议并保留原始可读展示文本', () => { const info = classifyMarkdownLink('javascript:alert(1)', '危险操作') expect(info.isBlocked).toBe(true) expect(info.safeHref).toBeNull() expect(info.displayText).toBe('危险操作') }) }) describe('5. openSafeExternalUrl 跳转安全控制', () => { it('允许合法 http / https 外部链接并正确调用系统 openURL', () => { const res = openSafeExternalUrl('https://github.com') expect(res).toBe(true) expect(mockOpenURL).toHaveBeenCalledTimes(1) expect(mockOpenURL).toHaveBeenCalledWith('https://github.com') }) it('允许 mailto 协议', () => { const res = openSafeExternalUrl('mailto:test@example.com') expect(res).toBe(true) expect(mockOpenURL).toHaveBeenCalledWith('mailto:test@example.com') }) it('绝对阻断危险伪协议,零调用系统 openURL', () => { expect(openSafeExternalUrl('javascript:void(0)')).toBe(false) expect(openSafeExternalUrl('file:///sdcard/test.txt')).toBe(false) expect(openSafeExternalUrl('data:text/plain;hello')).toBe(false) expect(mockOpenURL).not.toHaveBeenCalled() }) it('绝对阻断私有协议通过外部浏览器打开,零调用系统 openURL', () => { const validSessionPayload = Buffer.from(JSON.stringify('session-123')).toString('base64url') const validSessionHref = `dsh-session:${validSessionPayload}` expect(sanitizeAndValidateHref(validSessionHref).isBlocked).toBe(false) expect(openSafeExternalUrl(validSessionHref)).toBe(false) expect(openSafeExternalUrl('workspace:src/index.ts')).toBe(false) expect(mockOpenURL).not.toHaveBeenCalled() }) }) describe('6. 官方 DSH 桌面端本地文件链接语法 (parseDshFileLink)', () => { it('支持标准相对路径', () => { expect(parseDshFileLink('src/resolver.js')).toEqual({ path: 'src/resolver.js' }) expect(parseDshFileLink('client-src/markdown.js')).toEqual({ path: 'client-src/markdown.js' }) }) it('支持单行号与行号区间锚点 (#L24, #L9-L12, #L1-L7)', () => { expect(parseDshFileLink('src/resolver.js#L24')).toEqual({ path: 'src/resolver.js', line: 24 }) expect(parseDshFileLink('src/resolver.js#L9-L12')).toEqual({ path: 'src/resolver.js', line: 9 }) expect(parseDshFileLink('client-src/markdown.js#L1-L7')).toEqual({ path: 'client-src/markdown.js', line: 1 }) }) it('支持 Windows 盘符绝对路径 (D:/...) 与正反斜杠', () => { expect(parseDshFileLink('D:/123pan/dsh-git-manage/scripts/build-client.mjs')).toEqual({ path: 'D:/123pan/dsh-git-manage/scripts/build-client.mjs', }) expect(parseDshFileLink('C:\\Users\\admin\\project\\index.ts#L10')).toEqual({ path: 'C:\\Users\\admin\\project\\index.ts', line: 10, }) }) it('支持尖括号包裹含空格特殊路径 ()', () => { expect(parseDshFileLink('')).toEqual({ path: 'docs/e2e-demo.mp4' }) expect(parseDshFileLink('')).toEqual({ path: 'docs/my special file.md', line: 5, }) }) it('严格阻断带有 ? 查询参数的本地文件链接', () => { expect(parseDshFileLink('src/resolver.js?query=1')).toBeUndefined() }) it('阻断 UNC 路径与网络 scheme', () => { expect(parseDshFileLink('//server/share')).toBeUndefined() expect(parseDshFileLink('\\\\server\\share')).toBeUndefined() expect(parseDshFileLink('https://github.com')).toBeUndefined() expect(parseDshFileLink('javascript:alert(1)')).toBeUndefined() }) it('阻断路径穿越 (../)', () => { expect(parseDshFileLink('../secret.txt')).toBeUndefined() expect(parseDshFileLink('src/../../etc/passwd')).toBeUndefined() }) it('防御规范化前置注入绕过 (./https://, .///server, %3F)', () => { expect(parseDshFileLink('./https://example.com')).toBeUndefined() expect(parseDshFileLink('.///server/share')).toBeUndefined() expect(parseDshFileLink('src/a.ts%3Fquery=1')).toBeUndefined() }) }) describe('7. 贯穿分类与渲染的安全阻断断言 (End-to-End Safety)', () => { it('被 parseDshFileLink 拒绝的非法本地目标在分类层必须阻断 (isBlocked: true, safeHref: null)', () => { const targets = [ '../secret.txt', 'src/../../etc/passwd', 'src/resolver.js?query=1', '\\\\\\\\server\\\\share', './//server/share', 'workspace:%2e%2e/secret.txt', 'workspace:%2fetc/passwd', 'workspace:%43%3A%2Fsecret.txt', 'workspace:./C:/secret.txt', 'workspace:', 'workspace:././C:/secret.txt', 'workspace:././%43%3A%2Fsecret.txt', 'workspace:<././C:/secret.txt>', 'workspace:././https://example.com', 'workspace:././javascript:alert(1)', 'workspace:<././file:///etc/passwd>', 'workspace:././file:///etc/passwd', ] for (const target of targets) { // 两处入口(校验层与分类层)均必须 100% 阻断 const sanitizeRes = sanitizeAndValidateHref(target) expect(sanitizeRes.isBlocked).toBe(true) expect(sanitizeRes.safeHref).toBeNull() // 普通标签必须阻断 const info = classifyMarkdownLink(target, '目标') expect(info.isBlocked).toBe(true) expect(info.safeHref).toBeNull() // 尝试用引用角标伪装的非法目标也必须严格阻断,绝对不能逃逸! for (const citationLabel of ['[1]', '[^2]', '[来源 3]']) { const spoofed = classifyMarkdownLink(target, citationLabel) expect(spoofed.isBlocked).toBe(true) expect(spoofed.safeHref).toBeNull() } } }) it('文件类型与图标分类映射完整覆盖 (代码、文档、图片、目录与通用)', () => { expect(classifyDshLinkPath('src/resolver.js')).toBe('code') expect(classifyDshLinkPath('src/resolver.ts')).toBe('code') expect(classifyDshLinkPath('package.json')).toBe('code') expect(classifyDshLinkPath('cordis.patch.yml')).toBe('code') expect(classifyDshLinkPath('docs/my file.md')).toBe('document') expect(classifyDshLinkPath('README.mdx')).toBe('document') expect(classifyDshLinkPath('notes.txt')).toBe('document') expect(classifyDshLinkPath('report.pdf')).toBe('document') expect(classifyDshLinkPath('data.csv')).toBe('document') expect(classifyDshLinkPath('icon.svg')).toBe('image') expect(classifyDshLinkPath('photo.png')).toBe('image') expect(classifyDshLinkPath('scripts/')).toBe('folder') expect(classifyDshLinkPath('other.bin')).toBe('other') }) it('合法的 workspace: 链接正常解析出 filePath 与 iconKind', () => { const info = classifyMarkdownLink('workspace:src/ui/markdown.tsx', '组件代码') expect(info.kind).toBe('workspace') expect(info.filePath).toBe('src/ui/markdown.tsx') expect(info.iconKind).toBe('code') expect(info.isBlocked).toBe(false) }) it('www. 链接具备高优先级,正确分类为 external 并匹配对应图标', () => { const google = classifyMarkdownLink('www.google.com', 'Google') expect(google.kind).toBe('external') expect(google.iconKind).toBe('google') const github = classifyMarkdownLink('www.github.com/features', 'GitHub Features') expect(github.kind).toBe('external') expect(github.iconKind).toBe('github') }) it('严格防御域名伪造攻击 (evilgithub.com, github.com.evil.example 等)', () => { expect(classifyDshWebBrand('https://evilgithub.com')).toBe('globe') expect(classifyDshWebBrand('https://github.com.evil.example')).toBe('globe') expect(classifyDshWebBrand('https://google.com.fake.site')).toBe('globe') expect(classifyDshWebBrand('https://github.com/liguobao')).toBe('github') expect(classifyDshWebBrand('https://raw.githubusercontent.com/user/repo')).toBe('github') }) }) })