Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
#!/usr/bin/env node
// `pnpm ui:check:publish [<run dir>] [--remote <name>] [--branch <name>] [--dry-run]`
// Publishes a run's screenshots for a PR description, the way this repo's PRs carry images:
// an orphan-history `pr-assets/…` branch on the author's fork (never the upstream repo), linked
// by commit SHA. The worktree, index and current branch are not touched. Prints the PR text.
import { execFileSync } from 'node:child_process';
import { existsSync } from 'node:fs';
import { readdir, readFile, stat, writeFile } from 'node:fs/promises';
import path from 'node:path';
import { root } from './build.mjs';
const git = (args, input) =>
execFileSync('git', args, {
cwd: root,
encoding: 'utf8',
input,
stdio: ['pipe', 'pipe', 'pipe'],
}).trim();
function parse(argv) {
const options = {};
for (let i = 0; i < argv.length; i++) {
const arg = argv[i];
if (arg === '--') continue;
if (arg === '--remote' || arg === '--branch') options[arg.slice(2)] = argv[++i];
else if (arg === '--dry-run') options.dryRun = true;
else if (arg.startsWith('--')) throw new Error(`Unknown option: ${arg}`);
else options.run = path.resolve(arg);
}
return options;
}
/** owner/repo of a GitHub remote URL, or null. */
function githubRepo(url) {
return /github\.com[:/]([^/]+\/[^/]+?)(?:\.git)?$/.exec(url)?.[1] ?? null;
}
async function latestRun() {
const base = path.join(root, 'artifacts/ui-check');
const runs = await Promise.all(
(await readdir(base, { withFileTypes: true }))
.filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
.map(async (entry) => {
const dir = path.join(base, entry.name);
return { dir, time: (await stat(dir)).mtimeMs };
}),
);
const run = runs
.filter((item) => existsSync(path.join(item.dir, 'pr.md')))
.sort((a, b) => b.time - a.time)[0];
if (!run) throw new Error('No ui:check run with pr.md; run pnpm ui:check first');
return run.dir;
}
async function main() {
const options = parse(process.argv.slice(2));
const run = options.run ?? (await latestRun());
const summary = JSON.parse(await readFile(path.join(run, 'summary.json'), 'utf8'));
const images = summary.overviews ?? (summary.overview ? [summary.overview] : []);
if (!images.length) throw new Error(`${run} has no overview images`);
// Images go to the author's fork, never to the repository PRs target: the project's own
// repository (package.json) and an `upstream` remote, if any. Checked against the URL git
// actually pushes to, which is also where the links point.
const remotes = git(['remote']).split('\n').filter(Boolean);
const pushRepo = (name) => githubRepo(git(['remote', 'get-url', '--push', name]));
const project = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
// GitHub owner and repository names are case-insensitive.
const targets = new Set(
[
githubRepo(project.repository?.url ?? ''),
remotes.includes('upstream') && githubRepo(git(['remote', 'get-url', 'upstream'])),
]
.filter(Boolean)
.map((name) => name.toLowerCase()),
);
const isTarget = (name) => targets.has(name.toLowerCase());
const remote =
options.remote ??
remotes.find((name) => {
const repo = pushRepo(name);
return repo && !isTarget(repo);
});
const repo = remote && pushRepo(remote);
if (!repo)
throw new Error('Need a GitHub fork remote for screenshots (e.g. origin = <you>/cindy)');
if (isTarget(repo))
throw new Error(`${remote} pushes to ${repo}, the PR's target; publish to your fork instead`);
const current = git(['rev-parse', '--abbrev-ref', 'HEAD']);
const branch = options.branch ?? `pr-assets/${current === 'HEAD' ? 'detached' : current}`;
const folder = path.basename(run);
// One commit per run under its own folder; earlier runs stay reachable through the parent.
const entries = [];
for (const file of images) {
const blob = git(['hash-object', '-w', file]);
entries.push(`100644 blob ${blob}\t${path.basename(file)}`);
}
const runTree = git(['mktree'], `${entries.join('\n')}\n`);
const tree = git(['mktree'], `040000 tree ${runTree}\t${folder}\n`);
let parent = '';
try {
parent = git(['ls-remote', remote, `refs/heads/${branch}`]).split('\t')[0];
if (parent) git(['fetch', '--quiet', remote, `refs/heads/${branch}`]);
} catch {
parent = '';
}
const message = `ui:check screenshots ${folder}\n\nNot for merging; referenced by PR descriptions.`;
const commit = git(['commit-tree', tree, ...(parent ? ['-p', parent] : []), '-m', message]);
if (!options.dryRun) git(['push', '--quiet', remote, `${commit}:refs/heads/${branch}`]);
const url = (file) =>
`https://raw.githubusercontent.com/${repo}/${commit}/${folder}/${path.basename(file)}`;
const text = (await readFile(path.join(run, 'pr.md'), 'utf8')).replace(
/\n<!-- 截图:[^\n]*-->\n?$/,
`\n${images.map((file, i) => `})`).join('\n')}\n`,
);
const out = path.join(run, 'pr.published.md');
await writeFile(out, text);
console.log(
`UI_PUBLISH${options.dryRun ? ' (dry run, not pushed)' : ''} ${repo}@${branch} ${commit.slice(0, 12)} · ${images.length} images\npr: ${out}\n`,
);
console.log(text);
}
main().catch((error) => {
console.error(`单页验证截图未能发布:${error.message.split('\n')[0]}`);
process.exitCode = 1;
});