Compare commits

...

4 Commits

Author SHA1 Message Date
手瓜一十雪
38fc636088 chore(release): v2.0.2 2026-10-18 19:43:13 +08:00
手瓜一十雪
9c3c768968 docs: remove updater guide 2026-10-18 19:42:03 +08:00
手瓜一十雪
059faf79c0 chore(release): v2.0.2 2026-10-18 19:41:10 +08:00
手瓜一十雪
20cf7394e5 fix(update): recover from GitHub rate limits with configurable mirrors 2026-10-18 19:41:02 +08:00
34 changed files with 1419 additions and 108 deletions

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "snowluma-monorepo",
"version": "2.0.1",
"version": "2.0.2",
"description": "SnowLuma monorepo workspace (pnpm)",
"private": true,
"type": "module",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/bridge",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "SnowLuma bridge — QQ NT desktop client lifecycle: hook injection (via native addon), per-PID HookSession orchestration, pipe-watcher for process discovery, and the BridgeManagerSink interface that lets the hook layer call back into a UIN-keyed session router without depending on @snowluma/core. Consumed by the top-level app entry (which constructs the BridgeManager from @snowluma/core and injects it as the sink) and by the WebUI server (read-only HookProcessInfo views).",

View File

@@ -1,13 +1,17 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/common",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "SnowLuma shared infrastructure — leaf-package utilities with zero business dependencies. Logger / hex codec / log file transport / log line summariser / packet sender wire-protocol types / runtime config loader. Consumed by @snowluma/protocol, @snowluma/core, and @snowluma/onebot. Per-file subpath exports keep import sites unambiguous and let the bundler tree-shake aggressively (importing `@snowluma/common/hex` doesn't pull in `node:fs` from the logger transport).",
"main": "./src/index.ts",
"types": "./src/index.ts",
"exports": {
"./update-source": {
"types": "./src/update-source.ts",
"default": "./src/update-source.ts"
},
"./semver": {
"types": "./src/semver.ts",
"default": "./src/semver.ts"

View File

@@ -1,8 +1,10 @@
import fs from 'fs';
import path from 'path';
import { isObject } from './coerce';
import { normalizeUpdateSourceConfig, type UpdateSourceConfig } from './update-source';
export interface RuntimeConfig {
updateSource?: UpdateSourceConfig;
webuiPort?: number;
/** When true, every newly-discovered QQ process gets auto-injected by
* the HookManager. Also overridable at runtime via SNOWLUMA_HOOK_AUTOLOAD.
@@ -43,6 +45,9 @@ export const MAX_LOG_RETAIN_DAYS = Math.floor(Number.MAX_SAFE_INTEGER / (24 * 60
export function normalizeRuntimeConfig(parsed: unknown): RuntimeConfig {
const obj = isObject(parsed) ? parsed : {};
return {
...(obj.updateSource === undefined
? {}
: { updateSource: normalizeUpdateSourceConfig(obj.updateSource) }),
webuiPort: normalizePort(obj.webuiPort ?? DEFAULT_WEBUI_PORT, DEFAULT_WEBUI_PORT),
hookAutoLoad: normalizeBool(obj.hookAutoLoad, false),
webuiHost: normalizeHost(obj.webuiHost),
@@ -217,7 +222,8 @@ function sameRuntimeConfig(parsed: Record<string, unknown>, n: RuntimeConfig): b
parsed.trustProxy === n.trustProxy &&
parsed.logMaxTotalMb === n.logMaxTotalMb &&
parsed.logRetainDays === n.logRetainDays &&
parsed.logPerUin === n.logPerUin
parsed.logPerUin === n.logPerUin &&
JSON.stringify(parsed.updateSource) === JSON.stringify(n.updateSource)
);
}

View File

@@ -0,0 +1,60 @@
export interface UpdateSourceConfig {
mode: 'auto' | 'direct' | 'mirror';
mirror: string;
mirrors: string[];
}
export function normalizeMirrorUrl(value: unknown): string {
if (typeof value !== 'string' || value.length > 2048) {
throw new Error('镜像地址必须是 HTTP(S) URL');
}
let url: URL;
try {
url = new URL(value.trim());
} catch {
throw new Error('镜像地址必须是 HTTP(S) URL');
}
if (
!['http:', 'https:'].includes(url.protocol) ||
url.username ||
url.password ||
url.search ||
url.hash
) {
throw new Error('镜像地址仅支持 HTTP(S),不能包含账号、密码、查询参数或片段');
}
return url.href.replace(/\/+$/, '');
}
export function normalizeUpdateSourceConfig(value: unknown): UpdateSourceConfig {
if (!value || typeof value !== 'object' || Array.isArray(value)) {
throw new Error('更新来源必须是对象');
}
if (
!('mode' in value) ||
(value.mode !== 'auto' && value.mode !== 'direct' && value.mode !== 'mirror')
) {
throw new Error('更新来源模式无效');
}
if (!('mirrors' in value) || !Array.isArray(value.mirrors) || value.mirrors.length > 16) {
throw new Error('自动筛选最多支持 16 个镜像');
}
const mirror = 'mirror' in value && value.mirror !== '' ? normalizeMirrorUrl(value.mirror) : '';
if (value.mode === 'mirror' && !mirror) {
throw new Error('请指定镜像地址');
}
return {
mode: value.mode,
mirror,
mirrors: [...new Set(value.mirrors.map(normalizeMirrorUrl))],
};
}

View File

@@ -0,0 +1,54 @@
import { describe, expect, it } from 'vitest';
import { normalizeMirrorUrl, normalizeUpdateSourceConfig } from '../src/update-source';
import { normalizeRuntimeConfig } from '../src/runtime';
describe('update source configuration', () => {
it('normalizes proxy prefixes, deduplicates mirrors and retains order', () => {
expect(
normalizeUpdateSourceConfig({
mode: 'auto',
mirror: '',
mirrors: [
' https://EXAMPLE.com/proxy/ ',
'https://example.com/proxy',
'https://other.example',
],
}),
).toEqual({
mode: 'auto',
mirror: '',
mirrors: ['https://example.com/proxy', 'https://other.example'],
});
});
it.each([
'',
'file:///tmp/x',
'ftp://example.com',
'https://user:secret@example.com',
'https://example.com/?token=a',
'https://example.com/#a',
null,
])('rejects invalid mirror %s', (url) => {
expect(() => normalizeMirrorUrl(url)).toThrow();
});
it.each([
null,
[],
{ mode: ['auto'], mirrors: [] },
{ mode: 'mirror', mirror: '', mirrors: [] },
{ mode: 'auto', mirrors: Array(17).fill('https://example.com') },
])('rejects invalid configuration %j', (config) => {
expect(() => normalizeUpdateSourceConfig(config)).toThrow();
});
it('retains configured update sources when normalizing runtime settings', () => {
const updateSource = { mode: 'direct', mirror: '', mirrors: [] };
expect(normalizeRuntimeConfig({ updateSource, webuiPort: 7777 })).toMatchObject({
updateSource,
webuiPort: 7777,
});
expect(normalizeRuntimeConfig({})).not.toHaveProperty('updateSource');
});
});

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/core",
"version": "2.0.1",
"version": "2.0.2",
"description": "SnowLuma core - NTQQ packet sniffer with Node.js native addon",
"private": true,
"type": "module",

View File

@@ -2,10 +2,12 @@ import { APP_VERSION } from '@snowluma/common/version';
import { compareVersions, parseVersion } from '@snowluma/common/semver';
import { createLogger } from '@snowluma/common/logger';
import { createSingleFlightCache } from '@snowluma/common/single-flight-cache';
import type { UpdateSourceConfig } from '@snowluma/common/update-source';
import { fetchRelease } from './release';
import { readUpdateSource } from './sources';
const log = createLogger('Update');
const LATEST_RELEASE_URL = 'https://api.github.com/repos/SnowLuma/SnowLuma/releases/latest';
const CACHE_TTL_MS = 6 * 60 * 60 * 1000; // 6h — comfortably under the rate limit
const FETCH_TIMEOUT_MS = 8_000;
const NOTES_MAX = 4_000; // cap the release-body we hand back to the client
@@ -29,13 +31,6 @@ export interface UpdateCheckResult {
error?: string;
}
interface GithubRelease {
tag_name?: string;
html_url?: string;
body?: string;
published_at?: string;
}
function isEnabled(): boolean {
const v = (process.env.SNOWLUMA_UPDATE_CHECK ?? '').trim().toLowerCase();
return v !== '0' && v !== 'false' && v !== 'off' && v !== 'no';
@@ -47,8 +42,10 @@ function isEnabled(): boolean {
const updateCache = createSingleFlightCache<string, UpdateCheckResult>({
ttlMs: CACHE_TTL_MS,
shouldCache: (r) => !r.error,
load: async (current) => {
const result = await fetchLatest(current);
load: async (key) => {
// This key is constructed below from our version and normalized settings.
const [current, source] = JSON.parse(key) as [string, UpdateSourceConfig];
const result = await fetchLatest(current, source);
if (result.error) {
log.debug('update check failed: %s', result.error);
@@ -60,7 +57,10 @@ const updateCache = createSingleFlightCache<string, UpdateCheckResult>({
},
});
async function fetchLatest(current: string): Promise<UpdateCheckResult> {
async function fetchLatest(
current: string,
source: UpdateSourceConfig,
): Promise<UpdateCheckResult> {
const base: UpdateCheckResult = {
current,
latest: null,
@@ -74,21 +74,19 @@ async function fetchLatest(current: string): Promise<UpdateCheckResult> {
try {
// `/releases/latest` already excludes drafts and prereleases, so this is
// stable-channel by construction.
const res = await fetch(LATEST_RELEASE_URL, {
headers: {
Accept: 'application/vnd.github+json',
'User-Agent': `SnowLuma/${current}`,
'X-GitHub-Api-Version': '2022-11-28',
},
signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
});
const { data: rel } = await fetchRelease(
undefined,
source,
`SnowLuma/${current}`,
FETCH_TIMEOUT_MS,
);
if (!res.ok) {
return { ...base, error: `github ${res.status}` };
if (!rel || typeof rel !== 'object' || Array.isArray(rel)) {
return { ...base, error: 'invalid release info' };
}
const rel = (await res.json()) as GithubRelease;
const tag = typeof rel.tag_name === 'string' ? rel.tag_name.trim() : '';
const tag =
'tag_name' in rel && typeof rel.tag_name === 'string' ? rel.tag_name.trim() : '';
if (!tag) {
return { ...base, error: 'no tag' };
@@ -104,9 +102,15 @@ async function fetchLatest(current: string): Promise<UpdateCheckResult> {
current,
latest,
hasUpdate: compareVersions(latest, current) > 0,
htmlUrl: rel.html_url ?? null,
notes: rel.body ? rel.body.slice(0, NOTES_MAX) : null,
publishedAt: rel.published_at ?? null,
htmlUrl: 'html_url' in rel && typeof rel.html_url === 'string' ? rel.html_url : null,
notes:
'body' in rel && typeof rel.body === 'string' && rel.body
? rel.body.slice(0, NOTES_MAX)
: null,
publishedAt:
'published_at' in rel && typeof rel.published_at === 'string'
? rel.published_at
: null,
checkedAt: Date.now(),
};
} catch (e) {
@@ -120,14 +124,26 @@ async function fetchLatest(current: string): Promise<UpdateCheckResult> {
* failures come back as a result with `error` set and `hasUpdate: false`, and
* are not cached so the next check retries.
*/
export async function getUpdateInfo(force = false): Promise<UpdateCheckResult> {
export async function getUpdateInfo(
force = false,
source?: UpdateSourceConfig,
): Promise<UpdateCheckResult> {
const current = APP_VERSION;
if (!isEnabled()) {
return { ...emptyResult(current), error: 'disabled' };
}
return updateCache.get(current, { force });
try {
return await updateCache.get(JSON.stringify([current, source ?? readUpdateSource()]), {
force,
});
} catch (error) {
return {
...emptyResult(current),
error: error instanceof Error ? error.message : String(error),
};
}
}
function emptyResult(current: string): UpdateCheckResult {

View File

@@ -1,43 +1,30 @@
import { createHash } from 'node:crypto';
import { createWriteStream } from 'node:fs';
import { mkdir, readFile, writeFile } from 'node:fs/promises';
import { mkdir, readFile, writeFile, rm } from 'node:fs/promises';
import path from 'node:path';
import { Readable, Transform } from 'node:stream';
import { pipeline } from 'node:stream/promises';
import { unzipSync } from 'fflate';
import { x as extractTar } from 'tar';
import { isRuntimeEntry, readManifest } from './files';
import { assetName, fetchRelease } from './release';
export { assetName } from './release';
import { readUpdateSource, sourceUrls } from './sources';
import type { UpdateSourceConfig } from '@snowluma/common/update-source';
interface ReleaseAsset {
url: string;
size: number;
size: number | null;
digest: string;
}
export function assetName(version: string, target: string): string {
const platform = target.replace('win32', 'win');
return `SnowLuma-v${version}-${platform}-lite.${target.startsWith('win32') ? 'zip' : 'tar.gz'}`;
}
async function releaseAsset(version: string, target: string): Promise<ReleaseAsset> {
async function releaseAsset(
version: string,
target: string,
source: UpdateSourceConfig,
): Promise<ReleaseAsset> {
const name = assetName(version, target);
const response = await fetch(
`https://api.github.com/repos/SnowLuma/SnowLuma/releases/tags/v${version}`,
{
headers: {
Accept: 'application/vnd.github+json',
'User-Agent': 'SnowLuma',
'X-GitHub-Api-Version': '2022-11-28',
},
signal: AbortSignal.timeout(15_000),
},
);
if (!response.ok) {
throw new Error(`获取更新失败: GitHub ${response.status}`);
}
const release: unknown = await response.json();
const { data: release, fromPage } = await fetchRelease(version, source);
if (
!release ||
@@ -58,9 +45,10 @@ async function releaseAsset(version: string, target: string): Promise<ReleaseAss
!asset ||
typeof asset !== 'object' ||
!('size' in asset) ||
typeof asset.size !== 'number' ||
!Number.isSafeInteger(asset.size) ||
asset.size <= 0 ||
!(
(fromPage && asset.size === null) ||
(typeof asset.size === 'number' && Number.isSafeInteger(asset.size) && asset.size > 0)
) ||
!('digest' in asset) ||
typeof asset.digest !== 'string' ||
!/^sha256:[a-f0-9]{64}$/.test(asset.digest)
@@ -94,37 +82,98 @@ export async function downloadUpdate(
directory: string,
version: string,
target: string,
source = readUpdateSource(),
): Promise<void> {
const asset = await releaseAsset(version, target);
const response = await fetch(asset.url, { signal: AbortSignal.timeout(10 * 60_000) });
if (!response.ok || !response.body) {
throw new Error(`下载更新失败: HTTP ${response.status}`);
}
const asset = await releaseAsset(version, target, source);
const archive = path.join(directory, 'archive');
const hash = createHash('sha256');
let received = 0;
await pipeline(
Readable.fromWeb(response.body),
new Transform({
transform(chunk: Buffer, _encoding, callback) {
received += chunk.length;
const urls = sourceUrls(asset.url, source);
const failures: string[] = [];
if (received > asset.size) {
callback(new Error('更新包大小不匹配'));
return;
}
for (const [index, url] of urls.entries()) {
let created = false;
hash.update(chunk);
callback(null, chunk);
},
}),
createWriteStream(archive, { flags: 'wx' }),
);
try {
const headersTimeout = new AbortController();
const timer = setTimeout(() => headersTimeout.abort(), 8_000);
let response: Response;
if (received !== asset.size || `sha256:${hash.digest('hex')}` !== asset.digest) {
throw new Error('更新包校验失败');
try {
response = await fetch(url, {
signal: AbortSignal.any([
headersTimeout.signal,
AbortSignal.timeout(10 * 60_000),
]),
});
} finally {
clearTimeout(timer);
}
if (!response.ok || !response.body) {
await response.body?.cancel();
throw new Error(`下载更新失败: HTTP ${response.status}`);
}
if (/text\/html/i.test(response.headers.get('content-type') ?? '')) {
await response.body.cancel();
throw new Error('下载源返回了 HTML 页面,而不是更新包');
}
const hash = createHash('sha256');
const length = response.headers.get('content-length');
const size =
asset.size ?? (length === null ? null : /^\d+$/.test(length) ? Number(length) : 0);
if (size !== null && (!Number.isSafeInteger(size) || size <= 0)) {
await response.body.cancel();
throw new Error('下载源返回了无效的更新包大小');
}
let received = 0;
const output = createWriteStream(archive, { flags: 'wx' });
output.once('open', () => {
created = true;
});
await pipeline(
Readable.fromWeb(response.body),
new Transform({
transform(chunk: Buffer, _encoding, callback) {
received += chunk.length;
if (received > (size ?? 256 * 1024 * 1024)) {
callback(new Error('更新包大小不匹配'));
return;
}
hash.update(chunk);
callback(null, chunk);
},
}),
output,
);
if (
(size !== null && received !== size) ||
`sha256:${hash.digest('hex')}` !== asset.digest
) {
throw new Error('更新包校验失败');
}
break;
} catch (error) {
if (error && typeof error === 'object' && 'code' in error && error.code === 'EEXIST') {
throw error;
}
failures.push(error instanceof Error ? error.message : String(error));
if (index === urls.length - 1) {
throw new Error([...new Set(failures)].join(';'));
}
if (created) {
await rm(archive);
}
}
}
const payload = path.join(directory, 'payload');

View File

@@ -0,0 +1,196 @@
import { parseVersion } from '@snowluma/common/semver';
import type { UpdateSourceConfig } from '@snowluma/common/update-source';
import { RELEASE_ROOT, sourceUrls } from './sources';
export function assetName(version: string, target: string): string {
const platform = target.replace('win32', 'win');
return `SnowLuma-v${version}-${platform}-lite.${target.startsWith('win32') ? 'zip' : 'tar.gz'}`;
}
async function readText(response: Response, limit: number): Promise<string> {
if (!response.body) {
throw new Error('发布信息为空');
}
const reader = response.body.getReader();
const chunks: Uint8Array[] = [];
let size = 0;
try {
for (;;) {
const { value, done } = await reader.read();
if (done) {
break;
}
size += value.length;
if (size > limit) {
await reader.cancel();
throw new Error('发布信息过大');
}
chunks.push(value);
}
} finally {
reader.releaseLock();
}
return Buffer.concat(chunks).toString('utf8');
}
function attribute(tag: string, name: string): string | undefined {
return new RegExp(`\\s${name}\\s*=\\s*(["'])(.*?)\\1`, 'i')
.exec(tag)?.[2]
.replaceAll('&amp;', '&')
.replaceAll('&#39;', "'")
.replaceAll('&quot;', '"');
}
export function parseLatestReleasePage(html: string) {
const meta = html
.match(/<meta\b[^>]*>/gi)
?.find((tag) => attribute(tag, 'property') === 'og:url');
const canonical = meta && attribute(meta, 'content');
if (!canonical) {
throw new Error('发布页面缺少版本信息');
}
const url = new URL(canonical, 'https://github.com');
const tag = /^\/SnowLuma\/SnowLuma\/releases\/tag\/([^/]+)$/.exec(url.pathname)?.[1];
const decoded = tag && decodeURIComponent(tag);
const version = decoded?.startsWith('v') ? decoded.slice(1) : undefined;
const parsed = parseVersion(version);
if (url.origin !== 'https://github.com' || !parsed || parsed.prerelease.length) {
throw new Error('发布页面不是 SnowLuma 正式版本');
}
return { tag_name: `v${parsed.raw}`, html_url: `${RELEASE_ROOT}/tag/v${parsed.raw}` };
}
/** Match the digest in the same asset row; never borrow a neighbouring asset's hash. */
export function parseReleaseAssetsPage(html: string, version: string) {
const assets: { name: string; size: null; digest: string }[] = [];
const expected = ['win32-x64', 'linux-x64', 'linux-arm64'].map((target) =>
assetName(version, target),
);
for (const row of html.match(/<li\b[^>]*>[\s\S]*?<\/li>/gi) ?? []) {
const links = row.match(/<a\b[^>]*>/gi) ?? [];
const name = expected.find((candidate) =>
links.some((link) => {
const href = attribute(link, 'href');
return (
href === `/SnowLuma/SnowLuma/releases/download/v${version}/${candidate}` ||
href === `${RELEASE_ROOT}/download/v${version}/${candidate}`
);
}),
);
if (!name) {
continue;
}
const digests = (row.match(/<clipboard-copy\b[^>]*>/gi) ?? [])
.map((tag) => attribute(tag, 'value'))
.filter((value): value is string =>
Boolean(value && /^sha256:[a-f0-9]{64}$/.test(value)),
);
if (digests.length !== 1 || assets.some((asset) => asset.name === name)) {
throw new Error('发布页面缺少唯一的文件校验信息');
}
// GitHub renders a rounded size in HTML. Verify the exact digest even
// when a proxy streams the asset without Content-Length.
assets.push({ name, size: null, digest: digests[0]! });
}
if (!assets.length) {
throw new Error('发布页面没有可验证的更新包');
}
return { tag_name: `v${version}`, assets };
}
export interface ReleaseResult {
data: unknown;
fromPage: boolean;
}
export async function fetchRelease(
version: string | undefined,
source: UpdateSourceConfig,
userAgent = 'SnowLuma',
timeoutMs = 8_000,
): Promise<ReleaseResult> {
const apiUrl = `https://api.github.com/repos/SnowLuma/SnowLuma/releases/${version ? `tags/v${version}` : 'latest'}`;
let primaryError: unknown;
try {
const response = await fetch(apiUrl, {
headers: {
Accept: 'application/vnd.github+json',
'User-Agent': userAgent,
'X-GitHub-Api-Version': '2022-11-28',
},
signal: AbortSignal.timeout(timeoutMs),
});
if (!response.ok) {
await response.body?.cancel();
throw new Error(`GitHub ${response.status}`);
}
return {
data: JSON.parse(await readText(response, 256 * 1024)) as unknown,
fromPage: false,
};
} catch (error) {
primaryError = error;
}
const originalUrl = version
? `${RELEASE_ROOT}/expanded_assets/v${version}`
: `${RELEASE_ROOT}/latest`;
const controller = new AbortController();
try {
// Only a parsed release page can win. Fast errors and HTML interstitials
// cannot cancel a slower working source.
// Download proxies often only support assets. Always retain GitHub's
// release page for version/digest lookup, even with a pinned download mirror.
const urls = [...new Set([originalUrl, ...sourceUrls(originalUrl, source)])];
const data = await Promise.any(
urls.map(async (url) => {
const response = await fetch(url, {
signal: AbortSignal.any([controller.signal, AbortSignal.timeout(timeoutMs)]),
});
if (!response.ok) {
await response.body?.cancel();
throw new Error(`HTTP ${response.status}`);
}
const html = await readText(response, 1024 * 1024);
return version
? parseReleaseAssetsPage(html, version)
: parseLatestReleasePage(html);
}),
);
return { data, fromPage: true };
} catch (error) {
const failures = error instanceof AggregateError ? error.errors : [error];
const details = [primaryError, ...failures]
.filter(Boolean)
.map((failure: unknown) =>
failure instanceof Error ? failure.message : String(failure),
);
throw new Error(`${[...new Set(details)].join(';')};请在更新来源中检测或指定可用镜像`);
} finally {
controller.abort();
}
}

View File

@@ -0,0 +1,125 @@
import { APP_VERSION } from '@snowluma/common/version';
import { readRuntimeConfig, updateRuntimeConfig } from '@snowluma/common/runtime';
import {
normalizeUpdateSourceConfig,
type UpdateSourceConfig,
} from '@snowluma/common/update-source';
export const RELEASE_ROOT = 'https://github.com/SnowLuma/SnowLuma/releases';
export const DEFAULT_UPDATE_SOURCE: UpdateSourceConfig = {
mode: 'auto',
mirror: '',
mirrors: [
'https://ghfast.top',
'https://ghproxy.net',
'https://gh-proxy.com',
'https://github.chenc.dev',
'https://fastgit.cc',
'https://gh.noki.icu',
'https://cors.isteed.cc',
'https://gh-proxy.org',
'https://githubproxy.gohj99.site',
'https://github.xxlab.tech',
],
};
export function readUpdateSource(): UpdateSourceConfig {
return normalizeUpdateSourceConfig(readRuntimeConfig().updateSource ?? DEFAULT_UPDATE_SOURCE);
}
export function saveUpdateSource(value: unknown): UpdateSourceConfig {
const config = normalizeUpdateSourceConfig(value);
updateRuntimeConfig({ updateSource: config });
return config;
}
export function sourceUrls(url: string, config: UpdateSourceConfig): string[] {
if (config.mode === 'direct') {
return [url];
}
if (config.mode === 'mirror') {
return [`${config.mirror}/${url}`];
}
return [url, ...config.mirrors.map((mirror) => `${mirror}/${url}`)];
}
export interface MirrorProbeResult {
mirror: string;
available: boolean;
latencyMs: number;
error?: string;
}
export async function testUpdateSources(value: unknown): Promise<MirrorProbeResult[]> {
const config = normalizeUpdateSourceConfig(value);
const mirrors = [
...new Set(['', ...config.mirrors, ...(config.mirror ? [config.mirror] : [])]),
];
const target = process.platform === 'win32' ? 'win-x64' : `linux-${process.arch}`;
const extension = process.platform === 'win32' ? 'zip' : 'tar.gz';
const probeUrl = `${RELEASE_ROOT}/download/v${APP_VERSION}/SnowLuma-v${APP_VERSION}-${target}-lite.${extension}`;
const results = await Promise.all(
mirrors.map(async (mirror): Promise<MirrorProbeResult> => {
const start = performance.now();
try {
const response = await fetch(mirror ? `${mirror}/${probeUrl}` : probeUrl, {
headers: { Range: 'bytes=0-3' },
signal: AbortSignal.timeout(5_000),
});
if (!response.ok || !response.body) {
await response.body?.cancel();
throw new Error(`HTTP ${response.status}`);
}
if (/text\/html/i.test(response.headers.get('content-type') ?? '')) {
await response.body.cancel();
throw new Error('返回了 HTML 页面,而不是更新包');
}
const reader = response.body.getReader();
const prefix: number[] = [];
try {
while (prefix.length < 4) {
const { value, done } = await reader.read();
if (done) {
break;
}
prefix.push(...value.subarray(0, 4 - prefix.length));
}
} finally {
await reader.cancel();
reader.releaseLock();
}
const signature = extension === 'zip' ? [0x50, 0x4b, 0x03, 0x04] : [0x1f, 0x8b];
if (!signature.every((byte, index) => prefix[index] === byte)) {
throw new Error('返回内容不是有效的更新包');
}
return {
mirror,
available: true,
latencyMs: Math.round(performance.now() - start),
};
} catch (error) {
return {
mirror,
available: false,
latencyMs: Math.round(performance.now() - start),
error: error instanceof Error ? error.message : String(error),
};
}
}),
);
return results.sort(
(a, b) => Number(b.available) - Number(a.available) || a.latencyMs - b.latencyMs,
);
}

View File

@@ -1,10 +1,52 @@
import { Hono } from 'hono';
import type { HttpBindings } from '@hono/node-server';
import type { UpdateService } from '../update/service';
import { readUpdateSource, saveUpdateSource, testUpdateSources } from '../update/sources';
import {
normalizeUpdateSourceConfig,
type UpdateSourceConfig,
} from '@snowluma/common/update-source';
export function updateRoutes(service: UpdateService, restart: () => void) {
const app = new Hono<{ Bindings: HttpBindings }>();
app.get('/status', (c) => c.json(service.status()));
app.get('/sources', (c) => {
try {
return c.json({ config: readUpdateSource() });
} catch (error) {
return c.json({ message: error instanceof Error ? error.message : String(error) }, 500);
}
});
app.post('/sources', async (c) => {
let config: UpdateSourceConfig;
try {
config = normalizeUpdateSourceConfig(await c.req.json());
} catch (error) {
return c.json({ message: error instanceof Error ? error.message : String(error) }, 400);
}
try {
saveUpdateSource(config);
return c.json({
config,
saved: true,
applied: true,
online: true,
errors: [],
message: '更新来源已保存',
});
} catch (error) {
return c.json({ message: error instanceof Error ? error.message : String(error) }, 500);
}
});
app.post('/sources/test', async (c) => {
try {
return c.json({ results: await testUpdateSources(await c.req.json()) });
} catch (error) {
return c.json({ message: error instanceof Error ? error.message : String(error) }, 400);
}
});
app.post('/download', async (c) => {
let body: unknown;

View File

@@ -5,10 +5,14 @@ import path from 'node:path';
import { zipSync } from 'fflate';
import { c as createTar } from 'tar';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { archivePath, assetName, downloadUpdate } from '../src/update/download';
import { archivePath, assetName, downloadUpdate as download } from '../src/update/download';
import { readManifest } from '../src/update/files';
import { releaseFixture } from './helpers/update-fixture';
const direct = { mode: 'direct', mirror: '', mirrors: [] } as const;
const downloadUpdate = (directory: string, version: string, target: string) =>
download(directory, version, target, { ...direct, mirrors: [] });
let root: string;
beforeEach(async () => {
root = await mkdtemp(path.join(os.tmpdir(), 'snowluma-download-test-'));
@@ -43,6 +47,105 @@ function mockRelease(bytes: Uint8Array, target: string, digest?: string) {
}
describe('release downloads', () => {
it.each(['403', 'html', 'corrupt', 'interrupted'])(
'cleans and retries a %s response through a mirror using HTML release checksums',
async (failure) => {
const manifest = await releaseFixture(path.join(root, 'source'), '2.0.0', 'win32-x64');
const bytes = zipSync({
'release.json': new TextEncoder().encode(JSON.stringify(manifest)),
'app.mjs': new TextEncoder().encode('verified payload'),
});
const name = assetName('2.0.0', 'win32-x64');
const digest = createHash('sha256').update(bytes).digest('hex');
const fetchMock = vi.fn<typeof fetch>(async (input) => {
const url = String(input);
if (url.includes('api.github.com')) {
return new Response('rate limited', { status: 403 });
}
if (url.includes('/expanded_assets/')) {
return new Response(
`<li><a href="/SnowLuma/SnowLuma/releases/download/v2.0.0/${name}">asset</a><clipboard-copy value="sha256:${digest}"></clipboard-copy></li>`,
);
}
if (url.startsWith('https://working.example/')) {
// Mirrors may stream a verified archive without Content-Length.
return new Response(new Uint8Array(bytes));
}
if (failure === '403') {
return new Response('blocked', { status: 403 });
}
if (failure === 'html') {
return new Response('<html>challenge</html>', {
headers: { 'Content-Type': 'text/html' },
});
}
if (failure === 'interrupted') {
let sent = false;
return new Response(
new ReadableStream({
pull(controller) {
if (sent) {
controller.error(new Error('connection reset'));
} else {
controller.enqueue(new Uint8Array([1, 2, 3]));
sent = true;
}
},
}),
);
}
return new Response('corrupt archive');
});
vi.stubGlobal('fetch', fetchMock);
await download(root, '2.0.0', 'win32-x64', {
mode: 'auto',
mirror: '',
mirrors: ['https://working.example'],
});
expect(await readFile(path.join(root, 'archive'))).toEqual(Buffer.from(bytes));
expect(await readFile(path.join(root, 'payload/app.mjs'), 'utf8')).toBe(
'verified payload',
);
expect(
fetchMock.mock.calls
.filter(([url]) => String(url).includes('/download/'))
.map(([url]) => String(url)),
).toEqual([
`https://github.com/SnowLuma/SnowLuma/releases/download/v2.0.0/${name}`,
`https://working.example/https://github.com/SnowLuma/SnowLuma/releases/download/v2.0.0/${name}`,
]);
},
);
it('does not try other download sources in pinned mode', async () => {
const bytes = new Uint8Array([1, 2, 3]);
const fetchMock = mockRelease(bytes, 'win32-x64');
const original = fetchMock.getMockImplementation()!;
fetchMock.mockImplementation(async (input) =>
String(input).includes('api.github.com')
? original(input)
: new Response('blocked', { status: 403 }),
);
await expect(
download(root, '2.0.0', 'win32-x64', {
mode: 'mirror',
mirror: 'https://pinned.example',
mirrors: ['https://other.example'],
}),
).rejects.toThrow('HTTP 403');
expect(fetchMock.mock.calls.map(([url]) => url)).toEqual([
'https://api.github.com/repos/SnowLuma/SnowLuma/releases/tags/v2.0.0',
`https://pinned.example/https://github.com/SnowLuma/SnowLuma/releases/download/v2.0.0/${assetName('2.0.0', 'win32-x64')}`,
]);
expect(await readdir(root)).toEqual([]);
});
it.each(['win32-x64', 'linux-x64', 'linux-arm64'])(
'downloads and validates the %s lite package',
async (target) => {

View File

@@ -0,0 +1,126 @@
import { afterEach, describe, expect, it, vi } from 'vitest';
import type { UpdateSourceConfig } from '@snowluma/common/update-source';
import {
assetName,
fetchRelease,
parseLatestReleasePage,
parseReleaseAssetsPage,
} from '../src/update/release';
const direct: UpdateSourceConfig = { mode: 'direct', mirror: '', mirrors: [] };
const latest =
'<meta property="og:url" content="https://github.com/SnowLuma/SnowLuma/releases/tag/v2.0.1">';
const digest = `sha256:${'a'.repeat(64)}`;
const name = assetName('2.0.1', 'win32-x64');
const row = `<li><a href="/SnowLuma/SnowLuma/releases/download/v2.0.1/${name}">${name}</a><clipboard-copy value="${digest}"></clipboard-copy></li>`;
afterEach(() => vi.unstubAllGlobals());
describe('existing GitHub release pages', () => {
it('reads the canonical stable release without a new metadata asset', () => {
expect(parseLatestReleasePage(latest)).toEqual({
tag_name: 'v2.0.1',
html_url: 'https://github.com/SnowLuma/SnowLuma/releases/tag/v2.0.1',
});
expect(parseLatestReleasePage(latest.replace('https://github.com', '')).tag_name).toBe(
'v2.0.1',
);
});
it.each([
'<html>please sign in</html>',
latest.replace('github.com', 'unrelated.example'),
latest.replace('/SnowLuma/SnowLuma/', '/other/project/'),
latest.replace('v2.0.1', 'v02.0.1'),
latest.replace('v2.0.1', 'v2.0.1-rc.1'),
])('rejects non-release or invalid version pages', (html) => {
expect(() => parseLatestReleasePage(html)).toThrow();
});
it('matches an asset with its own digest, ignoring rounded HTML sizes', () => {
expect(parseReleaseAssetsPage(row, '2.0.1')).toEqual({
tag_name: 'v2.0.1',
assets: [{ name, size: null, digest }],
});
});
it.each([
row.replace('v2.0.1/', 'v2.0.0/'),
row.replace(digest, 'unavailable'),
row + row,
row.replace(`<clipboard-copy value="${digest}"></clipboard-copy>`, '') +
`<li><clipboard-copy value="${digest}"></clipboard-copy></li>`,
])('rejects absent, ambiguous or neighbouring checksum data', (html) => {
expect(() => parseReleaseAssetsPage(html, '2.0.1')).toThrow();
});
it('falls back from API 403 to the existing release page', async () => {
const fetchMock = vi.fn<typeof fetch>(async (url) =>
String(url).includes('api.github.com')
? new Response('rate limited', { status: 403 })
: new Response(latest),
);
vi.stubGlobal('fetch', fetchMock);
expect(await fetchRelease(undefined, direct)).toMatchObject({
fromPage: true,
data: { tag_name: 'v2.0.1' },
});
expect(fetchMock.mock.calls.map(([url]) => url)).toEqual([
'https://api.github.com/repos/SnowLuma/SnowLuma/releases/latest',
'https://github.com/SnowLuma/SnowLuma/releases/latest',
]);
});
it('waits for a valid mirror page after fast invalid responses and cancels other requests', async () => {
let finish!: (response: Response) => void;
const pending = new Promise<Response>((resolve) => {
finish = resolve;
});
const fetchMock = vi.fn<typeof fetch>(async (url) => {
if (String(url).startsWith('https://working.example/')) {
return pending;
}
return new Response('HTML challenge');
});
vi.stubGlobal('fetch', fetchMock);
const result = fetchRelease('2.0.1', {
...direct,
mode: 'auto',
mirrors: ['https://bad.example', 'https://working.example'],
});
await vi.waitFor(() => expect(fetchMock).toHaveBeenCalledTimes(4));
finish(new Response(row));
expect(await result).toMatchObject({
fromPage: true,
data: { assets: [{ name, digest }] },
});
expect(fetchMock.mock.calls.slice(1).every(([, options]) => options?.signal?.aborted)).toBe(
true,
);
});
it('keeps direct release lookup when the pinned download mirror cannot serve pages', async () => {
const fetchMock = vi.fn<typeof fetch>(async (url) =>
String(url) === 'https://github.com/SnowLuma/SnowLuma/releases/latest'
? new Response(latest)
: new Response('blocked', { status: 403 }),
);
vi.stubGlobal('fetch', fetchMock);
expect(
await fetchRelease(undefined, {
...direct,
mode: 'mirror',
mirror: 'https://files.example',
}),
).toMatchObject({ data: { tag_name: 'v2.0.1' } });
});
it('rejects oversized release responses', async () => {
vi.stubGlobal(
'fetch',
vi.fn(async () => new Response('x'.repeat(1024 * 1024 + 1))),
);
await expect(fetchRelease(undefined, direct)).rejects.toThrow('发布信息过大');
});
});

View File

@@ -0,0 +1,105 @@
import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { readRuntimeConfig, updateRuntimeConfig } from '@snowluma/common/runtime';
import { createUpdateService } from '../src/update/service';
import { updateRoutes } from '../src/webui/update-routes';
let directory: string;
let previous: string;
beforeEach(() => {
directory = fs.mkdtempSync(path.join(os.tmpdir(), 'snowluma-update-sources-'));
previous = process.cwd();
process.chdir(directory);
});
afterEach(() => {
process.chdir(previous);
vi.restoreAllMocks();
vi.unstubAllGlobals();
fs.rmSync(directory, { recursive: true, force: true });
});
async function routes() {
return updateRoutes(await createUpdateService(undefined, '2.0.1'), vi.fn());
}
describe('update source routes', () => {
it('returns a JSON error when persisted source settings are invalid', async () => {
fs.mkdirSync('config');
fs.writeFileSync(
'config/runtime.json',
JSON.stringify({ updateSource: { mode: 'invalid' } }),
);
const response = await (await routes()).request('/sources');
expect(response.status).toBe(500);
expect(response.headers.get('content-type')).toContain('application/json');
expect(await response.json()).toMatchObject({
message: expect.stringContaining('模式无效'),
});
});
it('persists settings for subsequent reads without changing other runtime values', async () => {
updateRuntimeConfig({ webuiPort: 6789, webuiHost: '127.0.0.2' });
const app = await routes();
const config = {
mode: 'mirror',
mirror: 'https://example.com/proxy/',
mirrors: ['https://second.example/'],
};
const response = await app.request('/sources', {
method: 'POST',
body: JSON.stringify(config),
});
expect(response.status).toBe(200);
const normalized = {
...config,
mirror: 'https://example.com/proxy',
mirrors: ['https://second.example'],
};
expect(await response.json()).toMatchObject({
config: normalized,
saved: true,
applied: true,
errors: [],
});
expect(readRuntimeConfig()).toMatchObject({
updateSource: normalized,
webuiPort: 6789,
webuiHost: '127.0.0.2',
});
expect(await (await app.request('/sources')).json()).toEqual({ config: normalized });
});
it.each(['not json', '{}', '[]', '{"mode":"mirror","mirrors":[]}'])(
'rejects malformed input without saving or fetching: %s',
async (body) => {
const fetchMock = vi.fn();
vi.stubGlobal('fetch', fetchMock);
const app = await routes();
for (const endpoint of ['/sources', '/sources/test']) {
expect((await app.request(endpoint, { method: 'POST', body })).status).toBe(400);
}
expect(fetchMock).not.toHaveBeenCalled();
expect(fs.existsSync('config/runtime.json')).toBe(false);
},
);
it('reports a persistence failure without claiming the config was saved', async () => {
updateRuntimeConfig({ webuiPort: 6789 });
const before = fs.readFileSync('config/runtime.json', 'utf8');
vi.spyOn(fs, 'renameSync').mockImplementationOnce(() => {
throw new Error('disk replacement failed');
});
const response = await (
await routes()
).request('/sources', {
method: 'POST',
body: JSON.stringify({ mode: 'direct', mirror: '', mirrors: [] }),
});
expect(response.status).toBe(500);
expect(await response.json()).toEqual({ message: 'disk replacement failed' });
expect(fs.readFileSync('config/runtime.json', 'utf8')).toBe(before);
});
});

View File

@@ -0,0 +1,81 @@
import { afterEach, describe, expect, it, vi } from 'vitest';
import { DEFAULT_UPDATE_SOURCE, sourceUrls, testUpdateSources } from '../src/update/sources';
import type { UpdateSourceConfig } from '@snowluma/common/update-source';
const config: UpdateSourceConfig = {
mode: 'auto',
mirror: '',
mirrors: [
'https://good.example',
'https://html.example',
'https://fake.example',
'https://failed.example',
],
};
afterEach(() => vi.unstubAllGlobals());
describe('update mirror selection', () => {
it('uses direct, ordered fallback or only the pinned mirror for downloads', () => {
const url = 'https://github.com/project/asset';
expect(sourceUrls(url, config)).toEqual([
url,
...config.mirrors.map((mirror) => `${mirror}/${url}`),
]);
expect(sourceUrls(url, { ...config, mode: 'direct' })).toEqual([url]);
expect(
sourceUrls(url, { ...config, mode: 'mirror', mirror: 'https://pinned.example/proxy' }),
).toEqual([`https://pinned.example/proxy/${url}`]);
expect(DEFAULT_UPDATE_SOURCE.mirrors.length).toBeGreaterThanOrEqual(7);
});
it('probes actual archive prefixes, rejects HTML even with a binary content type, and cancels bodies', async () => {
const cancelled = vi.fn();
const signature =
process.platform === 'win32' ? [0x50, 0x4b, 0x03, 0x04] : [0x1f, 0x8b, 0x08, 0];
const fetchMock = vi.fn<typeof fetch>(async (url) => {
if (String(url).startsWith('https://html.example')) {
return new Response('<html>blocked</html>', {
headers: { 'Content-Type': 'text/html' },
});
}
if (String(url).startsWith('https://fake.example')) {
return new Response('<html>blocked</html>', {
headers: { 'Content-Type': 'application/octet-stream' },
});
}
if (String(url).startsWith('https://failed.example')) {
return new Response('blocked', { status: 403 });
}
return new Response(
new ReadableStream({
start(controller) {
controller.enqueue(new Uint8Array(signature));
},
cancel: cancelled,
}),
);
});
vi.stubGlobal('fetch', fetchMock);
const results = await testUpdateSources(config);
expect(
results
.filter((result) => result.available)
.map((result) => result.mirror)
.sort(),
).toEqual(['', 'https://good.example']);
expect(results.filter((result) => !result.available)).toHaveLength(3);
expect(results.at(-1)?.available).toBe(false);
expect(cancelled).toHaveBeenCalledTimes(2);
expect(
fetchMock.mock.calls.every(
([, options]) =>
options?.headers &&
'Range' in options.headers &&
options.headers.Range === 'bytes=0-3',
),
).toBe(true);
});
});

View File

@@ -1,5 +1,8 @@
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { getUpdateInfo } from '../src/update/check';
import { getUpdateInfo as checkUpdate } from '../src/update/check';
const getUpdateInfo = (force = false) =>
checkUpdate(force, { mode: 'direct', mirror: '', mirrors: [] });
const LATEST_RELEASE_URL = 'https://api.github.com/repos/SnowLuma/SnowLuma/releases/latest';
const NOTES_MAX = 4_000;
@@ -85,7 +88,7 @@ describe('getUpdateInfo', () => {
htmlUrl: null,
notes: null,
publishedAt: null,
error: 'ECONNRESET',
error: expect.stringContaining('ECONNRESET'),
});
fetchMock.mockImplementation(async () => jsonResponse({ tag_name: 'v1.0.0' }));
@@ -93,7 +96,7 @@ describe('getUpdateInfo', () => {
expect(ok.latest).toBe('1.0.0');
expect(ok.hasUpdate).toBe(true);
expect(ok.error).toBeUndefined();
expect(fetchMock).toHaveBeenCalledTimes(2);
expect(fetchMock).toHaveBeenCalledTimes(3);
});
it.each(['', '1', 'true', 'yes', 'on', ' '] as const)(
@@ -190,7 +193,7 @@ describe('getUpdateInfo', () => {
htmlUrl: null,
notes: null,
publishedAt: null,
error: 'github 403',
error: expect.stringContaining('GitHub 403'),
});
});
@@ -230,7 +233,7 @@ describe('getUpdateInfo', () => {
throw new Error('getaddrinfo ENOTFOUND');
});
const result = await getUpdateInfo(true);
expect(result.error).toBe('getaddrinfo ENOTFOUND');
expect(result.error).toContain('getaddrinfo ENOTFOUND');
expect(result.hasUpdate).toBe(false);
});
@@ -239,7 +242,7 @@ describe('getUpdateInfo', () => {
throw 'timeout';
});
const result = await getUpdateInfo(true);
expect(result.error).toBe('network error');
expect(result.error).toContain('timeout');
expect(result.hasUpdate).toBe(false);
});
@@ -257,7 +260,7 @@ describe('getUpdateInfo', () => {
throw new Error('boom');
});
await expect(getUpdateInfo(true)).resolves.toMatchObject({
error: 'boom',
error: expect.stringContaining('boom'),
hasUpdate: false,
});
});
@@ -298,12 +301,12 @@ describe('getUpdateInfo', () => {
throw new Error('boom');
});
const bad = await getUpdateInfo(true);
expect(bad.error).toBe('boom');
expect(bad.error).toContain('boom');
const cached = await getUpdateInfo();
expect(cached).toBe(good);
expect(cached.error).toBeUndefined();
expect(fetchMock).toHaveBeenCalledTimes(2);
expect(fetchMock).toHaveBeenCalledTimes(3);
});
it('collapses concurrent checks onto one fetch', async () => {
@@ -332,4 +335,15 @@ describe('getUpdateInfo', () => {
});
expect(fetchMock).toHaveBeenCalledTimes(1);
});
it('does not reuse the previous source configuration cache after a mirror change', async () => {
const source = { mode: 'auto', mirror: '', mirrors: ['https://first.example'] } as const;
const fetchMock = mockFetch(async () => jsonResponse({ tag_name: 'v3.0.0' }));
const first = await checkUpdate(false, { ...source, mirrors: [...source.mirrors] });
fetchMock.mockImplementation(async () => jsonResponse({ tag_name: 'v3.0.1' }));
const second = await checkUpdate(false, { ...source, mirrors: ['https://second.example'] });
expect(first.latest).toBe('3.0.0');
expect(second.latest).toBe('3.0.1');
expect(fetchMock).toHaveBeenCalledTimes(2);
});
});

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/mcp",
"version": "2.0.1",
"version": "2.0.2",
"description": "MCP server exposing the SnowLuma OneBot action catalog (docs + JSON Schemas) and optional execution to LLM clients.",
"repository": {
"type": "git",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/onebot",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "SnowLuma OneBot v11 adapter — the protocol translation layer that maps the public OneBot vocabulary (HTTP / WebSocket actions, message segments, post events) onto @snowluma/core's typed Api hub (`bridge.apis.<area>.method()`). Owns network adapters (HTTP server / HTTP client / WS server / WS client), the registered action handlers, the receive-side event→OneBot converter, message-id hashing, message store (SQLite-backed event history), media store, and the OneBot instance + manager that ties one OneBotConfig to one Bridge. Per-file subpath exports mirror the legacy `core/src/onebot/*` layout 1:1 so the previous `import { … } from '../onebot/<x>'` collapses to `import { … } from '@snowluma/onebot/<x>'`.",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/proto-defs",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "SnowLuma QQ/Lagrange wire-protobuf type definitions. Pure TypeScript interfaces with proton's `pb<N, T>` marker types — `@snowluma/proton`'s vite plugin compiles them into zero-runtime encoder/decoder functions at the call sites in `@snowluma/core` (and any downstream consumer). Exposed as per-file subpaths (`@snowluma/proto-defs/oidb`, `@snowluma/proto-defs/message`, …) so the import-site shape mirrors the legacy `bridge/proto/proton/*` layout and avoids name collisions across files (notably `highway.ts` and `oidb-actions/media.ts` share NTV2-prefixed names).",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/protocol",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "SnowLuma protocol — the protocol-layer between QQ wire bytes and typed events. Owns: identity service (uid↔uin cache with SQLite persistence), event bus, packet pipeline (incoming SSO packet → QQEventVariant), msg-push decoders, element-builder (MessageElement → wire elems[]), highway upload protocol (file/image/video/ptt), OIDB envelope helper, and the event/notice/request type vocabulary. Consumers (@snowluma/core, @snowluma/onebot) talk to this package through `BridgeContext` for runtime calls and the standalone classes (IdentityService, BridgeEventBus, IncomingPacketPipeline) for composition. Per-file subpath exports mirror the legacy `core/src/bridge/*` layout 1:1 so the previous `import { …} from '../bridge/<x>'` collapses to `import { … } from '@snowluma/protocol/<x>'`.",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/proton",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "Compile-time protobuf encoder/decoder generator for SnowLuma. TypeScript interfaces → fully-inlined, zero-runtime protobuf codec functions. Vendored from SnowLuma/protobuf-dsl with edge-case fixes applied.",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/runtime",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"main": "index.mjs",

View File

@@ -4,7 +4,7 @@
"name": "MotricSeven",
"email": "motricseven@gmail.com"
},
"version": "2.0.1",
"version": "2.0.2",
"description": "TypeScript SDK for SnowLuma OneBot HTTP and WebSocket transports",
"keywords": [
"snowluma",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/sqlite",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"description": "SnowLuma asynchronous SQLite facade, native loader and release assets.",

View File

@@ -4,7 +4,7 @@
"name": "MotricSeven",
"email": "motricseven@gmail.com"
},
"version": "2.0.1",
"version": "2.0.2",
"description": "Shared SnowLuma UI primitives — Tailwind 4 theme tokens + shadcn-style atomic components",
"keywords": [
"snowluma",

View File

@@ -1,7 +1,7 @@
{
"license": "SEE LICENSE IN LICENSE",
"name": "@snowluma/websocket",
"version": "2.0.1",
"version": "2.0.2",
"private": true,
"type": "module",
"main": "./src/index.ts",

View File

@@ -2,7 +2,7 @@
"license": "SEE LICENSE IN LICENSE",
"name": "webui",
"private": true,
"version": "2.0.1",
"version": "2.0.2",
"type": "module",
"scripts": {
"dev": "vite",

View File

@@ -95,6 +95,7 @@ import { NotificationsPanel } from '@/components/settings/notifications-panel';
import { GlobalConfigPanel } from '@/components/settings/global-config-panel';
import { SystemPanel } from '@/components/settings/system-panel';
import { UpdateInstaller } from '@/components/settings/update-installer';
import { UpdateSources } from '@/components/settings/update-sources';
import { StoragePanel } from '@/components/settings/storage-panel';
import { DeveloperCrashProbe, developerCrashReducer } from '@/components/settings/developer-tools';
@@ -2000,6 +2001,12 @@ function UpdateGroup() {
</div>
</SettingRow>
{detail}
{updateInfo?.error && !disabledCheck && (
<p role="alert" className="px-5 py-3 text-xs text-destructive">
{updateInfo.error}
</p>
)}
<UpdateSources />
<UpdateInstaller version={updateInfo?.hasUpdate ? updateInfo.latest : null} />
</Group>
);

View File

@@ -0,0 +1,267 @@
import { useEffect, useId, useState } from 'react';
import { normalizeUpdateSourceConfig } from '@snowluma/common/update-source';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Textarea } from '@/components/ui/textarea';
import { DropdownSelect } from '@/components/ui/dropdown-select';
import { SkeletonSwap } from '@/components/interior/skeleton-swap';
import { useActionFeedback } from '@/contexts/ActionFeedbackContext';
import { useApi } from '@/lib/api';
import type { UpdateSourceConfig, UpdateSourceProbe } from '@/types';
export function UpdateSources() {
const api = useApi();
const { runAction } = useActionFeedback();
const id = useId();
const [config, setConfig] = useState<UpdateSourceConfig | null>(null);
const [mirrors, setMirrors] = useState('');
const [results, setResults] = useState<UpdateSourceProbe[]>([]);
const [error, setError] = useState<string | null>(null);
const [busy, setBusy] = useState(false);
const [ready, setReady] = useState(false);
const [reload, setReload] = useState(0);
useEffect(() => {
let disposed = false;
setReady(false);
void api.update
.sources()
.then(({ config: next }) => {
if (!disposed) {
setConfig(next);
setMirrors(next.mirrors.join('\n'));
setError(null);
}
})
.catch((caught: unknown) => {
if (!disposed) {
setError(caught instanceof Error ? caught.message : String(caught));
}
})
.finally(() => {
if (!disposed) {
setReady(true);
}
});
return () => {
disposed = true;
};
}, [api, reload]);
const act = async (testing: boolean) => {
setBusy(true);
setError(null);
try {
await runAction(
{
title: testing ? '正在检测更新来源' : '正在保存更新来源',
successTitle: testing ? '来源检测完成' : '更新来源已保存',
successDetail: testing
? '检测从 SnowLuma 所在服务器发起'
: '下次检查和下载时生效',
errorTitle: testing ? '来源检测失败' : '保存失败',
},
async () => {
const next = normalizeUpdateSourceConfig({
...config,
mirrors: mirrors
.split(/\r?\n/)
.map((line) => line.trim())
.filter(Boolean),
});
if (testing) {
setResults((await api.update.testSources(next)).results);
} else {
const saved = await api.update.saveSources(next);
if (!saved.saved || !saved.applied) {
throw new Error(saved.errors.join(';') || saved.message);
}
setConfig(saved.config);
setMirrors(saved.config.mirrors.join('\n'));
setResults([]);
}
},
);
} catch (caught) {
setError(caught instanceof Error ? caught.message : String(caught));
} finally {
setBusy(false);
}
};
return (
<div className="flex flex-col gap-3 px-5 py-4">
<p className="text-sm font-medium">更新来源</p>
{error && (
<p role="alert" className="break-words text-xs text-destructive">
{error}
</p>
)}
<SkeletonSwap ready={ready} reserve={100} lines={3} label="更新来源">
{config ? (
<fieldset
disabled={busy}
className="flex min-w-0 flex-col gap-3 disabled:opacity-60"
>
<DropdownSelect
value={config.mode}
ariaLabel="下载来源模式"
options={[
{ value: 'auto', label: '自动切换' },
{ value: 'direct', label: 'GitHub 直连' },
{ value: 'mirror', label: '指定镜像' },
]}
onChange={(mode) => {
setConfig({ ...config, mode });
setResults([]);
}}
/>
<p className="text-xs text-muted-foreground">
自动模式先尝试
GitHub,失败后按列表顺序切换。镜像用于文件下载,版本查询也会尝试 GitHub
发布页面。
</p>
{config.mode === 'mirror' && (
<div className="flex flex-col gap-1.5">
<label htmlFor={`${id}-mirror`} className="text-xs">
指定镜像地址
</label>
<Input
id={`${id}-mirror`}
value={config.mirror}
placeholder="https://ghfast.top"
onChange={(event) => {
setConfig({ ...config, mirror: event.target.value });
setResults([]);
}}
/>
</div>
)}
<details>
<summary className="cursor-pointer text-xs">
编辑候选镜像(每行一个地址)
</summary>
<Textarea
aria-label="候选镜像地址"
className="mt-2 min-h-32 font-mono text-xs"
value={mirrors}
onChange={(event) => {
setMirrors(event.target.value);
setResults([]);
}}
/>
<p className="mt-1 text-xs text-muted-foreground">
地址后会追加完整 GitHub 链接;支持带路径的代理前缀。
</p>
</details>
<div className="flex flex-wrap gap-2">
<Button
size="sm"
variant="outline"
onClick={() => {
void act(true);
}}
>
检测可用性
</Button>
<Button
size="sm"
onClick={() => {
void act(false);
}}
>
保存来源
</Button>
</div>
{results.length > 0 && (
<div className="flex flex-col gap-2">
<p className="text-xs text-muted-foreground">
按可用性和响应延迟排序;检测结果不代表下载速度。
</p>
<ul className="flex max-h-64 flex-col gap-2 overflow-auto">
{results.map((result) => (
<li
key={result.mirror}
className="flex items-center gap-2 text-xs"
>
<div className="min-w-0 flex-1">
<p className="break-all">
{result.mirror || 'GitHub 直连'}
</p>
<p
className={
result.available
? 'text-success'
: 'text-destructive'
}
>
{result.available
? `可用 · ${result.latencyMs} ms`
: result.error || '不可用'}
</p>
</div>
{result.available && (
<Button
size="sm"
variant="outline"
onClick={() => {
setConfig({
...config,
mode: result.mirror
? 'mirror'
: 'direct',
mirror: result.mirror,
});
}}
>
选用
</Button>
)}
</li>
))}
</ul>
<Button
size="sm"
variant="outline"
className="self-start"
onClick={() => {
setMirrors(
results
.filter(
(result) => result.available && result.mirror,
)
.map((result) => result.mirror)
.join('\n'),
);
setConfig({ ...config, mode: 'auto' });
setResults([]);
}}
>
仅保留可用镜像
</Button>
<p className="text-xs text-muted-foreground">
选用或筛选后,点击「保存来源」生效。
</p>
</div>
)}
</fieldset>
) : (
ready && (
<Button
size="sm"
variant="outline"
onClick={() => setReload((value) => value + 1)}
>
重试
</Button>
)
)}
</SkeletonSwap>
</div>
);
}

View File

@@ -24,6 +24,9 @@ import type {
UiConfig,
UpdateInfo,
UpdateStatus,
UpdateSourceConfig,
UpdateSourceProbe,
UpdateSourceSaveResult,
} from '@/types';
import type { PasswordRule } from '@/components/pages/change-password-form';
import { normalizeOneBotConfig } from '@/lib/onebot-config';
@@ -175,6 +178,11 @@ class HttpApiClient implements ApiClient {
check: (force) =>
this.getJson<UpdateInfo>(`/api/update/check${force ? '?force=true' : ''}`),
status: () => this.getJson<UpdateStatus>('/api/update/status'),
sources: () => this.getJson<{ config: UpdateSourceConfig }>('/api/update/sources'),
saveSources: (config) =>
this.postJson<UpdateSourceSaveResult>('/api/update/sources', config),
testSources: (config) =>
this.postJson<{ results: UpdateSourceProbe[] }>('/api/update/sources/test', config),
download: (version) => this.postJson<UpdateStatus>('/api/update/download', { version }),
restart: () => this.postJson<UpdateStatus>('/api/update/restart'),
};

View File

@@ -28,6 +28,9 @@ import type {
UiConfig,
UpdateInfo,
UpdateStatus,
UpdateSourceConfig,
UpdateSourceProbe,
UpdateSourceSaveResult,
} from '@/types';
import type { PasswordRule } from '@/components/pages/change-password-form';
@@ -277,6 +280,9 @@ export interface ApiClient {
/** Advisory check for a newer stable release. Read-only — never downloads. */
check(force?: boolean): Promise<UpdateInfo>;
status(): Promise<UpdateStatus>;
sources(): Promise<{ config: UpdateSourceConfig }>;
saveSources(config: UpdateSourceConfig): Promise<UpdateSourceSaveResult>;
testSources(config: UpdateSourceConfig): Promise<{ results: UpdateSourceProbe[] }>;
download(version: string): Promise<UpdateStatus>;
restart(): Promise<UpdateStatus>;
};

View File

@@ -1,6 +1,24 @@
export const APP_NAME = 'SnowLuma';
// Injected at build time by Vite from the monorepo root package.json.
export { APP_VERSION } from '@snowluma/common/version';
import type { UpdateSourceConfig } from '@snowluma/common/update-source';
export type { UpdateSourceConfig } from '@snowluma/common/update-source';
export interface UpdateSourceProbe {
mirror: string;
available: boolean;
latencyMs: number;
error?: string;
}
export interface UpdateSourceSaveResult {
config: UpdateSourceConfig;
saved: boolean;
applied: boolean;
online: boolean;
errors: string[];
message: string;
}
export type UpdateStatus = { current: string } & (
| { phase: 'unavailable' | 'error'; message: string }

View File

@@ -4,6 +4,30 @@ import { createApiClient } from '../src/lib/api/client';
afterEach(() => vi.unstubAllGlobals());
describe('update API', () => {
it('loads, tests and saves mirror selection through authenticated object endpoints', async () => {
const config = { mode: 'auto', mirror: '', mirrors: ['https://example.com'] } as const;
const payload = { ...config, mirrors: [...config.mirrors] };
const fetchMock = vi.fn<typeof fetch>(async () =>
Response.json({ config: payload, results: [] }),
);
vi.stubGlobal('fetch', fetchMock);
const api = createApiClient({ tokenStore: { load: () => 'token', save: () => undefined } });
await api.update.sources();
await api.update.testSources(payload);
await api.update.saveSources(payload);
expect(fetchMock.mock.calls.map(([url]) => url)).toEqual([
'/api/update/sources',
'/api/update/sources/test',
'/api/update/sources',
]);
for (const [, options] of fetchMock.mock.calls) {
expect(new Headers(options?.headers).get('X-SnowLuma-Token')).toBe('token');
}
expect(fetchMock.mock.calls[1]?.[1]?.body).toBe(JSON.stringify(payload));
expect(fetchMock.mock.calls[2]?.[1]?.method).toBe('POST');
});
it('sends authenticated download and restart requests', async () => {
const fetchMock = vi.fn<typeof fetch>(async () =>
Response.json({ current: '1.0.0', phase: 'ready', version: '2.0.0' }),