@co0ontty/wand 4.97.0 → 4.98.0

package/README.md

@@ -319,10 +319,6 @@ wand config:set port 9443
 - SQLite 升级前会生成一致性备份，迁移保留既有数据；遇到高于当前版本所支持的 schema 会拒绝启动，不会猜测兼容性并继续写入。降级需使用匹配的数据备份，不能让旧版本直接打开已经迁移的库。保险库和连接器的新密文使用数据库目录内独立的 `wand-vault.key`（权限 `0600`），不再只依赖同一数据库里的 `appSecret`。备份/迁移实例时须同时妥善保存数据库和密钥文件；只有数据库备份不能恢复新密文。缺失或损坏密钥会明确失败，不会生成新密钥覆盖现有密文。
 - 独立密钥防止仅泄露数据库时直接解密，但不防御获得整个数据目录或当前用户权限的攻击者。管理员密码的现有 CLI 查看/连接码兼容契约仍保留；不能据此宣称已全面完成密码哈希迁移或按设备令牌改造。
 
-### 语音识别
-
-Web、Android、iOS 可在语音输入设置中选择「服务端识别」或「客户端本地识别」。服务端使用按需安装的 whisper.cpp 多语言模型，支持无 GPU CPU 服务器、Mac mini Metal 与可选 CUDA；模型不随普通构建下载。部署、模型大小、鉴权和隐私边界见 [服务端语音识别](docs/server-speech.md)。设置内下载/初始化 LAYA 与语音模型，以及「石一」（决策专家）的本机性能检查和默认本地/免费调用链，见 [本地模型管理](docs/local-model-setup.md)。
-
 ### 可选本地决策（实验性）
 
 Apple Silicon 服务端可共享一份离线 Laya-MLX，为结构化 CLI 提供通用选择、评分和是非判断。它不是聊天模型，也不负责授权或自动派工。

package/dist/agent-dispatch.d.ts

@@ -40,6 +40,7 @@ export declare function dispatchAgentForTask(deps: AgentDispatchDeps, input: {
     systemPrompt?: string;
     employee?: SiliconEmployee;
     employeeCandidateIndex?: number;
+    sessionCreated?: (session: SessionSnapshot) => void;
     teamRequestStarted?: (sessionId: string, requestId: string) => void;
 }): Promise<AgentDispatchResult>;
 /**

package/dist/agent-dispatch.js

@@ -49,6 +49,16 @@ export async function dispatchAgentForTask(deps, input) {
     if (isLocalDecisionModel(resolvedModel)) {
         throw new AgentDispatchPreflightError("LAYA 仅支持有界决策，不能执行聊天或任务；该候选尚未接受输入。");
     }
+    // This resolution is a pure pre-session capability check: rejection here cannot have delivered input.
+    let sdkEngine = null;
+    if (agent.kind === "structured" && agent.engine === "sdk") {
+        try {
+            sdkEngine = await structured.resolveNewSessionPiEngine("sdk");
+        }
+        catch (cause) {
+            throw new AgentDispatchPreflightError("当前 Wand Agent 引擎不可用；未创建会话或发送输入，请核对执行工具配置。", { cause });
+        }
+    }
     const session = agent.kind === "pty"
         ? await processes.start(providerCliCommand(provider), cwd, agent.mode, input.prompt, {
             provider,
@@ -69,8 +79,8 @@ export async function dispatchAgentForTask(deps, input) {
             thinkingEffort: agent.thinkingEffort,
             // 直接派发 Wand Agent（不进员工候选链）：先裁决进程内引擎是否可用，
             // 不可用就让这次派发明确失败，不静默退回 CLI 冒充。
-            ...(agent.engine === "sdk"
-                ? { engine: (await structured.resolveNewSessionPiEngine("sdk")).engine }
+            ...(sdkEngine
+                ? { engine: sdkEngine.engine }
                 : {}),
             worktreeEnabled: false,
             sessionSource: "automation",
@@ -83,6 +93,7 @@ export async function dispatchAgentForTask(deps, input) {
             workspaceTaskId: group.workspaceTaskId,
         });
     storage.bindWandTaskSession(input.task.id, session.id);
+    input.sessionCreated?.(session);
     if (agent.kind !== "pty") {
         const completion = input.teamRequestStarted
             ? structured.sendMessage(session.id, input.prompt, { teamRequestStarted: input.teamRequestStarted })

package/dist/ai-team-types.d.ts

@@ -3,7 +3,7 @@ import type { AiTeamDeliverySummary } from "./ai-team-delivery-types.js";
 import type { WandTaskAgent } from "./task-types.js";
 import type { ConversationTurn } from "./types.js";
 export type { SiliconEmployee, SiliconEmployeeDraft } from "./employee-types.js";
-export { DEFAULT_EMPLOYEE_ID, DEFAULT_EMPLOYEE_KEY, DEFAULT_EMPLOYEE_NAME, DEFAULT_EMPLOYEE_TAG, DECISION_EXPERT_KEY, HR_EMPLOYEE_KEY, isBuiltinSiliconEmployee, isDecisionExpertSiliconEmployee, isDefaultSiliconEmployee, isSystemSiliconEmployee, parseSiliconEmployeeTagInput, parseSiliconEmployeeTags, SILICON_EMPLOYEE_MAX_TAGS, SILICON_EMPLOYEE_TAG_MAX_CHARS, siliconEmployeeTags, SPEECH_POLISHER_KEY, SYSTEM_EMPLOYEE_ID, SYSTEM_EMPLOYEE_KEY, SYSTEM_EMPLOYEE_NAME, SYSTEM_EMPLOYEE_TAG, } from "./employee-types.js";
+export { DEFAULT_EMPLOYEE_ID, DEFAULT_EMPLOYEE_KEY, DEFAULT_EMPLOYEE_NAME, DEFAULT_EMPLOYEE_TAG, DECISION_EXPERT_KEY, HR_EMPLOYEE_KEY, isBuiltinSiliconEmployee, isDecisionExpertSiliconEmployee, isDefaultSiliconEmployee, isSystemSiliconEmployee, parseSiliconEmployeeTagInput, parseSiliconEmployeeTags, SILICON_EMPLOYEE_MAX_TAGS, SILICON_EMPLOYEE_TAG_MAX_CHARS, siliconEmployeeTags, SYSTEM_EMPLOYEE_ID, SYSTEM_EMPLOYEE_KEY, SYSTEM_EMPLOYEE_NAME, SYSTEM_EMPLOYEE_TAG, } from "./employee-types.js";
 export declare const AI_TEAM_MIN_MEMBERS = 2;
 export declare const AI_TEAM_MAX_MEMBERS = 8;
 export declare const AI_TEAM_DEFAULT_MAX_STEPS = 30;

package/dist/ai-team-types.js

@@ -1,4 +1,4 @@
-export { DEFAULT_EMPLOYEE_ID, DEFAULT_EMPLOYEE_KEY, DEFAULT_EMPLOYEE_NAME, DEFAULT_EMPLOYEE_TAG, DECISION_EXPERT_KEY, HR_EMPLOYEE_KEY, isBuiltinSiliconEmployee, isDecisionExpertSiliconEmployee, isDefaultSiliconEmployee, isSystemSiliconEmployee, parseSiliconEmployeeTagInput, parseSiliconEmployeeTags, SILICON_EMPLOYEE_MAX_TAGS, SILICON_EMPLOYEE_TAG_MAX_CHARS, siliconEmployeeTags, SPEECH_POLISHER_KEY, SYSTEM_EMPLOYEE_ID, SYSTEM_EMPLOYEE_KEY, SYSTEM_EMPLOYEE_NAME, SYSTEM_EMPLOYEE_TAG, } from "./employee-types.js";
+export { DEFAULT_EMPLOYEE_ID, DEFAULT_EMPLOYEE_KEY, DEFAULT_EMPLOYEE_NAME, DEFAULT_EMPLOYEE_TAG, DECISION_EXPERT_KEY, HR_EMPLOYEE_KEY, isBuiltinSiliconEmployee, isDecisionExpertSiliconEmployee, isDefaultSiliconEmployee, isSystemSiliconEmployee, parseSiliconEmployeeTagInput, parseSiliconEmployeeTags, SILICON_EMPLOYEE_MAX_TAGS, SILICON_EMPLOYEE_TAG_MAX_CHARS, siliconEmployeeTags, SYSTEM_EMPLOYEE_ID, SYSTEM_EMPLOYEE_KEY, SYSTEM_EMPLOYEE_NAME, SYSTEM_EMPLOYEE_TAG, } from "./employee-types.js";
 export const AI_TEAM_MIN_MEMBERS = 2;
 export const AI_TEAM_MAX_MEMBERS = 8;
 export const AI_TEAM_DEFAULT_MAX_STEPS = 30;

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "a09542822526896c8dcc2c5af5862441fdb58282",
-  "builtAt": "2026-10-17T13:42:08.826Z",
-  "version": "4.97.0",
+  "commit": "2d092b1bc52286f63ff106cafb86f9c49ceb6a57",
+  "builtAt": "2026-10-19T03:45:08.103Z",
+  "version": "4.98.0",
   "channel": "stable"
 }

package/dist/cli.js

@@ -204,6 +204,7 @@ async function main() {
         case "session:create":
         case "session:resume":
         case "schedule:list":
+        case "task:context":
         case "schedule:read":
         case "schedule:create":
         case "schedule:update": {
@@ -364,6 +365,7 @@ Agent runtime:
   wand session:create --stdin  Create an employee session from JSON
   wand session:resume <id> --stdin  Continue the exact structured session with JSON input
   wand schedule:list [--include-cancelled]
+  wand task:context <task-id> [comment-id]  Read task facts and source reference
   wand schedule:read <id>    Read schedule and execution history
   wand schedule:create --stdin  Create a schedule from JSON (requestId required)
   wand schedule:update <id> --stdin  Edit/pause/cancel (revision required)

package/dist/config.d.ts

@@ -45,7 +45,7 @@ export declare function saveConfig(configPath: string, config: WandConfig): Prom
 export declare function loadConfigWithStorage(configPath: string, storage: WandStorage): Promise<WandConfig>;
 /**
  * Idempotent seeding of built-in employees (system ops, default partner, decision
- * expert, speech polisher, HR). Runs once per process start from loadConfigWithStorage;
+ * expert, HR). Runs once per process start from loadConfigWithStorage;
  * never rewrites user-maintained candidates.
  */
 export declare function bootstrapBuiltinEmployees(config: WandConfig, storage: WandStorage): void;

package/dist/config.js

@@ -196,7 +196,7 @@ export async function loadConfigWithStorage(configPath, storage) {
 }
 /**
  * Idempotent seeding of built-in employees (system ops, default partner, decision
- * expert, speech polisher, HR). Runs once per process start from loadConfigWithStorage;
+ * expert, HR). Runs once per process start from loadConfigWithStorage;
  * never rewrites user-maintained candidates.
  */
 export function bootstrapBuiltinEmployees(config, storage) {
@@ -211,7 +211,7 @@ export function bootstrapBuiltinEmployees(config, storage) {
     // 默认任务伙伴独立于系统运维；重启保留短期偏好与用户维护的候选。
     storage.ensureDefaultSiliconEmployee(config.defaultProvider);
     storage.ensureDecisionExpertEmployee();
-    storage.ensureSpeechPolisherEmployee();
+    storage.retireLegacySpeechPolisherEmployee();
     storage.ensureHrEmployee(storage.getSystemSiliconEmployee()?.agents);
 }
 /**

package/dist/core-runner.d.ts

@@ -20,10 +20,6 @@ export declare function coreMessagesFromTurns(session: SessionSnapshot, options?
     until?: number;
     summary?: string;
 }): AgentMessage[];
-/**
- * core agent 事件 → Wand 回合状态。与 pi CLI 适配器共用同一套 blocks 语义，
- * 但参数与结果是上游真值（不再从 provider 文本里反推）。返回本轮的 primaryError。
- */
 export declare function applyCoreAgentEvent(state: StructuredRunnerTurnState, event: Record<string, unknown>): string | null;
 export interface CoreRunnerOptions {
     openRouter?: OpenRouterFreeModelsService;

package/dist/core-runner.js

@@ -195,9 +195,13 @@ function applyAssistantMessage(state, message) {
  * core agent 事件 → Wand 回合状态。与 pi CLI 适配器共用同一套 blocks 语义，
  * 但参数与结果是上游真值（不再从 provider 文本里反推）。返回本轮的 primaryError。
  */
+const assistantMessageOffsets = new WeakMap();
 export function applyCoreAgentEvent(state, event) {
     capturePiExecutionEvent(state.blocks, event);
     const type = typeof event.type === "string" ? event.type : "";
+    if (type === "message_start" && event.message?.role === "assistant") {
+        assistantMessageOffsets.set(state, { blocks: state.blocks.length, result: state.result.length });
+    }
     if (type === "agent_start" || type === "turn_start" || type === "message_start") {
         state.phase = "responding";
         return null;
@@ -211,7 +215,7 @@ export function applyCoreAgentEvent(state, event) {
             return null;
         if (update?.type === "text_delta") {
             const last = state.blocks.at(-1);
-            if (last?.type === "text")
+            if (last?.type === "text" && state.blocks.length > (assistantMessageOffsets.get(state)?.blocks ?? 0))
                 last.text += delta;
             else
                 state.blocks.push({ type: "text", text: delta });
@@ -219,7 +223,7 @@ export function applyCoreAgentEvent(state, event) {
         }
         else if (update?.type === "thinking_delta") {
             const last = state.blocks.at(-1);
-            if (last?.type === "thinking")
+            if (last?.type === "thinking" && state.blocks.length > (assistantMessageOffsets.get(state)?.blocks ?? 0))
                 last.thinking += delta;
             else
                 state.blocks.push({ type: "thinking", thinking: delta });
@@ -230,7 +234,19 @@ export function applyCoreAgentEvent(state, event) {
         const message = event.message;
         if (message?.role !== "assistant")
             return null;
-        applyAssistantMessage(state, message);
+        const offset = assistantMessageOffsets.get(state);
+        if (offset) {
+            const segment = { ...state, blocks: state.blocks.slice(offset.blocks), result: state.result.slice(offset.result) };
+            applyAssistantMessage(segment, message);
+            state.blocks = [...state.blocks.slice(0, offset.blocks), ...segment.blocks];
+            state.result = state.result.slice(0, offset.result) + segment.result;
+            state.model = segment.model;
+            state.usage = segment.usage;
+            assistantMessageOffsets.delete(state);
+        }
+        else {
+            applyAssistantMessage(state, message);
+        }
         if (message.stopReason === "error") {
             return typeof message.errorMessage === "string" && message.errorMessage ? message.errorMessage : "core 引擎回合失败";
         }
@@ -457,6 +473,28 @@ export class CoreRunner {
                 },
             });
         }
+        // Agent owns getSteeringMessages internally. Stage only at its awaited finishTurn
+        // boundary, then let the native one-at-a-time queue drain before the next request.
+        // Install after AgentSession so extension boundary hooks finish first.
+        agent.steeringMode = "one-at-a-time";
+        const finishTurn = agent.finishTurn;
+        agent.finishTurn = async (turn, signal) => {
+            const decision = await finishTurn?.(turn, signal);
+            if (decision?.action === "end" || controller.signal.aborted || signal?.aborted
+                || !observer.isActive() || turn.message.stopReason === "error" || turn.message.stopReason === "aborted"
+                || agent.hasQueuedMessages())
+                return decision ?? undefined;
+            const prompt = context.takeSteering?.(state);
+            if (prompt !== null && prompt !== undefined) {
+                agent.steer({ role: "user", content: [{ type: "text", text: prompt }], timestamp: Date.now() });
+                // The preceding segment is now durable. Subsequent streaming must append
+                // after its new user turn rather than upsert the entire old assistant text.
+                state.blocks = [];
+                state.result = "";
+                state.usage = undefined;
+            }
+            return decision ?? undefined;
+        };
         if (extensionHost)
             register(agent, () => extensionHost.interrupt());
         const handleEvent = (event) => {

package/dist/decision-expert-employee.js

@@ -17,6 +17,7 @@ export function decisionExpertSeedAgents() {
 export function decisionExpertDefinition(now, existing) {
     return { id: existing?.id ?? DECISION_EXPERT_ID, systemKey: DECISION_EXPERT_KEY, name: DECISION_EXPERT_NAME,
         duty: DECISION_EXPERT_DUTY, prompt: DECISION_EXPERT_PROMPT, avatar: "", tags: [SYSTEM_EMPLOYEE_TAG],
+        systemSessionLimit: existing?.systemSessionLimit,
         agents: existing?.agents.length ? existing.agents : decisionExpertSeedAgents(),
         createdAt: existing?.createdAt ?? now, updatedAt: now };
 }

package/dist/distribution-manager.d.ts

@@ -38,6 +38,11 @@ export interface DistributionManagerOptions {
     fetch?: typeof fetch;
     now?: () => number;
 }
+/** 分发目录清理结果：删了哪些文件名、释放多少字节。 */
+export interface PruneReport {
+    deleted: string[];
+    freedBytes: number;
+}
 /**
  * GitHub Release 正文还包含 Android/macOS/iOS 的安装指引；它们属于发布页，
  * 不该出现在 Android 的更新弹窗。保留分隔线前的变更摘要，并兼容旧版正文。
@@ -78,10 +83,30 @@ export declare class DistributionManager {
      * compareLocalAssetCandidates）。返回删除的文件名与释放字节数；目录不存在、
      * 只剩一个包等情形都是空操作。单个文件删除失败不阻断其余清理。
      */
-    pruneAndroidApkDirectory(keepFileName?: string): Promise<{
-        deleted: string[];
-        freedBytes: number;
-    }>;
+    pruneAndroidApkDirectory(keepFileName?: string): Promise<PruneReport>;
+    /**
+     * 清理 macOS 分发目录。macOS 的构建脚本每个 debug 构建都产出独立时间戳的
+     * `.zip` + `.dmg` + `.update.json`，跨版本、同版本多次构建都会堆积。
+     *
+     * 保留：最新版本的全部文件（同版本的 zip/dmg/update.json 是一套，必须整体
+     * 保留——更新检查选 zip、`/macos/download` 可能选 dmg、update.json 是它们的
+     * 校验边车）、`currentDmgFile` 固定指向的包及其边车、本次正在下发的包及其边车。
+     * 其余版本的文件才会删除。
+     */
+    pruneMacosBetaDirectory(keepFileName?: string): Promise<PruneReport>;
+    /**
+     * 清理 iOS 分发目录。`ios/build.sh` 每次构建产出 `wand-v<version>.ipa`，
+     * debug 版本号带时间戳，因此同样会按构建次数堆积。
+     */
+    pruneIosIpaDirectory(keepFileName?: string): Promise<PruneReport>;
+    /**
+     * 分发目录清理的统一实现。三个平台只在「哪些文件算包」「怎么比版本」上不同，
+     * 保留规则和删除安全性必须共用，避免各自演化出不同答案。
+     *
+     * 排序与更新检查共用 `compareLocalAssetCandidates`，所以清理永远保留更新
+     * 检查会选中的那个文件。`.update.json` 这类边车不参与排序，只跟随它的包。
+     */
+    private pruneDistributionDirectory;
     /** Beta 仅从当前服务端的 macOS 分发目录选择，绝不回退 GitHub。 */
     resolveLatestMacosBeta(): Promise<ResolvedDistributionAsset | null>;
     /** 固定下载文件名，避免检查与下载之间新增包后下载到另一个版本。 */

package/dist/distribution-manager.js

@@ -2,9 +2,31 @@ import { createHash } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { lstat, mkdir, readdir, readFile, stat, unlink } from "node:fs/promises";
 import path from "node:path";
-import { compareApkInstallOrder, compareSemver, compareWandInstallOrder, extractSemver } from "./version-utils.js";
+import { compareApkInstallOrder, compareDistributionFiles, compareMacosFormatTieBreak, compareSemver, compareWandInstallOrder, extractSemver } from "./version-utils.js";
 const GITHUB_CACHE_TTL_MS = 10 * 60 * 1000;
 const MACOS_UPDATE_FILE_PATTERN = /^wand-v\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?\.(?:zip|dmg)$/i;
+/** macOS 构建脚本写在包旁边的校验边车（`wand-v<version>.update.json`）。 */
+const MACOS_UPDATE_SIDECAR_PATTERN = /^wand-v\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?\.update\.json$/i;
+function emptyPruneReport() {
+    return { deleted: [], freedBytes: 0 };
+}
+/** 从 `wand-v1.2.3.update.json` 得到 `wand-v1.2.3`，非边车返回 null。 */
+function macosSidecarBase(name) {
+    if (!MACOS_UPDATE_SIDECAR_PATTERN.test(name))
+        return null;
+    return name.slice(0, -"update.json".length - 1);
+}
+/** 尽力删除：删不掉（如下载流仍持有）就留给下次触发，不计入结果。 */
+async function removeQuietly(filePath, report) {
+    try {
+        await unlink(filePath);
+        report.deleted.push(path.basename(filePath));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * GitHub Release 正文还包含 Android/macOS/iOS 的安装指引；它们属于发布页，
  * 不该出现在 Android 的更新弹窗。保留分隔线前的变更摘要，并兼容旧版正文。
@@ -50,25 +72,11 @@ function extractArtifactVersion(fileName, extension) {
     return extractSemver(fileName.replace(new RegExp(`\\${extension}$`, "i"), ""));
 }
 /**
- * 本地分发候选的统一排序：版本新者优先（调用方提供比较器），解析不出版本的
- * 文件排在有版本的后面，同版本按修改时间新者优先。resolveLocalAsset 的挑选
- * 和 pruneAndroidApkDirectory 的「保最新」判定共用这一份规则。
+ * 本地分发候选的统一排序：直接复用 version-utils 的实现，保证「更新检查选谁」
+ * 与「构建包清理保谁」永远同一个答案。
  */
 function compareLocalAssetCandidates(a, b, extension, compareVersions) {
-    const aVersion = extractArtifactVersion(a.name, extension);
-    const bVersion = extractArtifactVersion(b.name, extension);
-    if (aVersion && bVersion) {
-        const comparison = compareVersions(bVersion, aVersion);
-        if (comparison !== 0)
-            return comparison;
-    }
-    else if (aVersion) {
-        return -1;
-    }
-    else if (bVersion) {
-        return 1;
-    }
-    return b.mtimeMs - a.mtimeMs;
+    return compareDistributionFiles({ ...a, version: extractArtifactVersion(a.name, extension) }, { ...b, version: extractArtifactVersion(b.name, extension) }, compareVersions);
 }
 function isPrerelease(version) {
     return !!version && version.includes("-");
@@ -172,45 +180,136 @@ export class DistributionManager {
         await this.refreshConfig();
         const { config, configDir } = this.options;
         if (config.android?.enabled !== true)
-            return { deleted: [], freedBytes: 0 };
-        const directory = resolveConfiguredDir(configDir, config.android.apkDir, "android");
+            return emptyPruneReport();
+        return this.pruneDistributionDirectory({
+            directory: resolveConfiguredDir(configDir, config.android.apkDir, "android"),
+            matches: (name) => name.toLowerCase().endsWith(".apk"),
+            extension: (name) => ".apk",
+            compareVersions: compareApkInstallOrder,
+            keepNames: [config.android.currentApkFile, keepFileName],
+        });
+    }
+    /**
+     * 清理 macOS 分发目录。macOS 的构建脚本每个 debug 构建都产出独立时间戳的
+     * `.zip` + `.dmg` + `.update.json`，跨版本、同版本多次构建都会堆积。
+     *
+     * 保留：最新版本的全部文件（同版本的 zip/dmg/update.json 是一套，必须整体
+     * 保留——更新检查选 zip、`/macos/download` 可能选 dmg、update.json 是它们的
+     * 校验边车）、`currentDmgFile` 固定指向的包及其边车、本次正在下发的包及其边车。
+     * 其余版本的文件才会删除。
+     */
+    async pruneMacosBetaDirectory(keepFileName) {
+        await this.refreshConfig();
+        const { config, configDir } = this.options;
+        if (config.macos?.enabled !== true)
+            return emptyPruneReport();
+        return this.pruneDistributionDirectory({
+            directory: resolveConfiguredDir(configDir, config.macos.dmgDir, "macos"),
+            matches: (name) => MACOS_UPDATE_FILE_PATTERN.test(name) || MACOS_UPDATE_SIDECAR_PATTERN.test(name),
+            extension: (name) => (name.toLowerCase().endsWith(".zip") ? ".zip" : ".dmg"),
+            // 与 resolveMacosBetaAsset 完全同一份规则：同版本 ZIP 优先，其次修改时间。
+            compareVersions: compareWandInstallOrder,
+            tieBreak: compareMacosFormatTieBreak,
+            keepNames: [config.macos.currentDmgFile, keepFileName],
+            sidecarOf: macosSidecarBase,
+        });
+    }
+    /**
+     * 清理 iOS 分发目录。`ios/build.sh` 每次构建产出 `wand-v<version>.ipa`，
+     * debug 版本号带时间戳，因此同样会按构建次数堆积。
+     */
+    async pruneIosIpaDirectory(keepFileName) {
+        await this.refreshConfig();
+        const { config, configDir } = this.options;
+        if (config.ios?.enabled !== true)
+            return emptyPruneReport();
+        return this.pruneDistributionDirectory({
+            directory: resolveConfiguredDir(configDir, config.ios.ipaDir, "ios"),
+            matches: (name) => name.toLowerCase().endsWith(".ipa"),
+            extension: () => ".ipa",
+            compareVersions: compareWandInstallOrder,
+            keepNames: [config.ios.currentIpaFile, keepFileName],
+        });
+    }
+    /**
+     * 分发目录清理的统一实现。三个平台只在「哪些文件算包」「怎么比版本」上不同，
+     * 保留规则和删除安全性必须共用，避免各自演化出不同答案。
+     *
+     * 排序与更新检查共用 `compareLocalAssetCandidates`，所以清理永远保留更新
+     * 检查会选中的那个文件。`.update.json` 这类边车不参与排序，只跟随它的包。
+     */
+    async pruneDistributionDirectory(options) {
+        const report = emptyPruneReport();
         let entries;
         try {
-            entries = await readdir(directory, { withFileTypes: true });
+            entries = await readdir(options.directory, { withFileTypes: true });
         }
         catch {
-            return { deleted: [], freedBytes: 0 };
+            return report;
         }
-        const apks = entries.filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".apk"));
-        if (apks.length === 0)
-            return { deleted: [], freedBytes: 0 };
-        const candidates = await Promise.all(apks.map(async (entry) => ({
-            name: entry.name,
-            filePath: path.join(directory, entry.name),
-            fileStat: await stat(path.join(directory, entry.name)),
-        })));
-        const sorted = [...candidates].sort((a, b) => compareLocalAssetCandidates({ name: a.name, mtimeMs: a.fileStat.mtimeMs }, { name: b.name, mtimeMs: b.fileStat.mtimeMs }, ".apk", compareApkInstallOrder));
-        const keepNames = new Set([sorted[0].name]);
-        const pinned = config.android.currentApkFile?.trim();
-        if (pinned)
-            keepNames.add(path.basename(pinned));
-        if (keepFileName)
-            keepNames.add(keepFileName);
-        const deleted = [];
-        let freedBytes = 0;
-        for (const candidate of sorted) {
-            if (keepNames.has(candidate.name))
-                continue;
+        const matched = entries.filter((entry) => entry.isFile() && options.matches(entry.name));
+        if (matched.length === 0)
+            return report;
+        const candidates = await Promise.all(matched.map(async (entry) => {
+            const filePath = path.join(options.directory, entry.name);
             try {
-                await unlink(candidate.filePath);
-                deleted.push(candidate.name);
-                freedBytes += candidate.fileStat.size;
+                const fileStat = await stat(filePath);
+                const sidecar = options.sidecarOf?.(entry.name) ?? null;
+                return {
+                    name: entry.name,
+                    filePath,
+                    fileStat,
+                    version: sidecar ? null : extractArtifactVersion(entry.name, options.extension(entry.name)),
+                    sidecar,
+                };
             }
             catch {
-                // 清理是尽力而为；删不掉（如正被另一个下载流读取）留到下次触发。
+                return null;
             }
+        }));
+        const packages = candidates.filter((candidate) => candidate !== null && candidate.version !== null);
+        const sidecars = candidates.filter((candidate) => candidate !== null && candidate.version === null);
+        if (packages.length === 0)
+            return report;
+        const sorted = [...packages].sort((a, b) => compareDistributionFiles({ name: a.name, mtimeMs: a.fileStat.mtimeMs, version: a.version }, { name: b.name, mtimeMs: b.fileStat.mtimeMs, version: b.version }, options.compareVersions, options.tieBreak));
+        const keepNames = new Set();
+        const newest = sorted[0];
+        // 最新版本保留整套：同版本的所有格式（zip/dmg）都留。
+        // debug 构建的版本号里已带构建时间戳（`4.97.1-debug.10181725`），所以同版本
+        // 多次构建是不同 version，自然只有最靠前的那一次被保留。
+        for (const candidate of packages)
+            if (candidate.version === newest.version)
+                keepNames.add(candidate.name);
+        for (const name of options.keepNames) {
+            const base = name?.trim();
+            if (!base)
+                continue;
+            const fileName = path.basename(base);
+            keepNames.add(fileName);
+            const version = extractArtifactVersion(fileName, options.extension(fileName));
+            // 固定指向某个版本时，该版本整套产物一起保留，避免留下半套。
+            if (version)
+                for (const candidate of packages)
+                    if (candidate.version === version)
+                        keepNames.add(candidate.name);
         }
-        return { deleted, freedBytes };
+        for (const candidate of packages) {
+            if (keepNames.has(candidate.name))
+                continue;
+            if (await removeQuietly(candidate.filePath, report))
+                report.freedBytes += candidate.fileStat.size;
+        }
+        // 边车跟随它的包：保留集合里的包所对应的 `wand-v<version>` 基名。
+        const keepBases = new Set();
+        for (const name of keepNames)
+            keepBases.add(name.slice(0, name.length - path.extname(name).length));
+        for (const sidecar of sidecars) {
+            if (sidecar.sidecar && keepBases.has(sidecar.sidecar))
+                continue;
+            if (await removeQuietly(sidecar.filePath, report))
+                report.freedBytes += sidecar.fileStat.size;
+        }
+        return report;
     }
     /** Beta 仅从当前服务端的 macOS 分发目录选择，绝不回退 GitHub。 */
     async resolveLatestMacosBeta() {
@@ -266,16 +365,7 @@ export class DistributionManager {
             filePath: path.join(directory, entry.name),
             fileStat: await stat(path.join(directory, entry.name)),
         })));
-        candidates.sort((a, b) => {
-            const aVersion = extractArtifactVersion(a.name, path.extname(a.name));
-            const bVersion = extractArtifactVersion(b.name, path.extname(b.name));
-            const order = compareWandInstallOrder(aVersion ?? "", bVersion ?? "");
-            if (order !== 0)
-                return -order;
-            // 同版本优先 ZIP，避免 DMG 挂载；同格式多构建按最新修改时间挑选。
-            const format = Number(b.name.toLowerCase().endsWith(".zip")) - Number(a.name.toLowerCase().endsWith(".zip"));
-            return format || b.fileStat.mtimeMs - a.fileStat.mtimeMs;
-        });
+        candidates.sort((a, b) => compareDistributionFiles({ name: a.name, mtimeMs: a.fileStat.mtimeMs, version: extractArtifactVersion(a.name, path.extname(a.name)) }, { name: b.name, mtimeMs: b.fileStat.mtimeMs, version: extractArtifactVersion(b.name, path.extname(b.name)) }, compareWandInstallOrder, compareMacosFormatTieBreak));
         const selected = candidates[0];
         if (!selected)
             return null;

package/dist/employee-types.d.ts

@@ -1,7 +1,6 @@
 import type { WandTaskAgent } from "./task-types.js";
 export { DECISION_EXPERT_KEY } from "./decision-expert-identity.js";
 export { HR_EMPLOYEE_KEY } from "./hr-employee-identity.js";
-export { SPEECH_POLISHER_KEY } from "./speech-polisher-identity.js";
 /** Employee contact entry; identity and execution choices are persisted independently of teams. */
 export interface SiliconEmployee {
     id: string;
@@ -12,6 +11,8 @@ export interface SiliconEmployee {
     agents: WandTaskAgent[];
     /** Built-in tags are fixed by systemKey; ordinary employees' tags are user-maintained. */
     tags?: string[];
+    /** Finished system auxiliary history only, excluding agent decisions/dispatch; null/omitted = unlimited, 0 = none. */
+    systemSessionLimit?: number | null;
     /** Non-empty = Wand built-in identity; it cannot be archived or deleted. */
     systemKey?: string;
     archivedAt?: string;

package/dist/employee-types.js

@@ -1,9 +1,7 @@
 import { DECISION_EXPERT_KEY } from "./decision-expert-identity.js";
 export { DECISION_EXPERT_KEY } from "./decision-expert-identity.js";
-import { SPEECH_POLISHER_KEY } from "./speech-polisher-identity.js";
 import { HR_EMPLOYEE_KEY } from "./hr-employee-identity.js";
 export { HR_EMPLOYEE_KEY } from "./hr-employee-identity.js";
-export { SPEECH_POLISHER_KEY } from "./speech-polisher-identity.js";
 export const SYSTEM_EMPLOYEE_KEY = "wand-ops";
 export const SYSTEM_EMPLOYEE_ID = "e_wand_ops";
 export const SYSTEM_EMPLOYEE_NAME = "勤劳的初二";
@@ -24,14 +22,14 @@ export function isDecisionExpertSiliconEmployee(employee) {
 export function isBuiltinSiliconEmployee(employee) {
     const key = employee?.systemKey;
     return key === SYSTEM_EMPLOYEE_KEY || key === DEFAULT_EMPLOYEE_KEY || key === DECISION_EXPERT_KEY
-        || key === SPEECH_POLISHER_KEY || key === HR_EMPLOYEE_KEY;
+        || key === HR_EMPLOYEE_KEY;
 }
 export const SILICON_EMPLOYEE_MAX_TAGS = 8;
 export const SILICON_EMPLOYEE_TAG_MAX_CHARS = 20;
 /** Built-in labels can only be projected from the corresponding stable employee identity. */
 export function siliconEmployeeTags(employee) {
     if (isSystemSiliconEmployee(employee) || isDecisionExpertSiliconEmployee(employee)
-        || employee.systemKey === SPEECH_POLISHER_KEY || employee.systemKey === HR_EMPLOYEE_KEY) {
+        || employee.systemKey === HR_EMPLOYEE_KEY) {
         return [SYSTEM_EMPLOYEE_TAG];
     }
     if (isDefaultSiliconEmployee(employee))

package/dist/feedback-feature-map.d.ts

@@ -23,7 +23,6 @@ export declare const FEEDBACK_API_FEATURES: {
     readonly "file-read": "files";
     readonly "file-write": "files";
     readonly "recent-paths": "files";
-    readonly speech: "speech";
     readonly settings: "settings";
     readonly config: "settings";
     readonly "user-profile": "settings";

package/dist/feedback-feature-map.js

@@ -4,7 +4,6 @@ export const FEEDBACK_API_FEATURES = {
     conversations: "conversations",
     "wand-tasks": "tasks", "wand-task-agent-defaults": "tasks", tasks: "tasks", "workspace-tasks": "tasks", workspaces: "tasks", "wand-milestones": "tasks", missions: "tasks", "scheduled-tasks": "tasks",
     files: "files", upload: "files", directory: "files", "session-files": "files", "file-preview": "files", "file-read": "files", "file-write": "files", "recent-paths": "files",
-    speech: "speech",
     settings: "settings", config: "settings", "user-profile": "settings", "auto-update": "settings", "update-channel": "settings",
     models: "models", "model-groups": "models", "local-models": "models",
     login: "authentication", logout: "authentication", "app-login": "authentication", "session-check": "authentication", "set-password": "authentication",

package/dist/feedback.d.ts

@@ -16,7 +16,6 @@ export declare const FEEDBACK_FEATURE_LABELS: {
     readonly conversations: "对话";
     readonly tasks: "任务";
     readonly files: "文件";
-    readonly speech: "语音";
     readonly settings: "设置";
     readonly models: "模型";
     readonly authentication: "登录认证";

package/dist/feedback.js

@@ -17,7 +17,7 @@ export const FEEDBACK_CLIENT_SOURCES = ["web", "macos", "android", "ios"];
 /** Stable semantic owners, not error-text classification or user-controlled URLs. */
 export const FEEDBACK_FEATURE_LABELS = {
     app_update: "应用更新", server_update: "服务端更新", provider_update: "CLI 工具更新", daemon_update: "底层组件更新",
-    api: "接口请求", sessions: "会话", conversations: "对话", tasks: "任务", files: "文件", speech: "语音",
+    api: "接口请求", sessions: "会话", conversations: "对话", tasks: "任务", files: "文件",
     settings: "设置", models: "模型", authentication: "登录认证", realtime: "实时连接", runtime: "系统运行",
     startup: "服务启动", storage: "存储", repository: "代码仓库",
 };