Skip to main content

Tsugu User Data Server

Tsugu 用户数据库服务 CLI 实现

安装

pip install tsugu-uds

参数启动

tsugu-uds serve

相关参数可以在 help 中查看

tsugu-uds --help
tsugu-uds serve --help

启动服务器

使用Uvicorn ASGI服务器启动:

# 基本启动
tsugu-uds serve

# 指定日志级别
tsugu-uds serve --log-level debug

# 指定工作进程数
tsugu-uds serve --workers 4

# 调试模式启动
tsugu-uds serve --debug

配置文件启动

# 生成默认配置文件
tsugu-uds config new

# 使用配置文件启动(完全按配置文件设置)
tsugu-uds run

配置文件包含所有设置选项,可以手动编辑。关键配置项:

  • log_level: 日志级别(debug, info, warning, error)
  • workers: Uvicorn的工作进程数

数据库管理

tsugu-uds db --help

direct-unbind 模式

使用 direct-unbind 参数启动服务器可实现解除绑定不验证, 但请保证你的服务器处于安全的非公网环境下才建议开启此功能, 否则任何人都有可能解除绑定任何账号, 此功能设计用于快速解除绑定.

此参数启用后 bind_player_request api 会在返回结果中添加一个 extra 字段, 值为 "safe_mode", 用于区分当前服务器的运行模式. 同时 bind_player_verification api 会直接解除绑定后, 返回解除成功状态.

目前支持 direct-unbind 的实现可以参考 Tsugu-b3.

Metadata

Release files for tsugu-uds 1.0.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tsugu-uds 1.0.9
File Size Uploaded Provenance Actions
tsugu_uds-1.0.9.tar.gz 14.2 kB With provenance Details for tsugu_uds-1.0.9.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tsugu-uds 1.0.9
File Interpreter ABI Platform Actions
tsugu_uds-1.0.9-py3-none-any.whl Python 3 none any Details for tsugu_uds-1.0.9-py3-none-any.whl

Total release size: 28.9 kB

Release files / tsugu_uds-1.0.9.tar.gz

Download URL tsugu_uds-1.0.9.tar.gz
Size 14.2 kB
Tags Source
SHA-256 checksum
How to use checksums
581353bd11023223b2337672f2f5eff0c6d27967c7078586463c737cf5c42796
BLAKE2b-256 checksum
How to use checksums
89ccd8374c81afb22c1a718adf6b48013e84157ea534485673cdf0efa918f5c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 2, 2025.

Transparency log

Release files / tsugu_uds-1.0.9-py3-none-any.whl

Download URL tsugu_uds-1.0.9-py3-none-any.whl
Size 14.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ea5f3844a322d3106e331cb2cfa656c140a3838877eb350f2c4ebf27fc310198
BLAKE2b-256 checksum
How to use checksums
1c82a95f20a4e70a9cac535ef5992ea9bf4cc82cfb201dcca31824a631d41543
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 2, 2025.

Transparency log

Security for tsugu-uds 1.0.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for tsugu_uds-1.0.9.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 2, 2025.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page