Services 与预览

如果你的项目有一个长期运行的开发服务器，你可以在工作区根目录的 linkcode.json 文件中声明它，让 LinkCode 替你运行并跟踪它，而不必你在另一个终端里自行管理。完整 schema 参见 linkcode.json 参考。

{
  "scripts": {
    "web": { "type": "service", "command": "pnpm dev" }
  }
}

Services 菜单

当工作区声明了脚本时，窗口头部会出现一个 Services 标签片，列出每个脚本，并用一个彩色圆点显示其状态 —— 运行中，且对于 service 而言还显示它当前是否通过健康检查；已停止；或空闲：

• Run / Stop — 启动或停止脚本。
• View logs — 跳转到一个附着于该脚本实时输出的终端标签页。
• Open — 对于运行中的 service，加载其预览 URL。你第一次打开链接时，LinkCode 会询问是在 Browser 面板中打开，还是在你的系统浏览器中打开，并提供一个记住你选择的选项，这样它就不再询问。

一个 task 类型的脚本（一次性命令，与持久 service 相对）在失败时会显示其退出码。

端口与环境变量

你不用自己挑选端口 —— LinkCode 会为每个声明的 service 自动分配一个（除非你用 linkcode.json 中的 port 字段固定一个），并将其作为 LINKCODE_PORT 和 LINKCODE_URL 注入脚本的环境。同一工作区中每个其他运行中的 service 也会作为 LINKCODE_SERVICE_<NAME>_PORT 和 LINKCODE_SERVICE_<NAME>_URL 暴露给各脚本，这样一个 service 就能按名称寻址另一个，无需硬编码端口。

预览地址

预览 URL 不是原始端口 —— 而是一个稳定地址，形如 web--my-project-a1b2c3.localhost，由你的 host（即 LinkCode daemon）代理。对于给定工作区中的给定脚本，它在多次重启之间保持不变，这便于收藏为书签，但它只在你自己的机器上解析：它无法与其他任何人共享，即便在你的本地网络上也不行。