SessionConfig

通过 SessionConfig 类可以进行各种设置。按 Copilot::run(prompt: '...', config: $config) 或 Copilot::start(function (CopilotSession $session) { ... }, config: $config) 的方式使用。当你只是想指定模型这种无需用到 SessionConfig 类的情况时，也可以用数组指定。Copilot::run(prompt: '...', config: ['model' => 'auto']) 官方 SDK 1.0.26 已移除 remoteSession 选项。SessionConfig 和 ResumeSessionConfig 不再接受该选项。

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\SystemMessageConfig;
use Revolution\Copilot\Types\InfiniteSessionConfig;
use Revolution\Copilot\Types\UserInputRequest;
use Revolution\Copilot\Types\Rpc\ModelCapabilitiesOverride;
use Revolution\Copilot\Types\Rpc\ModelCapabilitiesOverrideSupports;
use Revolution\Copilot\Types\Rpc\ModelCapabilitiesOverrideLimits;
use Revolution\Copilot\Enums\ReasoningEffort;
use Revolution\Copilot\Enums\UIAutoModeSwitchResponse;
use Revolution\Copilot\Types\AutoModeSwitchRequest;
use Revolution\Copilot\Types\ExitPlanModeRequest;
use Revolution\Copilot\Types\ExitPlanModeResult;
use Revolution\Copilot\Types\McpAuthRequest;
use Revolution\Copilot\Types\McpAuthToken;
use Revolution\Copilot\Enums\MemoryMode;
use Revolution\Copilot\Enums\WorkingDirectoryTrust;
use Revolution\Copilot\Types\MemoryConfiguration;

$config = new SessionConfig(
    // 指定要使用的模型
    model: 'auto',

    // 在创建新会话时指定固定的 session ID
    sessionId: 'session-123',

    // 新建本地会话的名称（与 cloud 同时使用时会被运行时拒绝）。
    // 命名会话会立即持久化，因此在执行任何轮次之前就可以列出并恢复。
    // 不能为空，不能包含首尾空白、控制字符或双引号。
    // 最多 100 个 UTF-16 码元。
    name: 'issue-triage',

    clientName: 'my-app',

    // 标记为由人类驱动的会话，以启用用户消息分析遥测（SDK 默认: false）。
    // 自动化消息不在统计范围内。对云端会话以及恢复正在运行的会话时会被忽略。
    interactiveUser: true,

    // 推理级别。仅在支持的模型上可设置。
    reasoningEffort: ReasoningEffort::HIGH,

    // 覆盖模型的 capabilities。会与运行时的默认值 deep-merge。
    // modelCapabilities: new ModelCapabilitiesOverride(
    //     supports: new ModelCapabilitiesOverrideSupports(vision: true, reasoningEffort: true),
    //     limits: new ModelCapabilitiesOverrideLimits(max_prompt_tokens: 200000),
    // ),
    // 也可以用数组指定
    // modelCapabilities: ['supports' => ['vision' => true]],

    // 覆盖 config 目录
    configDirectory: '',

    // 启用 MCP 配置和技能目录的自动发现
    // 会从工作目录自动发现 .mcp.json 或 .vscode/mcp.json，
    // 并与显式指定的 mcpServers 或 skillDirectories 合并（名称冲突时显式指定优先）
    enableConfigDiscovery: true,

    // 自定义工具
    tools: [...],

    // 系统消息
    systemMessage: new SystemMessageConfig(
        content: 'You are a helpful assistant for Laravel developers.',
    ),

    // 系统消息：replace 模式（完全替换 system prompt）
    // systemMessage: new SystemMessageConfig(
    //     mode: 'replace',
    //     content: '自定义的完整 system prompt',
    // ),

    // 系统消息：customize 模式（按段落覆盖）
    // systemMessage: new SystemMessageConfig(
    //     mode: 'customize',
    //     sections: [
    //         'tone' => new SectionOverride(action: SectionOverrideAction::REPLACE, content: 'Always respond in Japanese.'),
    //         'safety' => new SectionOverride(action: SectionOverrideAction::REMOVE),
    //         'custom_instructions' => new SectionOverride(action: SectionOverrideAction::APPEND, content: 'Additional instructions here.'),
    //     ],
    //     content: '与 append 模式类似的追加内容（可选）',
    // ),

    // 自定义提供商
    provider: new ProviderConfig(),

    // 每个会话独立的 GitHub token（多租户支持）
    // 可以在客户端级别 github_token 之外，按会话指定 token
    gitHubToken: $user->github_token,

    // Memory 配置（实验性）
    // mode 默认为 system-prompt。使用 user-prompt 可将 memory 注入到生成的用户消息中。
    memory: new MemoryConfiguration(
        enabled: true,
        mode: MemoryMode::UserPrompt,
    ),
    // 也可以用数组指定
    // memory: ['enabled' => true, 'mode' => 'user-prompt'],

    // 云端会话（不在本地而是在云端创建会话）
    // 可以选择性地关联仓库信息
    cloud: new \Revolution\Copilot\Types\CloudSessionOptions(
        repository: new \Revolution\Copilot\Types\CloudSessionRepository(
            owner: 'myorg',
            name: 'myrepo',
            branch: 'main',
        ),
    ),

    onPermissionRequest: function (array $request) {
        // 处理权限请求
    },

    onUserInputRequest: function (UserInputRequest $request) {
        // 处理用户输入请求。ask_user
    },

    // Elicitation 请求处理器
    // 设置后可以接收来自代理的基于表单的 UI 对话请求
    onElicitationRequest: function (ElicitationContext $context) {
        // 处理 elicitation 请求
        return ['action' => 'accept', 'content' => ['field' => 'value']];
    },

    // 当 MCP 服务器请求 OAuth 认证时，由宿主提供 token
    onMcpAuthRequest: function (McpAuthRequest $request, array $context): ?McpAuthToken {
        $accessToken = $credentialProvider->tokenFor($request->serverName);

        return $accessToken === null
            ? null
            : new McpAuthToken(accessToken: $accessToken, tokenType: 'Bearer');
    },

    // Plan 模式退出请求处理器
    // 设置后 SDK 会通过反向 RPC 进行响应。省略时请求会被自动批准。
    onExitPlanModeRequest: function (ExitPlanModeRequest $request) {
        // 检查 plan 内容并批准 / 拒绝
        return new ExitPlanModeResult(approved: true, selectedAction: $request->recommendedAction);
    },

    // 自动模式切换请求处理器
    // 在达到速率限制时，可以选择是否允许切换到 auto 模式。省略时默认为 "no"。
    onAutoModeSwitchRequest: function (AutoModeSwitchRequest $request) {
        // 返回 "yes"、"yes_always"、"no" 之一，或 UIAutoModeSwitchResponse 的 case
        return UIAutoModeSwitchResponse::Yes;
    },

    // 会话钩子
    hooks: [],

    // 工作目录
    workingDirectory: '',

    // 工作目录的信任范围。User 会持久化到之后的会话。
    trustWorkingDirectory: WorkingDirectoryTrust::Session,

    // 启用流式输出
    streaming: true,

    // 是否将子代理的流式事件包含到主流中（默认: true）
    includeSubAgentStreamingEvents: true,

    // 可用的内置工具
    availableTools: ['read_file', 'write_file'],

    // 或者要排除的工具
    excludedTools: ['shell'],

    // MCP 服务器配置
    mcpServers: [
        'github' => [
            'type' => 'http',
            'url' => 'https://api.githubcopilot.com/mcp/',
        ],
    ],

    // 自定义代理
    customAgents: [
        [
            'name' => 'reviewer',
            'displayName' => 'Code Reviewer',
            'description' => 'Reviews code for best practices',
            'prompt' => 'You are an expert code reviewer.',
        ],
    ],

    // 默认代理配置。当没有选择自定义代理时使用的内置代理配置。
    // excludedTools: 从默认代理中排除的工具列表。
    // 对自定义子代理仍然可用。
    defaultAgent: ['excludedTools' => ['tool_name']],

    // 指定会话启动时激活的代理。需要与 customAgents 的 name 一致。
    agent: 'reviewer',

    // 技能、代理、钩子和指令文件的显式发现根目录
    skillDirectories: [],
    agentDirectories: [],
    hookDirectories: [],
    instructionDirectories: [],

    // 已禁用的技能
    disabledSkills: [],

    // 无限会话配置。默认启用。
    infiniteSessions: new InfiniteSessionConfig(
        enabled: true,
        backgroundCompactionThreshold: 0.80, // 上下文使用率达到 80% 时开始压缩
        bufferExhaustionThreshold: 0.95,     // 直到压缩完成前在 95% 时阻塞
    ),

    // 禁用无限会话
    // infiniteSessions: new InfiniteSessionConfig(enabled: false),

    // 在会话创建 RPC 之前注册事件处理器。
    // 用于避免遗漏 session.start 等早期事件。
    // 与之后调用 $session->on($handler) 等价，但在生命周期更早阶段注册。
    onEvent: function (SessionEvent $event) {
        // 接收所有会话事件
    },
);

$response = Copilot::run('...', config: $config);

发现根目录

skillDirectories、agentDirectories、hookDirectories 和 instructionDirectories 是用于技能、自定义代理、文件钩子和自定义指令的仅发现用根目录。它们不会授予代理通用的文件访问权限。如需添加常规的文件访问位置，请使用 additionalDirectories。无论是否启用 enableConfigDiscovery，都可以设置发现根目录。 SDK 会在设置时基于当时有效的 workingDirectory 对相对路径进行一次解析。之后即使工作目录发生变化，这些根目录也不会随之移动。省略该键或传入 null 时，默认的发现来源保持不变。传入 [] 只会清除 SDK 显式设置的根目录。针对技能、代理、钩子和指令的按来源禁用设置以及 Managed Settings 仍然适用。

工作目录信任

在创建会话时设置 trustWorkingDirectory，即可将工作目录标记为受信任。

WorkingDirectoryTrust::Session 仅在当前会话中信任该目录。
WorkingDirectoryTrust::User 会持久化信任状态，之后的会话也会信任该目录。

省略时，SDK 不会更改信任状态。 trustWorkingDirectory 仅在创建会话时可用，ResumeSessionConfig 不接受该选项。

use Revolution\Copilot\Enums\WorkingDirectoryTrust;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    workingDirectory: base_path(),
    trustWorkingDirectory: WorkingDirectoryTrust::Session,
);

Memory 注入模式

Memory 配置目前处于实验阶段。

MemoryConfiguration 用于控制跨会话的 memory。其中的 mode 选项决定运行时将 memory 注入到哪里：

MemoryMode::SystemPrompt（system-prompt）将 memory 注入到 system prompt 中。省略 mode 时为默认值。
MemoryMode::UserPrompt（user-prompt）将 memory 注入到生成的用户消息中。

use Revolution\Copilot\Enums\MemoryMode;
use Revolution\Copilot\Types\MemoryConfiguration;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    memory: new MemoryConfiguration(enabled: true, mode: MemoryMode::UserPrompt),
);

// 也可以用数组指定
$config = new SessionConfig(memory: ['enabled' => true, 'mode' => 'user-prompt']);

排除 Managed Settings

使用 excludedManagedSettings 列出运行时应从其获取的 Managed Settings 中移除的设置路径。它不会影响通过 managedSettings 直接注入的设置。如需在恢复后继续保持排除，请在 ResumeSessionConfig 中再次传入 excludedManagedSettings。

$config = new SessionConfig(
    excludedManagedSettings: ['permissions'],
);

会话恢复时使用 ResumeSessionConfig 类。它与 SessionConfig 几乎相同，只有一点点差异。ResumeSessionConfig 只指定要变更的配置项。其他会沿用新建会话时的配置。 SDK 会在创建和恢复的 RPC 负载中发送相同的会话选项。其中包括 BYOK 提供商和模型、memory、enableMcpApps、interactiveUser、autopilot、sandboxConfig、excludedManagedSettings、发现根目录，以及 onMcpAuthRequest、onExitPlanModeRequest、onAutoModeSwitchRequest 等处理器。恢复时，请通过 ResumeSessionConfig 或使用相同键的数组传入这些选项。闭包和提供商对象不会被持久化，因此每次恢复时都需要重新提供。

Autopilot 自动继续

Autopilot 选项目前处于实验阶段。

使用 autopilot 设置 Autopilot 模式下的自动继续策略。它不会改变会话模式本身。新建的 SDK 会话默认启用自动继续，maxContinues 为 5。将 maxContinues 设置为 0 即可关闭常规的自动继续。

use Revolution\Copilot\Types\Rpc\AutopilotOptions;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    autopilot: new AutopilotOptions(
        continuationEnabled: true,
        maxContinues: 3,
    ),
);

// 也可以用数组指定
$config = new SessionConfig(autopilot: [
    'continuationEnabled' => false,
    'maxContinues' => 0,
]);

恢复时，请在 ResumeSessionConfig 或数组中传入相同的 autopilot 键。热恢复（warm resume）时，省略的字段会保留当前值。运行时重启后（冷恢复，cold resume），请重新传入这些设置。

沙箱配置

沙箱配置目前处于实验阶段。

使用 sandboxConfig 为会话配置 CLI 沙箱。 SDK 会在创建和恢复请求中都转发该配置。为兼容现有代码，SDK 也接受 sandbox 作为别名。两者同时设置时，非 null 的 sandboxConfig 优先。

use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    sandboxConfig: [
        'enabled' => true,
        'userPolicy' => [
            'filesystem' => ['readwritePaths' => [storage_path('app/workspace')]],
            'network' => [
                'allowedHosts' => ['api.example.com'],
                'blockedHosts' => ['untrusted.example.com'],
            ],
        ],
    ],
);

使用 auth 和 credentials，可以让沙箱内的进程使用凭据而不暴露其值：

auth 为 git 和 gh 启用凭据注入。
credentials.envVars 将环境变量名映射到允许接收其掩码值的 HTTPS 主机（injectHosts）。请勿将凭据值本身写入配置。

$config = new SessionConfig(
    sandboxConfig: [
        'enabled' => true,
        'auth' => ['git' => true, 'gh' => true],
        'credentials' => [
            'envVars' => [
                'APP_CREDENTIAL' => ['injectHosts' => ['registry.example.com']],
            ],
        ],
        'userPolicy' => [
            'experimental' => ['seatbelt' => ['keychainAccess' => true]],
        ],
    ],
);

也可以使用 Revolution\Copilot\Types\Rpc 命名空间中的 SandboxConfig、SandboxConfigAuth、SandboxCredentialsConfig、SandboxMaskedEnvVar、SandboxConfigUserPolicyExperimental 和 SandboxConfigUserPolicyExperimentalSeatbelt 等类型化对象。网络的允许和阻止规则取决于 CLI 沙箱的功能和版本。

Canvas 提供商

Canvas 支持目前处于实验阶段。

通过 canvases 声明 canvas，并通过 canvasHandler 处理打开和操作请求。当代理打开 canvas 或调用其某个操作时，运行时会通过反向 RPC 调用你的处理器。设置 requestCanvasRenderer: true 即可选择作为渲染器参与，运行时会为此连接向模型公开 canvas 代理工具。该选项默认关闭，以免影响无法显示 canvas 的 SDK 调用方。

use Revolution\Copilot\Support\CanvasError;
use Revolution\Copilot\Support\CanvasHandler;
use Revolution\Copilot\Types\CanvasDeclaration;
use Revolution\Copilot\Types\Rpc\CanvasAction;
use Revolution\Copilot\Types\Rpc\CanvasProviderInvokeActionRequest;
use Revolution\Copilot\Types\Rpc\CanvasProviderOpenRequest;
use Revolution\Copilot\Types\Rpc\CanvasProviderOpenResult;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    canvases: [
        new CanvasDeclaration(
            id: 'editor',
            displayName: 'Editor',
            description: 'Opens and edits project files.',
            actions: [
                new CanvasAction(name: 'format', description: 'Format the open file.'),
            ],
        ),
    ],
    canvasHandler: new class extends CanvasHandler
    {
        public function open(CanvasProviderOpenRequest $request): CanvasProviderOpenResult|array
        {
            return new CanvasProviderOpenResult(
                url: 'https://app.example.test/canvas/'.$request->instanceId,
                title: 'Project editor',
            );
        }

        public function invoke(CanvasProviderInvokeActionRequest $request): mixed
        {
            if ($request->actionName !== 'format') {
                throw CanvasError::noHandler();
            }

            return ['formatted' => true];
        }
    },
    requestCanvasRenderer: true,
);

会话文件系统提供商

技能与文件系统回调

使用 skillProvider 可以从应用自身管理的来源加载技能。这些回调属于该会话，不会被序列化到 Copilot 运行时。云端会话不支持自定义技能提供商。

use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;
use Revolution\Copilot\Types\SkillProviderCallOptions;

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
    skillProvider: [
        'listSkills' => fn (SkillProviderCallOptions $options) => [
            ['name' => 'deployment', 'description' => 'Safe application deployments'],
        ],
        'readSkill' => fn (string $name, SkillProviderCallOptions $options) =>
            $name === 'deployment' ? '# Deployment checklist' : null,
    ],
);

SkillProviderCallOptions::$signal 提供回调的取消令牌。取消是协作式的，回调需要自行监听该信号并取消未完成的工作。也可以实现 Revolution\Copilot\Contracts\SkillProvider 来代替回调数组。 sessionFsProvider 使用相同的会话级配置。文本回调为 readFile(path) 和 writeFile(path, content, mode)。如需支持二进制文件，请同时提供 readFileBytes(path) 和 writeFileBytes(path, bytes, mode)，或实现 SessionFsBinaryProvider。这些回调接收并返回原始字节，JSON-RPC 传输上的 base64 编码由 SDK 处理。请将文件系统访问限制在应用打算公开的路径范围内。

use Illuminate\Support\Facades\Storage;
use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;

$config = new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
    sessionFsProvider: [
        'readFile' => fn (string $path) => Storage::disk('local')->get($path),
        'writeFile' => fn (string $path, string $content, ?int $mode = null) =>
            Storage::disk('local')->put($path, $content),
        'readFileBytes' => fn (string $path) => Storage::disk('local')->get($path),
        'writeFileBytes' => fn (string $path, string $bytes, ?int $mode = null) =>
            Storage::disk('local')->put($path, $bytes),
    ],
);

使用 `sessionFs` 委托全部会话状态

设置客户端选项 sessionFs（别名 session_fs），即可将整个 Copilot CLI 会话状态（包括会话状态文件和每个会话的 SQLite 数据库）迁移到你自己的存储中。设置后，每个会话配置都必须提供 createSessionFsProvider 工厂。 SDK 会在 createSession() 和 resumeSession() 时，在确定会话 ID 之后、向运行时发送请求之前调用该工厂。

use Revolution\Copilot\Client;
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Support\PermissionHandler;
use Revolution\Copilot\Types\SessionConfig;

$client = new Client(['sessionFs' => [
    'initialCwd' => '/workspace',
    'sessionStatePath' => '/session-state',
    'conventions' => 'posix', // 或 windows
    'capabilities' => ['sqlite' => true, 'binary' => true], // 可选
]]);

$session = $client->createSession(new SessionConfig(
    onPermissionRequest: PermissionHandler::approveAll(),
    createSessionFsProvider: fn (CopilotSession $session) => new MySessionFsProvider($session->id()),
));

使用 Copilot facade 时，请在 config/copilot.php 中设置 session_fs。 initialCwd、sessionStatePath 和 conventions（posix 或 windows）为必填项。缺少字段或 conventions 值无效时会抛出 InvalidArgumentException。 createSessionFsProvider 是一个 Closure。它同样适用于数组，以及 SessionConfig 和 ResumeSessionConfig 的 fromArray() 与 toArray()。它返回的提供商可以是对象，也可以是由 callable 组成的数组。每项可选功能都有各自的接口：

接口	新增内容
`SessionFsProvider`	`readFile`、`writeFile`
`SessionFsBinaryProvider`	`readFileBytes`、`writeFileBytes`（`capabilities.binary` 所必需）
`SessionFsFilesystemProvider`	`appendFile`、`exists`、`stat`、`mkdir`、`readdir`、`readdirWithTypes`、`rm`、`rename`
`SessionFsSqliteCapableProvider`	返回 `SessionFsSqliteProvider`（`query`、`exists`）的 `sqlite()`。`capabilities.sqlite` 所必需
`SessionFsSqliteTransactionProvider`	SQLite 提供商上的 `transaction()`

如果提供商不满足声明的功能，SDK 会抛出 InvalidArgumentException。调用提供商不支持的操作会返回 UNKNOWN 错误。提供商通过抛出异常来表示失败。code 为 ENOENT（或 errno 2）的异常会转换为 ENOENT，其他情况均转换为 UNKNOWN。可以从 transaction() 中抛出 SessionFsSqliteTransactionFailure 来报告 errorClass（busyOrLocked、fatal 或 postCommitAmbiguous）。未设置客户端 sessionFs 选项时，SDK 永远不会调用 createSessionFsProvider，现有的 sessionFsProvider（readFile 和 writeFile）仍可正常工作。

面向多租户应用的 empty 模式

将客户端的 mode 设置为 empty，即可默认禁用依赖 Copilot CLI 宿主环境或跨会话状态的功能。默认值为 copilot-cli，保持现有行为。在 empty 模式下，必须设置一个持久化目标：base_directory、session_fs 或外部服务器 url。

// config/copilot.php
'mode' => env('COPILOT_MODE', 'copilot-cli'),
'base_directory' => storage_path('app/copilot'),

empty 模式下的每个会话都必须设置 availableTools。使用 ToolSet 构建带来源限定的工具过滤器（builtin:、custom:、mcp:）。 BuiltInTools::Isolated 只允许限定在单个会话内的内置工具，不允许访问宿主文件系统、环境、网络或其他会话。

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Support\BuiltInTools;
use Revolution\Copilot\Support\ToolSet;

$response = Copilot::run(
    prompt: 'Summarize this text.',
    config: [
        'availableTools' => (new ToolSet)
            ->addBuiltIn(BuiltInTools::Isolated)
            ->addCustom('lookup_order')
            ->addMcp('search'),
    ],
);

工具名称必须匹配 /^[a-zA-Z0-9_-]+$/ 或为通配符 *，否则 ToolSet 会抛出 InvalidArgumentException。 empty 模式会为会话遥测、持久化 MCP OAuth token 存储、embedding 检索与缓存、指令发现、文件钩子、宿主 git 操作、会话存储、技能、memory 以及实验模式应用安全的默认值。显式设置的会话选项优先于这些默认值。 GitHub 缓存存储既不是 empty 模式的默认值，也不是会话选项。SDK 不再在会话创建或恢复请求中发送 enableGitHubCacheStore，如果数组配置中仍保留该键，也会被忽略。 replace 模式下的 systemMessage 会按原样使用，其他模式会移除 environment_context 段落。 SDK 还会为 CLI 进程设置 COPILOT_DISABLE_KEYTAR=1。云端执行请参考 Cloud Sessions，Plugin Directory 请参考 Plugin Directories。

最新信息请参考 GitHub 仓库。

GitHub Copilot

SDK

AI SDK

VOICEVOX

启动套件

Feed 与 RSS

中间件

SessionConfig

SessionConfig

发现根目录

工作目录信任

Memory 注入模式

排除 Managed Settings

Autopilot 自动继续

沙箱配置

Canvas 提供商

会话文件系统提供商

技能与文件系统回调

使用 `sessionFs` 委托全部会话状态

面向多租户应用的 empty 模式

​SessionConfig

​发现根目录

​工作目录信任

​Memory 注入模式

​排除 Managed Settings

​Autopilot 自动继续

​沙箱配置

​Canvas 提供商

​会话文件系统提供商

​技能与文件系统回调

​使用 sessionFs 委托全部会话状态

​面向多租户应用的 empty 模式

SessionConfig

发现根目录

工作目录信任

Memory 注入模式

排除 Managed Settings

Autopilot 自动继续

沙箱配置

Canvas 提供商

会话文件系统提供商

技能与文件系统回调

使用 `sessionFs` 委托全部会话状态

面向多租户应用的 empty 模式