退出程序 (exit)

功能描述

此 API 端点 POST /api/system/exit 用于请求思源笔记程序执行关闭流程并退出。

关闭流程通常包括保存数据、执行必要的同步操作等。可以指定是否强制退出以及退出时如何处理新版本安装包。

请求参数

请求体是 JSON 格式，可以包含以下可选参数：

• force (boolean): 可选。是否强制退出。如果设置为 true，可能会跳过某些检查或同步失败时的等待，直接尝试退出。默认为 false。
• execInstallPkg (integer): 可选。控制退出时如何处理检测到的新版本安装包。
  • 0 (默认): 检查新版本，行为由系统决定（可能提示或自动执行）。
  • 1: 明确指示不执行新版本安装。
  • 2: 明确指示执行新版本安装（如果存在）。

请求示例 (正常退出，默认行为):

{}
            

请求示例 (强制退出，不安装新版本):

{
  "force": true,
  "execInstallPkg": 1
}
            

响应结果

API 会尝试返回一个 JSON 对象，但由于程序即将退出，客户端不一定能完整接收到响应。

• 正常退出 (预期): 理想情况下，返回 code: 0。但程序可能在响应发送前就已退出。

  
  {
    "code": 0,
    "msg": "",
    "data": null
  }
                      

• 同步失败等情况: 如果关闭过程中遇到可恢复的错误（如同步失败且未强制退出），可能返回 code: 1 和提示信息，程序此时可能不会退出，等待用户交互。

  
  {
    "code": 1,
    "msg": "同步执行失败......", // 包含提示和按钮的 HTML
    "data": { "closeTimeout": 0 }
  }
                      

• 发现新版本: 如果检测到新版本并准备安装/提示，可能返回 code: 2 和提示信息。

  
  {
    "code": 2,
    "msg": "检测到新版本...", // 提示信息
    "data": { "closeTimeout": 0 }
  }
                      

注意：由于此 API 的目的是退出程序，依赖其返回值进行后续操作是不可靠的。

在线测试