本项目仅供学习、研究和个人技术参考使用。

本项目涉及的能力均基于网盘服务提供方的官方开放接口，不包含破坏、绕过、破解官方接口或服务限制的行为。当前项目仅面向已拥有正版 SVIP 会员权益的账号使用者，用于在合法、合规、符合服务条款的前提下进行本地化管理和调用。

使用者应自行确认其账号、接口调用、数据处理和使用场景符合相关法律法规、平台服务协议以及授权范围。任何超出个人学习研究范围的使用，尤其是未经授权的商业用途、批量化调用、转售、共享账号权益或其他违反平台规则的行为，均可能导致账号限制、封禁、IP 限制、权益回收或其他法律及商业风险。

因使用者违反法律法规、平台规则、服务协议或授权范围而产生的任何后果，包括但不限于限速、封号、数据损失、权益损失、纠纷、索赔或其他风险，均由使用者自行承担，与本项目作者无关。

Open LC is the open-source LC Agent package exported from the LC monorepo.

It provides a local Agent API, a web console, desktop builds, Docker deployment, and the public LC v0 Broker protocol documents needed to build compatible Broker services.

• Local Agent API powered by Bun and Hono
• Web console built with Vite and React
• Desktop packaging through Electrobun
• Docker image for local or server deployment
• SQLite storage with Drizzle migrations
• Agent-facing Broker protocol documentation

Release assets are published when a vX.Y.Z tag is pushed.

Docker images are built for linux/amd64 and linux/arm64.

If macOS reports that LC Agent cannot be opened, remove the downloaded app quarantine attribute after installing it:

sudo xattr -r -d com.apple.quarantine /Applications/LC\ Agent.app

docker run --rm -p 3100:3100 -v open-lc-data:/data ghcr.io/leuki/open-lc:latest

The Docker image runs the Agent API and serves the built web console from the same process.

Docker Compose example:

services:
  open-lc:
    image: ghcr.io/leuki/open-lc:latest
    container_name: open-lc
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - open-lc-data:/data

volumes:
  open-lc-data:

bun install
bun run dev:agent-api
bun run dev:agent-web

Defaults:

• Agent API: http://localhost:3100
• Agent Web: http://localhost:5174/#/
• SQLite database: data/agent.sqlite

bun run dev:agent-desktop

Agent settings can be configured from the local web console. LC_AGENT_* environment variables are also read as fallbacks.

Common runtime paths:

• Database: LC_AGENT_DATABASE_URL
• Web console build: LC_AGENT_WEB_DIST_DIR
• Database migrations: LC_AGENT_MIGRATIONS_DIR
• Temporary files are managed by the local Agent runtime.

Do not commit real cookies, generated direct links, local SQLite files, or local environment files.

Open LC includes the public Agent-facing LC v0 Broker protocol so that third-party Broker implementations can be built without copying the official Broker service.

Start with:

• docs/broker-protocol/README.md
• docs/broker-protocol/AGENT_API.md
• docs/broker-protocol/STATE_MACHINE.md
• docs/broker-protocol/ERROR_CODES.md
• docs/broker-protocol/POLLING_LEASE.md

A compatible Broker must keep the Agent-facing HTTP contract and state behavior compatible. It does not need to copy the official Broker database schema, admin console, user frontend, or settlement implementation.

Thanks to the LinuxDo community for the discussions and feedback that inspired this project.

MIT License. See LICENSE.