chore(workspace): 补全 workspace 元数据，统一各 crate 发布字段

Author: KercyDing

.github/workflows/check.yml

@@ -29,4 +29,4 @@ jobs:
 
       - run: cargo clippy --workspace -- -D warnings
 
-      - run: cargo test --workspace --features sculk-core/ci
+      - run: cargo test --workspace --features sculk/ci

Cargo.lock

@@ -2,8 +2,16 @@
 members = ["core", "cli", "tui"]
 resolver = "3"
 
+[workspace.package]
+authors = ["KercyDing"]
+edition = "2024"
+license = "GPL-3.0"
+repository = "https://github.com/KercyDing/sculk"
+rust-version = "1.89"
+version = "0.1.0"
+
 [workspace.dependencies]
-sculk-core = { path = "core" }
+sculk = { path = "core", version = "0.1.0" }
 anyhow = "1.0"
 iroh = "0.96"
 tokio = { version = "1.49", features = ["full"] }

Cargo.toml

@@ -34,11 +34,11 @@ check:
 
 # 离线测试
 test:
-    cargo nextest run --workspace --features sculk-core/ci --no-tests=pass
+    cargo nextest run --workspace --features sculk/ci --no-tests=pass
 
 # 网络集成测试
 test-e2e:
-    cargo nextest run -p sculk-core --test p2p_test --no-tests=pass
+    cargo nextest run -p sculk --test p2p_test --no-tests=pass
 
 # 全量测试
 test-all: test test-e2e

Justfile

@@ -1,9 +1,13 @@
 # sculk
 
+[![crates.io](https://img.shields.io/crates/v/sculk.svg)](https://crates.io/crates/sculk)
+[![docs.rs](https://docs.rs/sculk/badge.svg)](https://docs.rs/sculk)
+[![license](https://img.shields.io/crates/l/sculk.svg)](LICENSE)
+
 一个面向 Minecraft 联机的 P2P 隧道项目，基于 iroh/QUIC，提供：
 - `sculk`：命令行客户端（CLI）
 - `sculk-tui`：终端图形客户端（TUI）
-- `sculk-core`：可复用隧道核心库
+- `sculk`：可复用隧道核心库
 
 > Sculk（幽匿）是 Minecraft 深暗之域中悄然蔓延的脉络，无声地在节点间传递信号。
 > 
@@ -13,7 +17,7 @@
 
 这是一个 Rust workspace：
 
-- `core` (`sculk-core`)：隧道能力与票据协议
+- `core` (`sculk`)：隧道能力与票据协议
   - `IrohTunnel::host/join`
   - `Ticket`（`sculk://...`）
   - `TunnelConfig` / `TunnelEvent`
@@ -42,25 +46,35 @@
 #### macOS / Linux
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/install/install.sh | sh
+sh -c "$(curl -fsSL https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/install/install.sh)"
 ```
 
 #### Windows PowerShell
 
 ```powershell
-irm https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/install/install.ps1 | iex
+& $([scriptblock]::Create((irm https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/install/install.ps1)))
 ```
 
 脚本会交互式询问安装：
 1. `sculk`
 2. `sculk-tui`
 3. 全部
 
-### 方式二：从源码安装
+### 方式二：从 crates.io 安装
+
+```sh
+cargo install sculk-cli
+cargo install sculk-tui
+```
+
+### 方式三：从源码安装
 
 ```sh
 cargo install --path cli
 cargo install --path tui
+
+# 或使用 just
+just install-all
 ```
 
 ## 卸载
@@ -70,13 +84,13 @@ cargo install --path tui
 #### macOS / Linux
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/uninstall/uninstall.sh | sh
+sh -c "$(curl -fsSL https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/uninstall/uninstall.sh)"
 ```
 
 #### Windows PowerShell
 
 ```powershell
-irm https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/uninstall/uninstall.ps1 | iex
+& $([scriptblock]::Create((irm https://raw.githubusercontent.com/KercyDing/sculk/main/scripts/uninstall/uninstall.ps1)))
 ```
 
 ### Cargo 卸载（注意包名）

README.md

@@ -1,10 +1,20 @@
 [package]
 name = "sculk-cli"
-version = "0.1.0"
-edition = "2024"
+categories = ["network-programming", "command-line-utilities"]
+description = "Minecraft P2P multiplayer tunnel CLI"
+documentation = "https://docs.rs/sculk-cli"
+include = ["/src/**", "/Cargo.toml", "/README.md"]
+keywords = ["minecraft", "p2p", "tunnel", "cli"]
+readme = "README.md"
+authors.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+version.workspace = true
 
 [dependencies]
-sculk-core = { workspace = true, features = ["persist", "clipboard"] }
+sculk = { workspace = true, features = ["persist", "clipboard"] }
 anyhow.workspace = true
 clap.workspace = true
 tokio.workspace = true

cli/Cargo.toml

@@ -0,0 +1,95 @@
+# sculk-cli
+
+Minecraft P2P multiplayer tunnel CLI, built on [sculk](https://crates.io/crates/sculk).
+
+## Installation
+
+```sh
+cargo install sculk-cli
+```
+
+> The binary is named `sculk`, the crate name is `sculk-cli`.
+
+## Usage
+
+### Host
+
+```sh
+sculk host
+```
+
+Options:
+- `-p <PORT>` — Local MC server port (default: 25565)
+- `--password <PWD>` — Connection password
+- `--max-players <N>` — Maximum player count
+- `--relay <URL>` — Override relay address
+- `--new-key` — Force generate a new secret key
+
+### Join
+
+```sh
+sculk join "sculk://..."
+```
+
+Options:
+- `-p <PORT>` — Local inbound listen port (default: 30000)
+- `--password <PWD>` — Join password
+- `--max-retries <N>` — Max reconnection attempts (omit for unlimited)
+
+### Relay Configuration
+
+```sh
+sculk relay --list
+sculk relay --url https://your-relay.example.com
+sculk relay --reset
+```
+
+---
+
+## 中文说明
+
+Minecraft P2P 联机隧道命令行客户端，基于 [sculk](https://crates.io/crates/sculk)。
+
+### 安装
+
+```sh
+cargo install sculk-cli
+```
+
+> 二进制名是 `sculk`，Cargo 包名是 `sculk-cli`。
+
+### 使用
+
+#### 建房
+
+```sh
+sculk host
+```
+
+常用参数：
+- `-p <PORT>` — 本地 MC 服务端端口（默认 25565）
+- `--password <PWD>` — 连接密码
+- `--max-players <N>` — 最大玩家数
+- `--relay <URL>` — 覆盖 relay 地址
+- `--new-key` — 强制生成新密钥
+
+#### 加入
+
+```sh
+sculk join "sculk://..."
+```
+
+常用参数：
+- `-p <PORT>` — 本地入站监听端口（默认 30000）
+- `--password <PWD>` — 加入密码
+- `--max-retries <N>` — 最大重连次数（不传=无限）
+
+#### 中继配置
+
+```sh
+sculk relay --list
+sculk relay --url https://your-relay.example.com
+sculk relay --reset
+```
+
+更多信息见[项目主页](https://github.com/KercyDing/sculk)。

cli/README.md

@@ -9,8 +9,8 @@ use std::path::PathBuf;
 use std::time::Duration;
 
 use clap::{CommandFactory, Parser, Subcommand};
-use sculk_core::persist::{self, Profile};
-use sculk_core::tunnel::{IrohTunnel, TunnelConfig, TunnelEvent};
+use sculk::persist::{self, Profile};
+use sculk::tunnel::{IrohTunnel, TunnelConfig, TunnelEvent};
 use tracing_subscriber::EnvFilter;
 
 const CLAP_STYLES: clap::builder::styling::Styles = clap::builder::styling::Styles::styled()
@@ -41,7 +41,7 @@ enum Commands {
     /// 作为房主启动并暴露本地 MC 服务端
     Host {
         /// 本地 Minecraft 服务端端口
-        #[arg(short, long, default_value_t = sculk_core::DEFAULT_MC_PORT)]
+        #[arg(short, long, default_value_t = sculk::DEFAULT_MC_PORT)]
         port: u16,
         /// 强制重新生成新密钥
         #[arg(long)]
@@ -67,7 +67,7 @@ enum Commands {
         /// 房主提供的 ticket
         ticket: String,
         /// 本地给 MC 客户端连接的端口
-        #[arg(short, long, default_value_t = sculk_core::DEFAULT_INLET_PORT)]
+        #[arg(short, long, default_value_t = sculk::DEFAULT_INLET_PORT)]
         port: u16,
         /// 路径状态打印间隔（秒，默认 0: 仅变化时输出）
         #[arg(short, long, default_value_t = 0)]
@@ -138,7 +138,7 @@ async fn run_command(cli: Cli) -> anyhow::Result<()> {
             let quoted = format!("\"{ticket_str}\"");
             println!("Ticket: {quoted}");
 
-            if sculk_core::clipboard::clipboard_copy(&quoted) {
+            if sculk::clipboard::clipboard_copy(&quoted) {
                 println!("(Copied to clipboard)");
             }
 
@@ -166,7 +166,7 @@ async fn run_command(cli: Cli) -> anyhow::Result<()> {
             password,
             max_retries,
         } => {
-            let ticket: sculk_core::tunnel::Ticket =
+            let ticket: sculk::tunnel::Ticket =
                 ticket.parse().map_err(|e| anyhow::anyhow!("{e}"))?;
             if let Some(ref url) = ticket.relay_url {
                 println!("Relay: {url}");
@@ -274,7 +274,7 @@ mod tests {
     fn parse_join_defaults() {
         let cli = Cli::try_parse_from(["sculk", "join", "ticket"]).expect("parse join");
         assert!(
-            matches!(cli.command, Commands::Join { port, .. } if port == sculk_core::DEFAULT_INLET_PORT)
+            matches!(cli.command, Commands::Join { port, .. } if port == sculk::DEFAULT_INLET_PORT)
         );
     }
 }

cli/src/main.rs

@@ -1,7 +1,17 @@
 [package]
-name = "sculk-core"
-version = "0.1.0"
-edition = "2024"
+name = "sculk"
+categories = ["network-programming", "game-development"]
+description = "P2P tunnel core library for Minecraft multiplayer"
+documentation = "https://docs.rs/sculk"
+include = ["/src/**", "/Cargo.toml", "/README.md"]
+keywords = ["minecraft", "p2p", "tunnel", "quic", "iroh"]
+readme = "README.md"
+authors.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+version.workspace = true
 
 [features]
 default = []