DeepSeek-Reasonix 桌面宿主协议Electron 壳与 Go 服务之间的版本化 JSON-RPC 契约详解【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-ReasonixDeepSeek-Reasonix 的桌面版采用“双进程”架构Electron 壳负责全部原生界面与系统能力Go 桌面服务承载全部业务命令两者之间通过一条运行在服务进程 stdio 上的私有、带版本的 JSON-RPC 2.0 连接协作。本篇指南以 docs/DESKTOP_HOST_PROTOCOL.zh-CN.md 为骨架结合仓库源码与测试完整讲解这条契约的传输层、握手校验、生命周期管理、业务调用、事件恢复、原生宿主调用、资源源、渲染进程 preload 接口、安全边界与性能诊断能力。读完你将能理解该协议的设计动机、逐字段的握手流程、全部命令与事件语义并掌握-emit-contract契约生成、--host-rpc启动方式与性能诊断工具的用法。一、架构总览谁拥有什么契约如何分工协议的第一原则是双方各守边界任何一方不得绕过契约Go 侧拥有全部桌面业务命令App的导出方法Electron 侧拥有全部原生界面窗口、对话框、托盘、浏览器面板等React 渲染进程不触碰 Electron 或 Go 的任何全局对象只通过 preload 暴露的类型化接口与壳通信。整个数据通路可以用下面这张图概括React 渲染进程 ──preload 类型化 IPC──▶ Electron 主进程 ──stdio JSON-RPC──▶ Go 桌面服务 ▲ │ └────── host/* 反向请求 ────────────┘从源码结构看这条契约被拆成了三块实现Go 服务端desktop/cmd/reasonix-desktop的宿主入口见 desktop/host_rpc.godesktop/internal/hostrpc/包实现了握手校验、注册表、事件序列与host/*反向请求desktop/internal/hostrpc/server.goElectron 壳端desktop/electron/src/main/下的handshake.ts、rpc.ts、protocol.ts、lifecycle.ts、hostCalls.ts等实现握手、转发与原生调用preload 桥desktop/electron/src/preload/index.ts只向渲染进程暴露window.reasonixDesktop一个对象。二、传输层行分隔 JSON-RPC 与资源上限传输层的规格如下帧格式按行分隔的 JSON-RPC 2.0采用rpcwire严格模式rpcwire.StrictJSONRPC: true。一行一帧UTF-8 编码不允许批量数组。启动方式Go 服务以reasonix-desktop --host-rpc启动。stdout 只承载协议帧stderr 承载日志两者严格分离。退出语义壳在发送desktop/shutdown之后关闭 stdin 以请求退出。即使从未调用过shutdownstdin 关闭后服务也会自行退出因此壳突然死亡不会留下无头 Go 进程。资源上限在 desktop/host_rpc.go 中可查到对应配置双向单帧上限 64 MiBMaxInboundBytes/MaxOutboundBytes均为64 20服务端最多 512 个并发入站处理器MaxConcurrentHandlers: 51230 秒写入停滞看门狗MaxWriteStall: 30 * time.Second。并发与顺序模型壳发出的每个请求都在独立 goroutine 上执行与已退役的进程内壳的绑定调用一致。只有desktop/event帧保证顺序——它们由服务端的单一队列写出事件序号在同一把锁内分配Server.Emit中emitMu保护seq自增与写入见 server.go。大体积二进制数据从不进入帧而是走下文介绍的“资源源”loopback HTTP 端点。三、握手desktop/hello与终止性失败码新连接上的第一个请求必须是desktop/hello否则一律以-32002 not_ready失败——server.go中所有desktop/*处理器都被gated()包裹在ready标志置位前只返回notReady()。3.1 握手请求与响应示例// 壳 → 服务 {method:desktop/hello,params:{ protocolVersion: 1, contractDigest: sha256:…, // 壳包内嵌的契约摘要 build: {version:v1.30.0,channel:stable,commit:abc123}, host: {name:electron,version:44.2.0,chrome:152.0.0,platform:darwin,arch:arm64}, instance: {home:/Users/…/.reasonix,dev:false} }} // 服务 → 壳 {result:{ protocolVersion: 1, contractDigest: sha256:…, service: {version:v1.30.0,channel:stable,commit:abc123,pid:4242}, runtimeGeneration: g-01J…, // 每个服务进程唯一 resources: {origin:http://127.0.0.1:51234,token:…}, window: {width:1280,height:820,minWidth:760,minHeight:480,frameless:false,zoomFactor:1} }}各字段含义字段含义protocolVersion协议版本号目前为1Electron 侧PROTOCOL_VERSION 1见 desktop/electron/src/main/handshake.tscontractDigest契约摘要双方内置用于检测“混装”安装build/service壳与服务各自的版本、渠道stable/dev等、commithost壳运行时信息Electron 版本、Chromium 版本、平台、架构instance.home壳的规范数据目录instanceidentity.CanonicalHome归一化runtimeGeneration每个服务进程唯一、随机生成的世代标记randomHex(8)生成见 host_rpc.goresources回环资源源的origin与token见下文“资源源”一节windowGo 根据保存状态和平台规则算出的主窗口初始几何其中window几何字段由 Go 侧计算默认 1280×820最小 760×480常量desktopWindowMinWidth/desktopWindowMinHeight见 host_rpc.goframeless按GOOS决定zoomFactor取自保存的缩放状态。壳按该几何隐藏创建窗口Go 随后在domReady中通过host/window.*系列调用定位、最大化并显示。3.2 握手校验顺序与终止性失败码validateHellodesktop/internal/hostrpc/hello.go按固定顺序执行检查第一个失败即返回终止性错误代码名称含义-32001protocol_mismatchprotocolVersion不一致-32003contract_mismatch命令/事件摘要不一致混装安装-32004build_mismatch壳与服务版本不同且都不是devdev渠道放宽该检查-32005instance_mismatch壳的规范数据目录与服务的不一致-32002not_readyhello 成功前的任何请求这些失败码都是终止性的壳显示真实错误信息只提供“打开日志”和“退出”两个动作绝不回退到浏览器 mock。handshake.ts中describeHandshakeFailure把每个错误码映射为可展示的标题与详情供壳的失败页渲染。runtimeGeneration标记该服务进程发出的每个事件、每个审批和浏览器授权。服务重启后产生新的世代壳会丢弃任何旧世代标记的内容这构成后文事件恢复机制的基础。四、生命周期请求从start到退出壳 → 服务的生命周期请求由server.go中的Hooks结构绑定到App的对应方法方法参数结果Go 负责者desktop/start{}{}App.startupdesktop/domReady{}{}App.domReadydesktop/rendererAttached{rendererGeneration:n}{}前端心跳/就绪desktop/beforeClose{reason:window\|quit\|tray\|updater}{prevent:bool}App.beforeClosedesktop/shutdown{}{}App.shutdowndesktop/hostEvent{name:string,payload:any}{}第二实例、托盘打开/退出、菜单动作desktop/browserControl{enabled:bool}{}内置浏览器开关构建会话时读取标准顺序为hello → start → 窗口加载 → domReady →每次渲染进程挂载后 rendererAttached → … → beforeClose →shutdown → 关闭 stdin → 退出几个实现细节desktop/beforeClose返回{prevent: bool}Go 侧App.beforeClose依据 reason窗口关闭、应用退出、托盘、更新器决定是否阻止关闭desktop/shutdown的处理是“先应答、后关闭”rpcwire.RespondThen保证响应发出后才close(s.done)结束Serve循环见 server.go随后壳关闭 stdin进程自然退出desktop/hostEvent是壳把系统事件第二实例启动、托盘打开/退出、菜单动作推送给 Go 业务层的通道具体事件名见第六节末尾。五、业务命令desktop/invoke与契约注册表业务调用统一走desktop/invoke{method:desktop/invoke,params:{method:OpenProjectTab,args:[/path, true]}} {result: {...}} // 方法的 JSON 结果void 为 null {error:{code:-32000,message:错误文本,data:{method:OpenProjectTab}}}5.1 方法签名规则与错误映射method必须是契约注册表接受的 GoApp导出方法。签名沿用已退役壳的规则参数任意可 JSON 序列化结果为()、(T)、(error)或(T, error)。注册表在构建期拒绝其他形态因此接口面不可能出现壳无法调用的方法。错误映射见 server.go未知方法名 →-32601ErrMethodNotFound参数解码失败 →-32602ErrInvalidParams方法 panic →-32603ErrInternal并记录 panic 值与堆栈业务错误 →-32000CodeBusinessdata.method指明命令名。5.2 契约生成-emit-contract是唯一事实来源生成的契约命令cd desktop go run . -emit-contract frontend/src/generated是唯一事实来源它输出 JSON 契约、摘要、TypeScript 命令表和渲染进程使用的 DTO 类型声明desktopContract.generated.ts/desktopContract.generated.json。检入的输出一旦漂移桌面 Go 测试就会失败保证生成物始终与源码同步。生成器从App类型出发不构造实例先做源码所有权扫描hostrpc.SourceOwnership再构建带所有权的注册表并序列化见 host_rpc.go。5.3 命令元数据owner、sources、scope 与 cancellation每个命令还记录domain源码模块owner准确的属主方法如App.OpenProjectTabsources仓库相对路径scope与cancellation参与摘要计算。生成器扫描所有平台声明并输出desktop/host_command_owners.generated.json宿主内嵌该文件要求每个反射命令都有匹配元数据。Scope 记录原方法的命名 wireinputs遗留无名参数使用argN和resolver无参数命令使用owner-state其余使用owner-inputs。这些字段只描述来源和分派边界输入校验、标签/会话选择及权限检查仍由原有 App 方法负责。5.4 取消语义before-dispatch与cooperative-context当前 App 命令声明before-dispatch宿主在解码前及真正分派前检查取消同步写入开始后即使收到取消也保留原方法的结果不承诺中断已分派的方法。宿主方法可通过首个 Go 参数context.Context声明cooperative-context宿主注入请求 context它不属于 JSON 参数或生成的 DTO。方法自身必须配合取消监听 context 并尽早返回。业务 Stop/Cancel 命令继续沿用已有 owner 和语义。这部分在 desktop/internal/hostrpc/cancellation_test.go 中有专门测试覆盖。六、事件流desktop/event与世代恢复服务 → 壳 → 渲染进程的事件帧{method:desktop/event,params:{seq:1093,generation:g-01J…,name:agent:event,args:[{...}]}}args保留原事件桥的可变参数载荷多数事件只有一个元素壳把该帧经reasonix:event通道转给渲染进程preload 的on(name, cb)按name过滤并调用cb(...args)序号在同一世代内严格递增重新挂载的渲染进程可据此发现缺口并重新快照而不是信任陈旧状态。6.1 缺口检测与desktop:resync服务监督器和 preload都拒绝重复、倒序帧preload 还根据当前服务状态拒绝旧世代帧并在 React 订阅前接入传输ipcRenderer.on(IPC.event, ...)在 React 挂载前绑定见 desktop/electron/src/preload/index.ts。世代变化、序号缺口或订阅期间遗漏会触发壳内事件desktop:resync载荷含generation、reason、expectedSeq、actualSeq它不属于 Go 业务事件。恢复流程运行状态通过SyncRuntimeState重读已挂载控制器重读ListTabs复用现有TurnEventsForTab日志与待审批提示恢复投影异步读取受后续恢复请求、会话身份和导航变更约束不重放业务调用服务重启后复用仍存活的应用渲染进程保留未发送草稿。6.2 恢复保证范围当前保证范围是核心运行状态、会话元数据、持久化轮次事件和待审批提示。终端虽有有界输出快照但没有原子输出游标因此缺口后的终端会明确标记“输出可能不完整”不将无法确定边界的快照合并进实时输出。扩展输出、文件监听等独立事件流仍需各自的重新快照契约不在上述核心恢复保证范围内。七、原生宿主调用host/*反向请求这些调用替代 Go 中对壳工具包的直接调用每一项对应 GonativeHost接口的一个方法见 desktop/native_host.goWails 实现已随 Electron 壳落地删除。业务代码访问壳的唯一入口是nativeHost接口测试中可注入 fakenoopNativeHost无壳环境下方法安全空转。完整方法表方法参数结果host/window.show{reason:string}{}host/window.hide{}{}host/app.hide{}{}macOS 应用级隐藏host/window.maximiseunmaximiseminimiseunminimisetoggleMaximisecenter{}{}host/window.isMaximisedisMinimised{}{value:bool}host/window.setPosition{x:n,y:n}{}host/window.setTitle{title:string}{}host/screen.list{}{screens:[{x,y,width,height,scale,primary}]}host/dialog.openDirectory{title,defaultDirectory}{path:string}表示取消host/dialog.openFile{title,defaultDirectory,filters:[{displayName,pattern}],multiple:bool}{paths:[]}host/dialog.saveFile{title,defaultDirectory,defaultFilename,filters}{path:string}host/dialog.message{type:info\|warning\|error\|question,title,message,buttons:[],defaultButton,cancelButton}{button:string}host/shell.openExternal{url:string}{}host/app.quit{}{}host/app.relaunch{args:[],execPath?:string}{}host/devtools.toggle{}{}host/remoteWindow.open{hostKey,url,title}{windowId:string}host/remoteWindow.navigate{hostKey,url,title}{}host/remoteWindow.focusclose{hostKey}{}host/tray.ensure{openTitle,openTooltip,quitTitle,quitTooltip,tooltip}{ready:bool,reason:string}7.1 安全与可靠性细节host/shell.openExternal只接受http:、https:和mailto:URL。包括file:、javascript:、data:在内的其他协议会在 Electron 宿主边界被拒绝不会交给系统打开器执行对话框结果从不暴露文件内容它们只返回路径再由 Go 经现有工作区和媒体检查授权超时分级见 desktop/native_host_rpc.go窗口操作类 fire-and-forget 调用使用 5 秒短超时rpcHostWindowTimeout保证卡死的壳永远不会阻塞 Go 侧业务 goroutine对话框类调用使用 24 小时超时rpcHostDialogTimeout因为对话框天然等待用户操作。7.2 托盘、浏览器与宿主事件| host/tray.destroy | {} | {} | | host/browser.grant revoke | {grantId,tabId,sessionId} / {grantId} | {} | | host/browser.tabs.list | {grantId} | {tabs:[{id,url,title,loading,temporary}]} | | host/browser.tabs.open | {grantId,url,temporary} | tab | | host/browser.tabs.navigate | {grantId,tabId,url,action} | tab | | host/browser.tabs.close | {grantId,tabId} | {} | | host/browser.snapshot | {grantId,tabId,selector} | {documentToken,url,title,tree,refs} | | host/browser.act | {grantId,operationId,tabId,documentToken,action,ref,text,keys,options,files,submit,deltaX,deltaY} | {executed,reason,documentToken} | | host/browser.screenshot | {grantId,tabId,ref,fullPage,directory} | {path,mime,width,height} | | host/browser.downloads | {grantId,tabId,waitForMs} | {downloads:[{id,url,path,state,bytes}]} |浏览器调用以-32010引用过期、-32011用户已接管该标签或-32012没有当前授权失败Go 执行器把它们映射到内核哨兵错误并把操作结果记入账本。授权的tabId是桌面标签任务该授权下打开的浏览器标签归属于它。宿主事件desktop/hostEvent包括tray.open、tray.quitsecondInstancepayload 携带原始 argvmenu.showWindowremoteWindow.closed{hostKey}browser.takeover{tabId,epoch,reason}。八、资源源大体积二进制与授权资源的中转站服务在回环端口上监听承载现有的授权资源处理器。从 host_rpc.go 可以看到中间件链的组装顺序jsProfilingMiddleware → remoteMarkdownImageMiddleware → workspaceMediaMiddleware → themeAssetMiddleware对应路径前缀/__reasonix_workspace_media/…、/__reasonix_theme_asset/…、远程 markdown 图片代理等。访问控制要点壳从受限的reasonix://app/scheme 提供打包界面只把上述前缀转发到资源源壳在主进程中附加Authorization: Bearer token头token 由服务端在启动时随机生成randomHex(32)并通过握手resources字段下发校验使用常量时间比较subtle.ConstantTimeCompare防时序侧信道失败返回 401见 host_rpc.gotoken 从不到达渲染进程、网站视图、远程窗口或 MCP App 框架Go 保留今天的全部文件身份与 TTL 检查。九、渲染进程 preload 接口window.reasonixDesktop可信 preload 只暴露一个对象window.reasonixDesktop其完整 TypeScript 接口为interface ReasonixDesktopHost { readonly kind: electron; readonly contract: { protocolVersion: number; digest: string; commands: readonly string[] }; readonly platform: { os: darwin | windows | linux; arch: string; versions: Recordstring, string }; invoke(method: string, args: unknown[]): Promiseunknown; on(name: string, cb: (...args: unknown[]) void): () void; native: { openExternal(url: string): Promisevoid; clipboard: { writeText(text: string): Promiseboolean; readText(): Promisestring }; window: { setTheme(theme: system | light | dark): void; setBackgroundColour(r: number, g: number, b: number, a: number): void; getBounds(): Promise{ x: number; y: number; width: number; height: number; maximised: boolean }; isMaximised(): Promiseboolean; minimise(): void; toggleMaximise(): void; close(): void; }; getPathForFile(file: File): string; // 原生拖放路径 onServiceState(cb: (state: ServiceState) void): () void; browserControl: { // 内置浏览器的设置页 get(): PromiseBrowserControlState | null; setEnabled(enabled: boolean): PromiseBrowserControlState; setIgnoreCertificateErrors(enabled: boolean): PromiseBrowserControlState; clearCache(): Promisevoid; // 保留 Cookie 与站点数据 clearAllData(): Promisevoid; // Cookie、站点数据与缓存 importChromeLogin(): PromiseChromeImportOutcome; }; }; browser: { // 用户驱动的浏览器面板Agent 调用经 Go list(): PromiseBrowserTabView[]; open(url: string, opts?: { temporary?: boolean; taskId?: string }): PromiseBrowserTabView; close(tabId: string): Promisevoid; activate(tabId: string | null): Promisevoid; navigate(tabId: string, target: { url?: string; action?: back | forward | reload | stop }): Promisevoid; setZoom(tabId: string, factor: number): Promisevoid; toggleDevTools(tabId: string): Promisevoid; resume(tabId: string): Promisevoid; // 把接管的标签交还给 Agent setLayout(rect: { x: number; y: number; width: number; height: number } | null): void; setOverlay(active: boolean): void; // 应用覆盖层隐藏所有网站视图 onTabs(cb: (tabs: BrowserTabView[]) void): () void; onDownload(cb: (download: BrowserDownloadView) void): () void; }; }9.1 核心类型定义BrowserTabView为{ id, taskId, url, title, loading, canGoBack, canGoForward, temporary, mode: agent | human, epoch, zoom, error }BrowserDownloadView为{ id, tabId, url, filename, path, state, received, total }。网站视图位于persist:browser共享登录或temp:id分区永远不会获得应用 preloadServiceState为{ phase: starting | ready | restarting | failed | exited; generation: string; error?: string }。业务组件只导入类型化 SDK从不直接使用该对象只有桥接适配层读取它BrowserControlState为{ controlEnabled, ignoreCertificateErrors, writable, warning: invalid-config | unreadable-config | unsupported-version | null }ChromeImportOutcome为{ ok: true, profile, cookies, skipped }或{ ok: false, reason }reason取值chrome-missing、profile-not-found、cookies-unreadable、safe-storage-denied、safe-storage-unavailable、unsupported-platform。十、安全边界协议在四个层面收紧边界应用窗口sandbox 开启、context isolation 开启、Node integration 关闭只加载reasonix://app使用上述 preload网站视图、远程 Serve 窗口和 MCP App 框架独立 session没有应用 preload不能访问reasonix://不能触达host/*IPC 处理器只接受来自应用窗口webContents的请求其他发送者被拒绝并记录内嵌契约之外的desktop/invoke名称在到达 Go 之前失败壳在转发前按内嵌命令表校验未知名称以-32601失败。十一、性能诊断补充以下可选 native 接口仅允许可信应用主框架调用。旧 shell 可缺少这些接口不涉及持久化用户数据格式变更或迁移。11.1processDiagnostics()返回{scope: electron, samples, growth}。要点样本包含年龄、可空 CPU 区间、PID/类型/创建时间、可空 CPU 百分比、工作集及私有内存MiB、截断标记采集节奏前台最多每 30 秒一次后台每 60 秒一次最多保留五分钟内的 12 条记录每条最多 128 个进程不采集标题、URL 或进程名称范围仅含 Electron 管理的进程不含 Go 服务。11.2captureRendererProfile(requestId?)通过 CDP 录制当前 renderer 五秒请求的采样间隔为 10ms返回状态、时长和最多八个应用脚本的自身耗时摘要。约束普通页面不启用 JS Self-Profiling最多一个进行中的采样要求窗口在前台冷却十分钟每次启动 shell 最多尝试三次不接管已有 debugger/DevTools失焦、隐藏、导航、renderer 退出或取消会停止采样分析在临时 Worker 中运行老生代限制 32 MiB、超时 1.5 秒、输入最多 20,000 个节点及 100,000 个样本原始 profile 不进入 UI 报告。11.3cancelRendererProfile(requestId)仅取消身份匹配的采样忽略 renderer 不带身份的取消请求防止长时间挂起后迟到的旧请求干扰新采样。每条 CDP 命令最多等待 1.5 秒所有终态均释放自己的 debugger。11.4exportHeapSnapshot()先显示原生风险提示并要求用户确认再选择保存路径仅保存本地、不上传也不接受 renderer 提供的路径。快照可能包含代码、聊天、密钥会暂停界面并可能占用较多磁盘。Electron 无法中断已开始的快照因而忙碌状态保持到操作实际结束不用超时伪装取消成功。11.5 内存增长报警信号内存增长信号要求PID 与创建时间连续一致至少五次读数跨越两分钟最近三次读数均超过前两次的较高基线至少 256 MiB 且至少 50%。全程可用时采用私有内存否则使用工作集。这表示观察到持续增长不代表确认泄漏也不代表独占的物理内存。配套行为报告立即显示已有证据进程补充最多等待 750ms短时 CPU 采样结束后更新同一报告前端 12 秒后放弃采样补充并请求取消。这些是异步等待期限不是同步工作可被抢占的保证。迟到结果不会重建已经关闭的报告采样结果明确标注为触发后的数据。用户主动生成堆快照期间及结束后五秒内暂停压力报警避免诊断触发自身报警。十二、验证与性能对照实验协议与诊断能力都有配套验证手段握手/协议desktop/electron/src/main/handshake.test.ts、protocol.test.ts、rpc.test.ts覆盖握手校验、错误码与 RPC 编解码Go 侧契约desktop/internal/hostrpc/下contract_test.go、registry_test.go、server_test.go、cancellation_test.go、ownership_test.go、browsercontrol_test.go覆盖注册表、取消语义、所有者元数据与浏览器控制性能诊断 smoke在desktop/electron目录运行node scripts/performance-smoke.mjs可隔离验证采样 owner、Worker、报告更新及本地堆快照。性能基准对照node scripts/performance-benchmark.mjs分别以关闭监测、基础监测、短时采样三种模式运行三次独立进程对照记录可用的 CPU 时间、帧时序、工作集及指标采集耗时。各模式使用同一 renderer bundle通过运行时开关选择固定活动信号并关闭后台节流用于无人值守比较成本。宿主事件测试独立覆盖生产焦点和导航取消策略原生 smoke 验证实际 CDP 与 ASAR 路径。输出至artifacts/performance/overhead.json。需要注意该合成测试不等同于 Windows 用户场景复现仍需对比刚启动、长时间使用、切回窗口和关闭标签等阶段。结语DeepSeek-Reasonix 桌面宿主协议的价值在于把“进程边界”变成“契约边界”Go 服务与 Electron 壳各自演进却能通过-emit-contract生成的单一事实来源保持严格一致世代标记加序号机制让渲染进程可以安全地在服务重启、事件缺口后自愈host/*反向调用把壳工具包隔离在业务代码之外测试友好且不会因壳卡死而阻塞业务Bearer-token 保护的资源源则在不暴露 token 给任何受限上下文的前提下继续复用 Go 侧完整的授权与 TTL 检查。理解这份协议是阅读桌面端代码、排查壳与服务混装故障、或为 Reasonix 桌面端扩展新命令的起点——协议文档本身位于 docs/DESKTOP_HOST_PROTOCOL.zh-CN.md实现代码集中在 desktop/internal/hostrpc/ 与 desktop/electron/src/main/。【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考