dsh-agentone 0.5.36 → 0.5.37

package/README.md

@@ -71,7 +71,9 @@ dsh plugin --profile web add dsh-agentone
 
 - `$DSH_HOME/settings.yaml` 写入 `llm-pi-ai.providers.platform`（指向平台
   `/api/plugin/v1` 代理）与 `agent-default-model`，dsh 模型选择器出现
-  「平台模型」；
+  「平台模型」；模型列表按系列聚簇 + 系列内版本降序写入（插件侧按平台
+  `sort_models_by_version` 同一规则兜底重排，旧版平台返回的上游原序也能得到
+  稳定顺序，默认模型仍取平台下发的 `default_model`）；
 - `$DSH_HOME/.credentials.yaml` 写入 `refs.AGENTONE_API_KEY`（0600），内容
   是 30 天插件令牌而非真实模型密钥——密钥不出平台，TokenHub 按用户计量；
 - 只覆盖 `platform` 命名空间，用户自己配置的其它 provider 原样保留；

package/lib/instance.js

@@ -120,4 +120,4 @@ export function resolvePlatformUrl(config, credentials, env = process.env) {
     || credentials?.platform_url
     || config.platformUrl
   ).replace(/\/+$/, '');
-}
+}

package/lib/model.js

@@ -145,6 +145,90 @@ export function buildLogoutSettingsYaml(existingText) {
   return stringify(settings);
 }
 
+// 模型选择器展示顺序：同一系列（模型 id 首段，如 deepseek / glm / kimi）聚簇，
+// 系列内版本降序，容量降配档（kimi-k3-256k）排在本版本标准档之后。
+//
+// 为什么插件也要排一遍：平台 /api/plugin/v1/models 的 data 顺序在旧版平台上
+// 直接沿用 AirRouter /models 的返回顺序（上游一变用户看到的列表就跟着变），
+// 平台侧的排序修复要等部署才生效。插件把平台返回的列表按同一套规则重排后
+// 再写进 dsh，旧平台也能拿到稳定顺序。规则与
+// app/services/dsh_model_capabilities.py 的 sort_models_by_version 完全一致
+// （系列聚簇 + 数字段补零取负降序 + 字母段字母序 + 容量段垫底），
+// 平台已经排好时这里是幂等的，不会出现两边顺序漂移。
+//
+// 只改展示顺序：defaultModel 仍取平台下发的 default_model，排序不参与决策
+//（平台未下发时回退列表首项，此时取排序后的首项，比上游原序更确定）。
+const VERSION_SLOTS = 6;
+const VERSION_NUMBERS = /\d+/g;
+// 容量限定段（256k / 1m）：同版本的降配档，不是更新的版本号。
+// 必须连着字母一起匹配：VERSION_NUMBERS 切出来的只有数字部分。
+const CAPACITY_QUALIFIER = /\d+(?:k|m|b)\b/g;
+
+/** 模型 id → 系列键（id 首段小写；没有连字符的裸 id 整体作为分组键）。 */
+function modelFamily(id) {
+  const lowered = String(id ?? '').trim().toLowerCase();
+  const at = lowered.indexOf('-');
+  return at > 0 ? lowered.slice(0, at) : lowered;
+}
+
+/** 系列内的版本比较键：数字段取负（升序即版本降序）、字母段、容量降配标记。 */
+function versionKey(id) {
+  const lowered = String(id ?? '').trim().toLowerCase();
+  const capacityHits = lowered.match(CAPACITY_QUALIFIER) ?? [];
+  const numbers = (lowered.replace(CAPACITY_QUALIFIER, ' ').match(VERSION_NUMBERS) ?? [])
+    .slice(0, VERSION_SLOTS)
+    .map((part) => -Number(part));
+  while (numbers.length < VERSION_SLOTS) numbers.push(0);
+  return {
+    numbers,
+    words: lowered.split('-').filter((part) => part && !/^\d+$/.test(part)),
+    downgraded: capacityHits.length > 0,
+  };
+}
+
+/** Python 字符串/元组比较口径（逐码点），与平台 sorted() 的结果对齐。 */
+function compareStrings(left, right) {
+  if (left === right) return 0;
+  return left < right ? -1 : 1;
+}
+
+function compareVersionKeys(left, right) {
+  for (let index = 0; index < VERSION_SLOTS; index += 1) {
+    if (left.numbers[index] !== right.numbers[index]) return left.numbers[index] - right.numbers[index];
+  }
+  const shared = Math.min(left.words.length, right.words.length);
+  for (let index = 0; index < shared; index += 1) {
+    const compared = compareStrings(left.words[index], right.words[index]);
+    if (compared !== 0) return compared;
+  }
+  if (left.words.length !== right.words.length) return left.words.length - right.words.length;
+  if (left.downgraded !== right.downgraded) return left.downgraded ? 1 : -1;
+  return 0;
+}
+
+/**
+ * 按系列聚簇、系列内版本降序排模型条目（只改展示顺序，不改集合成员）。
+ *
+ * 入参可以是平台条目对象（取 .id）或字符串 id；排序是确定性的，同样的输入
+ * 必得同样的输出，完全不依赖平台 / AirRouter 的返回顺序。
+ */
+export function sortPlatformModels(models) {
+  const entries = (Array.isArray(models) ? models : []).map((item, index) => ({
+    item,
+    index,
+    id: typeof item === 'string' ? item : String(item?.id ?? ''),
+  }));
+  entries.sort(
+    (left, right) =>
+      compareStrings(modelFamily(left.id), modelFamily(right.id))
+      // 原始下标兜底：与 Python sorted 的稳定性同口径，完全相同键保持原序
+      || compareVersionKeys(versionKey(left.id), versionKey(right.id))
+      || compareStrings(left.id.trim().toLowerCase(), right.id.trim().toLowerCase())
+      || left.index - right.index,
+  );
+  return entries.map((entry) => entry.item);
+}
+
 export async function fetchPlatformModels(platformUrl, accessToken) {
   const response = await platformFetch(`${platformUrl.replace(/\/+$/, '')}/api/plugin/v1/models`, {
     headers: { Authorization: `Bearer ${accessToken}` },
@@ -155,17 +239,19 @@ export async function fetchPlatformModels(platformUrl, accessToken) {
     throw await platformError(response, '获取平台模型列表失败');
   }
   const data = await response.json().catch(() => ({}));
-  const models = Array.isArray(data.data)
-    ? data.data
-        .map((item) =>
-          typeof item === 'string'
-            ? item
-            : item?.id
-              ? { id: item.id, input: item.input, reasoning: item.reasoning, contextWindow: item.contextWindow }
-              : null,
-        )
-        .filter(Boolean)
-    : [];
+  const models = sortPlatformModels(
+    Array.isArray(data.data)
+      ? data.data
+          .map((item) =>
+            typeof item === 'string'
+              ? item
+              : item?.id
+                ? { id: item.id, input: item.input, reasoning: item.reasoning, contextWindow: item.contextWindow }
+                : null,
+          )
+          .filter(Boolean)
+      : [],
+  );
   if (models.length === 0) throw new Error('平台返回的可用模型列表为空');
   const direct =
     data.direct && typeof data.direct.base_url === 'string' && typeof data.direct.api_key === 'string'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.36",
+  "version": "0.5.37",
   "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐与 CLI；lark-cli 首装一键初始化飞书应用；平台托管实例免登录自动授权",
   "type": "module",
   "scripts": {