添加下载代码功能

This commit is contained in:
2026-11-03 11:23:25 +08:00
parent eb12b23550
commit 4bb93bd9d3
6 changed files with 289 additions and 2 deletions
+28
View File
@@ -1009,6 +1009,34 @@ a.ws-badge:hover { color: var(--text); }
.ws-banner code { font-family: var(--mono); font-size: 12.5px; color: var(--text); }
.ws-banner a { color: var(--accent); cursor: pointer; margin-left: auto; }
.ws-hero + .p-tabs { margin-top: 28px; }
.p-tabs .ws-repo-toolbar { overflow: visible; justify-content: space-between; gap: 16px; }
.ws-tab-list { display: flex; gap: 6px; min-width: 0; overflow-x: auto; scrollbar-width: none; }
.ws-archive { position: relative; flex: 0 0 auto; }
.p-tabs .ws-archive-trigger { height: 36px; padding: 0 14px; gap: 8px; border: 1px solid var(--accent-line); border-radius: 9px; background: var(--accent-soft); color: var(--accent); font-size: 13px; font-weight: 600; }
.p-tabs .ws-archive-trigger:hover, .p-tabs .ws-archive-trigger[aria-expanded="true"] { background: var(--accent); color: var(--accent-ink); }
.p-tabs .ws-archive-trigger.is-downloading { color: var(--accent); background: var(--accent-soft); }
.ws-archive-pop { position: absolute; top: calc(100% + 10px); right: 0; width: min(330px, calc(100vw - 32px)); max-height: calc(100dvh - var(--nav) - 80px); overflow-y: auto; border: 1px solid var(--line-strong); border-radius: 14px; background: var(--surface); box-shadow: 0 20px 50px rgba(0, 0, 0, .5); }
.ws-archive-pop.opens-up { top: auto; bottom: calc(100% + 10px); }
.ws-archive-head { display: grid; gap: 4px; padding: 16px; border-bottom: 1px solid var(--line); }
.ws-archive-head b { font-size: 14px; font-weight: 600; }
.ws-archive-head > span { font-size: 12px; color: var(--muted); }
.ws-archive-options { padding: 6px; }
.p-tabs .ws-archive-options button { display: flex; width: 100%; height: auto; min-height: 44px; padding: 10px; border-radius: 8px; color: var(--text); font-size: 13.5px; text-align: left; }
.p-tabs .ws-archive-options button > span { margin-left: auto; color: var(--muted); font: 11px var(--mono); }
.p-tabs .ws-archive-options button:hover { background: var(--surface-2); }
.p-tabs .ws-archive-options button:disabled { opacity: .45; cursor: wait; }
.ws-archive-feedback { padding: 12px 16px; border-top: 1px solid var(--line); }
.ws-archive-feedback p { margin: 0; font-size: 12px; line-height: 1.7; color: var(--soft); overflow-wrap: anywhere; }
.ws-archive-feedback p.error { color: var(--danger); }
.p-tabs .ws-archive-feedback button { height: 36px; padding: 0 10px; margin-top: 10px; border: 1px solid var(--line-strong); border-radius: 8px; color: var(--text); font-size: 12px; }
.p-tabs .ws-archive-feedback button:hover { background: var(--surface-2); }
.ws-archive button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
@media (max-width: 600px) {
.p-tabs .ws-repo-toolbar { gap: 8px; }
.ws-tab-list { gap: 0; }
.p-tabs .ws-tab-list button { padding: 0 10px; gap: 6px; font-size: 13px; }
.p-tabs .ws-archive-trigger { height: 44px; padding: 0 10px; gap: 6px; font-size: 12px; }
}
.ws-body { padding-top: 28px; padding-bottom: 96px; display: grid; gap: 20px; }
.ws-head-left { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; min-width: 0; }
.ws-head-right { display: flex; gap: 8px; }
+41
View File
@@ -194,6 +194,47 @@ export async function downloadWorkspaceFile(code, path, commitSha) {
return res.blob();
}
// 归档可能需要数分钟:不走 JSON 封装,不设置短超时,取消覆盖整个响应体读取。
export async function downloadWorkspaceArchive(code, { format = 'zip', commitSha, signal } = {}) {
if (!['zip', 'tar.gz'].includes(format)) throw new ApiError(400, 'BAD_REQUEST', '不支持的下载格式');
if (commitSha !== undefined && !/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/i.test(commitSha)) {
throw new ApiError(400, 'BAD_REQUEST', '历史版本下载需要完整的提交 SHA');
}
const token = auth.token;
if (!token) throw new ApiError(401, 'UNAUTHORIZED', '请先登录后下载');
const type = format === 'zip' ? 'application/zip' : 'application/gzip';
const res = await fetch(`${API_BASE}/workspace/projects/${enc(code)}/archive?${toQuery({ format, commitSha })}`, {
headers: { Authorization: `Bearer ${token}`, Accept: type },
credentials: 'omit', cache: 'no-store', signal,
});
const requestId = res.headers.get('X-Request-Id');
if (!res.ok) {
if (res.status === 401) auth.clear();
const result = await res.json().catch(() => null);
const err = new ApiError(res.status, result?.code || 'BAD_RESPONSE', result?.message || `下载失败(HTTP ${res.status}),请稍后重试`, result?.requestId || requestId);
err.retryAfter = res.headers.get('Retry-After');
throw err;
}
if (res.headers.get('Content-Type')?.split(';')[0].trim().toLowerCase() !== type) {
await res.body?.cancel();
throw new ApiError(res.status, 'BAD_RESPONSE', '未收到有效的压缩包,请重新下载', requestId);
}
const blob = await res.blob();
const length = res.headers.get('Content-Length');
if (!blob.size || (length !== null && blob.size !== Number(length))) {
throw new ApiError(res.status, 'ARCHIVE_INCOMPLETE', '压缩包接收不完整,请重新下载', requestId);
}
if (signal?.aborted) throw new DOMException('下载已取消', 'AbortError');
const disposition = res.headers.get('Content-Disposition') || '';
const encoded = disposition.match(/filename\*=UTF-8''([^;]+)/i)?.[1];
const plain = disposition.match(/filename="([^"]+)"|filename=([^;\s]+)/i);
let filename = plain?.[1] || plain?.[2] || `${code}${commitSha ? `-${commitSha.slice(0, 12)}` : ''}.${format}`;
if (encoded) { try { filename = decodeURIComponent(encoded.trim()); } catch { /* 保留后备文件名 */ } }
filename = filename.replace(/[\\/\u0000-\u001f\u007f]/g, '_');
return { blob, filename };
}
// changes: [{ action: 'CREATE_FILE'|'UPDATE_FILE'|'DELETE_FILE'|'CREATE_DIRECTORY', path, content? }]
export const commitChanges = (code, expectedCommitSha, message, changes) =>
request(`/workspace/projects/${enc(code)}/commits`, { method: 'POST', body: { expectedCommitSha, message, changes }, auth: 'required' });
+120 -1
View File
@@ -177,8 +177,26 @@ async function initRepo() {
</div>
<div id="ws-banner"></div>
</header>
<nav class="p-tabs"><div class="container" id="ws-tabs"></div></nav>
<nav class="p-tabs ws-repo-tabs"><div class="container ws-repo-toolbar">
<div class="ws-tab-list" id="ws-tabs"></div>
<div class="ws-archive" id="ws-archive" hidden>
<button class="ws-archive-trigger" type="button" aria-expanded="false" aria-controls="ws-archive-pop" id="ws-archive-toggle">${icon('download', 15, 'aria-hidden="true"')}<span>下载文件</span>${icon('chevron', 13, 'aria-hidden="true"')}</button>
<div class="ws-archive-pop" id="ws-archive-pop" role="group" aria-labelledby="ws-archive-title" hidden>
<div class="ws-archive-head"><b id="ws-archive-title">下载项目文件</b><span id="ws-archive-version"></span></div>
<div class="ws-archive-options">
<button type="button" data-archive-format="zip">${icon('download', 16, 'aria-hidden="true"')}下载 ZIP<span>.zip</span></button>
<button type="button" data-archive-format="tar.gz">${icon('download', 16, 'aria-hidden="true"')}下载 TAR.GZ<span>.tar.gz</span></button>
</div>
<div class="ws-archive-feedback" hidden>
<p id="ws-archive-status" role="status" aria-live="polite" aria-atomic="true"></p>
<button class="ws-archive-cancel" type="button" hidden>取消下载</button>
<button class="ws-archive-login" type="button" hidden>重新登录</button>
</div>
</div>
</div>
</div></nav>
<section class="container ws-body" id="ws-main"></section>`;
initArchiveDownload();
$('ws-tabs').addEventListener('click', (e) => {
const b = e.target.closest('[data-tab]');
if (!b || !confirmLeave()) return;
@@ -236,11 +254,13 @@ async function renderHeader() {
: outdated ? `<div class="ws-banner">${icon('history', 14)}社区显示的是 <code>${short(p.publishedCommitSha)}</code>,工作区已经更新到 <code>${short(repo.head)}</code>。改动需要「更新社区版本」后其他人才能看到。</div>`
: '';
$('ws-banner').innerHTML = banner;
$('ws-archive').hidden = !ready();
$('ws-tabs').innerHTML = [['code', 'code', '代码'], ['history', 'history', '提交记录'], ['settings', 'gear', '设置']].map(([k, ic, label]) =>
`<button data-tab="${k}" class="${repo.tab === k ? 'active' : ''}">${icon(ic, 15)}${label}</button>`).join('');
}
function renderRepo() {
closeArchiveMenu();
urdfViewer?.dispose(); // 离开设置页时释放 3D 预览
urdfViewer = null;
$('ws-tabs').querySelectorAll('[data-tab]').forEach((b) => b.classList.toggle('active', b.dataset.tab === repo.tab));
@@ -253,6 +273,105 @@ function renderRepo() {
return renderBrowse();
}
// 下载入口独立于文件浏览区,切换标签或打开文件后仍可取消正在进行的下载。
let archiveController = null;
function closeArchiveMenu() {
const pop = $('ws-archive-pop');
if (pop) pop.hidden = true;
$('ws-archive-toggle')?.setAttribute('aria-expanded', 'false');
}
function initArchiveDownload() {
const wrap = $('ws-archive');
const toggle = $('ws-archive-toggle');
const pop = $('ws-archive-pop');
const status = $('ws-archive-status');
const feedback = wrap.querySelector('.ws-archive-feedback');
const cancel = wrap.querySelector('.ws-archive-cancel');
const login = wrap.querySelector('.ws-archive-login');
const options = [...wrap.querySelectorAll('[data-archive-format]')];
const position = () => {
if (pop.hidden) return;
const bounds = toggle.getBoundingClientRect();
const navHeight = parseFloat(getComputedStyle(document.documentElement).getPropertyValue('--nav')) || 0;
const above = bounds.top - navHeight - 22;
const below = innerHeight - bounds.bottom - 22;
const flip = below < 240 && above > below;
pop.classList.toggle('opens-up', flip);
pop.style.maxHeight = `${Math.max(44, flip ? above : below)}px`;
};
const show = () => {
if (!archiveController) $('ws-archive-version').textContent = repo.sha ? `历史版本 ${short(repo.sha)}` : 'main · 最新已提交版本';
pop.hidden = false;
toggle.setAttribute('aria-expanded', 'true');
position();
};
const message = (text, error = false) => {
feedback.hidden = false;
status.textContent = text;
status.classList.toggle('error', error);
};
toggle.addEventListener('click', () => { if (pop.hidden) show(); else closeArchiveMenu(); });
document.addEventListener('click', (e) => { if (!wrap.contains(e.target)) closeArchiveMenu(); });
wrap.addEventListener('focusout', (e) => { if (e.relatedTarget && !wrap.contains(e.relatedTarget)) closeArchiveMenu(); });
wrap.addEventListener('keydown', (e) => {
if (e.key === 'Escape' && !pop.hidden) { e.preventDefault(); closeArchiveMenu(); toggle.focus(); }
if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
e.preventDefault(); show();
const items = [...pop.querySelectorAll('button:not(:disabled):not([hidden])')];
const index = items.indexOf(document.activeElement);
const next = index < 0 ? (e.key === 'ArrowDown' ? 0 : items.length - 1) : (index + (e.key === 'ArrowDown' ? 1 : -1) + items.length) % items.length;
items[next]?.focus();
}
});
cancel.addEventListener('click', () => archiveController?.abort());
login.addEventListener('click', () => { closeArchiveMenu(); openLogin(); });
addEventListener('resize', position);
addEventListener('scroll', position, { passive: true });
addEventListener('pagehide', () => archiveController?.abort());
options.forEach((button) => button.addEventListener('click', async () => {
if (archiveController) return;
const controller = archiveController = new AbortController();
const format = button.dataset.archiveFormat;
const commitSha = repo.sha || undefined;
$('ws-archive-version').textContent = commitSha ? `历史版本 ${short(commitSha)}` : 'main · 最新已提交版本';
options.forEach((b) => { b.disabled = true; });
toggle.querySelector('span').textContent = '下载中…';
toggle.classList.add('is-downloading');
cancel.hidden = false;
login.hidden = true;
message(`正在准备并下载 ${format === 'zip' ? 'ZIP' : 'TAR.GZ'},请稍候…`);
cancel.focus();
try {
const { blob, filename } = await api.downloadWorkspaceArchive(code, { format, commitSha, signal: controller.signal });
if (controller.signal.aborted) return;
const url = URL.createObjectURL(blob);
const link = Object.assign(document.createElement('a'), { href: url, download: filename, hidden: true });
try { wrap.append(link); link.click(); }
finally { link.remove(); setTimeout(() => URL.revokeObjectURL(url), 1000); }
message('文件已准备好,请在浏览器下载列表中查看。若解压失败,请重新下载。');
toast('已开始保存压缩包');
} catch (err) {
if (controller.signal.aborted || err.name === 'AbortError') message('下载已取消,可以重新选择格式。');
else {
const hints = { 404: '项目或该版本已不存在,请刷新页面核对。', 409: '项目尚未就绪,请稍后刷新页面。', 413: '压缩包超过服务器允许的大小。', 429: '下载繁忙或操作过于频繁,请稍后重试。', 504: '下载超时,请稍后重新下载。' };
let text = hints[err.status] || api.errorText(err);
if (err.status === 429 && /^\d+$/.test(err.retryAfter || '')) text += `建议 ${err.retryAfter} 秒后重试。`;
if (err.requestId) text += ` 请求编号:${err.requestId}`;
message(text, true);
login.hidden = err.status !== 401;
}
} finally {
archiveController = null;
options.forEach((b) => { b.disabled = false; });
if (document.activeElement === cancel) options[0].focus();
cancel.hidden = true;
toggle.querySelector('span').textContent = '下载文件';
toggle.classList.remove('is-downloading');
}
}));
}
function go(next, push = true) {
if (!confirmLeave()) return;
Object.assign(repo, next);
+1
View File
@@ -9,6 +9,7 @@
"package:assembly-parts": "node scripts/assemble-microban.mjs",
"plan:assembly": "node scripts/plan-assembly-axes.mjs",
"test:assembly-planner": "node --test scripts/assembly-axis-planner.test.mjs",
"test:downloads": "node --test tests/repository-download.test.js",
"test:experiences": "node --test scripts/experience-packages.test.mjs scripts/model-assets.test.mjs scripts/project-resources.test.mjs scripts/assembly-motion.test.mjs scripts/assembly-explode.test.mjs",
"build": "npm run build:walking && node scripts/build.mjs",
"build:dev": "npm run build:walking && node scripts/build.mjs --env=dev"
+2 -1
View File
@@ -49,7 +49,8 @@ function proxy(req, res) {
res.writeHead(up.statusCode, out);
up.pipe(res);
});
upstream.setTimeout(120_000, () => upstream.destroy(new Error('后端响应超时')));
const archive = /^\/api\/workspace\/projects\/[^/]+\/archive(?:\?|$)/.test(req.url);
upstream.setTimeout(archive ? 400_000 : 120_000, () => upstream.destroy(new Error('后端响应超时')));
upstream.on('error', (err) => {
if (res.headersSent) { res.destroy(); return; }
res.writeHead(502, { 'Content-Type': 'application/json; charset=utf-8' });
+97
View File
@@ -0,0 +1,97 @@
import { test, beforeEach } from 'node:test';
import assert from 'node:assert/strict';
globalThis.location = { hostname: 'localhost' };
const storage = new Map();
globalThis.localStorage = {
getItem: (key) => storage.get(key) ?? null,
setItem: (key, value) => storage.set(key, value),
};
const { auth, ApiError, downloadWorkspaceArchive } = await import('../js/api.js');
const sha = 'b'.repeat(40);
const archive = (headers = {}, type = 'application/zip') => new Response('archive bytes', {
headers: { 'Content-Type': type, ...headers },
});
beforeEach(() => auth.set({ token: 'test-platform-token', user: { userCode: 'test-user' } }));
test('latest download carries Bearer auth only in headers and preserves the server filename', async (t) => {
t.mock.method(globalThis, 'fetch', async (url, options) => {
assert.equal(url, '/api/workspace/projects/project%2Fcode/archive?format=zip');
assert.equal(options.headers.Authorization, 'Bearer test-platform-token');
assert.equal(options.credentials, 'omit');
assert.equal(options.cache, 'no-store');
return archive({ 'Content-Disposition': "attachment; filename*=UTF-8''%E6%9C%BA%E5%99%A8%E4%BA%BA.zip" });
});
const result = await downloadWorkspaceArchive('project/code');
assert.equal(result.filename, '机器人.zip');
assert.equal(await result.blob.text(), 'archive bytes');
});
test('historical TAR.GZ uses the full SHA and a safe fallback filename', async (t) => {
t.mock.method(globalThis, 'fetch', async (url, options) => {
const query = new URL(url, 'http://localhost').searchParams;
assert.equal(query.get('format'), 'tar.gz');
assert.equal(query.get('commitSha'), sha);
assert.equal(options.headers.Accept, 'application/gzip');
return archive({}, 'application/gzip');
});
const result = await downloadWorkspaceArchive('project/code', { format: 'tar.gz', commitSha: sha });
assert.equal(result.filename, `project_code-${sha.slice(0, 12)}.tar.gz`);
});
test('missing login and abbreviated historical SHAs fail before a network request', async (t) => {
const fetch = t.mock.method(globalThis, 'fetch', () => assert.fail('unexpected request'));
await assert.rejects(downloadWorkspaceArchive('project', { commitSha: sha.slice(0, 7) }), { code: 'BAD_REQUEST' });
await assert.rejects(downloadWorkspaceArchive('project', { format: 'rar' }), { code: 'BAD_REQUEST' });
auth.clear();
await assert.rejects(downloadWorkspaceArchive('project'), { status: 401 });
assert.equal(fetch.mock.callCount(), 0);
});
test('rate limits retain Retry-After and request ID; proxy HTML has a useful fallback', async (t) => {
t.mock.method(globalThis, 'fetch', async () => new Response(JSON.stringify({ code: 'ARCHIVE_BUSY', message: '下载繁忙' }), {
status: 429, headers: { 'Retry-After': '30', 'X-Request-Id': 'request-busy' },
}));
await assert.rejects(downloadWorkspaceArchive('project'), (err) => {
assert.ok(err instanceof ApiError);
assert.equal(err.code, 'ARCHIVE_BUSY');
assert.equal(err.retryAfter, '30');
assert.equal(err.requestId, 'request-busy');
return true;
});
globalThis.fetch = async () => new Response('<html>Bad gateway</html>', { status: 502 });
await assert.rejects(downloadWorkspaceArchive('project'), { status: 502, code: 'BAD_RESPONSE' });
});
test('expired authentication clears the website login state', async (t) => {
t.mock.method(globalThis, 'fetch', async () => new Response(JSON.stringify({ code: 'UNAUTHORIZED', message: '请重新登录' }), { status: 401 }));
await assert.rejects(downloadWorkspaceArchive('project'), { status: 401 });
assert.equal(auth.token, null);
});
test('JSON masquerading as a success and incomplete archives cannot be saved', async (t) => {
t.mock.method(globalThis, 'fetch', async () => new Response('{"code":"OK"}', { headers: { 'Content-Type': 'application/json' } }));
await assert.rejects(downloadWorkspaceArchive('project'), { code: 'BAD_RESPONSE' });
globalThis.fetch = async () => archive({ 'Content-Length': '999' });
await assert.rejects(downloadWorkspaceArchive('project'), { code: 'ARCHIVE_INCOMPLETE' });
});
test('cancellation after response headers aborts reading and discards the partial archive', async (t) => {
const controller = new AbortController();
let bodyStarted;
const reading = new Promise((resolve) => { bodyStarted = resolve; });
t.mock.method(globalThis, 'fetch', async (url, { signal }) => {
assert.equal(signal, controller.signal);
return new Response(new ReadableStream({
start(stream) {
stream.enqueue(new TextEncoder().encode('partial'));
signal.addEventListener('abort', () => stream.error(new DOMException('cancelled', 'AbortError')), { once: true });
bodyStarted();
},
}), { headers: { 'Content-Type': 'application/zip' } });
});
const result = downloadWorkspaceArchive('project', { signal: controller.signal });
await reading;
controller.abort();
await assert.rejects(result, { name: 'AbortError' });
});