加入ReadAny社区:微信/小红书/爱发电支持,如何反馈Bug与参与开源共建
【免费下载链接】ReadAnyAI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.项目地址: https://gitcode.com/gh_mirrors/re/ReadAny
ReadAny 是一款 AI 驱动的跨平台电子书阅读器,内置语义搜索、RAG 智能问答、本地向量库、笔记、TTS 朗读和 WebDAV 同步等功能。本文带你 3 步加入 ReadAny 社区(微信群 / 小红书群 / 爱发电),并学会在应用内一键反馈 Bug、参与开源共建,无论是新手还是老用户都能快速上手 📚
为什么需要加入 ReadAny 社区
ReadAny 覆盖桌面端(Tauri)与移动端(iOS / Android),你在任何一端遇到的使用问题、功能建议,都能通过社区获得响应:
- 微信群:日常使用答疑、版本更新通知、用户交流;
- 小红书群:阅读技巧分享、AI 阅读玩法讨论;
- 爱发电支持:如果你认可这个开源项目,可以通过爱发电为持续开发助力 ☕
官方社区入口维护在 Community.astro 中,官网的"社区与支持"板块会同步展示入群二维码和反馈渠道。
3 步加入 ReadAny 微信群 / 小红书群
- 获取入群方式:在仓库根目录的 README_CN.md 的"社区"一栏,可以找到小红书群与微信群的二维码;
- 扫码进群:手机端直接扫描对应二维码即可,建议优先加入微信群,答疑最及时;
- 自我介绍 + 提问:进群后简单说明你使用的平台(Windows / macOS / iOS / Android)和版本,提问效率更高。
💡 提示:如果你在小红书上搜索 ReadAny,也能找到官方分享帖,评论区通常附有入群方式。
ReadAny 如何反馈 Bug:应用内一键提交
ReadAny 内置了完整的反馈系统,你甚至不需要打开网页就能提交 Bug 报告 🐛
桌面端:设置 → 反馈建议
打开设置对话框中的"反馈建议"页面(源码见 FeedbackSettings.tsx),流程非常简单:
- 选择类型:Bug / 建议 / 其他,三选一;
- 填写标题和详细描述:写清"做了什么 → 期望结果 → 实际结果";
- 勾选"上传应用日志":默认附带最近 1 小时的诊断日志,日志中的敏感信息(密码、Token 等)会自动脱敏,详见日志清洗逻辑 feedback-service.ts;
- 点击提交:反馈会自动创建一个 Issue,提交成功后你能看到对应的 Issue 编号。
移动端:设置 → 反馈
移动端入口在 FeedbackScreen.tsx,功能与桌面端一致。值得注意的细节:
- 每设备每天最多提交3 次,防止刷屏;
- 在"我的反馈"标签页可以追踪每条反馈的状态(处理中 / 已关闭);
- 开发者回复后,反馈列表会出现红点提醒,点开即可看到完整评论。
反馈是如何被处理的
应用内反馈会通过一个 Cloudflare Worker 自动转为 Issue 工单(见 feedback-worker/README.md),开发者在工单系统里统一分诊。你提交时附带的设备信息(平台、系统版本、App 版本、语言环境)会帮助团队更快复现问题。
支持开源:爱发电与其他方式
ReadAny 采用 GPL-3.0 协议开源(见 LICENSE),源码完全免费。官方提供了多种支持方式:
- 爱发电:在官网社区板块可找到"餐桌"入口,适合想长期支持项目的用户;
- 社区活跃:参与讨论、提交 Issue、帮忙验证 Bug 修复,同样是零成本的支持;
- 推荐分享:把 ReadAny 推荐给同样喜欢阅读的朋友 👍
参与 ReadAny 开源共建:从 Fork 到 PR
想写代码贡献?流程很标准,三步走 🚀
第一步:克隆仓库
git clone https://gitcode.com/gh_mirrors/re/ReadAny环境要求:Node.js ≥18、pnpm ≥9,桌面端开发还需 Rust(Tauri 需要);移动端需要 Xcode 或 Android Studio。
第二步:了解代码结构
仓库是 monorepo 结构,核心代码在这里:
- 核心库(RAG、反馈、同步、统计等):packages/core/
- 桌面端应用(Tauri + React):packages/app/
- 移动端应用(Expo / React Native):packages/app-expo/
- 官网(Astro + Starlight 文档站):website/
第三步:开发、提交、PR
- Fork 后创建特性分支;
- 本地开发并运行
pnpm lint确保代码风格一致; - 提交 Pull Request,附上问题描述和截图。
即使是新手,也可以从这些低门槛任务入手:修复文案错别字、补充 docs/ 下的设计文档、翻译 i18n 语言包(已覆盖 80+ 语言文件)。
常见问答 FAQ
Q:反馈提交后多久有回复?A:开发者会定期处理,可在"我的反馈"里查看状态;有新回复时应用会显示红点提醒。
Q:附带日志会不会泄露隐私?A:不会。日志在提交前会经过脱敏处理,密码、Token、敏感 URL 等字段均被自动替换,见 sanitizeLogLine。
Q:不写代码也能贡献吗?A:可以。报告高质量 Bug、参与社区讨论、完善文档和翻译,都是项目非常需要的贡献。
Q:未来还有哪些社区计划?A:参考 README_CN.md 的开发路线,官方云同步、插件系统、更多 AI 模型都在路上,欢迎在社区提前提出你的需求优先级建议。
加入 ReadAny 社区只需扫一个码,反馈 Bug 只需填一张表单,参与共建只需一个 PR。现在就去 README_CN.md 找到二维码,和更多阅读爱好者一起,把这款 AI 电子书阅读器变得更好吧 ✨
【免费下载链接】ReadAnyAI-powered cross-platform e-book reader with semantic search, RAG chat, local vector store, notes, TTS, and WebDAV sync.项目地址: https://gitcode.com/gh_mirrors/re/ReadAny
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考