更新 lib/market.js
This commit is contained in:
parent
e0aa005e58
commit
b872e99cc9
|
|
@ -0,0 +1,217 @@
|
|||
/**
|
||||
* Skill market providers (P3).
|
||||
*
|
||||
* A provider answers `search` / `getDetail` / `resolveArtifact` for ONE
|
||||
* configured, verified source. The browser half never passes a repository URL:
|
||||
* it only names a provider id and an entry id, so no request can make the host
|
||||
* fetch an arbitrary address or clone an arbitrary repository.
|
||||
*
|
||||
* First provider: the Claude Code plugin marketplace manifest that lives at
|
||||
* `.claude-plugin/marketplace.json` in a public GitHub repository. That format
|
||||
* lists plugins, each with a description and the relative folders of the skills
|
||||
* it ships. Installing an entry reuses the same staged plan/commit pipeline as
|
||||
* a manual git install, pinned to the commit resolved here.
|
||||
*/
|
||||
import { parseSkillFrontmatter } from "./skill-sync.js";
|
||||
/** Typed failure so routes can map it to a status code. */
|
||||
export class MarketError extends Error {
|
||||
code;
|
||||
constructor(code, message) {
|
||||
super(message);
|
||||
this.code = code;
|
||||
this.name = 'MarketError';
|
||||
}
|
||||
}
|
||||
/** Normalize a manifest skill path to a folder name (its basename). */
|
||||
function folderOf(skillPath) {
|
||||
const trimmed = skillPath.replace(/^\.\//, '').replace(/\/+$/, '');
|
||||
const parts = trimmed.split('/');
|
||||
return parts[parts.length - 1] ?? trimmed;
|
||||
}
|
||||
/** Provider over a Claude Code plugin marketplace manifest on GitHub. */
|
||||
export class ClaudePluginMarketplaceProvider {
|
||||
options;
|
||||
cache = new Map();
|
||||
fetchImpl;
|
||||
constructor(options) {
|
||||
this.options = options;
|
||||
this.fetchImpl = options.fetchImpl ?? fetch;
|
||||
}
|
||||
info() {
|
||||
return {
|
||||
id: this.options.id,
|
||||
label: this.options.label,
|
||||
description: this.options.description,
|
||||
source: this.options.repo,
|
||||
homepage: this.options.homepage ?? `https://github.com/${this.options.repo}`,
|
||||
};
|
||||
}
|
||||
ref() {
|
||||
return this.options.ref ?? 'main';
|
||||
}
|
||||
timeoutMs() {
|
||||
return this.options.timeoutMs ?? 8000;
|
||||
}
|
||||
rawUrl(path) {
|
||||
const clean = path.replace(/^\.\//, '');
|
||||
return `https://raw.githubusercontent.com/${this.options.repo}/${encodeURIComponent(this.ref())}/${clean}`;
|
||||
}
|
||||
async fetchText(url) {
|
||||
let response;
|
||||
try {
|
||||
response = await this.fetchImpl(url, {
|
||||
headers: { accept: 'application/json, text/plain, */*', 'user-agent': 'dsh-brain-market' },
|
||||
signal: AbortSignal.timeout(this.timeoutMs()),
|
||||
});
|
||||
}
|
||||
catch (error) {
|
||||
throw new MarketError('unreachable', `市场来源不可达:${error instanceof Error ? error.message : String(error)}`);
|
||||
}
|
||||
if (!response.ok) {
|
||||
throw new MarketError('http_' + String(response.status), `市场来源返回 HTTP ${response.status}`);
|
||||
}
|
||||
return response.text();
|
||||
}
|
||||
async fetchJson(url, ttlMs = 60_000) {
|
||||
const hit = this.cache.get(url);
|
||||
if (hit !== undefined && Date.now() - hit.at < ttlMs)
|
||||
return hit.value;
|
||||
const text = await this.fetchText(url);
|
||||
let parsed;
|
||||
try {
|
||||
parsed = JSON.parse(text);
|
||||
}
|
||||
catch {
|
||||
throw new MarketError('invalid_manifest', '市场清单不是合法 JSON。');
|
||||
}
|
||||
this.cache.set(url, { at: Date.now(), value: parsed });
|
||||
return parsed;
|
||||
}
|
||||
async manifest() {
|
||||
const parsed = await this.fetchJson(this.rawUrl('.claude-plugin/marketplace.json'));
|
||||
if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
||||
throw new MarketError('invalid_manifest', '市场清单结构不正确。');
|
||||
}
|
||||
return parsed;
|
||||
}
|
||||
entriesOf(manifest) {
|
||||
const list = Array.isArray(manifest.plugins) ? manifest.plugins : [];
|
||||
const version = manifest.metadata?.version;
|
||||
const author = manifest.owner?.name;
|
||||
const entries = [];
|
||||
for (const plugin of list) {
|
||||
const name = typeof plugin.name === 'string' ? plugin.name : '';
|
||||
if (name === '')
|
||||
continue;
|
||||
const paths = Array.isArray(plugin.skills) ? plugin.skills.filter((p) => typeof p === 'string') : [];
|
||||
const entry = {
|
||||
id: name,
|
||||
providerId: this.options.id,
|
||||
name,
|
||||
description: typeof plugin.description === 'string' ? plugin.description : '',
|
||||
skills: paths.map(folderOf),
|
||||
skillPaths: paths,
|
||||
sourceRepo: this.options.repo,
|
||||
sourceUrl: `https://github.com/${this.options.repo}`,
|
||||
};
|
||||
if (typeof version === 'string')
|
||||
entry.version = version;
|
||||
if (typeof author === 'string')
|
||||
entry.author = author;
|
||||
entries.push(entry);
|
||||
}
|
||||
return entries;
|
||||
}
|
||||
async search(query, cursor) {
|
||||
const entries = this.entriesOf(await this.manifest());
|
||||
const needle = query.trim().toLowerCase();
|
||||
const filtered = needle === ''
|
||||
? entries
|
||||
: entries.filter((entry) => `${entry.name}\n${entry.description}\n${entry.skills.join(' ')}`.toLowerCase().includes(needle));
|
||||
const pageSize = 10;
|
||||
const start = Number.isFinite(cursor) && cursor > 0 ? Math.floor(cursor) : 0;
|
||||
const page = filtered.slice(start, start + pageSize);
|
||||
const next = start + pageSize < filtered.length ? start + pageSize : undefined;
|
||||
return next === undefined ? { entries: page } : { entries: page, nextCursor: next };
|
||||
}
|
||||
findEntry(manifest, entryId) {
|
||||
const entry = this.entriesOf(manifest).find((item) => item.id === entryId);
|
||||
if (entry === undefined)
|
||||
throw new MarketError('not_found', `市场里没有条目:${entryId}`);
|
||||
return entry;
|
||||
}
|
||||
async getDetail(entryId) {
|
||||
const entry = this.findEntry(await this.manifest(), entryId);
|
||||
const skillDetails = [];
|
||||
// Bound the fan-out: a manifest can list dozens of skills.
|
||||
for (const path of entry.skillPaths.slice(0, 24)) {
|
||||
const folder = folderOf(path);
|
||||
try {
|
||||
const markdown = await this.fetchText(this.rawUrl(`${path.replace(/^\.\//, '')}/SKILL.md`));
|
||||
const frontmatter = parseSkillFrontmatter(markdown);
|
||||
const detail = { folder, path, ok: true };
|
||||
if (typeof frontmatter.name === 'string')
|
||||
detail.name = frontmatter.name;
|
||||
if (typeof frontmatter.description === 'string')
|
||||
detail.description = frontmatter.description.slice(0, 300);
|
||||
skillDetails.push(detail);
|
||||
}
|
||||
catch {
|
||||
skillDetails.push({ folder, path, ok: false });
|
||||
}
|
||||
}
|
||||
return { ...entry, skillDetails, fetchedAt: Date.now() };
|
||||
}
|
||||
async resolveArtifact(entryId, _version) {
|
||||
const entry = this.findEntry(await this.manifest(), entryId);
|
||||
let commit;
|
||||
try {
|
||||
const payload = await this.fetchJson(`https://api.github.com/repos/${this.options.repo}/commits/${encodeURIComponent(this.ref())}`, 30_000);
|
||||
if (typeof payload.sha === 'string' && /^[0-9a-f]{7,40}$/i.test(payload.sha))
|
||||
commit = payload.sha;
|
||||
}
|
||||
catch {
|
||||
// Rate-limited or offline: fall back to the branch ref; git checkout pins
|
||||
// the actual commit at clone time and the install records it.
|
||||
}
|
||||
const artifact = {
|
||||
repoUrl: `https://github.com/${this.options.repo}.git`,
|
||||
ref: commit ?? this.ref(),
|
||||
folders: entry.skills,
|
||||
};
|
||||
if (commit !== undefined)
|
||||
artifact.commit = commit;
|
||||
if (entry.version !== undefined)
|
||||
artifact.version = entry.version;
|
||||
return artifact;
|
||||
}
|
||||
}
|
||||
/** A small registry of providers; the browser can only ask for one by id. */
|
||||
export class MarketService {
|
||||
byId = new Map();
|
||||
constructor(providers) {
|
||||
for (const provider of providers)
|
||||
this.byId.set(provider.info().id, provider);
|
||||
}
|
||||
list() {
|
||||
return [...this.byId.values()].map((provider) => provider.info());
|
||||
}
|
||||
has(providerId) {
|
||||
return this.byId.has(providerId);
|
||||
}
|
||||
get(providerId) {
|
||||
const provider = this.byId.get(providerId);
|
||||
if (provider === undefined)
|
||||
throw new MarketError('unknown_provider', `未知的市场来源:${providerId}`);
|
||||
return provider;
|
||||
}
|
||||
search(providerId, query, cursor) {
|
||||
return this.get(providerId).search(query, cursor);
|
||||
}
|
||||
detail(providerId, entryId) {
|
||||
return this.get(providerId).getDetail(entryId);
|
||||
}
|
||||
resolve(providerId, entryId, version) {
|
||||
return this.get(providerId).resolveArtifact(entryId, version);
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue