状态文件

lip 在工作区的状态文件中记录工作区状态：安装了哪些包、它们的确切版本、来源，以及它们写入磁盘的文件。

位置

状态文件是工作区根目录下的 .lip/state.json。在 Windows 上，lip 创建 .lip 目录时会为其设置隐藏属性；在其他平台上，它的名称本身就使其隐藏。

由于状态文件位于工作区目录之中，而不是与其路径绑定，移动、重命名或复制工作区后，状态文件会随之保留，已安装的包也随之保留。

.lip 为 lip 保留：安装的包若要把文件写入工作区根目录下的 .lip 或其下任何位置，安装会失败；purge 模式也永远不会匹配 .lip 及其下的任何内容。

作用

状态文件有以下几个用途：

状态追踪：作为工作区安装状态的唯一真实来源。
可复现性：记录安装每个已安装包时所用的包文件，对于来自 git 仓库的包还记录其所在的提交。当 lip 再次需要某个包时，会用该包文件安装它，而不是重新解析该包。
卸载：lip 追踪包写入磁盘的每个文件，使 lip uninstall 能干净地删除与包相关的所有文件，避免工作区中残留"腐烂文件"。
依赖图：区分用户显式安装的包和作为依赖安装的包。这样 lip uninstall 也能移除不再被任何显式安装的包需要的依赖，lip list 也能把两组分开显示。
环境：一旦得知工作区的运行端和平台，就将其记录下来，使后续命令使用同一环境。

状态文件在一次操作的所有包都安装或卸载完成后才替换一次。若操作失败，lip 会撤销其对工作区的修改，状态文件保持原样，因此两者始终一致（参见内部机制）。

结构

状态文件是一个 JSON 文件，由 JSON Schema state.schema.json 描述：

json

{
  "format": 4,
  "side": "server",
  "platform": "win-x64",
  "packages": [...]
}

字段

format：状态文件的格式，4。
side：工作区的运行端，"server" 或 "client"。lip 写入 "server"。
platform：工作区的平台，一个 .NET RID。
packages：已安装的包，按安装顺序排列：一个包排在满足其依赖的包之后。

side 和 platform 总是存在且从不为 null；缺少它们的状态文件无效。没有状态文件的工作区从其第一次 setup、install、uninstall 或 update 获得环境（参见 lip install）。

包条目

每个包恰好由以下成员记录：

manifest：安装该包时所用的完整包文件。对于早期格式的 tooth.json，它是 lip 针对工作区环境从中派生的包文件。其 id 是包 ID，version 是已安装的版本。
variant：安装来源的变体，默认变体为 ""。它与 manifest 的 id 一起构成包的身份。
explicit：
- true：该包由用户显式安装（例如 lip install <package>）。
- false：该包作为另一个包的依赖安装。
ref：包的安装来源：传给 lip install 或 lip update 的参数（例如 github.com/user/repo、github.com/user/repo#lua@branch:main 或 https:// URL；本地路径记录为其绝对路径的 file: URI），lip setup 安装游戏或加载器所用的来源（例如 github.com/LiteLDev/bds@1.21.0），对于依赖则是该依赖的键。lip update 会再次请求它。
commit：仅用于来自 git 仓库的包：其归档所在的提交，以小写十六进制表示。来自 URL 或本地路径的包没有 commit。
files：包拥有的文件，相对于工作区根目录，以 / 分隔。

已安装的条目是 manifest.variants[variant] 中 side 和 platform 与工作区相同的那个条目。

lip 只按身份、版本和提交比较已安装的包与它解析出的包：身份和版本相同、且都不来自 git 仓库或来自同一提交的两个包是同一个包，即使 URL 或本地路径的文件此后已经改变。下载的 ZIP 归档或资源的校验和既不记录也不检查。

当 lip 再次需要某个已安装包的文件时，它用记录的 manifest 安装该包：对于来自 git 仓库的包，从记录的提交安装（即使它来自一个此后已前进的分支）；否则从其 ref 现在指向的归档安装。卸载不需要两者中的任何一个。

示例

json

{
  "format": 4,
  "side": "server",
  "platform": "win-x64",
  "packages": [
    {
      "manifest": {
        "format": 4,
        "id": "github.com/example/MyMod",
        "version": "1.0.0",
        "variants": {
          "": [
            {
              "side": "server",
              "platform": "win-x64",
              "deps": { "github.com/LiteLDev/LeviLamina": ">=1.0.0 <2.0.0" },
              "assets": [
                {
                  "type": "mcmod",
                  "urls": ["https://github.com/example/MyMod/releases/download/v1.0.0/MyMod-server-win-x64.zip"]
                }
              ]
            }
          ]
        }
      },
      "variant": "",
      "explicit": true,
      "ref": "github.com/example/MyMod",
      "commit": "0123456789abcdef0123456789abcdef01234567",
      "files": ["mods/MyMod/MyMod.dll", "mods/MyMod/manifest.json"]
    }
  ]
}

lip v0.39.x 的工作区

lip v0.39.x 的状态文件同样是格式 4，但在其根部以及每个记录的 manifest 的条目中，把运行端写作 platform、把平台写作 runtime。lip 不读取这样的状态文件：含有 runtime、或 platform 为 "server" 或 "client" 的根部或条目会使命令失败，并给出消息，提示把 platform 改名为 side、把 runtime 改名为 platform。lip 不会迁移它；请在根部以及每个 manifest 的每个条目中改名这两个键。下一节介绍 lip v0.37.0 及更早版本的工作区。

linux-x64 的工作区

早期版本的 lip 曾通过 --platform 为 win-x64 以外的平台安装包。lip 把记录平台 linux-x64 的状态文件当作 win-x64 的状态文件读取，其中的 github.com/LiteLDev/bds 是其变体 github.com/LiteLDev/bds#linux，即 Linux 版服务器，下一次 setup、install、uninstall 或 update 会如此记录它。记录了其他任何包的 linux-x64 状态文件会使读取它的每条命令失败，并给出指明该包的消息：请在新工作区中重新安装这些包。记录其他平台的状态文件会使 setup、install、uninstall、update 和 run 失败。

lip v0.x 的工作区

lip v0.37.0 及更早版本的工作区在其根目录中有一个格式版本 3 的 tooth_lock.json，而没有状态文件。lip 会自动迁移它：

lip list 把它读作它所代表的状态文件，不做修改。
下一次 lip setup、lip install、lip uninstall 或 lip update 把该状态文件写为 .lip/state.json，并删除 tooth_lock.json。

每个包保留其变体、是否显式安装，以及它拥有的、位于工作区之下的文件；其 ref 为其包 ID（加上 #<variant>），其 commit 从其仓库的版本标签 v<version> 查得。无法查得该提交时，命令会失败。lip 无法针对工作区环境读取其 tooth.json 的包会被丢弃。