Spot it. Save it. Free, local-first Chrome extension for images, videos and prompts. Explore 2,000+ curated cases and connect your library to AI Agents via MCP. 提示词导演
JavaScript ai-artai-videochrome-extensionclaude-codecodexhiggsfieldjimenglocal-firstmcpmidjourneymoodboardprompt-engineeringprompt-libraryprompt-managerreference-libraryseedancevisual-bookmarksweb-clipper
import { readImageGenerationInfo } from "./image-generation-info.js";
import { createSearchIndexCache } from "./search-index.js";
import { materializeLogicalCases, normalizeCompoundCases } from "./compound-cases.js";
import { entryMediaAssets } from "./media.js";
import { filterCaseSearchEntries, searchCaseResult, caseSearchSourceSummary, caseSearchPage } from "./case-search.js";
import { describeCaseQuery } from './case-query-fields.js';
import { caseTextPage } from './case-text-page.js';
import { caseTextPart } from "./composer-library-tools.js";
import { AGENT_CHUNK_BYTES, agentDownloadChunkBytes, agentError, bytesToBase64, requireInteger } from "./agent-protocol.js";
import { detailPromptSources } from "./prompt-sources.js";
import { sha256Blob } from "./blob-digest.js";
import { resolveCaseMediaId } from './media-identity-aliases.js';
import { assertCaseFilesReadable, caseFilesUnavailable } from './case-file-status.js';
import { startPhase } from './perf-trace.js';
// Explicit projections: never return GET_STATE or model runtime credentials.
export function createAgentLibrary({ loadState, readBlob, readDerived, readDerivedMetadata, libraryUrl }) {
const searchCache = createSearchIndexCache();
async function load() {
const state = await loadState();
return { ...state, entries: materializeLogicalCases(state.entries, normalizeCompoundCases(state.compoundCases, state.entries)) };
}
async function documents(entries) {
const docs = new Map();
for (const entry of entries.filter(entry => !caseFilesUnavailable(entry))) for (const asset of entryMediaAssets(entry)) {
if (asset.kind === "document" && !docs.has(asset.id)) docs.set(asset.id, (await readDerived(asset.id))?.searchText || "");
}
return docs;
}
function summary(entry) {
return { caseId: entry.id, title: entry.title, sourceUrl: entry.url || "", savedAt: entry.savedAt,
...(caseFilesUnavailable(entry) ? { availability: 'recovery-only', readOnly: true } : {}),
tags: entry.customLabels || [], openUrl: `${libraryUrl}?case=${encodeURIComponent(entry.id)}`,
media: entryMediaAssets(entry).map(asset => ({
assetId: asset.id, kind: asset.kind, mimeType: asset.mimeType, name: asset.sourceTitle || "",
byteSize: asset.byteSize, ...(asset.durationMs ? { durationMs: asset.durationMs } : {}), storageMode: asset.storageMode, usage: asset.usage || "",
sourceUrl: asset.sourceUrl || ""
})) };
}
function find(state, id) {
const entry = state.entries.find(item => item.id === id);
if (!entry) throw agentError("case_not_found", "案例不存在或已删除,请重新搜索。");
assertCaseFilesReadable(entry);
return entry;
}
return {
async describeQuery() {
let done = startPhase("agent", "describe:load");
const state = await load();
done();
done = startPhase("agent", "describe:fields");
try { return describeCaseQuery(state.entries, state); } finally { done(); }
},
async search(input = {}) {
const { query = "", offset = 0, limit = 24 } = input;
requireInteger(offset); requireInteger(limit, { min: 1, max: 100 });
let done = startPhase("agent", "search:load");
const state = await load();
done();
const { minDurationMs, maxDurationMs, hasOriginalPrompt, hasPrompt, ...indexScope } = input;
filterCaseSearchEntries([], state.organizerState, input);
const scoped = filterCaseSearchEntries(state.entries, state.organizerState, indexScope);
done = startPhase("agent", "search:derived");
const docs = await documents(scoped);
const derived = await readDerivedMetadata();
done();
done = startPhase("agent", "search:index");
const { index, resultVersion } = searchCache.build(scoped, state.facetCatalog, docs, derived, new Set(state.entries.map(e => e.id)));
done();
// Coverage must include unknown-duration candidates; structural project/type
// scoping happens below, while index reads already skip unrelated projects.
done = startPhase("agent", "search:match");
const result = await searchCaseResult(state.entries, index, state.organizerState, input, resultVersion, { ...state, documentTextByAsset: docs, derivedMetadataByAsset: derived });
done();
const { matches: entries, revision, durationCoverage, engagementCoverage } = result;
const page = caseSearchPage(result, input, limit, entry => ({ ...summary(entry), sources: caseSearchSourceSummary(entry, input), excerpt: caseFilesUnavailable(entry) ? '' : String(entry.text || "").slice(0, 240), excerptOnly: true }));
return { ...page, query, revision, ...(durationCoverage ? { durationCoverage } : {}), ...(engagementCoverage ? { engagementCoverage } : {}), total: entries.length, offset,
basis: "本地文字、标签和媒体元数据;未进行视觉识别。" };
},
async read({ caseId, assetId, part = "body", offset = 0, length = 12000, expectedRevision }) {
requireInteger(offset); requireInteger(length, { min: 1, max: AGENT_CHUNK_BYTES / 4 });
const entry = find(await load(), caseId);
assetId = resolveCaseMediaId(entry, assetId);
const docs = part === "document" ? await documents([entry]) : new Map();
const byEntry = new Map([[entry.id, entryMediaAssets(entry).map(asset => docs.get(asset.id) || "").filter(Boolean).join("\n")]]);
const asset = part === "generation_info" ? entryMediaAssets(entry).find(item => item.id === assetId && item.kind === "image" && item.usage !== "poster") : null;
if (part === "generation_info" && !asset) throw agentError("asset_not_in_case", "请指定该案例中的原始图片。");
let generationInfo = asset?.generationInfo ?? null;
if (part === "generation_info" && !generationInfo) {
const original = await readBlob(asset.id);
if (original) generationInfo = await readImageGenerationInfo(original);
}
let assetOriginal;
if (part === "original_prompt" && assetId) {
const sources = entry.memberEntries?.length ? entry.memberEntries : [entry];
const matching = sources.flatMap(source => entryMediaAssets(source)
.filter(item => item.id === assetId && item.usage !== "poster")
.map(asset => detailPromptSources(source, asset).original));
if (!matching.length) throw agentError("asset_not_in_case", "请指定该案例中的原始素材。");
if (new Set(matching).size > 1) throw agentError("ambiguous_asset_prompt", "组合成员对同一素材保存了不同原词,请用 read_case_details 读取各成员的媒体提示词关系。");
assetOriginal = matching[0];
}
const text = part === "generation_info" ? JSON.stringify(generationInfo)
: assetOriginal !== undefined ? assetOriginal
: part === "media_prompts" ? JSON.stringify(entry.mediaPrompts || [])
: caseTextPart(entry, part, byEntry);
return { caseId: entry.id, ...(assetId ? { assetId } : {}), title: entry.title, sourceUrl: entry.url || '',
openUrl: `${libraryUrl}?case=${encodeURIComponent(entry.id)}`, part,
...await caseTextPage({ caseId: entry.id, assetId, part, text, offset, length, expectedRevision }) };
},
async media({ caseId, assetId, offset = 0, expectedHash }) {
requireInteger(offset);
const entry = find(await load(), caseId);
assetId = resolveCaseMediaId(entry, assetId);
const asset = entryMediaAssets(entry).find(item => item.id === assetId);
if (!asset) throw agentError("asset_not_in_case", "该媒体不属于指定案例。");
const blob = await readBlob(assetId);
if (!blob) throw agentError("asset_not_local", "没有可读取的本地原件,请先在插件中补齐素材或恢复文件授权。");
if (expectedHash && !/^[a-f0-9]{64}$/u.test(expectedHash)) throw agentError("invalid_input", "原件摘要无效。");
// Hash the starting original once. The receiver hashes the assembled file
// and rejects any concurrent content change; avoid rehashing GBs per chunk.
const hash = offset === 0 || !expectedHash ? await sha256Blob(blob) : expectedHash;
if (offset > blob.size) throw agentError("invalid_input", "读取位置超出原件大小。");
const bytes = new Uint8Array(await blob.slice(offset, offset + agentDownloadChunkBytes()).arrayBuffer());
return { assetId, mimeType: blob.type || asset.mimeType, name: asset.sourceTitle || assetId,
byteSize: blob.size, sha256: hash, offset, data: bytesToBase64(bytes),
nextOffset: offset + bytes.length < blob.size ? offset + bytes.length : null };
}
};
}