# crosslink工具包

**Repository Path**: shendong0313/crosslink-tools

## Basic Information

- **Project Name**: crosslink工具包
- **Description**: crosslink固件相关的工具包
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Crosslink Calibre 插件安装与使用说明

## 一、需要安装的插件

Crosslink 的 Calibre 集成需要安装两个插件：

1. **设备插件**  
   `crosslink_reader_device_with_menu.zip`

2. **菜单插件**  
   `crosslink_send_menu_plugin.zip`

两个都需要安装，不能只装其中一个。

---

## 二、安装插件

1. 打开 **Calibre**
2. 点击顶部菜单：  
   **首选项 / Preferences**
3. 进入：  
   **插件 / Plugins**
4. 点击右下角：  
   **从文件加载插件 / Load plugin from file**
5. 选择第一个插件：  
   `crosslink_reader_device_with_menu.zip`
6. 按提示确认安装
7. 再次点击：  
   **从文件加载插件 / Load plugin from file**
8. 选择第二个插件：  
   `crosslink_send_menu_plugin.zip`
9. 安装完成后，**重启 Calibre**

---

## 三、确认插件已安装

重启 Calibre 后，进入：

**首选项 / Preferences → 插件 / Plugins**

应该能看到：

- **Crosslink Reader**
- **Crosslink Send Local Files Menu**

如果都能看到，说明安装成功。

---

## 四、连接 Crosslink 设备

1. 打开 Crosslink 设备的无线传书/网络服务功能
2. 确保电脑和 Crosslink 设备在同一个网络下
3. 回到 Calibre
4. 等待 Calibre 自动发现 Crosslink 设备

如果没有自动发现，可以到插件配置里检查设备地址。

路径：

**首选项 / Preferences → 插件 / Plugins → Device Interface plugins / 设备接口插件 → Crosslink Reader → Customize plugin / 自定义插件**

默认配置：

- Host：`192.168.4.1`
- Port：`81`
- Upload path：`/`

---

## 五、发送本地 EPUB 到 Crosslink

安装菜单插件后，可以通过菜单发送本地文件。

1. 在 Calibre 顶部找到 **Crosslink** 菜单
2. 点击：

   **发送本地epub到Crosslink**

3. 选择本地的 `.epub` 文件
4. 可以一次选择一个或多个文件
5. 确认后，插件会把文件发送到 Crosslink 设备

发送时使用的是**本地文件原始文件名**，不会使用 Calibre 的拼音名或内部编号。

---

## 六、如果看不到 Crosslink 菜单

如果安装后没有看到 **Crosslink** 菜单，可以手动添加到工具栏：

1. 打开 Calibre
2. 进入：

   **首选项 / Preferences → 工具栏与菜单 / Toolbars & menus**

3. 在可用动作里找到：

   **Crosslink**

4. 把它添加到主工具栏或菜单栏
5. 保存后重启 Calibre

然后再点击：

**Crosslink → 发送本地epub到Crosslink**

---

## 七、备用入口

如果菜单入口不可用，还可以从插件配置页发送：

1. 进入：

   **首选项 / Preferences → 插件 / Plugins**

2. 找到：

   **Device Interface plugins / 设备接口插件 → Crosslink Reader**

3. 点击：

   **Customize plugin / 自定义插件**

4. 点击：

   **发送本地epub到Crosslink**

5. 选择本地 EPUB 文件发送

---

## 八、常见问题

### 1. 为什么要安装两个插件？

Calibre 的插件机制限制，一个插件 zip 只能作为一种插件类型加载。

Crosslink 需要两个能力：

- 作为设备出现在 Calibre 中
- 在菜单里提供“发送本地epub到Crosslink”

这两个能力对应 Calibre 的两种插件类型，所以需要安装两个插件。

---

### 2. 发送到设备后文件名会变吗？

使用 **发送本地epub到Crosslink** 功能时，文件名使用本地文件的原始文件名。

例如本地文件叫：

```text
三体.epub
```

发送到设备后仍然是：

```text
三体.epub
```

---

### 3. Calibre 自带的“发送到设备”会保留原文件名吗？

不一定。

Calibre 自带发送逻辑可能会根据书名、作者、模板、拼音规则重新生成文件名。

如果想保留本地文件名，请使用：

**Crosslink → 发送本地epub到Crosslink**

---

### 4. 发送失败怎么办？

请检查：

- Crosslink 设备是否已开启网络传书服务
- 电脑和设备是否在同一个 Wi-Fi 网络
- 插件配置里的 Host 和 Port 是否正确
- 防火墙是否阻止 Calibre 访问局域网
- 设备存储空间是否充足

可以先在浏览器里访问设备的 Web 页面，确认电脑能连到设备。