@oyasmi/pipiclaw 0.5.6 → 0.5.8

package/README.md

@@ -129,6 +129,13 @@ Pipiclaw 当前已经内置一轮工具层安全增强：
   - 直接使用 Anthropic 默认模型
   - 或在 `models.json` 中配置自定义模型提供方（provider）
 
+Windows 补充说明：
+
+- Pipiclaw 的工具执行层默认按 POSIX shell 语义工作
+- 在 Windows host 模式下，建议安装 Git Bash，并确保 `bash` 可在 PATH 中找到
+- 如果 `bash` 不在 PATH 中，可以设置 `PIPICLAW_SHELL` 指向具体可执行文件，例如 `C:\Program Files\Git\bin\bash.exe`
+- 如果你不想依赖本机 shell 环境，推荐直接使用 Docker sandbox
+
 #### 2. 安装（Install）
 
 ```bash
@@ -169,6 +176,12 @@ export PIPICLAW_HOME=/your/custom/pipiclaw-home
 
 设置后，`channel.json`、`auth.json`、`models.json`、`settings.json` 和整个 `workspace/` 都会改为从这个目录读取和写入。
 
+如果你在 Windows host 模式下运行，并且 `bash` 不在 PATH 中，也可以一并设置：
+
+```powershell
+$env:PIPICLAW_SHELL = "C:\Program Files\Git\bin\bash.exe"
+```
+
 如果 `channel.json` 仍然是初始化模板，程序会提示你补全配置后再启动。这是正常行为。
 
 #### 4. 创建钉钉应用（Create a DingTalk App）
@@ -327,6 +340,9 @@ pipiclaw
 
 确认当前可见模型和默认模型都符合预期后，再发送一条普通消息，例如：
 
+- `/model` 会列出当前模型和可用模型
+- 切换时支持精确的 `provider/modelId`、精确的 `modelId`，以及能唯一命中的片段字符串，例如 `/model turbo`
+
 ```text
 请介绍一下你自己，并说明你现在能做什么
 ```
@@ -394,9 +410,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 +531,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/dist/sandbox.js

@@ -1,4 +1,4 @@
-import { spawn } from "child_process";
+import { spawn, spawnSync } from "child_process";
 import { shellEscape } from "./shared/shell-escape.js";
 export function parseSandboxArg(value) {
     if (value === "host") {
@@ -17,6 +17,15 @@ export function parseSandboxArg(value) {
 }
 export async function validateSandbox(config) {
     if (config.type === "host") {
+        if (process.platform === "win32") {
+            try {
+                resolveWindowsHostShell();
+            }
+            catch (error) {
+                console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+                process.exit(1);
+            }
+        }
         return;
     }
     // Check if Docker is available
@@ -45,7 +54,10 @@ export async function validateSandbox(config) {
 }
 function execSimple(cmd, args) {
     return new Promise((resolve, reject) => {
-        const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+        const child = spawn(cmd, args, {
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
         let stdout = "";
         let stderr = "";
         child.stdout?.on("data", (d) => {
@@ -62,6 +74,51 @@ function execSimple(cmd, args) {
         });
     });
 }
+const WINDOWS_POSIX_SHELL_CANDIDATES = [
+    "bash",
+    "sh",
+    "C:\\Program Files\\Git\\bin\\bash.exe",
+    "C:\\Program Files\\Git\\usr\\bin\\bash.exe",
+    "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
+    "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe",
+];
+let cachedWindowsHostShell;
+function looksLikeUnixShellPath(shell) {
+    return shell.endsWith("/bash") || shell.endsWith("/sh");
+}
+function isUsablePosixShell(command) {
+    const result = spawnSync(command, ["-lc", "printf pipiclaw"], {
+        stdio: ["ignore", "pipe", "ignore"],
+        encoding: "utf-8",
+        windowsHide: true,
+    });
+    return !result.error && result.status === 0 && result.stdout === "pipiclaw";
+}
+function resolveWindowsHostShell() {
+    if (cachedWindowsHostShell) {
+        return cachedWindowsHostShell;
+    }
+    const configuredShell = process.env.PIPICLAW_SHELL?.trim();
+    const inheritedShell = process.env.SHELL?.trim();
+    const shellCandidates = [
+        configuredShell,
+        inheritedShell && looksLikeUnixShellPath(inheritedShell) ? inheritedShell.split("/").pop() : undefined,
+        ...WINDOWS_POSIX_SHELL_CANDIDATES,
+    ].filter((value) => Boolean(value));
+    for (const command of shellCandidates) {
+        if (isUsablePosixShell(command)) {
+            cachedWindowsHostShell = { command, args: ["-lc"] };
+            return cachedWindowsHostShell;
+        }
+    }
+    throw new Error("Windows host sandbox requires a POSIX shell. Install Git Bash and ensure `bash` is on PATH, set `PIPICLAW_SHELL`, or use the Docker sandbox.");
+}
+function resolveHostShell() {
+    if (process.platform === "win32") {
+        return resolveWindowsHostShell();
+    }
+    return { command: "sh", args: ["-c"] };
+}
 /**
  * Create an executor that runs commands either on host or in Docker container
  */
@@ -74,13 +131,13 @@ export function createExecutor(config) {
 class HostExecutor {
     async exec(command, options) {
         return new Promise((resolve, reject) => {
-            const shell = process.platform === "win32" ? "cmd" : "sh";
-            const shellArgs = process.platform === "win32" ? ["/c"] : ["-c"];
+            const shell = resolveHostShell();
             const child = (() => {
                 try {
-                    return spawn(shell, [...shellArgs, command], {
+                    return spawn(shell.command, [...shell.args, command], {
                         detached: true,
                         stdio: ["pipe", "pipe", "pipe"],
+                        windowsHide: true,
                     });
                 }
                 catch (err) {
@@ -199,6 +256,7 @@ function killProcessTree(pid) {
             spawn("taskkill", ["/F", "/T", "/PID", String(pid)], {
                 stdio: "ignore",
                 detached: true,
+                windowsHide: true,
             });
         }
         catch {

package/dist/shared/shell-escape.d.ts

@@ -3,3 +3,10 @@
  * Wraps in single quotes and escapes internal single quotes.
  */
 export declare function shellEscape(s: string): string;
+/**
+ * Normalize filesystem paths for POSIX-style shells.
+ * On Windows we convert backslashes to forward slashes so Git Bash/MSYS tools
+ * can consume the path consistently.
+ */
+export declare function toShellPath(path: string): string;
+export declare function shellEscapePath(path: string): string;

package/dist/shared/shell-escape.js

@@ -5,3 +5,14 @@
 export function shellEscape(s) {
     return `'${s.replace(/'/g, "'\\''")}'`;
 }
+/**
+ * Normalize filesystem paths for POSIX-style shells.
+ * On Windows we convert backslashes to forward slashes so Git Bash/MSYS tools
+ * can consume the path consistently.
+ */
+export function toShellPath(path) {
+    return process.platform === "win32" ? path.replace(/\\/g, "/") : path;
+}
+export function shellEscapePath(path) {
+    return shellEscape(toShellPath(path));
+}

package/dist/tools/edit.js

@@ -3,7 +3,7 @@ import * as Diff from "diff";
 import { DEFAULT_SECURITY_CONFIG } from "../security/config.js";
 import { logSecurityEvent } from "../security/logger.js";
 import { guardPath } from "../security/path-guard.js";
-import { shellEscape } from "../shared/shell-escape.js";
+import { shellEscapePath } from "../shared/shell-escape.js";
 import { writeContent } from "./write-content.js";
 /**
  * Generate a unified diff string with line numbers and context
@@ -123,7 +123,7 @@ export function createEditTool(executor, options = {}) {
                 }
             }
             // Read the file
-            const readResult = await executor.exec(`cat ${shellEscape(path)}`, { signal });
+            const readResult = await executor.exec(`cat ${shellEscapePath(path)}`, { signal });
             if (readResult.code !== 0) {
                 throw new Error(readResult.stderr || `File not found: ${path}`);
             }

package/dist/tools/read.js

@@ -3,7 +3,7 @@ import { extname } from "path";
 import { DEFAULT_SECURITY_CONFIG } from "../security/config.js";
 import { logSecurityEvent } from "../security/logger.js";
 import { guardPath } from "../security/path-guard.js";
-import { shellEscape } from "../shared/shell-escape.js";
+import { shellEscapePath, toShellPath } from "../shared/shell-escape.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead } from "./truncate.js";
 /**
  * Map of file extensions to MIME types for common image formats
@@ -70,7 +70,7 @@ export function createReadTool(executor, options = {}) {
             const mimeType = isImageFile(path);
             if (mimeType) {
                 // Read as image (binary) - use base64
-                const result = await executor.exec(`base64 < ${shellEscape(path)}`, { signal });
+                const result = await executor.exec(`base64 < ${shellEscapePath(path)}`, { signal });
                 if (result.code !== 0) {
                     throw new Error(result.stderr || `Failed to read file: ${path}`);
                 }
@@ -84,7 +84,7 @@ export function createReadTool(executor, options = {}) {
                 };
             }
             // Get total line count first
-            const countResult = await executor.exec(`wc -l < ${shellEscape(path)}`, { signal });
+            const countResult = await executor.exec(`wc -l < ${shellEscapePath(path)}`, { signal });
             if (countResult.code !== 0) {
                 throw new Error(countResult.stderr || `Failed to read file: ${path}`);
             }
@@ -99,10 +99,10 @@ export function createReadTool(executor, options = {}) {
             // Read content with offset
             let cmd;
             if (startLine === 1) {
-                cmd = `cat ${shellEscape(path)}`;
+                cmd = `cat ${shellEscapePath(path)}`;
             }
             else {
-                cmd = `tail -n +${startLine} ${shellEscape(path)}`;
+                cmd = `tail -n +${startLine} ${shellEscapePath(path)}`;
             }
             const result = await executor.exec(cmd, { signal });
             if (result.code !== 0) {
@@ -124,7 +124,7 @@ export function createReadTool(executor, options = {}) {
             if (truncation.firstLineExceedsLimit) {
                 // First line at offset exceeds 50KB - tell model to use bash
                 const firstLineSize = formatSize(Buffer.byteLength(selectedContent.split("\n")[0], "utf-8"));
-                outputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${path} | head -c ${DEFAULT_MAX_BYTES}]`;
+                outputText = `[Line ${startLineDisplay} is ${firstLineSize}, exceeds ${formatSize(DEFAULT_MAX_BYTES)} limit. Use bash: sed -n '${startLineDisplay}p' ${toShellPath(path)} | head -c ${DEFAULT_MAX_BYTES}]`;
                 details = { truncation };
             }
             else if (truncation.truncated) {

package/dist/tools/write-content.js

@@ -1,9 +1,10 @@
+import { dirname } from "node:path";
 import { DEFAULT_SECURITY_CONFIG } from "../security/config.js";
 import { logSecurityEvent } from "../security/logger.js";
 import { guardPath } from "../security/path-guard.js";
-import { shellEscape } from "../shared/shell-escape.js";
+import { shellEscapePath } from "../shared/shell-escape.js";
 function getDir(path) {
-    return path.includes("/") ? path.substring(0, path.lastIndexOf("/")) : ".";
+    return dirname(path);
 }
 function ensureSuccess(result, path) {
     if (result.code !== 0) {
@@ -41,8 +42,8 @@ export async function writeContent(executor, path, content, signal, options) {
             throw new Error(lines.join("\n"));
         }
     }
-    const dirPrefix = createParentDir ? `mkdir -p ${shellEscape(getDir(path))} && ` : "";
-    const result = await executor.exec(`${dirPrefix}cat > ${shellEscape(path)}`, {
+    const dirPrefix = createParentDir ? `mkdir -p ${shellEscapePath(getDir(path))} && ` : "";
+    const result = await executor.exec(`${dirPrefix}cat > ${shellEscapePath(path)}`, {
         signal,
         stdin: content,
     });

package/package.json

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