#q2316367743/open-list

• 支持 OpenList 的两种认证方式：永久 token，或账号密码（首次请求前 自动登录换取限时 token）。
• 六个域各自独立成包，但共享同一份认证状态：client.auth().login(...) 之后， client.fs() 立刻可用。
• 每个端点都有类型化方法；没封装的端点用 client.request(...) 逃生通道。
• 契约以 OpenList v4 服务端源码为准（官方 API 文档有出入的地方在 docs/ 里逐条标出）。

#安装

moon add q2316367743/open-list

#快速开始

///|
async fn main {
  // 方式一：永久 token
  let client = @open-list.create_open_list_client_with_token(
    "https://openlist.example.com",
    "YOUR_PERMANENT_TOKEN",
  )

  // 方式二：账号密码（第一次需要认证的请求前自动登录）
  let client = @open-list.create_open_list_client(
    @open-list.Settings::new("https://openlist.example.com"),
    @open-list.Credentials::password("admin", "your-password"),
  )

  try {
    let entries = client.fs().list("/")
    println("共 \{entries.total} 项")
    println(client.public().init_status().initialized)
  } catch {
    @open-list.OpenListError::Api(error) => println("业务错误 \{error.code}: \{error.message}")
    error => println("请求失败：\{error.message()}")
  }
}

#六个子模块

#文档

#开发

moon check        # 静态检查
moon test         # 全部测试（不联网，注入 Mock 传输层）
moon fmt          # 格式化
moon info         # 更新 .mbti
moon run src/main # 真机联调程序（永久 token 模式，见 docs/09）

#已知限制

• 账号密码凭证下，并发首次调用可能发出两次登录请求（结果一致）。
• token 过期不主动刷新，只在这次请求收到 401 时重登一次。
• 时间统一是 RFC3339 字符串；开放取值集合用 String / Int，不建枚举。
• SSO、WebAuthn、任务域、扫描、种子等未封装，见 docs/08。