@tnnevol/dsh-zcode 0.0.0-stage → 6.0.6

package/lib/routes-DhHLL5UC.d.ts

@@ -0,0 +1,244 @@
+import { E as ZCodeEndpointPlan, o as ZCodeConsoleClient } from "./console-client-54wUcPDA.js";
+import { t as ZCodeAuthService } from "./auth-B99K5y4S.js";
+import { g as ZCodeModel, i as ZCodeCatalogService } from "./catalog-CnI_VsFm.js";
+import { Api, Model, Provider } from "@earendil-works/pi-ai";
+import { ReasoningEffortId } from "@deepseek-ai/dsh-llm";
+import { Context } from "@deepseek-ai/cordis";
+import { IncomingMessage } from "node:http";
+import { AttachmentStore } from "@deepseek-ai/dsh-attachment";
+import { ResolvedPiAiProviderProfile } from "@deepseek-ai/dsh-llm-pi-ai";
+//#region src/contracts/preferences.d.ts
+/** 对话输入区用量胶囊的显隐策略。 */
+type ZCodeUsageVisibility = 'auto' | 'always' | 'off';
+/** 持久化的插件偏好。 */
+interface ZCodePreferences {
+  /** `auto`：仅选中 ZCode 模型时显示；`always`：常驻；`off`：隐藏并停止轮询。 */
+  readonly usageVisibility: ZCodeUsageVisibility;
+  /** 目录与额度的自动刷新间隔（分钟）；0 表示关闭自动刷新。 */
+  readonly refreshMinutes: number;
+  /** 在模型选择器里隐藏的模型 id。 */
+  readonly hiddenModels: readonly string[];
+  /**
+   * 推理端点策略：`start-plan` 用账号 JWT 消耗套餐额度，`ultra` 用家族
+   * MaaS 令牌消耗按量余额。二者对第三方客户端的可达性不同，故由用户选择。
+   */
+  readonly endpointPlan: ZCodeEndpointPlan;
+}
+declare const DEFAULT_ZCODE_PREFERENCES: ZCodePreferences;
+/** 合法刷新间隔范围（分钟）；下限 1 避免把额度接口打成轮询。 */
+declare const ZCODE_REFRESH_MINUTES: {
+  readonly min: 0;
+  readonly max: 240;
+};
+/** 规范化任意输入；非法字段回落到默认值，绝不抛给调用方。 */
+declare function normalizePreferences(value: unknown): ZCodePreferences;
+//#endregion
+//#region src/host/preferences.d.ts
+/** 偏好文件名（位于 DSH home 下）。 */
+declare const ZCODE_PREFERENCES_FILENAME = ".dsh-zcode-preferences.json";
+/** 偏好文件路径。 */
+declare function zcodePreferencesPath(dshHome?: string): string;
+/** 文件落盘的偏好存储。 */
+declare class ZCodePreferencesStore {
+  readonly filename: string;
+  constructor(filename?: string);
+  /** 读取偏好；文件缺失或内容不可解析时返回默认值。 */
+  read(): Promise<ZCodePreferences>;
+  /** 合并写入偏好；返回落盘后的完整值。 */
+  write(patch: unknown): Promise<ZCodePreferences>;
+}
+//#endregion
+//#region src/host/provider.d.ts
+/**
+ * 把目录条目投影为 pi-ai 模型。
+ *
+ * @param model - 目录条目。
+ * @param baseURL - 覆盖端点（端点策略决定，见 `ZCodeEndpointPlan`）。
+ */
+declare function toPiModel(model: ZCodeModel, baseURL?: string): Model<Api>;
+/** 构建 provider。 */
+declare function createZCodeProvider(models: readonly ZCodeModel[], resolveToken: () => Promise<string | undefined>, baseURL?: string): Provider;
+/** 构建供应商 profile。 */
+declare function createZCodeProfile(models: readonly ZCodeModel[], resolveToken: () => Promise<string | undefined>, headers?: Readonly<Record<string, string>>, baseURL?: string): ResolvedPiAiProviderProfile;
+/**
+ * 固定显示名的 pi-ai 适配器。
+ *
+ * registry 在 `registerAdapter` 时立即调用 `providerInfo` 并**永久缓存**结果
+ * （`listProviders()` 之后只返回这份快照），而本插件的 profile 快照要等目录
+ * 首次刷新才有内容——默认实现那一刻会回落成 provider id，模型选择器的分组名
+ * 从此固定成 `dsh-zcode`。这里直接返回契约常量，不依赖任何运行期状态。
+ */
+/** 运行时依赖。 */
+interface ZCodeProviderRuntimeOptions {
+  /**
+   * 按端点策略返回可用凭据；未登录/缺凭据返回 undefined。
+   *
+   * `start-plan` 用账号 JWT（ZCode 域凭证）；`ultra` 用家族 MaaS 令牌。
+   * 两种凭据由同一份登录记录提供，但被不同端点接受。
+   */
+  readonly resolveToken: (plan: ZCodeEndpointPlan) => Promise<string | undefined>;
+  /** 提供稳定的设备标识，用于构造路由头。 */
+  readonly deviceMid: () => string;
+  /** 读取宿主附件服务，供图片输入使用。 */
+  readonly resolveAttachments: () => AttachmentStore | undefined;
+  readonly logger: Pick<Context['logger'], 'warn' | 'info'>;
+}
+/** 路由状态，供详情页诊断。 */
+interface ZCodeRouteStatus {
+  readonly id: string;
+  readonly name: string;
+  readonly registered: boolean;
+  readonly error?: string;
+  readonly modelCount: number;
+  /** 当前端点策略，便于详情页说明「请求会发到哪里、扣哪种额度」。 */
+  readonly endpointPlan?: ZCodeEndpointPlan;
+}
+/**
+ * 注册并持有唯一的 `dsh-zcode` 路由。
+ *
+ * 路由被其他适配器占用时记录原因并保持未注册状态，由详情页把冲突说明展示
+ * 给用户，而不是让整个插件失效。
+ */
+declare class ZCodeProviderRuntime {
+  private readonly options;
+  private snapshot;
+  /** HTTP 通道：同时是模型元数据的唯一来源。 */
+  /** 执行通道：自行收发 Anthropic Messages（满足网关对 system 分块的要求）。 */
+  private readonly adapter;
+  private registration;
+  private registered;
+  private error;
+  private currentModels;
+  private endpointPlan;
+  constructor(options: ZCodeProviderRuntimeOptions);
+  /** 当前目录模型。 */
+  models(): readonly ZCodeModel[];
+  /** 路由注册状态。 */
+  routeStatus(): readonly ZCodeRouteStatus[];
+  /** 在插件 fiber 上注册路由。 */
+  register(ctx: Context): void;
+  /** 当前端点策略。 */
+  plan(): ZCodeEndpointPlan;
+  /**
+   * 用新目录与端点策略重建 profile；下一次 LLM 操作即可见。
+   *
+   * 端点策略决定 baseURL 与凭据类型，两者必须一起换：只换端点不换凭据会直接
+   * 401（`ultra` 不接受账号 JWT）。
+   */
+  update(models: readonly ZCodeModel[], plan?: ZCodeEndpointPlan): void;
+}
+//#endregion
+//#region src/contracts/usage.d.ts
+/**
+ * 用量契约：Start Plan 的额度窗口。
+ *
+ * ZCode 的额度按「每个模型 × 周期」表达（日 / 周 / 月 / 一次性），与参考插件的
+ * 固定三窗口不同，因此这里保留上游的粒度：一个模型可能同时有日额度和一次性
+ * 活动额度，两块都要能显示，不能合并成一个百分比。
+ *
+ * @module dsh-zcode/usage-contract
+ */
+/** 一个模型的额度窗口。 */
+interface ZCodeUsageWindow {
+  /** 展示名（如 `GLM-5.3`）。 */
+  readonly label: string;
+  /** capability 原文（如 `model:glm-5.3`），用于与目录对齐。 */
+  readonly capability?: string;
+  readonly totalUnits: number;
+  readonly usedUnits: number;
+  readonly remainingUnits: number;
+  /** 已用百分比，0..100；总量为 0 时给 0。 */
+  readonly percent: number;
+  /** 周期：`daily` / `weekly` / `monthly` / `one_time` 等，上游原样。 */
+  readonly period?: string;
+  /** 重置或到期时间（ISO 8601）。 */
+  readonly resetsAt?: string;
+  /** 该窗口是否已耗尽。 */
+  readonly exhausted: boolean;
+}
+/** Start Plan 用量快照。 */
+interface ZCodeUsage {
+  /** 当前生效的套餐。 */
+  readonly plans: readonly {
+    readonly planId: string;
+    readonly name?: string;
+    readonly endsAt?: string;
+  }[];
+  readonly windows: readonly ZCodeUsageWindow[];
+  /** 读取时间（epoch ms）。 */
+  readonly fetchedAt: number;
+  /** 账号家族。 */
+  readonly family?: string;
+}
+/** 剩余百分比。 */
+declare function remainingPercent(window: ZCodeUsageWindow): number;
+/** 距离重置的毫秒数；无效或缺失时间返回 undefined。 */
+declare function resetAfterMs(window: ZCodeUsageWindow, now?: number): number | undefined;
+/**
+ * 把上游额度换算成百分比。
+ *
+ * 上游给的是整数 token 单位，可能为 0（活动额度未发放）；此时按 0% 处理而不是
+ * 制造 NaN 或 Infinity——界面上「0 / 0」比「NaN%」可读得多。
+ */
+declare function usagePercent(used: number, total: number): number;
+//#endregion
+//#region src/host/usage.d.ts
+/** 失败原因。 */
+type ZCodeUsageFailure = 'not-signed-in' | 'request-failed';
+/** 读取结果。 */
+type ZCodeUsageResult = {
+  readonly ok: true;
+  readonly usage: ZCodeUsage;
+} | {
+  readonly ok: false;
+  readonly reason: ZCodeUsageFailure;
+  readonly message: string;
+};
+/** 额度服务依赖。 */
+interface ZCodeUsageServiceOptions {
+  readonly client: ZCodeConsoleClient;
+  readonly resolveToken: () => Promise<string | undefined>;
+  readonly resolveFamily?: () => Promise<string | undefined>;
+  readonly logger?: Pick<Context['logger'], 'warn' | 'info'>;
+  /** 缓存时间（毫秒）；额度是低频变化数据，读太勤没有意义。 */
+  readonly cacheMs?: number;
+  readonly now?: () => number;
+}
+/** 额度服务。 */
+declare class ZCodeUsageService {
+  private cached;
+  private inflight;
+  private readonly options;
+  constructor(options: ZCodeUsageServiceOptions);
+  private get now();
+  /** 失效缓存，强制下次读取走网络。 */
+  invalidate(): void;
+  /** 读取额度；`force` 为 true 时跳过缓存。 */
+  read(force?: boolean): Promise<ZCodeUsageResult>;
+  private load;
+}
+//#endregion
+//#region src/host/routes.d.ts
+/** 来源不受信任时的错误码（与客户端文案对应）。 */
+declare const ZCODE_ORIGIN_NOT_TRUSTED = "remote-web-origin-not-trusted";
+/** 目录刷新失败的错误码。 */
+declare const ZCODE_CATALOG_UNAVAILABLE = "zcode-catalog-unavailable";
+/** 允许同源页面与 fnOS 网关的回环代理；跨站请求一律拒绝。 */
+declare function trustedRequest(req: IncomingMessage): boolean;
+/** 路由依赖。 */
+interface ZCodeRoutesOptions {
+  readonly auth: ZCodeAuthService;
+  readonly usage: ZCodeUsageService;
+  readonly catalog: ZCodeCatalogService;
+  readonly preferences: ZCodePreferencesStore;
+  /** 登录状态变化后刷新目录与用量。 */
+  readonly refresh: (force: boolean) => Promise<void>;
+  /** 偏好被写入后让宿主侧重新调度刷新。 */
+  readonly preferencesChanged: () => Promise<void>;
+  /** 供应商路由的注册状态，供详情页诊断。 */
+  readonly routes: () => readonly ZCodeRouteStatus[];
+}
+/** 注册全部插件路由；返回的清理函数由 `ctx.effect` 管理。 */
+declare function registerZCodeRoutes(ctx: Context, options: ZCodeRoutesOptions): void;
+//#endregion
+export { zcodePreferencesPath as C, ZCodeUsageVisibility as D, ZCodePreferences as E, normalizePreferences as O, ZCodePreferencesStore as S, ZCODE_REFRESH_MINUTES as T, ZCodeRouteStatus as _, trustedRequest as a, toPiModel as b, ZCodeUsageService as c, ZCodeUsageWindow as d, remainingPercent as f, ZCodeProviderRuntimeOptions as g, ZCodeProviderRuntime as h, registerZCodeRoutes as i, ZCodeUsageServiceOptions as l, usagePercent as m, ZCODE_ORIGIN_NOT_TRUSTED as n, ZCodeUsageFailure as o, resetAfterMs as p, ZCodeRoutesOptions as r, ZCodeUsageResult as s, ZCODE_CATALOG_UNAVAILABLE as t, ZCodeUsage as u, createZCodeProfile as v, DEFAULT_ZCODE_PREFERENCES as w, ZCODE_PREFERENCES_FILENAME as x, createZCodeProvider as y };

package/lib/routes-vzWlp-oN.js

@@ -0,0 +1,307 @@
+import { d as ZCODE_FAMILIES } from "./identity-DE3rOYuE.js";
+//#region src/contracts/routes.ts
+/**
+* 插件同源 Web 路由：宿主注册、浏览器调用，两端引用同一份常量。
+*
+* 不用 Remote API 命名空间，是因为这里只有低频率、无状态的读写；同源 HTTP
+* 路由的信任边界由宿主侧 `trustedRequest` 把关，与其他账号插件一致。
+*
+* @module dsh-zcode/routes
+*/
+/** 本插件 Web 路由的前缀。 */
+const ZCODE_ROUTE_PREFIX = "/plugins/dsh-zcode";
+const ZCODE_ROUTES = {
+	/** 账号状态（含进行中的登录挑战）。 */
+	status: `${ZCODE_ROUTE_PREFIX}/auth/status`,
+	/** 开始授权；响应带授权地址。 */
+	login: `${ZCODE_ROUTE_PREFIX}/auth/login`,
+	/** 桌面授权码流程的回调地址：浏览器登录后回跳到这里完成换取。 */
+	callback: `${ZCODE_ROUTE_PREFIX}/auth/callback`,
+	/** 取消进行中的登录，不删除已保存凭据。 */
+	cancel: `${ZCODE_ROUTE_PREFIX}/auth/cancel`,
+	/** 退出登录并删除凭据。 */
+	logout: `${ZCODE_ROUTE_PREFIX}/auth/logout`,
+	/** Start Plan 额度。 */
+	usage: `${ZCODE_ROUTE_PREFIX}/usage`,
+	/** 当前模型目录快照。 */
+	catalog: `${ZCODE_ROUTE_PREFIX}/catalog`,
+	/** 强制刷新模型目录。 */
+	catalogRefresh: `${ZCODE_ROUTE_PREFIX}/catalog/refresh`,
+	/** 插件偏好设置。 */
+	preferences: `${ZCODE_ROUTE_PREFIX}/preferences`
+};
+//#endregion
+//#region src/host/routes.ts
+/** 请求体上限：只有少量表单字段。 */
+const REQUEST_BODY_LIMIT = 16384;
+/** 来源不受信任时的错误码（与客户端文案对应）。 */
+const ZCODE_ORIGIN_NOT_TRUSTED = "remote-web-origin-not-trusted";
+/** 目录刷新失败的错误码。 */
+const ZCODE_CATALOG_UNAVAILABLE = "zcode-catalog-unavailable";
+function header(req, name) {
+	const value = req.headers[name];
+	return Array.isArray(value) ? value[0] : value;
+}
+function firstForwarded(value) {
+	return value?.split(",")[0]?.trim() || void 0;
+}
+function requestOrigin(req) {
+	const host = firstForwarded(header(req, "x-forwarded-host")) ?? header(req, "host");
+	if (host === void 0) return void 0;
+	const proto = firstForwarded(header(req, "x-forwarded-proto")) ?? (req.socket.encrypted === true ? "https" : "http");
+	try {
+		return new URL(`${proto}://${host}`).origin;
+	} catch {
+		return;
+	}
+}
+function normalizeOrigin(raw) {
+	try {
+		return new URL(raw).origin;
+	} catch {
+		return;
+	}
+}
+function localPeer(req) {
+	const remote = req.socket.remoteAddress;
+	return remote === "127.0.0.1" || remote === "::1" || remote === "::ffff:127.0.0.1";
+}
+/** 允许同源页面与 fnOS 网关的回环代理；跨站请求一律拒绝。 */
+function trustedRequest(req) {
+	if (header(req, "sec-fetch-site")?.trim().toLowerCase() === "cross-site") return false;
+	const origin = header(req, "origin");
+	if (origin !== void 0) return requestOrigin(req) === normalizeOrigin(origin);
+	return localPeer(req);
+}
+/** 浏览器整页跳转用的极简结果页（回调路径不在 SPA 内，需要自渲染）。 */
+function html(res, status, body) {
+	res.writeHead(status, {
+		"content-type": "text/html; charset=utf-8",
+		"content-security-policy": "default-src 'none'; style-src 'unsafe-inline'"
+	});
+	res.end(body);
+}
+/** 回调结果页：一句话结论 + 关闭提示，不引用任何外部资源。 */
+function callbackPage(message, ok) {
+	const title = ok ? "ZCode 登录成功" : "ZCode 登录失败";
+	return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${title}</title></head><body style="margin:0;min-height:100vh;display:flex;align-items:center;justify-content:center;font:14px/1.6 -apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;background:#f8f9fa"><div style="padding:32px 40px;border-radius:12px;background:#fff;box-shadow:0 2px 12px rgba(0,0,0,.08);max-width:420px;text-align:center"><h1 style="margin:0 0 12px;font-size:16px;color:${ok ? "#12b886" : "#e03131"}">${title}</h1><p style="margin:0;color:#495057">${message}</p></div></body></html>`;
+}
+function json(res, status, value) {
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-store",
+		"x-content-type-options": "nosniff"
+	});
+	res.end(JSON.stringify(value));
+}
+function readJsonBody(req) {
+	return new Promise((resolve, reject) => {
+		let body = "";
+		let size = 0;
+		let finished = false;
+		req.setEncoding("utf8");
+		req.on("data", (chunk) => {
+			if (finished) return;
+			size += Buffer.byteLength(chunk);
+			if (size > REQUEST_BODY_LIMIT) {
+				finished = true;
+				reject(/* @__PURE__ */ new Error("请求体过大"));
+				return;
+			}
+			body += chunk;
+		});
+		req.on("end", () => {
+			if (finished) return;
+			finished = true;
+			try {
+				resolve(body.length === 0 ? {} : JSON.parse(body));
+			} catch {
+				reject(/* @__PURE__ */ new Error("请求体不是合法 JSON"));
+			}
+		});
+		req.on("error", (error) => {
+			if (finished) return;
+			finished = true;
+			reject(error);
+		});
+	});
+}
+/** 错误文本脱敏：绝不把 token 回显给浏览器。 */
+function safeMessage(error) {
+	return (error instanceof Error ? error.message : String(error)).replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[redacted token]").replace(/(\b(?:code|token|refresh_token|access_token|apiKey)=)[^&\s]+/giu, "$1[redacted]").slice(0, 1e3);
+}
+/** 从请求体解析账号家族；非法值返回 undefined。 */
+function parseFamily(body) {
+	const value = body !== null && typeof body === "object" && !Array.isArray(body) ? body.family : void 0;
+	if (typeof value !== "string") return void 0;
+	const normalized = value.trim().toLowerCase();
+	return ZCODE_FAMILIES.find((family) => family === normalized);
+}
+/** 目录响应的统一形状（列表/强制刷新共用）。 */
+function catalogResponse(catalog, routes, error) {
+	return {
+		catalog: catalog ?? null,
+		routes,
+		...error === void 0 ? {} : { error }
+	};
+}
+/** 注册全部插件路由；返回的清理函数由 `ctx.effect` 管理。 */
+function registerZCodeRoutes(ctx, options) {
+	ctx.effect(() => {
+		const authorize = (req, res) => {
+			if (trustedRequest(req)) return true;
+			json(res, 403, { error: ZCODE_ORIGIN_NOT_TRUSTED });
+			return false;
+		};
+		const handlers = [
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.status,
+				handler: async (req, res) => {
+					if (req.method !== "GET") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						json(res, 200, await options.auth.status());
+					} catch (error) {
+						json(res, 500, { error: safeMessage(error) });
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.login,
+				handler: async (req, res) => {
+					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						const family = parseFamily(await readJsonBody(req)) ?? "bigmodel";
+						json(res, 200, {
+							status: "signing-in",
+							challenge: await options.auth.loginDesktop(family, requestOrigin(req))
+						});
+					} catch (error) {
+						json(res, 500, { error: safeMessage(error) });
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.callback,
+				handler: async (req, res) => {
+					const url = new URL(req.url ?? "/", requestOrigin(req) ?? "http://127.0.0.1");
+					const code = url.searchParams.get("code") ?? url.searchParams.get("authCode");
+					const state = url.searchParams.get("state");
+					const family = parseFamily(url.searchParams.get("family")) ?? "bigmodel";
+					if (code === null || state === null) return html(res, 400, callbackPage("授权回调缺少 code 或 state，请回到 DSH 重新登录。", false));
+					try {
+						await options.auth.completeDesktopLogin({
+							code,
+							state,
+							family
+						});
+						return html(res, 200, callbackPage("登录成功，可以关闭此页并回到 DSH。", true));
+					} catch (error) {
+						return html(res, 400, callbackPage(safeMessage(error), false));
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.cancel,
+				handler: async (req, res) => {
+					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						options.auth.cancel();
+						json(res, 200, await options.auth.status());
+					} catch (error) {
+						json(res, 500, { error: safeMessage(error) });
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.logout,
+				handler: async (req, res) => {
+					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						await options.auth.logout();
+						options.usage.invalidate();
+						await options.refresh(true).catch(() => void 0);
+						json(res, 200, await options.auth.status());
+					} catch (error) {
+						json(res, 500, { error: safeMessage(error) });
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.usage,
+				handler: async (req, res) => {
+					if (req.method !== "GET") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					if ((await options.auth.status().catch(() => ({ status: "signed-out" }))).status !== "signed-in") return json(res, 200, { signedIn: false });
+					const result = await options.usage.read();
+					json(res, 200, result.ok ? {
+						signedIn: true,
+						usage: result.usage
+					} : {
+						signedIn: true,
+						error: result.message,
+						reason: result.reason
+					});
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.catalog,
+				handler: async (req, res) => {
+					if (req.method !== "GET") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						json(res, 200, catalogResponse(options.catalog.snapshot() ?? await options.catalog.refreshIfStale(), options.routes()));
+					} catch (error) {
+						json(res, 200, catalogResponse(options.catalog.snapshot(), options.routes(), safeMessage(error) || "zcode-catalog-unavailable"));
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.catalogRefresh,
+				handler: async (req, res) => {
+					if (req.method !== "POST") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						await options.refresh(true);
+						json(res, 200, catalogResponse(options.catalog.snapshot(), options.routes()));
+					} catch (error) {
+						json(res, 200, catalogResponse(options.catalog.snapshot(), options.routes(), safeMessage(error) || "zcode-catalog-unavailable"));
+					}
+				}
+			}),
+			ctx.webServer.register({
+				kind: "exact",
+				path: ZCODE_ROUTES.preferences,
+				handler: async (req, res) => {
+					if (req.method !== "GET" && req.method !== "PUT") return json(res, 405, { error: "method not allowed" });
+					if (!authorize(req, res)) return;
+					try {
+						if (req.method === "GET") return json(res, 200, await options.preferences.read());
+						const next = await options.preferences.write(await readJsonBody(req));
+						await options.preferencesChanged();
+						json(res, 200, next);
+					} catch (error) {
+						json(res, 400, { error: safeMessage(error) });
+					}
+				}
+			})
+		];
+		return async () => {
+			for (const dispose of handlers) dispose();
+			options.auth.dispose();
+		};
+	}, "dsh-zcode: Web 路由");
+}
+//#endregion
+export { ZCODE_ROUTES as a, trustedRequest as i, ZCODE_ORIGIN_NOT_TRUSTED as n, ZCODE_ROUTE_PREFIX as o, registerZCodeRoutes as r, ZCODE_CATALOG_UNAVAILABLE as t };