慧星传书 阅星曈（XTEINK）传书智能体 XTEAILINK
为阅星曈（XTEINK）电子纸(X4)阅读器提供智能传书服务的智能体系统，支持多种格式传书、AI智能电子期刊的生成以及MCP服务！
功能特性
- 智能传书服务 - 相比阅星曈自带传书功能需要先将电子纸连接网络，慧星传书上传后加入队列，系统会自动等待电子纸连接网络后主动传书（这非常适合Nas使用！）
- 智能格式转换 - 支持带图mobi，带图epub等转换为XTC格式，畅享轻小说阅读体验
- AI 电子期刊 - 支持流式SteamableHTTP的MCP和生图能力的对话式智能体，助您生成图文并茂的电子期刊并传到您的阅星曈，畅享优质阅读体验
- MCP支持 - 开放SteamableHTTP MCP服务，支持cherrystodio，claude code等工具连接到慧星传书
- 传书内容加入队列，想下载时，直接点开阅星曈的电脑传书，智能体会自动将队列中的文件推送到电子纸中！
ToDo
- 定时订阅，支持每天订阅电子期刊
- RSS订阅和网页内容获取的油猴脚本
- 传书自动整理
- MCP服务支持XTC构建
AI功能配置
- 大模型：支持openAI兼容大模型，需要具有工具调用能力：推荐glm-4.7,minimax-2.1,DeepSeek-V3.2
- MCP：支持所有的SteamableHTTP的MCP服务，推荐智谱搜索。
- 生图：仅支持modelscope提供的生图模型和字节火山引擎生图模型，使用字节字节火山引擎需要在requirements.txt中添加
volcengine-python-sdk[ark]
通过一个modelscope api-key白嫖所有AI功能
大模型、生图、联网搜索？配置太复杂，要花钱？？ 感谢modelscope的免费白嫖api，让我们能用一个api-key白嫖XTEAILINK的所有ai功能！
- 创建一个 modelscope 账号
- 获取api-key（右上角-账号设置-访问令牌,建议建立一个新的长期访问令牌）
- MCP广场-必应搜索中文-服务配置，配置长期的bing搜索服务，获取url
- 在慧星传书智能体右下角ai助手中配置：大模型url和api-key，生图api-key，bing搜索url和api-key
当前modelscope暂时不支持白嫖GLM4.7了，暂时建议使用deepseek-ai/DeepSeek-V3.2
致谢
epub2xtc
用于生成 XTEINK 电子书格式的转换工具
- GitHub: epub2xtc
- 功能: 将 EPUB 转换为 XTC/XTG 格式，支持 PNG 图片处理
XtcViewer
XTC查看器
- GitHub: XtcViewer
xtctool
转换为XTC、XTG、XTH的实现 -xtctool
z code
本项目完全使用智谱z code和GLM-4.7 vibecoding完成！
快速开始
使用 Docker 部署（推荐）
nas部署
以飞牛fnos为例。
- 文件上传到nas
- 先从镜像仓库拉一个ubuntu，方便基础镜像的拉取
- Docker-Compose-新增项目 路径选择项目目录，提示所选择的路径包含docker-compose，确定，构建后启动容器。
- 访问服务：http://nas-ip:8098
docker-compose
- 克隆项目并进入目录：
cd XTEAILINK- 使用 Docker Compose 启动服务：
docker-compose up -d --build- 访问服务：
- 主服务：http://localhost:8098
- mcp：http://localhost:8099/mcp
docker部署使用ubuntu作为基础镜像，并基本完全配置国内源，您可以自行替换为别的基础镜像。（修改Dockerfile最上边的FROM ubuntu为你的基础镜像）
Windows运行
release版本
- 下载release版本：
国内可从网盘下载 百度网盘
- 双击
一键启动.bat运行
源码版本
- 安装依赖：
你的电脑需要有python环境和uv，如果没有uv请安装uv
pip install uv- 启动服务：
# 推荐使用 start.bat（Windows）
start.bat- 访问服务：
配置
配置文件位于 config/ 目录下：
config.json- 主配置文件ai_config.json- AI 相关配置，也可以在前端配置
请根据需要修改配置文件中的参数。
端口
系统暴露以下端口：
8098- Web 服务主端口（传书服务界面）8099- MCP端口
MCP
你可以用 http://服务器地址:8099/mcp 连接到SteamableHTTP的MCP服务，可让LLM将任何内容转为txt，直接传输到您的电子纸！
项目结构
XTEAILINK/
├── src/ # 源代码目录
│ ├── web_server.py # Web 服务器
│ ├── chat_service.py # AI助手
│ ├── conversion_service.py # 转换服务
│ └── mcp/ # MCP 服务器
├── static/ # 静态资源
│ ├── js/ # JavaScript 文件
│ └── output/ # 输出文件目录
├── templates/ # HTML 模板
├── config/ # 配置文件
├── tool/ # 工具脚本
├── requirements.txt # Python 依赖
├── Dockerfile # Docker 构建文件
├── docker-compose.yml # Docker Compose 配置
└── README.md # 项目说明常见问题
docker构建失败，我拉不下来ubuntu镜像
请用记事本或编辑器打开Dockerfile，将第一行FROM ubuntu改为FROM docker.xuanyuan.run/library/ubuntu:latest或是FROM docker.1ms.run/library/ubuntu:latest,尝试从国内源拉取。
windows使用realease版本一键启动失败
可能是uv无法自动获取合适的python版本，尝试自行安装一个python3.12