@alpsckr/unitycli 0.4.0

package/dist/services/docs-reflect-cache.js

@@ -0,0 +1,301 @@
+import { access, readFile, readdir, stat } from "node:fs/promises";
+import { basename, extname, join, relative, resolve, sep } from "node:path";
+import { StructuredToolError } from "../tools/errors.js";
+export class CacheError extends Error {
+    code;
+    nextActions;
+    constructor(code, message, nextActions = []) {
+        super(message);
+        this.code = code;
+        this.nextActions = nextActions;
+    }
+}
+const docsIndexCandidates = ["docs-index.json", "unity-docs.json", "docs.json", "index.json"];
+const reflectIndexCandidates = ["reflect-index.json", "unity-reflect.json", "reflect.json", "index.json"];
+/** 解析文档 cache 目录；只读取显式输入、环境变量和 dataDir。 */
+export function docsCacheDir(docsDir, dataDir) {
+    return resolve(docsDir ?? process.env.UNITY_CLI_DOCS_DIR ?? join(dataDir, "docs"));
+}
+/** 解析反射 cache 目录；只读取显式输入、环境变量和 dataDir。 */
+export function reflectCacheDir(reflectDir, dataDir) {
+    return resolve(reflectDir ?? process.env.UNITY_CLI_REFLECT_DIR ?? join(dataDir, "reflect"));
+}
+/** 读取文档索引或 Markdown 文件树，返回规范化 cache；副作用仅为文件读取。 */
+export async function loadDocsCache(root) {
+    await assertDirectory(root, "DOCS_CACHE_MISSING", "Unity documentation cache was not found.", [
+        "Pass --docs-dir <path> or set UNITY_CLI_DOCS_DIR.",
+        "Populate the cache with index.json/docs.json or Markdown files before running offline docs queries."
+    ]);
+    const json = await readFirstJson(root, docsIndexCandidates);
+    if (json)
+        return { ...normalizeIndex(json.data, root, "docs"), root, indexPath: json.path };
+    const entries = await readMarkdownDocs(root);
+    if (entries.length === 0) {
+        throw new CacheError("DOCS_CACHE_MISSING", "Unity documentation cache has no readable index or Markdown files.", [
+            "Add docs-index.json, unity-docs.json, docs.json, index.json, or *.md files.",
+            "Pass --docs-dir <path> pointing at a populated cache."
+        ]);
+    }
+    return { root, entries, diagnostics: [] };
+}
+/** 读取并规范化反射索引；副作用仅为文件读取。 */
+export async function loadReflectCache(root) {
+    await assertDirectory(root, "REFLECT_CACHE_MISSING", "Unity reflection cache was not found.", [
+        "Pass --reflect-dir <path> or set UNITY_CLI_REFLECT_DIR.",
+        "Generate a reflection index from the selected Live Editor."
+    ]);
+    const json = await readFirstJson(root, reflectIndexCandidates);
+    if (!json) {
+        throw new CacheError("REFLECT_CACHE_MISSING", "Unity reflection cache has no readable index file.", [
+            "Add reflect-index.json, unity-reflect.json, reflect.json, or index.json.",
+            "Regenerate the reflection cache from the selected Live Editor."
+        ]);
+    }
+    return { ...normalizeIndex(json.data, root, "reflect"), root, indexPath: json.path };
+}
+/** 按请求版本筛选条目；无匹配时抛出带稳定 code 的 cache 错误。 */
+export function filterVersion(cache, requested, code) {
+    if (!requested)
+        return cache;
+    const withVersions = cache.entries.filter((entry) => entry.version ?? cache.unityVersion);
+    const matches = cache.entries.filter((entry) => versionMatches(entry.version ?? cache.unityVersion, requested));
+    if (withVersions.length > 0 && matches.length === 0) {
+        const available = [...new Set(withVersions.map((entry) => entry.version ?? cache.unityVersion).filter(Boolean))];
+        throw new CacheError(code, `Unity version was not found in cache: ${requested}.`, [`Available versions: ${available.join(", ") || "unknown"}.`]);
+    }
+    return { ...cache, entries: matches.length > 0 ? matches : cache.entries, unityVersion: requested };
+}
+/** 延迟读取文档正文；读取失败时保留索引条目，不产生写入。 */
+export async function hydrateContent(entry, root) {
+    if (entry.content || !entry.path)
+        return entry;
+    try {
+        return { ...entry, content: await readFile(resolve(root, entry.path), "utf8") };
+    }
+    catch {
+        return entry;
+    }
+}
+/** 按 cursor 和 pageSize 截取结果并生成 continuation 信息。 */
+export function paginate(items, options) {
+    const pageSize = Math.max(1, Math.min(options.pageSize ?? 20, 500));
+    const cursor = Math.max(0, Number.parseInt(options.cursor ?? "0", 10) || 0);
+    const pageItems = items.slice(cursor, cursor + pageSize);
+    const next = cursor + pageItems.length;
+    return { items: pageItems, pageInfo: { pageSize, cursor: String(cursor), ...(next < items.length ? { nextCursor: String(next) } : {}), total: items.length } };
+}
+/** 将 cache 异常转换为工具层结构化错误，保留 code 和恢复动作。 */
+export function cacheError(error) {
+    if (error instanceof StructuredToolError)
+        return error;
+    if (error instanceof CacheError)
+        return new StructuredToolError(error.code, error.message, error.nextActions);
+    return new StructuredToolError("CACHE_READ_FAILED", error instanceof Error ? error.message : String(error));
+}
+/** 返回适合公开输出的文档字段，可按需携带正文。 */
+export function publicDoc(entry, includeContent) {
+    return compact({ name: entry.name, title: entry.title, summary: entry.summary, kind: entry.kind, namespace: entry.namespace, version: entry.version, url: entry.url, path: entry.path, content: includeContent ? entry.content : undefined });
+}
+/** 返回适合公开输出的类型字段，可按需展开成员。 */
+export function publicType(entry, includeMembers) {
+    return compact({ name: entry.name, fullName: entry.fullName ?? entry.name, namespace: entry.namespace, kind: entry.kind, assembly: entry.assembly, signature: entry.signature, summary: entry.summary, members: includeMembers ? (entry.members ?? []).map((member) => publicMember(member, entry)) : undefined });
+}
+/** 返回适合公开输出的成员字段，并补充声明类型和程序集。 */
+export function publicMember(member, type) {
+    return compact({ name: member.name, kind: member.kind, signature: member.signature, returnType: member.returnType, parameters: member.parameters, summary: member.summary, assembly: member.assembly ?? type.assembly, declaringType: type.fullName ?? type.name });
+}
+/** 返回 cache 的公开来源信息。 */
+export function cacheSource(cache) {
+    return compact({ cacheDir: cache.root, indexPath: cache.indexPath });
+}
+/** 返回 cache 解析出的 Unity 版本。 */
+export function unityVersion(cache) {
+    return compact({ resolved: cache.unityVersion });
+}
+/** 只返回程序集相关诊断，避免混入其他 cache 警告。 */
+export function assemblyDiagnostics(cache) {
+    return cache.diagnostics.filter((diagnostic) => diagnostic.code.includes("ASSEMBLY"));
+}
+/** 精确匹配类型短名、全名或标题，匹配不区分大小写。 */
+export function typeMatches(entries, query) {
+    const target = normalize(query);
+    return entries.filter((entry) => [entry.fullName, entry.name, entry.title].some((value) => normalize(value) === target));
+}
+/** 精确匹配文档名、全名或标题，匹配不区分大小写。 */
+export function entryMatchesName(entry, query) {
+    const target = normalize(query);
+    return [entry.name, entry.fullName, entry.title].some((value) => normalize(value) === target);
+}
+/** 对 cache 条目进行相关性评分并稳定排序。 */
+export function scoreEntries(entries, query) {
+    return entries.map((entry) => ({ entry, score: scoreEntry(entry, query) })).sort((left, right) => right.score - left.score || left.entry.name.localeCompare(right.entry.name));
+}
+/** 计算单条 cache 记录的字段加权相关性。 */
+export function scoreEntry(entry, query) {
+    return scoreText(entry.name, query) * 4 + scoreText(entry.fullName, query) * 4 + scoreText(entry.title, query) * 3 + scoreText(entry.summary, query) * 2 + scoreText(entry.signature, query) + scoreText(entry.content, query);
+}
+/** 计算文本与查询的精确、前缀或包含匹配分值。 */
+export function scoreText(value, query) {
+    if (!value)
+        return 0;
+    const text = normalize(value);
+    const target = normalize(query);
+    if (text === target)
+        return 4;
+    if (text.startsWith(target))
+        return 3;
+    return text.includes(target) ? 1 : 0;
+}
+/** 将文档条目渲染为纯文本输出。 */
+export function docText(doc) {
+    return [doc.title ?? doc.name, doc.summary, doc.content, doc.url].filter(Boolean).join("\n\n");
+}
+/** 将类型及其成员摘要渲染为纯文本输出。 */
+export function typeText(type) {
+    const members = Array.isArray(type.members) ? type.members : [];
+    return [`${type.fullName ?? type.name}${type.assembly ? ` (${type.assembly})` : ""}`, type.signature, type.summary, ...members.map((member) => `- ${member.signature ?? member.name}`)].filter(Boolean).join("\n");
+}
+/** 将单个成员详情渲染为纯文本输出。 */
+export function memberText(type, member) {
+    return [`${type.fullName ?? type.name}.${member.name}`, member.signature, member.summary, member.assembly ? `Assembly: ${member.assembly}` : undefined].filter(Boolean).join("\n");
+}
+/** 将反射搜索项渲染为单行文本。 */
+export function reflectSearchLine(item) {
+    const object = asObject(item);
+    if (object.kind === "member") {
+        const member = asObject(object.member);
+        return `member ${member.declaringType}.${member.name} - ${member.signature ?? ""}`.trim();
+    }
+    return `type ${object.fullName ?? object.name} - ${object.assembly ?? ""}`.trim();
+}
+/** 校验路径存在且为目录；失败时统一为指定 cache 错误。 */
+async function assertDirectory(path, code, message, nextActions) {
+    try {
+        if (!(await stat(path)).isDirectory())
+            throw new CacheError(code, message, nextActions);
+    }
+    catch (error) {
+        if (error instanceof CacheError)
+            throw error;
+        throw new CacheError(code, message, nextActions);
+    }
+}
+/** 按候选顺序读取首个合法 JSON 索引；不存在或解析失败时继续尝试。 */
+async function readFirstJson(root, names) {
+    for (const name of names) {
+        const path = join(root, name);
+        try {
+            await access(path);
+            return { path, data: JSON.parse(await readFile(path, "utf8")) };
+        }
+        catch {
+            // 候选文件缺失或损坏时继续检查下一名称。
+        }
+    }
+    return undefined;
+}
+/** 将外部索引结构规范化为 docs/reflect 共用 cache 模型。 */
+function normalizeIndex(data, root, kind) {
+    const object = asObject(data);
+    const entries = rawEntries(data, kind).map(normalizeEntry);
+    const assemblies = (rawArray(object.assemblies) ?? []).map(normalizeAssembly);
+    const diagnostics = (rawArray(object.diagnostics) ?? []).map(normalizeDiagnostic).filter((item) => item !== undefined);
+    for (const assembly of assemblies) {
+        if (assembly.status === "failed" || assembly.status === "missing" || assembly.error) {
+            diagnostics.push({ level: "error", code: "REFLECT_ASSEMBLY_LOAD_FAILED", message: assembly.error ?? `Assembly could not be loaded: ${assembly.name}.`, assembly: assembly.name, path: assembly.path });
+        }
+    }
+    return { root, unityVersion: stringField(object, "unityVersion") ?? stringField(object, "version"), entries, assemblies, diagnostics };
+}
+/** 从数组或名称映射中提取原始条目列表。 */
+function rawEntries(data, kind) {
+    if (Array.isArray(data))
+        return data;
+    const object = asObject(data);
+    const direct = rawArray(object.entries) ?? rawArray(object.items) ?? rawArray(kind === "docs" ? object.docs : object.types) ?? rawArray(kind === "docs" ? object.apis : undefined);
+    if (direct)
+        return direct;
+    const map = kind === "docs" ? asObject(object.docs ?? object.apis) : asObject(object.types);
+    return Object.entries(map).map(([name, value]) => ({ name, ...asObject(value) }));
+}
+/** 将一个外部条目规范化并递归处理成员。 */
+function normalizeEntry(value) {
+    const object = asObject(value);
+    const fullName = stringField(object, "fullName") ?? stringField(object, "qualifiedName");
+    return {
+        name: stringField(object, "name") ?? stringField(object, "api") ?? fullName ?? stringField(object, "title") ?? "unknown",
+        title: stringField(object, "title"), summary: stringField(object, "summary") ?? stringField(object, "description"),
+        content: stringField(object, "content") ?? stringField(object, "markdown") ?? stringField(object, "text"),
+        url: stringField(object, "url") ?? stringField(object, "href"), kind: stringField(object, "kind") ?? stringField(object, "type"),
+        namespace: stringField(object, "namespace"), version: stringField(object, "unityVersion") ?? stringField(object, "version"),
+        path: stringField(object, "path") ?? stringField(object, "file") ?? stringField(object, "contentPath"),
+        assembly: stringField(object, "assembly") ?? stringField(object, "assemblyName"), fullName,
+        signature: stringField(object, "signature"), returnType: stringField(object, "returnType"), parameters: object.parameters,
+        members: (rawArray(object.members) ?? []).map(normalizeEntry)
+    };
+}
+/** 将程序集状态规范化为公开诊断使用的结构。 */
+function normalizeAssembly(value) {
+    const object = asObject(value);
+    return { name: stringField(object, "name") ?? stringField(object, "assembly") ?? basename(stringField(object, "path") ?? "unknown"), path: stringField(object, "path"), status: stringField(object, "status"), error: stringField(object, "error") ?? stringField(object, "message") };
+}
+/** 校验并规范化外部诊断；缺少 code/message 的记录被忽略。 */
+function normalizeDiagnostic(value) {
+    const object = asObject(value);
+    const code = stringField(object, "code");
+    const message = stringField(object, "message");
+    if (!code || !message)
+        return undefined;
+    const level = stringField(object, "level");
+    return { level: level === "info" || level === "warning" || level === "error" ? level : "warning", code, message, assembly: stringField(object, "assembly"), path: stringField(object, "path") };
+}
+/** 遍历文本文件并生成文档 cache 条目；副作用仅为目录和文件读取。 */
+async function readMarkdownDocs(root) {
+    const files = await walk(root);
+    const docs = [];
+    for (const file of files.filter((path) => [".md", ".markdown", ".txt"].includes(extname(path).toLowerCase()))) {
+        const content = await readFile(file, "utf8");
+        const title = content.split(/\r?\n/).find((line) => line.startsWith("# "))?.replace(/^#\s+/, "").trim();
+        docs.push({ name: basename(file, extname(file)), title, summary: firstParagraph(content), content, path: relativeCachePath(root, file) });
+    }
+    return docs;
+}
+/** 递归列出目录内文件；副作用仅为目录读取。 */
+async function walk(root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    return (await Promise.all(entries.map(async (entry) => entry.isDirectory() ? walk(join(root, entry.name)) : [join(root, entry.name)]))).flat();
+}
+/** 判断 cache 版本与请求版本是否互为兼容前缀。 */
+function versionMatches(version, requested) {
+    return !!version && (version === requested || version.startsWith(`${requested}.`) || requested.startsWith(`${version}.`));
+}
+/** 提取 Markdown 首个非空正文段落作为摘要。 */
+function firstParagraph(content) {
+    return content.split(/\r?\n\s*\r?\n/).map((part) => part.replace(/^#.*$/m, "").trim()).find(Boolean);
+}
+/** 将文件路径转换为跨平台 cache 相对路径。 */
+function relativeCachePath(root, file) {
+    return relative(root, file).split(sep).join("/");
+}
+/** 规范化可选字符串以供不区分大小写比较。 */
+function normalize(value) {
+    return (value ?? "").trim().toLowerCase();
+}
+/** 从未知对象中读取非空字符串字段。 */
+function stringField(object, key) {
+    const value = object[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/** 将未知值收窄为数组。 */
+function rawArray(value) {
+    return Array.isArray(value) ? value : undefined;
+}
+/** 将未知值收窄为普通对象，其他输入返回空对象。 */
+function asObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+/** 删除公开输出中的 undefined 字段。 */
+function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+//# sourceMappingURL=docs-reflect-cache.js.map

package/dist/services/docs-reflect-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-reflect-cache.js","sourceRoot":"","sources":["../../src/services/docs-reflect-cache.ts"],"names":[],"mappings":"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"}

package/dist/services/docs-service.d.ts

@@ -0,0 +1,16 @@
+import type { DocsGetRequest, DocsGetResult } from "../tools/docs/get.js";
+import type { DocsSearchRequest, DocsSearchResult } from "../tools/docs/search.js";
+export interface DocsServiceRuntime {
+    dataDir: string;
+    fetch?: DocsFetcher;
+}
+type DocsFetcher = (url: string) => Promise<{
+    ok: boolean;
+    status: number;
+    text: () => Promise<string>;
+}>;
+/** 读取单个 Unity API 文档；输入为 typed request，输出为业务结果，副作用仅为 cache/网络读取。 */
+export declare function getDocs(request: DocsGetRequest, runtime: DocsServiceRuntime): Promise<DocsGetResult>;
+/** 搜索 Unity API 文档；优先 cache 并保留 cursor 分页，必要时只读访问在线文档。 */
+export declare function searchDocs(request: DocsSearchRequest, runtime: DocsServiceRuntime): Promise<DocsSearchResult>;
+export {};

package/dist/services/docs-service.js

@@ -0,0 +1,208 @@
+import { StructuredToolError } from "../tools/errors.js";
+import { cacheError, cacheSource, docsCacheDir, docText, entryMatchesName, filterVersion, hydrateContent, loadDocsCache, paginate, publicDoc, scoreEntries, unityVersion } from "./docs-reflect-cache.js";
+/** 读取单个 Unity API 文档；输入为 typed request，输出为业务结果，副作用仅为 cache/网络读取。 */
+export async function getDocs(request, runtime) {
+    let cacheFailure;
+    try {
+        const root = docsCacheDir(request.docsDir, runtime.dataDir);
+        const cache = filterVersion(await loadDocsCache(root), request.unityVersion, "DOCS_VERSION_NOT_FOUND");
+        const matches = cache.entries.filter((entry) => entryMatchesName(entry, request.api));
+        if (matches.length === 0) {
+            cacheFailure = new StructuredToolError("DOCS_API_NOT_FOUND", `Unity API documentation was not found in the offline cache: ${request.api}.`, [
+                "Run tools run docs.search --input '{\"query\":\"<query>\"}' to inspect cached APIs.",
+                "Pass --docs-dir <path> or set UNITY_CLI_DOCS_DIR to a populated cache."
+            ]);
+        }
+        else if (matches.length > 1) {
+            throw new StructuredToolError("DOCS_API_AMBIGUOUS", `Multiple cached Unity APIs matched: ${request.api}.`, [
+                `Use one of: ${matches.slice(0, 5).map((entry) => entry.name).join(", ")}.`
+            ]);
+        }
+        else {
+            const doc = await hydrateContent(matches[0], cache.root);
+            const format = outputFormat(request.format);
+            return {
+                mode: "offline",
+                requiresUnity: false,
+                source: cacheSource(cache),
+                unityVersion: unityVersion(cache),
+                api: request.api,
+                format,
+                doc: publicDoc(doc, format === "json"),
+                ...(format === "text" ? { text: docText(doc) } : {})
+            };
+        }
+    }
+    catch (error) {
+        cacheFailure = cacheError(error);
+        if (cacheFailure.code === "DOCS_API_AMBIGUOUS")
+            throw cacheFailure;
+    }
+    if (shouldUseOnlineFallback(request, cacheFailure)) {
+        return getDocsOnline(request, runtime, cacheFailure);
+    }
+    throw cacheFailure;
+}
+/** 搜索 Unity API 文档；优先 cache 并保留 cursor 分页，必要时只读访问在线文档。 */
+export async function searchDocs(request, runtime) {
+    let cacheFailure;
+    try {
+        const root = docsCacheDir(request.docsDir, runtime.dataDir);
+        const cache = filterVersion(await loadDocsCache(root), request.unityVersion, "DOCS_VERSION_NOT_FOUND");
+        const items = scoreEntries(cache.entries, request.query).filter((entry) => entry.score > 0).map(({ entry }) => publicDoc(entry, false));
+        if (items.length === 0 && !request.offlineOnly) {
+            const notFound = new StructuredToolError("DOCS_QUERY_NOT_FOUND", `No offline docs matched: ${request.query}.`, ["Try a broader query or provide a populated docs cache."]);
+            return searchDocsOnline(request, runtime, notFound);
+        }
+        const page = paginate(items, request);
+        const format = outputFormat(request.format);
+        return {
+            mode: "offline",
+            requiresUnity: false,
+            source: cacheSource(cache),
+            unityVersion: unityVersion(cache),
+            query: request.query,
+            format,
+            items: page.items,
+            pageInfo: page.pageInfo,
+            ...(format === "text" ? { text: page.items.map((entry) => `${entry.name} - ${entry.title ?? entry.summary ?? ""}`.trim()).join("\n") } : {})
+        };
+    }
+    catch (error) {
+        cacheFailure = cacheError(error);
+    }
+    if (shouldUseOnlineFallback(request, cacheFailure)) {
+        return searchDocsOnline(request, runtime, cacheFailure);
+    }
+    throw cacheFailure;
+}
+/** 根据显式离线配置和 cache 来源决定是否允许网络 fallback，不产生副作用。 */
+function shouldUseOnlineFallback(request, error) {
+    if (request.offlineOnly)
+        return false;
+    const explicitCache = request.docsDir !== undefined || process.env.UNITY_CLI_DOCS_DIR !== undefined;
+    const missingExplicitCache = explicitCache && error.code === "DOCS_CACHE_MISSING";
+    return !missingExplicitCache || request.onlineFallback === true;
+}
+/** 在线读取单个 API 文档；网络不可用时抛出保留离线错误详情的结构化错误。 */
+async function getDocsOnline(request, runtime, offlineError) {
+    const fetcher = docsFetcher(runtime);
+    if (!fetcher)
+        throw offlineError;
+    const candidates = docsUrlCandidates(request.api);
+    for (const url of candidates) {
+        const response = await safeFetch(fetcher, url);
+        if (!response?.ok)
+            continue;
+        const html = await response.text();
+        const title = extractTitle(html) ?? request.api;
+        const content = htmlToText(html);
+        const format = outputFormat(request.format);
+        const doc = { name: request.api, title, summary: firstSentence(content), content, url, kind: "online" };
+        return {
+            mode: "online",
+            requiresUnity: false,
+            source: { kind: "online", url, offlineFallbackFrom: offlineError.code },
+            unityVersion: unityVersionHint(request.unityVersion),
+            api: request.api,
+            format,
+            doc: (format === "json" ? doc : { name: doc.name, title: doc.title, summary: doc.summary, url: doc.url, kind: doc.kind }),
+            diagnostics: [{ level: "warning", code: "DOCS_ONLINE_FALLBACK", message: `Offline docs failed with ${offlineError.code}; fetched docs.unity3d.com instead.` }],
+            ...(format === "text" ? { text: content } : {})
+        };
+    }
+    throw new StructuredToolError("DOCS_ONLINE_UNAVAILABLE", `Unity online documentation was not reachable for: ${request.api}.`, [
+        "Retry later, pass --offline-only to skip online lookup, or provide --docs-dir with a populated cache."
+    ], { offlineError: offlineError.code, attemptedUrls: candidates });
+}
+/** 在线搜索 API 文档并分页；网络不可用时返回稳定错误 code 和尝试 URL。 */
+async function searchDocsOnline(request, runtime, offlineError) {
+    const fetcher = docsFetcher(runtime);
+    if (!fetcher)
+        throw offlineError;
+    const url = `https://docs.unity3d.com/ScriptReference/30_search.html?q=${encodeURIComponent(request.query)}`;
+    const response = await safeFetch(fetcher, url);
+    if (!response?.ok) {
+        throw new StructuredToolError("DOCS_ONLINE_UNAVAILABLE", `Unity online documentation search was not reachable for: ${request.query}.`, [
+            "Retry later, pass --offline-only to skip online lookup, or provide --docs-dir with a populated cache."
+        ], { offlineError: offlineError.code, attemptedUrl: url });
+    }
+    const page = paginate(extractSearchItems(await response.text(), request.query), request);
+    const format = outputFormat(request.format);
+    return {
+        mode: "online",
+        requiresUnity: false,
+        source: { kind: "online", url, offlineFallbackFrom: offlineError.code },
+        unityVersion: unityVersionHint(request.unityVersion),
+        query: request.query,
+        format,
+        diagnostics: [{ level: "warning", code: "DOCS_ONLINE_FALLBACK", message: `Offline docs failed with ${offlineError.code}; searched docs.unity3d.com instead.` }],
+        items: page.items,
+        pageInfo: page.pageInfo,
+        ...(format === "text" ? { text: page.items.map((entry) => `${entry.name} - ${entry.summary ?? ""}`.trim()).join("\n") } : {})
+    };
+}
+/** 取得宿主 fetch 或全局 fetch，并统一为可注入接口。 */
+function docsFetcher(runtime) {
+    if (runtime.fetch)
+        return runtime.fetch;
+    if (typeof fetch !== "function")
+        return undefined;
+    return async (url) => {
+        const response = await fetch(url);
+        return { ok: response.ok, status: response.status, text: () => response.text() };
+    };
+}
+/** 执行一次网络读取；网络异常被视为候选不可用。 */
+async function safeFetch(fetcher, url) {
+    try {
+        return await fetcher(url);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 为 API 名生成去重后的 Unity ScriptReference URL 候选。 */
+function docsUrlCandidates(api) {
+    const normalized = api.trim();
+    const shortName = normalized.replace(/^UnityEngine\./, "").replace(/^UnityEditor\./, "");
+    return Array.from(new Set([
+        `https://docs.unity3d.com/ScriptReference/${normalized}.html`,
+        `https://docs.unity3d.com/ScriptReference/${shortName}.html`,
+        `https://docs.unity3d.com/ScriptReference/${shortName.replace(/\./g, "-")}.html`
+    ]));
+}
+/** 从 HTML title 中提取文档标题。 */
+function extractTitle(html) {
+    return html.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1]?.replace(/\s*-\s*Unity.*$/i, "").trim();
+}
+/** 删除脚本、样式和标签并解码常用实体，生成纯文本。 */
+function htmlToText(html) {
+    return html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/\s+/g, " ").trim();
+}
+/** 提取最多 240 字符的首句作为摘要。 */
+function firstSentence(text) {
+    return text.split(/(?<=[.!?])\s+/)[0]?.slice(0, 240) ?? "";
+}
+/** 从在线搜索 HTML 提取链接；无结果时保留可访问的搜索入口。 */
+function extractSearchItems(html, query) {
+    const items = Array.from(html.matchAll(/<a[^>]+href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi)).map((match) => {
+        const href = match[1];
+        const title = htmlToText(match[2]);
+        if (!href || !title)
+            return undefined;
+        const url = href.startsWith("http") ? href : `https://docs.unity3d.com/ScriptReference/${href.replace(/^\.\//, "")}`;
+        return { name: title, title, summary: url, url, kind: "online" };
+    }).filter((item) => item !== undefined);
+    const url = `https://docs.unity3d.com/ScriptReference/30_search.html?q=${encodeURIComponent(query)}`;
+    return items.length > 0 ? items : [{ name: query, title: query, summary: `Online Unity documentation search for ${query}.`, url, kind: "online" }];
+}
+/** 规范化用户请求的输出格式。 */
+function outputFormat(format) {
+    return format === "text" ? "text" : "json";
+}
+/** 生成在线结果使用的 Unity 版本提示。 */
+function unityVersionHint(requested) {
+    return { requested, resolved: requested, source: "online" };
+}
+//# sourceMappingURL=docs-service.js.map

package/dist/services/docs-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-service.js","sourceRoot":"","sources":["../../src/services/docs-service.ts"],"names":[],"mappings":"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"}

package/dist/services/reflect-service.d.ts

@@ -0,0 +1,12 @@
+import type { ReflectMemberRequest, ReflectMemberResult } from "../tools/reflect/member.js";
+import type { ReflectSearchRequest, ReflectSearchResult } from "../tools/reflect/search.js";
+import type { ReflectTypeRequest, ReflectTypeResult } from "../tools/reflect/type.js";
+export interface ReflectServiceRuntime {
+    dataDir: string;
+}
+/** 读取反射 cache 中的类型及成员；输入为 typed request，副作用仅为 cache 文件读取。 */
+export declare function getReflectType(request: ReflectTypeRequest, runtime: ReflectServiceRuntime): Promise<ReflectTypeResult>;
+/** 读取反射 cache 中的单个成员签名；最后一个点用于分隔类型和成员。 */
+export declare function getReflectMember(request: ReflectMemberRequest, runtime: ReflectServiceRuntime): Promise<ReflectMemberResult>;
+/** 搜索反射 cache 中的类型和成员，按相关性排序并返回 cursor 分页。 */
+export declare function searchReflect(request: ReflectSearchRequest, runtime: ReflectServiceRuntime): Promise<ReflectSearchResult>;