@oyasmi/pipiclaw 0.5.6 → 0.5.7

package/README.md

@@ -327,6 +327,9 @@ pipiclaw
 
 确认当前可见模型和默认模型都符合预期后，再发送一条普通消息，例如：
 
+- `/model` 会列出当前模型和可用模型
+- 切换时支持精确的 `provider/modelId`、精确的 `modelId`，以及能唯一命中的片段字符串，例如 `/model turbo`
+
 ```text
 请介绍一下你自己，并说明你现在能做什么
 ```
@@ -394,9 +397,22 @@ Pipiclaw 有两层命令。
 | `/new` | 开启一个新的会话 |
 | `/compact [instructions]` | 手动压缩当前会话上下文，可附带额外说明 |
 | `/session` | 查看当前会话状态、消息统计、token 使用量和当前模型 |
-| `/model [provider/modelId|modelId]` | 查看当前模型，或切换到指定模型 |
+| `/model [provider/modelId|modelId|substring]` | 查看当前模型，或切换到指定模型 |
+
+`/model` 的匹配顺序是：
+
+1. 精确匹配 `provider/modelId`
+2. 精确匹配 `modelId`
+3. 对完整的 `provider/modelId` 做子字符串匹配
+
+只有当片段字符串能唯一命中一个可用模型时才会切换。例如：
+
+- `/model qwen`
+- `/model k2.5`
+- `/model turbo`
+- `/model zpai`
 
-`/model` 只支持精确匹配切换。
+像 `/model glm5` 这种不构成子字符串的输入不会命中。
 
 ## 工作区结构（Workspace Layout）
 
@@ -502,7 +518,7 @@ Pipiclaw 不会把所有历史对话无上限地塞进 prompt，而是按层管
 - 如果是 OpenAI-compatible 服务，是否需要：
   - `"supportsDeveloperRole": false`
   - `"supportsReasoningEffort": false`
-- 给机器人发送 `/model`，确认当前可见模型和默认模型是否正确
+- 给机器人发送 `/model`，确认当前可见模型和默认模型是否正确；如需切换，也可以用唯一命中的片段，例如 `/model turbo`
 
 ### 机器人能收到消息，但没有回复（The Bot Receives Messages but Does Not Reply）
 

package/dist/agent/command-extension.js

@@ -1,5 +1,5 @@
 import { basename } from "path";
-import { findExactModelReferenceMatch, formatModelList, formatModelReference } from "../models/utils.js";
+import { findModelReferenceMatch, formatModelList, formatModelReference } from "../models/utils.js";
 export const COMMAND_RESULT_CUSTOM_TYPE = "pipiclaw.command_result";
 function buildSessionText(stats, currentModel, thinkingLevel) {
     const modelText = currentModel ? `\`${formatModelReference(currentModel)}\`` : "(none)";
@@ -43,7 +43,7 @@ export function createCommandExtension(options) {
             },
         });
         pi.registerCommand("model", {
-            description: "Show the current model or switch models using an exact match",
+            description: "Show the current model or switch models using an exact or uniquely matching substring",
             handler: async (args) => {
                 const availableModels = await options.getAvailableModels();
                 const currentModel = options.getCurrentModel();
@@ -54,13 +54,13 @@ export function createCommandExtension(options) {
 
 Current model: ${current}
 
-Use \`/model <provider/modelId>\` or \`/model <modelId>\` to switch. Bare model IDs must resolve uniquely.
+Use \`/model <provider/modelId>\`, \`/model <modelId>\`, or any uniquely matching substring to switch.
 
 Available models:
 ${available}`);
                     return;
                 }
-                const match = findExactModelReferenceMatch(args, availableModels);
+                const match = findModelReferenceMatch(args, availableModels);
                 const available = availableModels.length > 0 ? formatModelList(availableModels, currentModel, 10) : "- (none)";
                 if (match.match) {
                     await options.switchModel(match.match);
@@ -68,13 +68,13 @@ ${available}`);
                     return;
                 }
                 if (match.ambiguous) {
-                    sendCommandResult(pi, `未切换模型：\`${args.trim()}\` 匹配到多个模型。请改用精确的 \`provider/modelId\` 形式。
+                    sendCommandResult(pi, `未切换模型：\`${args.trim()}\` 匹配到多个模型。请提供更精确的 \`provider/modelId\`、\`modelId\` 或更长的片段。
 
 Available models:
 ${available}`);
                     return;
                 }
-                sendCommandResult(pi, `未找到模型 \`${args.trim()}\`。请使用精确的 \`provider/modelId\` 或唯一的 \`modelId\`。
+                sendCommandResult(pi, `未找到模型 \`${args.trim()}\`。请使用精确的 \`provider/modelId\`、唯一的 \`modelId\`，或能唯一命中的片段字符串。
 
 Available models:
 ${available}`);

package/dist/agent/commands.js

@@ -29,7 +29,7 @@ These are handled inside the Pipiclaw session layer:
   Show current session state, message stats, token usage, and model info
   Example: \`/session\`
 - \`/model [provider/modelId|modelId]\`
-  Show the current model, or switch models using an exact match
+  Show the current model, or switch models using an exact match or a uniquely matching substring
   Example: \`/model\`
   Example: \`/model anthropic/claude-opus-4-6\`
 - \`/new\`

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { type RecalledMemory, type RecallRequest, type RecallResult, recallRelev
 export { renderSessionMemory, type SessionMemoryState, type SessionMemoryUpdateOptions, updateChannelSessionMemory, } from "./memory/session.js";
 export { runSidecarTask, type SidecarResult, type SidecarTask, } from "./memory/sidecar-worker.js";
 export { getApiKeyForModel } from "./models/api-keys.js";
-export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
+export { findExactModelReferenceMatch, findModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
 export { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, SUB_AGENTS_DIR, SUB_AGENTS_DIR_NAME, WORKSPACE_DIR, } from "./paths.js";
 export { ensureChannelDir, getChannelDir, getChannelDirName, } from "./runtime/channel-paths.js";
 export { createDingTalkContext } from "./runtime/delivery.js";

package/dist/index.js

@@ -11,7 +11,7 @@ export { recallRelevantMemory, } from "./memory/recall.js";
 export { renderSessionMemory, updateChannelSessionMemory, } from "./memory/session.js";
 export { runSidecarTask, } from "./memory/sidecar-worker.js";
 export { getApiKeyForModel } from "./models/api-keys.js";
-export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
+export { findExactModelReferenceMatch, findModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
 export { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, SUB_AGENTS_DIR, SUB_AGENTS_DIR_NAME, WORKSPACE_DIR, } from "./paths.js";
 export { ensureChannelDir, getChannelDir, getChannelDirName, } from "./runtime/channel-paths.js";
 export { createDingTalkContext } from "./runtime/delivery.js";

package/dist/models/utils.d.ts

@@ -6,5 +6,9 @@ export declare function findExactModelReferenceMatch(modelReference: string, ava
     match?: Model<Api>;
     ambiguous: boolean;
 };
+export declare function findModelReferenceMatch(modelReference: string, availableModels: Model<Api>[]): {
+    match?: Model<Api>;
+    ambiguous: boolean;
+};
 export declare function formatModelList(models: Model<Api>[], currentModel: Model<Api> | undefined, limit?: number): string;
 export declare function resolveInitialModel(modelRegistry: ModelRegistry, settingsManager: PipiclawSettingsManager): Model<Api>;

package/dist/models/utils.js

@@ -38,6 +38,21 @@ export function findExactModelReferenceMatch(modelReference, availableModels) {
     }
     return { ambiguous: idMatches.length > 1 };
 }
+export function findModelReferenceMatch(modelReference, availableModels) {
+    const exactMatch = findExactModelReferenceMatch(modelReference, availableModels);
+    if (exactMatch.match || exactMatch.ambiguous) {
+        return exactMatch;
+    }
+    const normalizedReference = modelReference.trim().toLowerCase();
+    if (!normalizedReference) {
+        return { ambiguous: false };
+    }
+    const substringMatches = availableModels.filter((model) => formatModelReference(model).toLowerCase().includes(normalizedReference));
+    if (substringMatches.length === 1) {
+        return { match: substringMatches[0], ambiguous: false };
+    }
+    return { ambiguous: substringMatches.length > 1 };
+}
 export function formatModelList(models, currentModel, limit = 20) {
     const refs = models
         .slice()

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oyasmi/pipiclaw",
-	"version": "0.5.6",
+	"version": "0.5.7",
 	"description": "An AI assistant runtime for coding and team workflows, with DingTalk AI Cards, sub-agents, memory, and scheduled events.",
 	"type": "module",
 	"bin": {