feat: add mirror help pages and interactive Debian configuration

This commit is contained in:
2026-11-02 00:33:40 +08:00
parent 8ec5e4e324
commit 70e9f9b884
24 changed files with 691 additions and 18 deletions
+53
View File
@@ -0,0 +1,53 @@
import assert from 'node:assert/strict'
import { marked } from 'marked'
import { debianReleases, debianSources, type DebianSourceOptions } from '../src/debian-sources.ts'
import { helpBlocks } from '../src/help-content.ts'
const origin = 'https://mirrors.example.edu'
const base: DebianSourceOptions = { origin, release: 'trixie', format: 'list', sources: false, nonFree: true, securityMirror: false }
const defaultList = debianSources(base)
assert.ok(defaultList.includes('deb https://mirrors.example.edu/mirrors/debian/ trixie main contrib non-free non-free-firmware\n'))
assert.ok(defaultList.includes('deb https://security.debian.org/debian-security trixie-security'))
assert.ok(defaultList.includes('# deb-src https://mirrors.example.edu/mirrors/debian/ trixie '))
let cases = 0
for (const release of debianReleases) for (const format of ['list', 'deb822'] as const) for (const sources of [false, true]) for (const nonFree of [false, true]) for (const securityMirror of [false, true]) {
const value = debianSources({ origin, release: release.id, format, sources, nonFree, securityMirror })
assert.ok(!/undefined|NaN|trusted=yes|allow-insecure|testing-security|sid-security/.test(value))
assert.equal(value.includes('non-free-firmware'), nonFree && release.firmware)
assert.equal(value.includes('contrib non-free'), nonFree)
assert.equal(value.includes(`${release.id}-updates`), release.stable)
assert.equal(value.includes(`${release.id}-backports`), release.backports)
assert.equal(value.includes(`${release.id}-security`), release.stable)
if (release.stable) {
assert.equal(value.includes('https://mirrors.example.edu/mirrors/debian-security/'), securityMirror)
assert.equal(value.includes('https://security.debian.org/debian-security'), !securityMirror)
}
if (format === 'list') {
assert.equal(value.split('\n').some(line => line.startsWith('deb-src ')), sources)
assert.ok(value.split('\n').every(line => !line || /^(?:# )?deb(?:-src)? https:\/\/\S+ \S+ main(?: contrib non-free(?: non-free-firmware)?)?$/.test(line)))
} else {
for (const stanza of value.trim().split('\n\n')) {
const fields = Object.fromEntries(stanza.split('\n').map(line => line.split(/: (.*)/s).slice(0, 2)))
assert.equal(fields.Types, sources ? 'deb deb-src' : 'deb')
assert.equal(fields['Signed-By'], '/usr/share/keyrings/debian-archive-keyring.gpg')
assert.ok(fields.URIs && fields.Suites && fields.Components)
}
}
cases++
}
assert.ok(debianSources({ ...base, origin: 'http://100.69.2.2:8080/path?ignored=true' }).includes('http://100.69.2.2:8080/mirrors/debian/'))
assert.throws(() => debianSources({ ...base, origin: 'javascript:alert(1)' }))
assert.throws(() => debianSources({ ...base, origin: 'https://secret:password@example.edu' }))
assert.throws(() => debianSources({ ...base, release: 'unknown' as DebianSourceOptions['release'] }))
const fence = (data: string) => '```mirror-config\n' + data + '\n```\n'
const source = '## 配置\n\n[Debian][official]\n\n' + fence('{"type":"debian","format":"list"}') + '\n## 新格式\n\n' + fence('{"type":"debian","format":"deb822"}') + '\n[official]: https://www.debian.org/\n'
const blocks = helpBlocks(source)
assert.deepEqual(blocks.filter(block => block.kind === 'debian'), [{ kind: 'debian', format: 'list' }, { kind: 'debian', format: 'deb822' }])
assert.ok(blocks.filter(block => block.kind === 'markdown').map(block => marked.parser(block.tokens)).join('').includes('href="https://www.debian.org/"'), 'Reference-style Markdown links must survive widget insertion')
for (const data of ['not JSON', '{"type":"shell","format":"list"}', '{"type":"debian","format":"other"}', '{"type":"debian","format":"list","script":"alert(1)"}', 'null']) {
assert.ok(helpBlocks(fence(data)).every(block => block.kind === 'markdown'), 'Invalid or unsupported blocks must remain ordinary Markdown code')
}
assert.ok(helpBlocks('````markdown\n' + fence('{"type":"debian","format":"list"}') + '````\n').every(block => block.kind === 'markdown'), 'A quoted code example must not instantiate a live widget')
console.log(`Debian help check passed: ${cases} option combinations, release-specific suites, official security defaults, DEB822 fields, widget parsing and Markdown links.`)
+13
View File
@@ -0,0 +1,13 @@
import assert from 'node:assert/strict'
import { helpRoute, helpUrl } from '../src/help.ts'
for (const name of ['ubuntu', 'debian-cd', 'AOSP', 'gcc.git', 'archlinuxcn', 'test+repo']) {
const url = helpUrl(name)
assert.deepEqual(helpRoute(url), { active: true, name, invalid: false })
assert.deepEqual(helpRoute(url.slice(0, -1)), { active: true, name, invalid: false })
}
for (const path of ['/help', '/help/']) assert.deepEqual(helpRoute(path), { active: true, name: null, invalid: false })
for (const path of ['/', '/helpful', '/announcements']) assert.equal(helpRoute(path).active, false)
for (const path of ['/help/../', '/help/ubuntu/extra', '/help/%2fsecret', '/help/%zz', '/help/%252fsecret']) assert.equal(helpRoute(path).invalid, true)
assert.equal(helpUrl('a/b?c#d'), '/help/a%2Fb%3Fc%23d/')
console.log('Help check passed: index and deep links, case-sensitive names, encoded identifiers and malformed paths.')