dsh-zen-free 1.1.0 → 1.2.0

package/lib/index.js

@@ -984,6 +984,108 @@ const adapter = {
 	},
 };
 
+/**
+ * 设置页命名空间。
+ *
+ * 必须等于本插件在 profile 里的 loader 条目 id（`cordis.patch.yml` 的
+ * `insert[].id`），因为 `settings.describe()` 用 `entry.options.id` 作为 ns，
+ * 而模型页的供应商目录用 `settingsNs` 去这张表里找 namespace 来判定「已配置」。
+ * 两者对不上，供应商就只会掉进「+ 添加模型提供商」的候选列表。
+ */
+const SETTINGS_NS = 'zenfree';
+
+/**
+ * 插件 Config schema。
+ *
+ * 这不是装饰：`settings.describe()` 只登记那些 `entry.fiber.runtime.Config`
+ * 存在且带 `toJSON` 的条目，而 `runtime.Config` 就是插件的具名导出 `Config`。
+ * 没有它，`zenfree` 这个 namespace 在设置页里不存在，模型页就无法把供应商
+ * 判为已配置 —— 表现为「模型列表能用，但供应商设置里找不到它」。
+ *
+ * 这里刻意不 import `@deepseek-ai/schemastery`（第三方插件在 profile 的
+ * node_modules 下解析不到官方包），而是手写它的 JSON 序列化形状。
+ *
+ * 形状必须是 **带 uid 引用表** 的形式（`{uid, refs}`），节点之间用 refs 的下标
+ * 字符串互相引用 —— 这是 `toJSON()` 的产出，也是 `new z(json)` 唯一能正确
+ * 重建 dict/inner 关系的输入形式。用内联对象写 `inner` 虽然能被 `new z()`
+ * 接受，但 settings 的 `plainSchema()` 会先 `toJSON()` 再 `new z()`，
+ * 往返时内联的 dict 值会被丢掉（`dict.models` 变成 undefined），随后
+ * 设置页遍历节点时直接抛错。所以下面严格按官方 refs 形状写。
+ */
+function defineConfigSchema() {
+	/**
+	 * refs 表：0=根 object，1=dict(models)，2=模型 object，3~5=模型的三项字段，
+	 * 6=dict 的键类型（string）。
+	 */
+	const refs = {
+		0: {
+			type: 'object',
+			meta: { default: {}, volatile: true, description: 'zenfree 免费池供应商配置' },
+			dict: { models: 1 },
+		},
+		1: { type: 'dict', meta: { default: {}, volatile: true, description: '按模型 id 索引的设置' }, inner: 2, sKey: 6 },
+		2: {
+			type: 'object',
+			meta: { default: {}, description: '单个 zenfree 模型的运行期设置' },
+			dict: { contextWindow: 3, maxTokens: 4, input: 5 },
+		},
+		3: { type: 'number', meta: { default: CONTEXT_WINDOW, description: '上下文窗口（token）' } },
+		4: { type: 'number', meta: { default: DEFAULT_MAX_TOKENS, description: '单次输出上限（token）' } },
+		5: { type: 'array', meta: { default: [...MODALITIES], description: '输入模态：text / image' }, inner: 7 },
+		6: { type: 'string', meta: {} },
+		7: { type: 'string', meta: {} },
+	};
+
+	return {
+		/** schemastery 序列化形状；settings 的 plainSchema() 会用它重建一份可编辑副本。 */
+		toJSON: () => ({ uid: 0, refs }),
+		/** Standard Schema 校验入口：把插件配置归一成 {models} 形状。 */
+		'~standard': {
+			version: 1,
+			vendor: PACKAGE_NAME,
+			validate(value) {
+				const raw = value === null || typeof value !== 'object' ? {} : value;
+				const models = raw.models === null || typeof raw.models !== 'object' ? {} : raw.models;
+				return { value: { ...raw, models: { ...models } } };
+			},
+		},
+	};
+}
+
+/** 插件的 Config 导出：让 `zenfree` 成为设置页可解析的命名空间。 */
+export const Config = defineConfigSchema();
+
+/**
+ * 把 zenfree 登记进「可配置供应商目录」。
+ *
+ * 模型页的供应商列表来自 `llm.listConfigurableProviders()`，而它只返回
+ * `registerConfigurableProviders()` 登记过的条目。只调 `registerAdapter()`
+ * 时模型能用、但供应商列表里没有这一行 —— 这正是要补的那半边。
+ *
+ * `settingsPath` 取空数组：该供应商的配置整体就是命名空间本身（不是
+ * `providers.<name>` 那种子路径），模型页据此把这一行判为「已配置」并
+ * 直接渲染成可编辑的供应商卡片。
+ *
+ * 失败不阻断模型路由：目录只是展示层，拿不到就只是少一行。
+ *
+ * @param ctx - 插件上下文。
+ */
+function setupDirectory(ctx) {
+	if (typeof ctx.llm?.registerConfigurableProviders !== 'function') return;
+	try {
+		ctx.llm.registerConfigurableProviders([
+			{
+				provider: PROVIDER_ID,
+				displayName: PROVIDER_NAME,
+				settingsNs: SETTINGS_NS,
+				settingsPath: [],
+			},
+		]);
+	} catch {
+		// 目录登记失败（例如同名 provider 已被声明）：模型照常可用。
+	}
+}
+
 /**
  * 挂载：注册 zenfree 路由，并把配置/统计服务暴露给设置页。
  *
@@ -997,6 +1099,7 @@ const adapter = {
 export function apply(ctx, config) {
 	modelSettings = resolveModelSettings(config);
 	ctx.llm.registerAdapter([PROVIDER_ID], adapter);
+	setupDirectory(ctx);
 	setupRemotes(ctx, config);
 }
 

package/package.json

@@ -1,47 +1,47 @@
-{
-  "name": "dsh-zen-free",
-  "version": "1.1.0",
-  "description": "OpenCode Zen 免费池供应商：往 DSH 注册 zenfree 路由与 ds4.1f / glm5.3f 两个免费模型，无需 API Key，请求强制直连（不走任何代理），并带模型配置与请求统计设置页。",
-  "license": "MIT",
-  "type": "module",
-  "main": "./lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib/index.js",
-    "lib/client.js",
-    "cordis.patch.yml",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "dshapp-plugin",
-    "llm",
-    "provider",
-    "opencode-zen",
-    "free"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-api-remotes"
-      ],
-      "platform": "web"
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
-  }
-}
+{
+  "name": "dsh-zen-free",
+  "version": "1.2.0",
+  "description": "OpenCode Zen 免费池供应商：往 DSH 注册 zenfree 路由与 ds4.1f / glm5.3f 两个免费模型，无需 API Key，请求强制直连（不走任何代理），并带模型配置与请求统计设置页。",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "dshapp-plugin",
+    "llm",
+    "provider",
+    "opencode-zen",
+    "free"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  }
+}