# crosspoint_chinesetype **Repository Path**: allocated/crosspoint_chinesetype ## Basic Information - **Project Name**: crosspoint_chinesetype - **Description**: 基于阅星曈xteink x4优化 禁商业化 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 16 - **Forks**: 3 - **Created**: 2026-02-01 - **Last Updated**: 2026-05-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 版本信息 第一次写固件，欢迎大家指导批评~ 可以的话点点star⭐，谢谢 本项目目前仅支持阅星曈xteink x4.即将支持适配x3，敬请期待 ！！支持学习，反对商业化，请注意开源协议为AGPL 3.0 开源协议具有传染性，请注意 基于 **crosspoint 1.0.0** 版本修改而来，主要为了适配中文读者，另外希望能够完成自己想要的一些小功能，感谢以下开源项目及其贡献者： - 参考改版项目：[crosspoint-reader](https://github.com/crosspoint-reader/crosspoint-reader) - 自选字体功能参考：[ruby-builds/crosspoint-reader (custom-fonts分支)](https://github.com/ruby-builds/crosspoint-reader/tree/feature/custom-fonts) - 字体制作工具：[ZYFDroid/crosspointcn-fontcreator](https://github.com/ZYFDroid/crosspointcn-fontcreator) - 蓝牙功能参考：[thedrunkpenguin/crosspoint-reader-ble](https://github.com/thedrunkpenguin/crosspoint-reader-ble) - 键盘QR输入:[QR_input](https://github.com/crosspoint-reader/crosspoint-reader/pull/839) --- # 开放贡献式 已发详细功能介绍： http://xhslink.com/o/4wo6yvTUpvn 多多少少的贡献都可以哈，有编程能力的都可以玩一下，不用加我联系方式，当然，想加也欢迎，不是不欢迎哈哈哈哈，不过尽量聊固件，去掉无用社交，咱们就是开放式玩起来。 如果有实在搞不懂的，可以小红书@allocate 私聊发送代码给我，以及想如何提及你（github名 gitee名或者小红书名字或者什么昵称之类的），我将把你加入贡献者 如何贡献？ 分叉仓库：Fork the repo 创建分支 （feature/dithering-improvement)：Create a branch (feature/dithering-improvement) 基于最新master做出修改：Submit a PR 提交：Submit a PR # 改版说明 为避免争议，共同维护开源社区的和谐友好氛围。 如将固件在社交平台分享并传递给别人，需要遵循APGL开源协议（请注意这是强传染开源协议）， 并在发布的第一时间以第一段落的形式阐明你本人的贡献功能（不可以小字等特殊格式，需要与正文格式一致），为避免春秋笔法，本人做一个示例吧： 如：开源库原版作者为@allocate ，本人在原版基础上增加以下功能：功能1、功能2、功能3...。(仅为示例，并无强制三个功能的要求) 然后后面想写啥写啥 开源库的readme部分：需要复制我版本信息里感谢的这些库，并将我列为参考改版项目。感谢理解。 # 闭源维护 卷土重来，从内耗型人格改为外耗型 等我周末放代码，连同一个静态网站的demo会放在主页另一个库吧，到时候新建一个，收集我的一些弃案，期待焕发新的生机， 当然，这部分肯定不是AGPL开源协议hhh，会更开放一点，但是同样禁商业化吧 ---- 之前写的： 固件发展至今，本人不会再继续进行功能研究，仅对目前的问题进行解决。 后续刷过的可以通过ota来更新，debug以及等待crosspoint海外组对中日韩的适配（一直不改分区表也是这个原因，想无缝接入海外组），相信已经不远了。 如果后续改版我的项目需要 @allocated 我，不然不要怪我说话难听了。 以下是一些碎碎念，不用看 不会再对阅星曈及任何商家进行无私贡献，开源目前来说弊大于利，以后自己玩自己的开发板了。 目前的代码库不会删除，因为我觉得中文的阅读器epub解析开源源代码很少。 crosspoint作为一个能在eps32-c3 仅可用内存300k不到的一个如此有限的板子上流畅运行的系统，是非常难得的，它的价值远不止于此。它的存在证明了现在的阅读器其实都可以进行一个内存优化，可以用更便宜的设备进行一个更好的效果。 目前展示版本不包含我写好的txt解析代码 图片解析代码以及后面的功能。不过我觉得目前展示的部分已经足够了，想根据这个版本写后面的功能非常简单。 后面还有一个简单demo可能放出，是之前梦西游大佬在s3上展示微信读书的时候我感觉非常有意思自己研究的，原理很简单，我后面觉得没什么用，就没展示，谁想玩可以玩玩。 xteink x4为什么国外的开发环境可以做到这么好，而国内本来做的人就少，开源的更少，不过目前的环境我感觉大家也都能理解。 --- # 免责声明 刷机风险自担。根据阅星曈官方来说，意思是刷机不保修，自行判断吧。 --- # 当前进度 - **EPUB**：排版完成。 - **XTC**：实现动态管理功能 - **TXT**：已全部完成，排版完成。支持utf-8的文件。 --- # 阅读文本 中英文均可 ## 一、刷机说明 ### 1.1 刷机准备 - **TypeC 数据线** - **电脑** ### 1.2 刷机步骤 1. 下载 Release 页面下的 bin 文件 2. 打开网页：https://xteink.dve.al/ 3. 首次刷机建议备份官方固件：在 `full flash controls` 界面，选择 `save full flash` 4. 在 `OTA fast flash controls` 部分选择下载好的 bin 文件，点击 `flash firmware from file` 5. 先短按复位键（SD 卡附近），再长按电源键 --- ## 二、Epub 阅读 ### 2.1 注意事项 首次进入 Epub 阅读需要缓存一段时间，请耐心等待。 ### 2.2 操作界面说明 1. 进入阅读界面后，**短按确认键**进入菜单 2. 菜单栏支持：目录、阅读方向、直达进度、进度同步（koreader 开源阅读）、清理缓存等 3. 目录页面操作： - 短按 `UP/DOWN`：菜单翻页 - 短按 `LEFT/RIGHT`：选项选择 - 长按 `LEFT/RIGHT`：菜单快速翻页 4. 边距设置： - 进入阅读界面后，**长按确认键**进入边距设置 - 短按/长按 `LEFT`：减少/增加左边距 - 短按/长按 `RIGHT`：减少/增加右边距 - 短按/长按 `UP`：减少/增加上边距 - 短按/长按 `DOWN`：减少/增加下边距 - 说明：边距设置在退出设置后生效，可通过黑框判断边距是否合适 5. 翻页操作： - 短按 `LEFT/UP`：上一页 - 短按 `RIGHT/DOWN`：下一页 - 长按 `LEFT/UP`：上一章 - 长按 `RIGHT/DOWN`：下一章 --- ## 三、XTC 格式说明 本人不再继续适配 XTC 格式，目前仅支持 `xtc(1bit)` 和 `xtch(2bit)`。 使用体验不如 Epub 和 TXT，建议优先使用后两者。 **菜单操作**： 确认键进入目录，短按 `UP/DOWN` 翻页，短按 `LEFT/RIGHT` 选择，长按 `LEFT/RIGHT` 快速翻页。 --- ## 四、TXT 阅读 **菜单操作**： 确认键进入目录，短按 `UP/DOWN` 翻页，短按 `LEFT/RIGHT` 选择，长按 `LEFT/RIGHT` 快速翻页。 注意：为了尽量少使用内存地打开大txt，进行了一些策略调整，所以如果看到empty file，直接确认键进入目录页，如果目录页空白，使用侧边键前后翻两下，拿到缓存就显示了。 --- ## 书签 1. xtc txt 长按确认键添加书签 2. epub在菜单栏添加书签 --- ## 五、自定义字体 1. 打开字体生成网站：https://epdfontweb.streamlit.app/ - 网站休眠时点击 `Yes, get this app back up!` 唤醒 2. 上传 `ttf/otf` 格式字体，选择常用5000字/7000字，调整字号、字距、灰度后生成并下载 3. 将生成的字体文件放入 `fonts/` 文件夹，**请勿使用特殊符号**，建议用中文/字母/数字命名 4. 进入：设置 → 系统设置 → 设置自定义字体，选择需要的字体即可 --- ## 六、坚果云 1. 在 设置 → 系统设置 中填写坚果云账号信息 2. 返回主页，点击「坚果云」，联网后点击确认键可下载文件 3. 下载的书籍保存在 SD 卡的 `坚果云/` 文件夹内 --- ## 七、开源阅读 App ⚠️ 开源阅读 App **必须配置坚果云 WebDav** 才能使用同步功能。 ### 7.1 同步书籍 1. 开源阅读 → 右上角三点 → 缓存/导出 → 离线缓存页面右上角三点 2. 点击「导出到 WebDav」，选择导出格式为 `epub`，选择书籍导出 ### 7.2 同步阅读进度 1. 开源阅读 → 我的 → 设置 → 备份与恢复 → 打开「同步阅读进度」 2. 设备端：打开需要同步的 Epub → 确认键 → 进度同步（开源阅读） 3. 配置 WiFi 后，可选择「下载云端进度」或「上传云端进度」 --- ## 八、图片选择器 选择图片进入后，支持以下操作： - 设为阅读背景 - 设为自定义睡眠屏 - 设为透明壁纸 - 旋转180度 - 左右翻转 --- ## 九、电源键操作 **双击电源键**进入功能切换模式，可设置： - 忽略 - 翻页 - 全刷 - 截屏 - wifi传书 截屏文件保存在 `screenshots/` 文件夹。 --- ## 十、文件管理器 支持功能：打开、删除、复制、剪切、粘贴、搜索、退出搜索 使用 `LEFT/RIGHT` 切换功能页面。 1. **删除**：需要**长按确认键**，防止误删 2. **复制/剪切**：操作后切换到目标目录，点击粘贴即可 3. **搜索**：仅支持搜索 2 个汉字，依靠手机传输，找到后直接打开；无需使用时点击退出搜索 --- ## 十一、蓝牙功能 如果谁想开发蓝牙功能的话，根据我的经验来说，蓝牙应该放在阅读内部，避免zip 蓝牙 png 三大块打架。 仅支持HID蓝牙设备，就目前的反馈来说，还有我个人的尝试来看，智联纵维的就不要想了，他家应该使用了一套加密方法，没有研究明白。 支持的设备：机械键盘（薄膜的就不要想了） 萝卜兔翻页器 free2翻页器 ，其他家的只能自行尝试了。 1.阅读界面菜单栏-bluetooth开启蓝牙并配对 2. 配对完成后开始按键映射--点击确认键 按下一个按键作为上一页--点击确认键，按下一个按键作为下一页 3. 蓝牙休眠时间和系统休眠时间绑定 4. 如需要开机就使用蓝牙，先开启翻页器，再开机 ---