@steerable/agent-shell 0.6.32 → 0.6.34

package/dist/host/runtime.js

@@ -17,6 +17,7 @@ import { TerminalManager } from '../terminal-manager.js';
 import { ToolRouter } from '../tool-router.js';
 import { McpServerRegistry, } from '../mcp-server-registry.js';
 import { ProjectRegistry } from '../project-registry.js';
+import { getProductConfig } from '../product-config.js';
 import { LocalBackendRouter } from '../local-backend/router.js';
 import { WorktreeService } from '../local-backend/worktree-service.js';
 import { TaskService } from '../local-backend/task-service.js';
@@ -31,6 +32,7 @@ import { getChatAttachmentsDir } from '../attachments.js';
 import { ensureChatWorkspace } from '../project-home.js';
 import { recordInsightTurn } from '../insights/record.js';
 import { llmService } from '../llm/index.js';
+import { isProductLlmLocked, resolveRuntimeLlmSettings } from '../host-tools-runtime.js';
 import { getPackAssemblies, } from './pack-assembly.js';
 export async function createHostRuntime(options) {
     const { broadcast, hasWindow, onLog } = options;
@@ -65,15 +67,14 @@ export async function createHostRuntime(options) {
     // 生效，这里负责进程重启后的恢复）。
     {
         const persistedLlmSettings = await defaultStore.getLlmSettings();
-        setDefaultExecTimeoutMs(persistedLlmSettings?.execTimeoutSeconds
-            ? persistedLlmSettings.execTimeoutSeconds * 1000
+        const runtimeLlmSettings = resolveRuntimeLlmSettings(persistedLlmSettings);
+        if (isProductLlmLocked()) {
+            await defaultStore.setLlmSettings(runtimeLlmSettings);
+        }
+        setDefaultExecTimeoutMs(runtimeLlmSettings.execTimeoutSeconds
+            ? runtimeLlmSettings.execTimeoutSeconds * 1000
             : null);
-        llmService.initialize(persistedLlmSettings ?? {
-            provider: 'ollama',
-            model: 'llama3.1:8b',
-            baseUrl: 'http://127.0.0.1:11434',
-            temperature: 0.3,
-        }, {
+        llmService.initialize(runtimeLlmSettings, {
             setLlmSettings: (settings) => defaultStore.setLlmSettings(settings),
         });
     }
@@ -85,6 +86,7 @@ export async function createHostRuntime(options) {
         name: 'agent-mcp-servers',
         defaults: { mcpServers: [] },
     }));
+    mcpServerRegistry.seedProductServers(getProductConfig().builtinMcp);
     const projectRegistry = new ProjectRegistry(createJsonStore({
         name: 'agent-projects',
         defaults: { projects: [] },

package/dist/host/visible-terminal-exec.js

@@ -5,6 +5,7 @@
  */
 import log from 'electron-log';
 import { GUI_LAUNCH_WAIT_MS, getConfiguredExecTimeoutMs, isGuiLaunchCommand, rewriteExeCommandIfNeeded, } from '../local-executor.js';
+import { getResolvedHostTools } from '../host-tools-runtime.js';
 /**
  * Map a raw PTY shell binary name (e.g. `powershell.exe`, `cmd.exe`, `zsh`) to
  * the {@link LocalExecResult} `shell` enum so the agent sees the *real* dialect
@@ -33,6 +34,9 @@ export function mapSessionShell(shell) {
 export function createVisibleTerminalExec(deps) {
     const { localExecutor, terminalManager } = deps;
     return async function maybeExecInTerminal(req) {
+        if (!getResolvedHostTools().terminal.chrome) {
+            return null;
+        }
         if (req.command) {
             req.command = rewriteExeCommandIfNeeded(req.command);
         }

package/dist/host-tools-runtime.d.ts

@@ -0,0 +1,10 @@
+import { buildHostApproval, type ChatModeId, type ResolvedHostTools } from './host-tools.js';
+import { type LlmSettings } from './storage/llm-settings.js';
+export declare function getResolvedHostTools(): ResolvedHostTools;
+export declare function isProductApprovalEnabled(): boolean;
+export declare function resolveTurnApproval(storePath?: string): ReturnType<typeof buildHostApproval>;
+export declare function assertHostIpcAllowed(channel: string): void;
+export declare function resolveTurnChatMode(requested: unknown): ChatModeId;
+export declare function isProductLlmLocked(): boolean;
+/** 设置页开着走已存/出厂默认；关掉则钉死 product.json 的 llm。 */
+export declare function resolveRuntimeLlmSettings(persisted: LlmSettings | null): LlmSettings;

package/dist/host-tools-runtime.js

@@ -0,0 +1,44 @@
+/**
+ * 把产品注入的 hostTools / approval 接到解析器。
+ * host-tools.ts 保持无 node 依赖，供测试与渲染层复用解析规则。
+ */
+import os from 'node:os';
+import path from 'node:path';
+import { getProductConfig } from './product-config.js';
+import { buildHostApproval, clampChatMode, isHostIpcAllowed, resolveChatModes, resolveHostTools, resolveSettingsChrome, } from './host-tools.js';
+import { DEFAULT_LLM_SETTINGS, resolveLockedLlmSettings, } from './storage/llm-settings.js';
+export function getResolvedHostTools() {
+    return resolveHostTools(getProductConfig().hostTools);
+}
+export function isProductApprovalEnabled() {
+    return (buildHostApproval({
+        productApproval: getProductConfig().approval,
+        envApproval: process.env.STEERABLE_APPROVAL,
+        storePath: 'unused',
+    }) !== undefined);
+}
+export function resolveTurnApproval(storePath = path.join(os.homedir(), '.steerable', 'approvals.json')) {
+    return buildHostApproval({
+        productApproval: getProductConfig().approval,
+        envApproval: process.env.STEERABLE_APPROVAL,
+        storePath,
+    });
+}
+export function assertHostIpcAllowed(channel) {
+    if (!isHostIpcAllowed(channel, getResolvedHostTools())) {
+        throw new Error(`${channel} is disabled for this product`);
+    }
+}
+export function resolveTurnChatMode(requested) {
+    return clampChatMode(requested, resolveChatModes(getProductConfig().chatModes));
+}
+export function isProductLlmLocked() {
+    return !resolveSettingsChrome(getProductConfig().settings).llm;
+}
+/** 设置页开着走已存/出厂默认；关掉则钉死 product.json 的 llm。 */
+export function resolveRuntimeLlmSettings(persisted) {
+    if (!isProductLlmLocked()) {
+        return persisted ?? DEFAULT_LLM_SETTINGS;
+    }
+    return resolveLockedLlmSettings(getProductConfig().llm, process.env, persisted);
+}

package/dist/host-tools.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 宿主工具族：产品声明引入哪些工具，服务端按同一份配置钳死围栏 / 路由 / 工具面。
+ * 渲染层只投影 chrome；缺省（中性 shell、未声明的族）全开，兼容存量产品。
+ */
+export declare const HOST_TOOL_FAMILY_IDS: readonly ["terminal", "local-fs", "projects", "background-tasks", "mcp", "web", "plugins"];
+export type HostToolFamilyId = (typeof HOST_TOOL_FAMILY_IDS)[number];
+export interface HostToolFamilySurface {
+    /** 模型可见工具 + 围栏 / 服务端能力。 */
+    capability: boolean;
+    /** 用户入口：按钮、菜单、项目分组、点路径打开、可见 PTY。会话附件跟 capability 走。 */
+    chrome: boolean;
+}
+/** 产品声明：`true` 两边开，`false` 两边关，对象可拆 chrome / capability。 */
+export type HostToolsConfig = Partial<Record<HostToolFamilyId, boolean | {
+    capability?: boolean;
+    chrome?: boolean;
+}>>;
+export type ResolvedHostTools = Record<HostToolFamilyId, HostToolFamilySurface>;
+export type ApprovalMode = 'host' | 'off';
+export declare const CHAT_MODE_IDS: readonly ["agent", "plan"];
+export type ChatModeId = (typeof CHAT_MODE_IDS)[number];
+/** 产品声明的对话模式。缺省 Agent + Plan；空/非法回落 Agent。 */
+export declare function resolveChatModes(value?: unknown): ChatModeId[];
+export declare function clampChatMode(requested: unknown, modes?: readonly ChatModeId[]): ChatModeId;
+/** 设置入口：侧栏页 + 综合设置分段。缺省全开；`false` 只藏入口。 */
+export declare const SETTINGS_ITEM_IDS: readonly ["agents", "skills", "mcp", "appearance", "llm", "web-search", "usage", "diagnose", "security", "insights", "telemetry"];
+export type SettingsItemId = (typeof SETTINGS_ITEM_IDS)[number];
+export declare const GENERAL_SETTINGS_ITEM_IDS: readonly ["appearance", "llm", "web-search", "usage", "diagnose", "security", "insights", "telemetry"];
+export type SettingsChromeConfig = Partial<Record<SettingsItemId, boolean>>;
+export type ResolvedSettingsChrome = Record<SettingsItemId, boolean>;
+/**
+ * 产品 `settings`：未声明的项全开。关了的宿主工具族会一并藏对应设置段
+ * （skills←plugins、mcp、web-search←web）。
+ */
+export declare function resolveSettingsChrome(value?: unknown, tools?: ResolvedHostTools): ResolvedSettingsChrome;
+export declare function hasGeneralSettingsChrome(chrome?: ResolvedSettingsChrome): boolean;
+export declare const LOCAL_FS_TOOL_NAMES: readonly ["local_exec_shell", "local_read_file", "local_write_file", "local_edit_file", "local_open_path", "local_run_snippet", "local_list_scripts", "local_run_script"];
+export declare function resolveHostToolSurface(value: boolean | {
+    capability?: boolean;
+    chrome?: boolean;
+} | undefined): HostToolFamilySurface;
+/**
+ * 对象声明必须显式 `chrome: true` 才开入口。
+ * `capability` 缺省为 true——只关入口写成 `{ chrome: false }` 即可。
+ */
+export declare function resolveHostTools(config?: HostToolsConfig | null): ResolvedHostTools;
+export declare function resolveApprovalMode(value: unknown): ApprovalMode;
+/**
+ * 产品 `approval: "off"` 或 STEERABLE_APPROVAL=0 时本轮不挂 host 审批。
+ * 环境变量是调试逃生口；产品字段是装配真源。
+ */
+export declare function isApprovalEnabled(input?: {
+    productApproval?: unknown;
+    envApproval?: string;
+}): boolean;
+export declare function clampExecPolicy(requested: unknown, tools?: ResolvedHostTools): 'workspace' | 'full';
+export declare function familyForHostToolName(name: string): HostToolFamilyId | null;
+export declare function isHostToolCapabilityEnabled(name: string, tools?: ResolvedHostTools): boolean;
+export declare function isHostRouteAllowed(pathname: string, tools?: ResolvedHostTools): boolean;
+export declare function sanitizeRightPanelKind(kind: string | null | undefined, tools?: ResolvedHostTools): string | null;
+/** Electron IPC 通道与 HTTP `/host/*` 用同一套 chrome / capability 规则。 */
+export declare function isHostIpcAllowed(channel: string, tools?: ResolvedHostTools): boolean;
+/** 本轮是否挂 host 审批对象；关掉时返回 undefined（sidecar 不弹询问）。 */
+export declare function buildHostApproval(input: {
+    productApproval?: unknown;
+    envApproval?: string;
+    storePath: string;
+    timeoutMs?: number;
+}): {
+    mode: 'host';
+    timeoutMs: number;
+    storePath: string;
+} | undefined;

package/dist/host-tools.js

@@ -0,0 +1,198 @@
+/**
+ * 宿主工具族：产品声明引入哪些工具，服务端按同一份配置钳死围栏 / 路由 / 工具面。
+ * 渲染层只投影 chrome；缺省（中性 shell、未声明的族）全开，兼容存量产品。
+ */
+export const HOST_TOOL_FAMILY_IDS = [
+    'terminal',
+    'local-fs',
+    'projects',
+    'background-tasks',
+    'mcp',
+    'web',
+    'plugins',
+];
+export const CHAT_MODE_IDS = ['agent', 'plan'];
+const DEFAULT_CHAT_MODES = ['agent', 'plan'];
+/** 产品声明的对话模式。缺省 Agent + Plan；空/非法回落 Agent。 */
+export function resolveChatModes(value) {
+    if (!Array.isArray(value))
+        return [...DEFAULT_CHAT_MODES];
+    const allowed = CHAT_MODE_IDS.filter((id) => value.includes(id));
+    return allowed.length > 0 ? allowed : ['agent'];
+}
+export function clampChatMode(requested, modes = resolveChatModes()) {
+    return requested === 'plan' && modes.includes('plan') ? 'plan' : 'agent';
+}
+/** 设置入口：侧栏页 + 综合设置分段。缺省全开；`false` 只藏入口。 */
+export const SETTINGS_ITEM_IDS = [
+    'agents',
+    'skills',
+    'mcp',
+    'appearance',
+    'llm',
+    'web-search',
+    'usage',
+    'diagnose',
+    'security',
+    'insights',
+    'telemetry',
+];
+export const GENERAL_SETTINGS_ITEM_IDS = [
+    'appearance',
+    'llm',
+    'web-search',
+    'usage',
+    'diagnose',
+    'security',
+    'insights',
+    'telemetry',
+];
+function settingsFollowsHostTool(id, tools) {
+    if (id === 'skills')
+        return tools.plugins.chrome;
+    if (id === 'mcp')
+        return tools.mcp.chrome;
+    if (id === 'web-search')
+        return tools.web.chrome;
+    return true;
+}
+/**
+ * 产品 `settings`：未声明的项全开。关了的宿主工具族会一并藏对应设置段
+ * （skills←plugins、mcp、web-search←web）。
+ */
+export function resolveSettingsChrome(value, tools = resolveHostTools()) {
+    const config = value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+    const out = {};
+    for (const id of SETTINGS_ITEM_IDS) {
+        out[id] = config[id] !== false && settingsFollowsHostTool(id, tools);
+    }
+    return out;
+}
+export function hasGeneralSettingsChrome(chrome = resolveSettingsChrome()) {
+    return GENERAL_SETTINGS_ITEM_IDS.some((id) => chrome[id]);
+}
+export const LOCAL_FS_TOOL_NAMES = [
+    'local_exec_shell',
+    'local_read_file',
+    'local_write_file',
+    'local_edit_file',
+    'local_open_path',
+    'local_run_snippet',
+    'local_list_scripts',
+    'local_run_script',
+];
+const FAMILY_TOOL_PREFIX = {
+    terminal: [],
+    projects: [],
+    'local-fs': LOCAL_FS_TOOL_NAMES,
+    'background-tasks': [
+        'task_run',
+        'task_send',
+        'task_status',
+        'task_result',
+        'worktree_create',
+        'worktree_list',
+        'worktree_remove',
+    ],
+    mcp: ['mcp_list_tools', 'mcp_tool_exec'],
+    web: ['web_search', 'web_fetch'],
+    plugins: ['plugin_list', 'plugin_enable', 'plugin_disable', 'plugin_reload'],
+};
+const ALL_ON = { capability: true, chrome: true };
+const ALL_OFF = { capability: false, chrome: false };
+export function resolveHostToolSurface(value) {
+    if (value === undefined)
+        return { ...ALL_ON };
+    if (value === true)
+        return { ...ALL_ON };
+    if (value === false)
+        return { ...ALL_OFF };
+    return {
+        capability: value.capability !== false,
+        chrome: value.chrome === true,
+    };
+}
+/**
+ * 对象声明必须显式 `chrome: true` 才开入口。
+ * `capability` 缺省为 true——只关入口写成 `{ chrome: false }` 即可。
+ */
+export function resolveHostTools(config) {
+    const out = {};
+    for (const id of HOST_TOOL_FAMILY_IDS) {
+        out[id] = resolveHostToolSurface(config?.[id]);
+    }
+    return out;
+}
+export function resolveApprovalMode(value) {
+    return value === 'off' ? 'off' : 'host';
+}
+/**
+ * 产品 `approval: "off"` 或 STEERABLE_APPROVAL=0 时本轮不挂 host 审批。
+ * 环境变量是调试逃生口；产品字段是装配真源。
+ */
+export function isApprovalEnabled(input = {}) {
+    if (input.envApproval === '0')
+        return false;
+    return resolveApprovalMode(input.productApproval) === 'host';
+}
+export function clampExecPolicy(requested, tools = resolveHostTools()) {
+    if (!tools['local-fs'].chrome)
+        return 'workspace';
+    return requested === 'full' ? 'full' : 'workspace';
+}
+export function familyForHostToolName(name) {
+    if (name.startsWith('mcp__'))
+        return 'mcp';
+    for (const id of HOST_TOOL_FAMILY_IDS) {
+        if (FAMILY_TOOL_PREFIX[id].includes(name))
+            return id;
+    }
+    return null;
+}
+export function isHostToolCapabilityEnabled(name, tools = resolveHostTools()) {
+    const family = familyForHostToolName(name);
+    return family == null ? true : tools[family].capability;
+}
+export function isHostRouteAllowed(pathname, tools = resolveHostTools()) {
+    if (pathname.startsWith('/host/terminal'))
+        return tools.terminal.chrome;
+    // 会话附件：公文关 chrome（不露访达 / 完整权限）仍要上传材料。
+    if (pathname === '/host/attachments/save')
+        return tools['local-fs'].capability;
+    if (pathname === '/host/local/open-path')
+        return tools['local-fs'].chrome;
+    if (pathname.startsWith('/host/local/'))
+        return tools['local-fs'].capability;
+    return true;
+}
+export function sanitizeRightPanelKind(kind, tools = resolveHostTools()) {
+    if (!kind)
+        return null;
+    if (kind === 'terminal')
+        return tools.terminal.chrome ? 'terminal' : null;
+    return kind;
+}
+/** Electron IPC 通道与 HTTP `/host/*` 用同一套 chrome / capability 规则。 */
+export function isHostIpcAllowed(channel, tools = resolveHostTools()) {
+    if (channel.startsWith('terminal:'))
+        return tools.terminal.chrome;
+    if (channel === 'attachments:save')
+        return tools['local-fs'].capability;
+    if (channel === 'local:open-path')
+        return tools['local-fs'].chrome;
+    if (channel.startsWith('local:'))
+        return tools['local-fs'].capability;
+    return true;
+}
+/** 本轮是否挂 host 审批对象；关掉时返回 undefined（sidecar 不弹询问）。 */
+export function buildHostApproval(input) {
+    if (!isApprovalEnabled(input))
+        return undefined;
+    return {
+        mode: 'host',
+        timeoutMs: input.timeoutMs ?? 120_000,
+        storePath: input.storePath,
+    };
+}

package/dist/local-backend/router.js

@@ -22,6 +22,8 @@ import { sanitizeCompatOverrides, sanitizePresetsChoice, sanitizeLlmProvider, sa
 import { setDefaultExecTimeoutMs } from '../local-executor.js';
 import { allowEgressForBaseUrl, getActiveEgressBroker, getEgressPosture } from '../sidecar/egress-proxy.js';
 import { buildExecSandbox, parseExecPolicy } from '../sidecar/exec-sandbox.js';
+import { clampExecPolicy } from '../host-tools.js';
+import { getResolvedHostTools, isProductLlmLocked, resolveRuntimeLlmSettings, resolveTurnApproval, resolveTurnChatMode, } from '../host-tools-runtime.js';
 import { SidecarSupervisor } from '../sidecar/index.js';
 import { diagnoseLlmConnection } from './llm-diagnose.js';
 import { brandSkillVars, buildSystemPrompt, buildForcedSkillMessage, conditionsFromTools, } from './prompt-builder.js';
@@ -38,7 +40,7 @@ import { detectInterruptedTurn } from './interrupted-helper.js';
 import { dropCurrentUserMessage } from './history-helper.js';
 import { parseImageAttachments, processImageAttachments } from '../image-attachment.js';
 import { loadProjectRuleFiles } from '../project-rules.js';
-import { allocateProjectHome, ensureChatWorkspace, ensureProjectHome, } from '../project-home.js';
+import { allocateProjectHome, ensureChatWorkspace, ensureProjectHome, expandUserPath, } from '../project-home.js';
 import { registerLiveStream, getLiveStream, removeLiveStream } from './live-stream.js';
 import { beginPackTurnObservers, collectPackExecWritableRoots, collectPackForcedSkillVars, collectPackWorldState, } from './pack-turn-hooks.js';
 import { matchPackBackendRoute } from './pack-backend-routes.js';
@@ -48,7 +50,9 @@ import { getAuthProvider } from '../auth/index.js';
 function parseSourceFolders(value) {
     if (!Array.isArray(value))
         return [];
-    return value.filter((item) => typeof item === 'string' && item.trim() !== '');
+    return value
+        .filter((item) => typeof item === 'string' && item.trim() !== '')
+        .map(expandUserPath);
 }
 /**
  * 把 CoreLoop/LLM 的底层错误翻译成适合直接显示在助手消息里的中文提示。
@@ -391,6 +395,9 @@ export class LocalBackendRouter {
             const projectId = typeof payload.projectId === 'string' && payload.projectId.trim()
                 ? payload.projectId.trim()
                 : null;
+            if (projectId && !getResolvedHostTools().projects.capability) {
+                return { status: 403, data: { detail: 'Projects are disabled for this product' } };
+            }
             if (projectId) {
                 const project = this.toolRouter.projectRegistry?.get(projectId);
                 if (!project) {
@@ -426,6 +433,10 @@ export class LocalBackendRouter {
         // ───── 项目模式：projects CRUD ─────
         // 项目记录存 electron-store（agent-projects.json），chat.project_id 存
         // SQLite。删除项目不删会话——会话降级为无项目对话。
+        if ((pathname === '/api/v2/projects' || pathname.startsWith('/api/v2/projects/')) &&
+            !getResolvedHostTools().projects.capability) {
+            return { status: 403, data: { error: 'Projects are disabled for this product' } };
+        }
         if (pathname === '/api/v2/projects') {
             const registry = this.toolRouter.projectRegistry;
             if (!registry) {
@@ -439,7 +450,7 @@ export class LocalBackendRouter {
                 try {
                     const name = String(payload.name || '');
                     const sourceFolders = parseSourceFolders(payload.sourceFolders);
-                    let folderPath = typeof payload.folderPath === 'string' ? payload.folderPath.trim() : '';
+                    let folderPath = typeof payload.folderPath === 'string' ? expandUserPath(payload.folderPath) : '';
                     if (!folderPath) {
                         folderPath = allocateProjectHome(name);
                         ensureProjectHome(folderPath);
@@ -471,7 +482,7 @@ export class LocalBackendRouter {
                 try {
                     const project = registry.update(projectId, {
                         name: typeof payload.name === 'string' ? payload.name : undefined,
-                        folderPath: typeof payload.folderPath === 'string' ? payload.folderPath : undefined,
+                        folderPath: typeof payload.folderPath === 'string' ? expandUserPath(payload.folderPath) : undefined,
                         sourceFolders: payload.sourceFolders === undefined
                             ? undefined
                             : parseSourceFolders(payload.sourceFolders),
@@ -679,6 +690,9 @@ export class LocalBackendRouter {
             // （必须真实存在，防止把会话挂到幽灵项目上）。
             let projectIdUpdate;
             if ('projectId' in payload) {
+                if (!getResolvedHostTools().projects.capability) {
+                    return { status: 403, data: { detail: 'Projects are disabled for this product' } };
+                }
                 if (payload.projectId === null) {
                     projectIdUpdate = null;
                 }
@@ -1463,10 +1477,13 @@ export class LocalBackendRouter {
             if (method === 'GET') {
                 return {
                     status: 200,
-                    data: await this.store.getLlmSettings(),
+                    data: resolveRuntimeLlmSettings(await this.store.getLlmSettings()),
                 };
             }
             if (method === 'POST') {
+                if (isProductLlmLocked()) {
+                    return { status: 403, data: { error: 'LLM settings are product-locked' } };
+                }
                 const payload = this.toRecord(request.body);
                 const saved = await llmService.setSettings({
                     provider: sanitizeLlmProvider(payload.provider),
@@ -2020,7 +2037,7 @@ export class LocalBackendRouter {
         }
         // Plan 模式（类 Cursor "先出计划"）：仅暴露只读工具给模型，引导它先调研、
         // 再输出结构化计划，不做任何写操作/执行。其余值一律视为常规 agent 模式。
-        const chatMode = payload.mode === 'plan' ? 'plan' : 'agent';
+        const chatMode = resolveTurnChatMode(payload.mode);
         // 本轮生效的智能体：人设、技能勾选、工具策略同源。必须先解析——工具
         // 策略决定工具列表，工具列表又决定技能的触发条件。
         const turnAgents = await this.resolveTurnAgents(chatId, payload, mentionedAgentIds);
@@ -2910,19 +2927,13 @@ export class LocalBackendRouter {
             // 工作区）。
             ...collectPackExecWritableRoots(chatId),
             workspaceRoot,
-        ], { policy: parseExecPolicy(payload.execPolicy) });
+        ], { policy: clampExecPolicy(parseExecPolicy(payload.execPolicy), getResolvedHostTools()) });
         // W4-1: approval algebra, host mode — every tool call is gated by the
         // Electron approval UI over the reverse channel. The durable scope
         // (allow_always / deny_always) persists per tool category under
-        // ~/.steerable (writable inside the layer-1 sandbox). STEERABLE_APPROVAL=0
-        // restores the legacy ungated behavior.
-        const approval = process.env.STEERABLE_APPROVAL === '0'
-            ? undefined
-            : {
-                mode: 'host',
-                timeoutMs: 120_000,
-                storePath: path.join(os.homedir(), '.steerable', 'approvals.json'),
-            };
+        // ~/.steerable (writable inside the layer-1 sandbox). 产品
+        // approval:"off" 或 STEERABLE_APPROVAL=0 本轮不挂审批。
+        const approval = resolveTurnApproval();
         let assistantText = '';
         const executedActions = [];
         const timeline = [];

package/dist/local-backend/skill-loader.d.ts

@@ -14,6 +14,38 @@
  * readable by both. The sidecar is the only chat path and auto-restarts, so
  * it is available both in-turn (prompt assembly) and for the management UI.
  */
+/** shell 随包分发的内置技能目录。产品经 product.json `builtinSkills` 按需引入。 */
+export declare const SHELL_BUILTIN_SKILLS: readonly [{
+    readonly dir: "00-identity";
+    readonly name: "identity";
+}, {
+    readonly dir: "10-goal";
+    readonly name: "goal";
+}, {
+    readonly dir: "11-loop";
+    readonly name: "loop";
+}, {
+    readonly dir: "12-create-skill";
+    readonly name: "create-skill";
+}, {
+    readonly dir: "70-plan-mode";
+    readonly name: "plan-mode";
+}, {
+    readonly dir: "80-tool-usage";
+    readonly name: "tool-usage";
+}, {
+    readonly dir: "81-anti-deferred";
+    readonly name: "anti-deferred-execution";
+}, {
+    readonly dir: "82-data-grounding";
+    readonly name: "data-grounding";
+}, {
+    readonly dir: "85-local-exec";
+    readonly name: "local-exec";
+}, {
+    readonly dir: "86-proactive-coding";
+    readonly name: "proactive-coding";
+}];
 /** builtin = 随应用分发; user = 设置页导入; workspace = 项目/工作区 `skills/`. */
 export type SkillOrigin = 'builtin' | 'user' | 'workspace';
 export declare function getUserSkillsDir(): string;

package/dist/local-backend/skill-loader.js

@@ -17,10 +17,38 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { isShellBuiltinSkillEnabled } from '../product-config.js';
 import { getAppRootDir, getUserDataDir } from '../runtime.js';
 import { getSidecarSupervisor, whenSidecarSupervisor } from '../sidecar/handle.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DEFAULT_SKILLS_DIR = path.resolve(__dirname, 'skills');
+/** shell 随包分发的内置技能目录。产品经 product.json `builtinSkills` 按需引入。 */
+export const SHELL_BUILTIN_SKILLS = [
+    { dir: '00-identity', name: 'identity' },
+    { dir: '10-goal', name: 'goal' },
+    { dir: '11-loop', name: 'loop' },
+    { dir: '12-create-skill', name: 'create-skill' },
+    { dir: '70-plan-mode', name: 'plan-mode' },
+    { dir: '80-tool-usage', name: 'tool-usage' },
+    { dir: '81-anti-deferred', name: 'anti-deferred-execution' },
+    { dir: '82-data-grounding', name: 'data-grounding' },
+    { dir: '85-local-exec', name: 'local-exec' },
+    { dir: '86-proactive-coding', name: 'proactive-coding' },
+];
+function productWantsShellBuiltinSkills() {
+    return SHELL_BUILTIN_SKILLS.some((skill) => isShellBuiltinSkillEnabled(skill.dir));
+}
+function disabledShellBuiltinSkillNames() {
+    if (!productWantsShellBuiltinSkills())
+        return [];
+    const names = [];
+    for (const skill of SHELL_BUILTIN_SKILLS) {
+        if (!isShellBuiltinSkillEnabled(skill.dir)) {
+            names.push(skill.dir, skill.name);
+        }
+    }
+    return names;
+}
 export function getUserSkillsDir() {
     const dir = path.join(getUserDataDir(), 'skills');
     if (!fs.existsSync(dir)) {
@@ -82,7 +110,9 @@ export function listSkillRoots(skillsDir) {
     const user = path.resolve(getUserSkillsDir());
     const pack = packSkillsDir && fs.existsSync(packSkillsDir) ? [path.resolve(packSkillsDir)] : [];
     const extras = uniqueExisting(workspaceSkillRootsProvider?.() ?? []).filter((dir) => !samePath(dir, builtin) && !samePath(dir, user) && !pack.some((p) => samePath(dir, p)));
-    return [builtin, ...pack, ...extras, user];
+    return productWantsShellBuiltinSkills()
+        ? [builtin, ...pack, ...extras, user]
+        : [...pack, ...extras, user];
 }
 export function classifySkillOrigin(skillsDir) {
     const resolved = path.resolve(skillsDir);
@@ -109,10 +139,14 @@ export async function loadSkills(options = {}) {
         return [];
     }
     try {
+        const exclude = [
+            ...disabledShellBuiltinSkillNames(),
+            ...(options.excludeSkillNames ? Array.from(options.excludeSkillNames) : []),
+        ];
         return await supervisor.listSkills({
             roots: listSkillRoots(options.skillsDir),
             conditions: options.conditions ? Array.from(options.conditions) : undefined,
-            exclude: options.excludeSkillNames ? Array.from(options.excludeSkillNames) : undefined,
+            exclude: exclude.length > 0 ? exclude : undefined,
             ignoreConditions: options.ignoreConditions,
         });
     }

package/dist/local-backend/task-service.js

@@ -24,12 +24,12 @@
  * 没有 `task_run`，任务不能再派生任务（任务里仍可 delegate_subagent）。
  */
 import path from 'node:path';
-import os from 'node:os';
 import { llmService, getSidecarSupervisor } from '../llm/index.js';
 import { sidecarWireProvider } from '../storage/llm-settings.js';
 import { buildWorldState, streamCoreLoopTurn, } from './coreloop-stream.js';
 import { builtinSubagentParam } from './subagent-profiles.js';
 import { buildExecSandbox } from '../sidecar/exec-sandbox.js';
+import { resolveTurnApproval } from '../host-tools-runtime.js';
 import { readSidecarHistoryEntries, timelineFromHistoryEntries, } from './task-process.js';
 import { appendTimelineDelta, syncTimelineTools, } from './turn-timeline.js';
 /** 任务回合的系统提示词：自包含、汇报结果、不假装执行。 */
@@ -279,13 +279,7 @@ export class TaskService {
                 ? await this.deps.resolveChatWorkspaceRoot(chatId)
                 : null);
         const execSandbox = buildExecSandbox(fenceRoot ? [fenceRoot] : []);
-        const approval = process.env.STEERABLE_APPROVAL === '0'
-            ? undefined
-            : {
-                mode: 'host',
-                timeoutMs: 120_000,
-                storePath: path.join(os.homedir(), '.steerable', 'approvals.json'),
-            };
+        const approval = resolveTurnApproval();
         // depth-1：任务回合没有 task_run（不能再派生任务），其余工具面与
         // 普通回合一致；task_status / task_result 保留（任务可以自查/互查）。
         const tools = this.deps.toolRouter

package/dist/main.js

@@ -11,6 +11,7 @@ import log from 'electron-log';
 import { getBrand } from './brand.js';
 import { getPreloadPath } from './runtime.js';
 import { getProductConfig } from './product-config.js';
+import { assertHostIpcAllowed, getResolvedHostTools } from './host-tools-runtime.js';
 import { createJsonStore } from './json-store.js';
 import { getUserDataDir } from './runtime.js';
 import { saveAttachmentFiles } from './attachments.js';
@@ -428,19 +429,23 @@ function createMenu() {
         {
             label: '视图',
             submenu: [
-                {
-                    label: '打开终端',
-                    accelerator: 'CmdOrCtrl+T',
-                    click: () => {
-                        // 终端内嵌在主窗口的 /terminal 路由——通知 renderer 导航过去。
-                        if (mainWindow && !mainWindow.isDestroyed()) {
-                            mainWindow.show();
-                            mainWindow.focus();
-                            mainWindow.webContents.send('menu:open-terminal');
-                        }
-                    },
-                },
-                { type: 'separator' },
+                ...(getResolvedHostTools().terminal.chrome
+                    ? [
+                        {
+                            label: '打开终端',
+                            accelerator: 'CmdOrCtrl+T',
+                            click: () => {
+                                // 终端内嵌在主窗口的 /terminal 路由——通知 renderer 导航过去。
+                                if (mainWindow && !mainWindow.isDestroyed()) {
+                                    mainWindow.show();
+                                    mainWindow.focus();
+                                    mainWindow.webContents.send('menu:open-terminal');
+                                }
+                            },
+                        },
+                        { type: 'separator' },
+                    ]
+                    : []),
                 { role: 'reload', label: '重新加载' },
                 { role: 'forceReload', label: '强制重新加载' },
                 { type: 'separator' },
@@ -558,6 +563,7 @@ function setupIpcHandlers() {
     });
     // 会话附件：把渲染进程给出的源路径（Electron）或 base64 字节（BS）落盘。
     ipcMain.handle('attachments:save', async (_event, input) => {
+        assertHostIpcAllowed('attachments:save');
         const chatId = typeof input?.chatId === 'string' ? input.chatId : '';
         const files = Array.isArray(input?.files)
             ? input.files.filter((f) => f && (typeof f.path === 'string' || typeof f.data === 'string'))
@@ -612,7 +618,10 @@ function setupIpcHandlers() {
     });
     ipcMain.handle('local:read-file', async (_event, request) => localExecutor.readLocalFile(request));
     ipcMain.handle('local:write-file', async (_event, request) => localExecutor.writeLocalFile(request));
-    ipcMain.handle('local:open-path', async (_event, request) => localExecutor.openLocalTarget(request));
+    ipcMain.handle('local:open-path', async (_event, request) => {
+        assertHostIpcAllowed('local:open-path');
+        return localExecutor.openLocalTarget(request);
+    });
     ipcMain.handle('local:list-scripts', async () => localScriptRegistry.list());
     ipcMain.handle('local:add-script', async (_event, input) => localScriptRegistry.create(input));
     ipcMain.handle('local:update-script', async (_event, payload) => localScriptRegistry.update(payload.id, payload.updates));
@@ -748,11 +757,16 @@ function setupIpcHandlers() {
     // ---------------------------------------------------------------------------
     // Terminal IPC: visible PTY embedded in the main window's /terminal route
     // ---------------------------------------------------------------------------
-    ipcMain.handle('terminal:list', async () => terminalManager.list());
+    ipcMain.handle('terminal:list', async () => {
+        assertHostIpcAllowed('terminal:list');
+        return terminalManager.list();
+    });
     ipcMain.handle('terminal:spawn', async (_event, options = {}) => {
+        assertHostIpcAllowed('terminal:spawn');
         return terminalManager.spawn(options);
     });
     ipcMain.handle('terminal:ensure', async (event, options = {}) => {
+        assertHostIpcAllowed('terminal:ensure');
         const session = terminalManager.ensurePrimary(options);
         // Replay any output buffered before the renderer was attached, so the
         // window doesn't look empty if the agent kicked off a command before the
@@ -770,13 +784,19 @@ function setupIpcHandlers() {
         return session;
     });
     ipcMain.handle('terminal:write', async (_event, payload) => {
+        assertHostIpcAllowed('terminal:write');
         return terminalManager.write(payload.id, payload.data);
     });
     ipcMain.handle('terminal:resize', async (_event, payload) => {
+        assertHostIpcAllowed('terminal:resize');
         return terminalManager.resize(payload.id, payload.cols, payload.rows);
     });
-    ipcMain.handle('terminal:kill', async (_event, id) => terminalManager.kill(id));
+    ipcMain.handle('terminal:kill', async (_event, id) => {
+        assertHostIpcAllowed('terminal:kill');
+        return terminalManager.kill(id);
+    });
     ipcMain.handle('terminal:exec', async (_event, payload) => {
+        assertHostIpcAllowed('terminal:exec');
         let id = payload.id;
         if (!id) {
             const session = terminalManager.ensurePrimary();

package/dist/mcp-server-registry.d.ts

@@ -70,6 +70,8 @@ export declare class McpServerRegistry {
     constructor(store: McpServerKvStore);
     list(): McpServerEntry[];
     get(idOrName: string): McpServerEntry | null;
+    /** 产品预置 MCP：缺省不引入；已有同名服务不覆盖。 */
+    seedProductServers(specs: CreateMcpServerInput[] | undefined): void;
     create(input: CreateMcpServerInput): McpServerEntry;
     update(id: string, updates: Partial<CreateMcpServerInput>): McpServerEntry;
     delete(id: string): boolean;

package/dist/mcp-server-registry.js

@@ -33,6 +33,14 @@ export class McpServerRegistry {
         const needle = idOrName.trim().toLowerCase();
         return (this.list().find((s) => s.id === idOrName || s.name.toLowerCase() === needle) ?? null);
     }
+    /** 产品预置 MCP：缺省不引入；已有同名服务不覆盖。 */
+    seedProductServers(specs) {
+        for (const spec of specs ?? []) {
+            if (this.get(spec.name))
+                continue;
+            this.create(spec);
+        }
+    }
     create(input) {
         const name = input.name.trim();
         const command = input.command.trim();

package/dist/product-config.d.ts

@@ -33,7 +33,68 @@ export interface ProductConfig {
      * 数据；中性 shell 缺省 'agent-shell.db'。
      */
     dbFileName?: string;
+    /**
+     * 宿主工具族：产品声明引入哪些工具。缺省全开。
+     * 形状由 host-tools 解析；本模块只存声明、不依赖解析器。
+     */
+    hostTools?: Record<string, boolean | {
+        capability?: boolean;
+        chrome?: boolean;
+    }>;
+    /**
+     * 命令安全询问：host = 弹宿主审批；off = 本轮不挂审批。缺省 host。
+     * STEERABLE_APPROVAL=0 仍是调试逃生口。
+     */
+    approval?: 'host' | 'off';
+    /**
+     * 对话模式。缺省 `['agent','plan']`。只留一种时渲染层不显示切换。
+     */
+    chatModes?: Array<'agent' | 'plan'>;
+    /**
+     * 设置入口。缺省全开。`false` 藏对应侧栏页或综合设置分段。
+     */
+    settings?: Record<string, boolean>;
+    /**
+     * 产品钉死的大模型。`settings.llm === false` 时必填，运行时用这份，
+     * 不再读设置页。密钥用 `apiKeyEnv` 指向环境变量，不要把 key 写进仓库。
+     */
+    llm?: {
+        provider?: string;
+        vendorId?: string;
+        model?: string;
+        baseUrl?: string;
+        apiKey?: string;
+        apiKeyEnv?: string;
+        temperature?: number;
+        maxTotalTokens?: number;
+    };
+    /**
+     * shell 内置智能体。按需引入，缺省全关。
+     * `true` 才种子；未声明或 `false` 不写入，已有行归档。
+     */
+    builtinAgents?: Partial<Record<'local-assistant' | 'all-round-assistant', boolean>>;
+    /**
+     * shell 内置技能。按需引入，缺省全关。
+     * `true` 引入全部；对象里 `true` 的目录才引入。设置页入口不受影响。
+     */
+    builtinSkills?: boolean | Partial<Record<string, boolean>>;
+    /**
+     * 产品预置 MCP 服务。按需引入，缺省空。已有同名服务不覆盖。
+     * 设置页入口不受影响。
+     */
+    builtinMcp?: Array<{
+        name: string;
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+        cwd?: string;
+        enabled?: boolean;
+    }>;
 }
+/** shell 内置智能体：只有产品显式 `true` 才开。 */
+export declare function isShellBuiltinAgentEnabled(id: 'local-assistant' | 'all-round-assistant', config?: ProductConfig): boolean;
+/** shell 内置技能：`true` 全开；否则只有对象里显式 `true` 的目录开。 */
+export declare function isShellBuiltinSkillEnabled(id: string, config?: ProductConfig): boolean;
 /**
  * 注入产品配置（产品组装根在第一个 import 时调用）。重复注入抛错
  * （组装期笔误，fail fast——与 setProductBrand 同语义）。
@@ -41,3 +102,5 @@ export interface ProductConfig {
 export declare function setProductConfig(config: ProductConfig): void;
 /** 读取已注入的产品配置；未注入返回空对象（中性框架行为）。 */
 export declare function getProductConfig(): ProductConfig;
+/** 测试用：清掉已注入的产品配置，避免用例互相污染。 */
+export declare function resetProductConfigForTests(): void;

package/dist/product-config.js

@@ -9,6 +9,19 @@
  *
  * 本模块只允许依赖 node 内置模块（与 brand.ts 同约束）。
  */
+/** shell 内置智能体：只有产品显式 `true` 才开。 */
+export function isShellBuiltinAgentEnabled(id, config = getProductConfig()) {
+    return config.builtinAgents?.[id] === true;
+}
+/** shell 内置技能：`true` 全开；否则只有对象里显式 `true` 的目录开。 */
+export function isShellBuiltinSkillEnabled(id, config = getProductConfig()) {
+    const value = config.builtinSkills;
+    if (value === true)
+        return true;
+    if (!value || typeof value !== 'object')
+        return false;
+    return value[id] === true;
+}
 let productConfig = null;
 /**
  * 注入产品配置（产品组装根在第一个 import 时调用）。重复注入抛错
@@ -24,3 +37,7 @@ export function setProductConfig(config) {
 export function getProductConfig() {
     return productConfig ?? {};
 }
+/** 测试用：清掉已注入的产品配置，避免用例互相污染。 */
+export function resetProductConfigForTests() {
+    productConfig = null;
+}

package/dist/server/http-server.js

@@ -36,6 +36,8 @@ import { getBrand } from '../brand.js';
 import { saveAttachmentFiles } from '../attachments.js';
 import { selectNativeDirectory } from '../native-folder-dialog.js';
 import { getAuthProvider } from '../auth/index.js';
+import { isHostRouteAllowed } from '../host-tools.js';
+import { getResolvedHostTools } from '../host-tools-runtime.js';
 /** 与 router.handleStream 内部的路由正则保持一致——只有这些路径是流式。 */
 const STREAM_PATH_PATTERNS = [
     /^\/api\/v2\/chats\/[^/]+\/(send|run|agent)$/,
@@ -153,6 +155,10 @@ export function createBsServer(deps) {
     async function handleHost(req, res, pathname) {
         const body = asRecord(await readJsonBody(req));
         const method = req.method ?? 'GET';
+        if (!isHostRouteAllowed(pathname, getResolvedHostTools())) {
+            sendJson(res, 403, { detail: 'Host route is disabled for this product' });
+            return;
+        }
         if (method === 'GET' && pathname === '/host/info') {
             const brand = getBrand();
             sendJson(res, 200, {
@@ -330,6 +336,7 @@ export function createBsServer(deps) {
             sendJson(res, 200, await saveAttachmentFiles(chatId, files));
             return;
         }
+        log.warn(`[bs] ${method} ${pathname} -> 404`);
         sendJson(res, 404, { detail: `Unknown host endpoint: ${method} ${pathname}` });
     }
     /** 静态托管 + index.html 注入 BS 标记（前端据此切换 http-bridge）。 */

package/dist/storage/index.js

@@ -1,5 +1,6 @@
 import { randomUUID } from 'crypto';
 import { ALL_ROUND_ASSISTANT_AGENT_ID, LOCAL_ASSISTANT_AGENT_ID, getBrand, } from '../brand.js';
+import { isShellBuiltinAgentEnabled } from '../product-config.js';
 import { DEFAULT_LLM_SETTINGS, llmSettingsCarryExpiredBakedKey, llmSettingsMatchOllamaDefaults, mergeLlmSettings, } from './llm-settings.js';
 import { MESSAGE_ORDER_DESC } from './message-order.js';
 import { mergeTelemetrySettings, } from './telemetry-settings.js';
@@ -473,92 +474,108 @@ export class SqliteScopedStore {
         @sortOrder, @createdAt, @updatedAt
       )
     `);
-        if (!hasBuiltin) {
-            insertAgent.run({
-                tenantId: this.scope.tenantId,
-                userId: this.scope.userId,
-                id: LOCAL_ASSISTANT_AGENT_ID,
-                slug: LOCAL_ASSISTANT_AGENT_ID,
-                name: '电脑操作员',
-                icon: 'Cpu',
-                color: '#4f46e5',
-                description: '默认本地助手，可调用 shell、文件与 MCP 工具。',
-                rolePrompt: '你是 **电脑操作员**，本地离线助手，回答时清晰、可执行。',
-                forbiddenPrompt: null,
-                skillIds: JSON.stringify([]),
-                toolPolicy: JSON.stringify({ mode: 'all', tools: [] }),
-                allowExternalSkills: 1,
-                loadAllSkills: 0,
-                isBuiltin: 1,
-                isArchived: 0,
-                // 激活包有主打种子（sortOrder 0）时让位到 1。
-                sortOrder: hasHeroSeed ? 1 : 0,
-                createdAt: now,
-                updatedAt: now,
-            });
-        }
-        else {
-            this.db.prepare(`UPDATE chat_agents SET name = ?
-                       WHERE tenant_id = ? AND user_id = ? AND id = ?`)
-                .run('电脑操作员', this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
-            const local = this.db
-                .prepare(`SELECT role_prompt FROM chat_agents
-                  WHERE tenant_id = ? AND user_id = ? AND id = ?`)
-                .get(this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
-            if (local?.role_prompt === '你是本地离线助手，回答时清晰、可执行。') {
-                this.db
-                    .prepare(`UPDATE chat_agents SET role_prompt = ?
+        if (isShellBuiltinAgentEnabled(LOCAL_ASSISTANT_AGENT_ID)) {
+            if (!hasBuiltin) {
+                insertAgent.run({
+                    tenantId: this.scope.tenantId,
+                    userId: this.scope.userId,
+                    id: LOCAL_ASSISTANT_AGENT_ID,
+                    slug: LOCAL_ASSISTANT_AGENT_ID,
+                    name: '电脑操作员',
+                    icon: 'Cpu',
+                    color: '#4f46e5',
+                    description: '默认本地助手，可调用 shell、文件与 MCP 工具。',
+                    rolePrompt: '你是 **电脑操作员**，本地离线助手，回答时清晰、可执行。',
+                    forbiddenPrompt: null,
+                    skillIds: JSON.stringify([]),
+                    toolPolicy: JSON.stringify({ mode: 'all', tools: [] }),
+                    allowExternalSkills: 1,
+                    loadAllSkills: 0,
+                    isBuiltin: 1,
+                    isArchived: 0,
+                    // 激活包有主打种子（sortOrder 0）时让位到 1。
+                    sortOrder: hasHeroSeed ? 1 : 0,
+                    createdAt: now,
+                    updatedAt: now,
+                });
+            }
+            else {
+                this.db.prepare(`UPDATE chat_agents SET name = ?
+                         WHERE tenant_id = ? AND user_id = ? AND id = ?`)
+                    .run('电脑操作员', this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
+                const local = this.db
+                    .prepare(`SELECT role_prompt FROM chat_agents
                     WHERE tenant_id = ? AND user_id = ? AND id = ?`)
-                    .run('你是 **电脑操作员**，本地离线助手，回答时清晰、可执行。', this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
+                    .get(this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
+                if (local?.role_prompt === '你是本地离线助手，回答时清晰、可执行。') {
+                    this.db
+                        .prepare(`UPDATE chat_agents SET role_prompt = ?
+                      WHERE tenant_id = ? AND user_id = ? AND id = ?`)
+                        .run('你是 **电脑操作员**，本地离线助手，回答时清晰、可执行。', this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
+                }
             }
         }
+        else if (hasBuiltin) {
+            this.db
+                .prepare(`UPDATE chat_agents SET is_archived = 1, updated_at = ?
+                  WHERE tenant_id = ? AND user_id = ? AND id = ? AND is_archived = 0`)
+                .run(now, this.scope.tenantId, this.scope.userId, LOCAL_ASSISTANT_AGENT_ID);
+        }
         const hasAllRound = this.db
             .prepare(`SELECT id FROM chat_agents WHERE tenant_id = ? AND user_id = ? AND id = ?`)
             .get(this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
-        if (!hasAllRound) {
-            insertAgent.run({
-                tenantId: this.scope.tenantId,
-                userId: this.scope.userId,
-                id: ALL_ROUND_ASSISTANT_AGENT_ID,
-                slug: ALL_ROUND_ASSISTANT_AGENT_ID,
-                name: '智能助手',
-                icon: '🔮',
-                color: '#a855f7',
-                description: '全能智能体，自动加载全部已安装本地技能和工具，无需限定条件。',
-                rolePrompt: [
-                    '你是 **智能助手**，一个具备高权限且集成了全部本地技能（Skills）的行动体。',
-                    '你具备完整的本地命令执行（local_exec_shell）、文件读写能力，以及当前产品安装的全部场景工具。',
-                    '你的系统提示词中已经无条件加载了所有已安装的本地技能与工具。',
-                    '请根据用户的需求，直接、高效地调用最合适的本地工具或执行脚本来解决任务。'
-                ].join('\n'),
-                forbiddenPrompt: null,
-                skillIds: JSON.stringify([]),
-                toolPolicy: JSON.stringify({ mode: 'all', tools: [] }),
-                allowExternalSkills: 1,
-                // 「智能助手」的定位就是无条件加载全部技能（此前是 router 硬编码）。
-                loadAllSkills: 1,
-                isBuiltin: 1,
-                isArchived: 0,
-                sortOrder: 2,
-                createdAt: now,
-                updatedAt: now,
-            });
-        }
-        else {
-            const agent = this.db.prepare(`SELECT role_prompt FROM chat_agents
-         WHERE tenant_id = ? AND user_id = ? AND id = ?`).get(this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
-            if (agent) {
-                const updatedPrompt = agent.role_prompt.replace(/全能专家助手/g, '智能助手');
-                this.db.prepare(`UPDATE chat_agents SET name = ?, role_prompt = ?
-                         WHERE tenant_id = ? AND user_id = ? AND id = ?`)
-                    .run('智能助手', updatedPrompt, this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
+        if (isShellBuiltinAgentEnabled(ALL_ROUND_ASSISTANT_AGENT_ID)) {
+            if (!hasAllRound) {
+                insertAgent.run({
+                    tenantId: this.scope.tenantId,
+                    userId: this.scope.userId,
+                    id: ALL_ROUND_ASSISTANT_AGENT_ID,
+                    slug: ALL_ROUND_ASSISTANT_AGENT_ID,
+                    name: '智能助手',
+                    icon: '🔮',
+                    color: '#a855f7',
+                    description: '全能智能体，自动加载全部已安装本地技能和工具，无需限定条件。',
+                    rolePrompt: [
+                        '你是 **智能助手**，一个具备高权限且集成了全部本地技能（Skills）的行动体。',
+                        '你具备完整的本地命令执行（local_exec_shell）、文件读写能力，以及当前产品安装的全部场景工具。',
+                        '你的系统提示词中已经无条件加载了所有已安装的本地技能与工具。',
+                        '请根据用户的需求，直接、高效地调用最合适的本地工具或执行脚本来解决任务。'
+                    ].join('\n'),
+                    forbiddenPrompt: null,
+                    skillIds: JSON.stringify([]),
+                    toolPolicy: JSON.stringify({ mode: 'all', tools: [] }),
+                    allowExternalSkills: 1,
+                    // 「智能助手」的定位就是无条件加载全部技能（此前是 router 硬编码）。
+                    loadAllSkills: 1,
+                    isBuiltin: 1,
+                    isArchived: 0,
+                    sortOrder: 2,
+                    createdAt: now,
+                    updatedAt: now,
+                });
             }
             else {
-                this.db.prepare(`UPDATE chat_agents SET name = ?
-                         WHERE tenant_id = ? AND user_id = ? AND id = ?`)
-                    .run('智能助手', this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
+                const agent = this.db.prepare(`SELECT role_prompt FROM chat_agents
+           WHERE tenant_id = ? AND user_id = ? AND id = ?`).get(this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
+                if (agent) {
+                    const updatedPrompt = agent.role_prompt.replace(/全能专家助手/g, '智能助手');
+                    this.db.prepare(`UPDATE chat_agents SET name = ?, role_prompt = ?
+                           WHERE tenant_id = ? AND user_id = ? AND id = ?`)
+                        .run('智能助手', updatedPrompt, this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
+                }
+                else {
+                    this.db.prepare(`UPDATE chat_agents SET name = ?
+                           WHERE tenant_id = ? AND user_id = ? AND id = ?`)
+                        .run('智能助手', this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
+                }
             }
         }
+        else if (hasAllRound) {
+            this.db
+                .prepare(`UPDATE chat_agents SET is_archived = 1, updated_at = ?
+                  WHERE tenant_id = ? AND user_id = ? AND id = ? AND is_archived = 0`)
+                .run(now, this.scope.tenantId, this.scope.userId, ALL_ROUND_ASSISTANT_AGENT_ID);
+        }
         // ─── 场景包智能体种子（0.3d） ───
         // 激活包：不存在则种子；命中历史代文案（用户从未定制）则静默升级；
         // 被归档但未定制的行重新露出。未激活包：未定制的内置行归档（用户改

package/dist/storage/llm-settings.d.ts

@@ -81,6 +81,21 @@ export declare function llmSettingsCarryExpiredBakedKey(s: LlmSettings): boolean
 export declare const OLLAMA_DEFAULTS: LlmSettings;
 export declare function sanitizeLlmProvider(raw: unknown): LlmProvider;
 export declare function sanitizeVendorId(raw: unknown): string | undefined;
+export interface ProductLlmConfig {
+    provider?: string;
+    vendorId?: string;
+    model?: string;
+    baseUrl?: string;
+    apiKey?: string;
+    apiKeyEnv?: string;
+    temperature?: number;
+    maxTotalTokens?: number;
+}
+/**
+ * `settings.llm` 关掉后，产品必须声明 `llm.model`。密钥优先 product.apiKey，
+ * 其次 `apiKeyEnv` 指向的环境变量，再回落已存 key（升级前用户填过的）。
+ */
+export declare function resolveLockedLlmSettings(value: unknown, env?: Record<string, string | undefined>, persisted?: LlmSettings | null): LlmSettings;
 /** Sidecar `agent.chat.stream` 的 provider 字段。 */
 export declare function sidecarWireProvider(provider: LlmProvider): string;
 export declare function usesOpenAiCompatExtras(provider: LlmProvider): boolean;

package/dist/storage/llm-settings.js

@@ -67,6 +67,34 @@ export function sanitizeVendorId(raw) {
     const id = raw.trim();
     return id || undefined;
 }
+/**
+ * `settings.llm` 关掉后，产品必须声明 `llm.model`。密钥优先 product.apiKey，
+ * 其次 `apiKeyEnv` 指向的环境变量，再回落已存 key（升级前用户填过的）。
+ */
+export function resolveLockedLlmSettings(value, env = {}, persisted = null) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('[product-llm] settings.llm is off; product.json must declare llm');
+    }
+    const raw = value;
+    const model = typeof raw.model === 'string' ? raw.model.trim() : '';
+    if (!model) {
+        throw new Error('[product-llm] llm.model is required when settings.llm is off');
+    }
+    const fromProduct = typeof raw.apiKey === 'string' && raw.apiKey.trim() ? raw.apiKey.trim() : undefined;
+    const envName = typeof raw.apiKeyEnv === 'string' ? raw.apiKeyEnv.trim() : '';
+    const fromEnv = envName ? env[envName]?.trim() || undefined : undefined;
+    const fromPersisted = persisted?.apiKey?.trim() || undefined;
+    return mergeLlmSettings({
+        provider: sanitizeLlmProvider(raw.provider ?? persisted?.provider ?? 'openai-compat'),
+        vendorId: sanitizeVendorId(raw.vendorId),
+        model,
+        baseUrl: typeof raw.baseUrl === 'string' ? raw.baseUrl : persisted?.baseUrl,
+        apiKey: fromProduct || fromEnv || fromPersisted,
+        temperature: typeof raw.temperature === 'number' ? raw.temperature : undefined,
+        maxTotalTokens: typeof raw.maxTotalTokens === 'number' ? raw.maxTotalTokens : persisted?.maxTotalTokens,
+        execTimeoutSeconds: persisted?.execTimeoutSeconds,
+    });
+}
 /** Sidecar `agent.chat.stream` 的 provider 字段。 */
 export function sidecarWireProvider(provider) {
     switch (provider) {

package/dist/tool-router.js

@@ -5,6 +5,8 @@ import { mcpExecutor } from './mcp-executor.js';
 import { rankTools, resolveMaxResults, TOOL_SEARCH_DEFAULT_MAX_RESULTS, } from './tool-search-rank.js';
 import { maybeAutoInstallWrittenSkill } from './local-backend/skill-install.js';
 import { filterToolsByPolicy, isToolAllowed, } from './local-backend/agent-capability.js';
+import { isHostToolCapabilityEnabled } from './host-tools.js';
+import { getResolvedHostTools } from './host-tools-runtime.js';
 /** 已注册 MCP 服务的动态工具名前缀：`mcp__<serverKey>__<toolName>`。 */
 export const MCP_DYNAMIC_TOOL_PREFIX = 'mcp__';
 /**
@@ -608,7 +610,8 @@ export class ToolRouter {
      */
     listModelSchemas(policy) {
         const effective = policy ?? { mode: 'all', tools: [] };
-        const all = filterToolsByPolicy(this.listSchemas(), effective);
+        const tools = getResolvedHostTools();
+        const all = filterToolsByPolicy(this.listSchemas(), effective).filter((s) => isHostToolCapabilityEnabled(s.name, tools));
         const hasDeferred = all.some(s => s.exposure === 'deferred');
         return all.filter(s => {
             if ((s.exposure ?? 'direct') !== 'direct')
@@ -630,6 +633,9 @@ export class ToolRouter {
         if (toolPolicy && !isToolAllowed(toolPolicy, call.name)) {
             throw new Error(`工具 ${call.name} 被当前智能体的工具策略拒绝（智能体管理 → 工具权限）`);
         }
+        if (!isHostToolCapabilityEnabled(call.name, getResolvedHostTools())) {
+            throw new Error(`工具 ${call.name} 未在本产品引入`);
+        }
         if (call.name.startsWith(MCP_DYNAMIC_TOOL_PREFIX)) {
             return await this.executeRegisteredMcpTool(call.name, args);
         }
@@ -883,7 +889,8 @@ export class ToolRouter {
      */
     executeToolSearch(args, policy) {
         const cap = resolveMaxResults(args.max_results);
-        const deferred = filterToolsByPolicy(this.listSchemas().filter(s => s.exposure === 'deferred'), policy ?? { mode: 'all', tools: [] });
+        const tools = getResolvedHostTools();
+        const deferred = filterToolsByPolicy(this.listSchemas().filter(s => s.exposure === 'deferred'), policy ?? { mode: 'all', tools: [] }).filter((s) => isHostToolCapabilityEnabled(s.name, tools));
         const ranked = rankTools(deferred, String(args.query ?? ''));
         const matches = ranked.slice(0, cap).map(schema => ({
             name: schema.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell",
-  "version": "0.6.32",
+  "version": "0.6.34",
   "description": "Steerable framework — product-neutral desktop/headless agent host (Tier 5). Electron main + preload + headless HTTP server (BS) sharing one storage/sidecar/tooling core; scenario packs extend it through the @steerable/pack-sdk contract and are composed at build time by the consuming product.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
@@ -15,6 +15,10 @@
   "type": "module",
   "main": "dist/runtime.js",
   "exports": {
+    "./host-tools": {
+      "types": "./dist/host-tools.d.ts",
+      "default": "./dist/host-tools.js"
+    },
     "./auth": {
       "types": "./dist/auth/index.d.ts",
       "default": "./dist/auth/index.js"
@@ -49,9 +53,9 @@
     "electron-store": "^8.1.0",
     "he": "^1.2.0",
     "node-pty": "^1.1.0",
-    "@steerable/agent-protocol": "0.6.32",
-    "@steerable/pack-sdk": "0.6.32",
-    "@steerable/agent-harness": "0.6.32"
+    "@steerable/agent-harness": "0.6.34",
+    "@steerable/pack-sdk": "0.6.34",
+    "@steerable/agent-protocol": "0.6.34"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",