返回文档入口

结构

LinX、Xpod 和 drizzle-solid 各管什么

一页说清你干活的那一层、保存和接口那一层、应用数据那一层各自做什么,以及它们怎么接起来。

这三部分是同一件事的三个位置,不是三个互相独立的项目。你可以只用其中一部分,但合起来才看得出它们为什么这样分工。

这一页里,标「现在」的都有公开资料可以核对;标「接下来」「以后」的还在计划里,不是已经交付的功能。

LinX 负责你干活的那一面

LinX 是用户直接打开的客户端:你给材料和自己的要求,它给出可以继续修改的结果。

  • 现在可核对:仓库和版本发布记录是公开的,LinX 发布记录里最新一条是 linx-v0.3.33(2026-06-30),只带 .tgz 包文件。
  • 还没核实:桌面安装包、各平台的系统要求、首次启动和连接流程。本站不会把没核实的能力写成已经能用。
  • 具体怎么开始:使用 LinX。

Xpod 负责保存、身份和接口

Xpod 是保存数据和对外提供接口的那一层。官方 README 把它描述为本地优先的 Pod 运行时,内部由 Community Solid Server 加一层 API 组成,通过一个网关对外。

  • 现在可核对:两种部署档,local(SQLite 加本地磁盘,不需要 Redis 或 MinIO)和 cloud(PostgreSQL、MinIO、Redis);bun run local 与 bun run cloud 等命令;库模式入口 startXpodRuntime;sidecar 路径 /-/sparql、/-/vector;AI 接口 /v1/chat/completions、/v1/responses、/v1/messages、/v1/models、/v1/chatkit。
  • 官方标为计划中:/-/terminal 在 README 里写着 planned。
  • 还没核实:我们团队没有执行过任何一次 Xpod 部署。启动命令和依赖要求见自部署 Xpod,那些内容来自官方 README。
  • 存在哪、谁能看、怎么带走:保存、访问和迁移说明。

drizzle-solid 负责应用里的数据读写

drizzle-solid 是给应用开发者用的数据层。它把应用自己的数据按有类型的 schema 写进 Solid Pod,并提供两种写法:偏 Solid 的 pod() 和接近 Drizzle 的 drizzle()。两者用的是同一套运行时,区别只在写法。

  • 现在可核对:npm 包 @undefineds.co/drizzle-solid,我们核对时的最新版本是 0.3.24,依赖 drizzle-orm;官方 README 给出 podTable、pod(session)、drizzle(session),以及 examples/ 目录。
  • 还没核实:我们没有执行过官方示例。安装来源、认证前提和读写目标见drizzle-solid 读写指南。

数据、身份和请求分别怎么走

这三件事要分开说,混在一起最容易得出错误结论。

数据:应用通过 Solid 的 HTTP 接口读写 Pod 里的资源。Xpod 的 local 档把数据放在 SQLite 和本地磁盘上,cloud 档放在 PostgreSQL 和 MinIO 上。drizzle-solid 负责把应用对象映射成 Pod 文档和资源 id:base 决定文档放在哪里,id 是相对 base 的资源 id,例如 post-1.ttl。

身份:Xpod 把 Pod 资源、WebID 身份和访问控制放在核心位置。用 drizzle-solid 读写数据时,pod(session) 和 drizzle(session) 都要先拿到一个已经认证过的 session。也就是说,应用用的是某个具体用户的身份和权限,而不是绕开访问控制。

请求:应用对 Pod 的读写走 Solid 接口;需要集合查询时走 /-/sparql。调用外部模型是另一件事:请求会发给你配置的模型服务,发出去的内容取决于你调用了哪个接口、带了哪些材料。保存位置和请求去向分开说明在保存、访问和迁移说明里。

现在、接下来和以后

阶段内容可核对到什么
现在把文件、对话和工作记录保存在 Pod 里;应用通过已认证的 session 读写 Pod 数据Xpod 的 local / cloud 两种部署档;drizzle-solid 0.3.24 的官方示例
接下来把你采纳了哪一版、改了哪一句顺手记下来;用你愿意提供的记录探索属于你的模型还没有上线确认,本站按「接下来」标注
以后在你划定的范围和标准之内,让 LinX 多替你处理一些小事长期方向;哪些能交给它、哪些必须先问你,都由你重新决定

官方路线图里还列着一些计划项:Xpod 的 /-/terminal 标为 planned;drizzle-solid 公开的 2026 路线图包括 schema 生命周期与迁移、跨 Pod 的精确操作等。这些是官方计划,不是本站已经验收的功能。

想动手从哪里开始