ds-harness-remote-fast/apps/android/tests/chat-session-links.test.ts

460 lines
20 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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('支持尖括号包裹含空格特殊路径 (<docs/my file.md>)', () => {
expect(parseDshFileLink('<docs/e2e-demo.mp4>')).toEqual({ path: 'docs/e2e-demo.mp4' })
expect(parseDshFileLink('<docs/my special file.md#L5>')).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:<C:/secret.txt>',
'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')
})
})
})