any-reader-ui

KO | EN

gitlite — search

#python #hacktoberfest #ai #llm #golang #android #machine-learning #rust #deep-learning #docker #awesome #security #mcp #ios

(★ 18)

No description available.

any-reader-ui Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>AnyReader · 十二问</h1>

<p><b>为深度阅读与对话式学习而生的现代知识库</b></p>

<p>
  Markdown · 数学公式 · 思维导图 · 协作勘误 · AI 学习伙伴
</p>

<p>
  <a href="./README.md">简体中文</a>
  &nbsp;·&nbsp;
  <a href="./README.en.md">English</a>
</p>

</div>

---

## ✨ 这是什么

**AnyReader（十二问）** 是一个面向**深度阅读**与**对话式学习**的现代知识库平台。

它把你长期积累的 Markdown 笔记、教材讲义、研究材料、Obsidian 知识库，重新组织成可以被**结构化阅读、标注勘误、AI 协助理解**的知识资产。

它和你熟悉的工具不同：

- 它不是写作工具 —— 它专注**阅读与思考**。
- 它不是 PDF 阅读器 —— 它围绕**结构化 Markdown** 重新定义阅读体验。
- 它也不止是一个阅读器 —— 内置 **Socratic 式 AI 学习伙伴**，让单向阅读变成双向对话。

> 「读得更慢，但理解得更深」是 AnyReader 想为你做的事。

## 📸 产品速览

<table>
<tr>
<td width="50%">
<img src="assets/feature-ask-flow.gif" alt="划线追问 · 解题流程" />
<p align="center"><sub>划线追问：选段 → 右键 → AI 流式解答，LaTeX 公式直接渲染</sub></p>
</td>
<td width="50%">
<img src="assets/feature-socratic.gif" alt="苏格拉底学堂" />
<p align="center"><sub>苏格拉底学堂：不灌结论，用问题帮你澄清概念</sub></p>
</td>
</tr>
<tr>
<td width="50%">
<img src="assets/feature-mindmap.gif" alt="一键思维导图" />
<p align="center"><sub>一键思维导图：右键当前章节 → Markmap 浮窗展开</sub></p>
</td>
<td width="50%">
<img src="assets/feature-bookwall.gif" alt="海量书库与论文集" />
<p align="center"><sub>海量书库与论文集：33 本教材 + 2 套论文集，五大分类持续上新</sub></p>
</td>
</tr>
</table>

## 🎯 核心特性

#### 📚 多源知识库

Zip 导入、Obsidian Vault 直挂、云端同步，统一阅读入口。版本化发布，团队成员共享同一份只读快照。

</td>
<td width="33%" valign="top">

#### 🤖 AI 学习伙伴

Socratic 对话式辅导。选段即问、思路即答。多个虚拟学习伙伴可切换，上下文自动从段落 / 章节 / 整书中智能切片。

</td>
<td width="33%" valign="top">

#### ✍️ 富文本与公式

KaTeX、MathLive 原生数学体验；Markmap 思维导图；Monaco 代码块；GFM 全集。学术 / 工科内容渲染零妥协。

</td>
</tr>
<tr>
<td width="33%" valign="top">

#### 📝 注释与勘误

逐段高亮、彩色标注、QA 记录归档、协作勘误工单。把读书变成可沉淀的资产。

</td>
<td width="33%" valign="top">

#### 👥 团队协作

多用户权限（Owner / Admin / Editor / Viewer），共享书库、邀请白名单、行级访问控制。

</td>
<td width="33%" valign="top">

#### 🌐 PWA & 国际化

PWA 离线可用、桌面 / 移动端响应式、中英双语开箱即用、深浅主题自动切换。

</td>
</tr>
</table>

## 🚀 两种使用方式

### ☁️ 云端版 — 推荐快速体验

零配置，开箱即用。访问 **[app.exnju.top](https://app.exnju.top)**，邮件链接（Magic Link）登录即可使用全部功能 —— 包含 AI 学习伙伴、团队协作、多设备同步与云端书库管理。

> **适合**：希望立即上手、需要团队协作、希望使用 AI 学习伙伴、不想自己维护服务的用户。

### 🏠 自托管 / 本地版

```bash
git clone https://github.com/TeaFishMeow/any-reader-ui.git
cd any-reader-ui
npm install
npm run dev
```

打开 `http://127.0.0.1:1420/`，把你的 Markdown 目录或 Obsidian Vault 挂载进来即可。

> **适合**：自托管爱好者、二次开发者、需要数据完全本地化的场景、希望深度定制阅读体验的研究者。

## 🛠️ 快速开始

### 环境要求

- **Node.js** ≥ 20
- **npm** ≥ 10
- 一个本地的 Markdown 目录或 Obsidian Vault

### 安装与启动

```bash
git clone https://github.com/TeaFishMeow/any-reader-ui.git
cd any-reader-ui
npm install
npm run dev
```

启动成功后浏览器访问：`http://127.0.0.1:1420/`

### 切换你自己的知识库

在 `vite.config.ts` 中调整本地 Vault 路径常量，指向你自己的 Markdown 目录或 Obsidian Vault 根目录即可。所有 Markdown 文件与附件都会被自动索引和服务。

### 构建生产版本

```bash
npm run build
npm run preview
```

构建产物在 `dist/`，可部署到任意静态托管（Vercel / Cloudflare Pages / GitHub Pages）。

## 🧱 技术栈

| 类别 | 选型 |
|---|---|
| 前端框架 | **React 19** + **TypeScript 5.7** |
| 构建工具 | **Vite 6** |
| 富文本 | **TipTap 3** |
| 数学渲染 | **KaTeX** · **MathLive** |
| 思维导图 | **Markmap** |
| 代码编辑器 | **Monaco Editor** |
| Markdown 管线 | **unified** + **remark** + **rehype** |
| 离线能力 | **PWA** + Service Worker |

## 🗺️ Roadmap

- [ ] 📱 移动端 / 平板端体验深度优化
- [ ] 🧩 插件 / 扩展系统（自定义渲染器、Block 类型）
- [ ] 🤖 更多 LLM Provider 接入（Claude · Gemini · 本地 Ollama）
- [ ] 👥 实时协作光标与评论
- [ ] 🎓 学习课程模板市场
- [ ] 🔌 第三方知识源接入（Wikipedia · arXiv · Zotero）
- [ ] 🌍 更多语言（日语 · 韩语 · 西班牙语）

详细规划见 [Issues](https://github.com/TeaFishMeow/any-reader-ui/issues) 与 [Discussions](https://github.com/TeaFishMeow/any-reader-ui/discussions)。

## 🤝 贡献

欢迎任何形式的贡献 —— Issue、PR、文档改进、设计建议、使用反馈。

- 🐛 反馈问题：[新建 Issue](https://github.com/TeaFishMeow/any-reader-ui/issues/new)
- 💡 提议特性：[GitHub Discussions](https://github.com/TeaFishMeow/any-reader-ui/discussions)
- 🔧 提交代码：Fork → 改动 → Pull Request

### 贡献者

## 💬 社区

- 💬 **GitHub Discussions**: [加入讨论](https://github.com/TeaFishMeow/any-reader-ui/discussions)
- 🐛 **Issue 反馈**: [github.com/TeaFishMeow/any-reader-ui/issues](https://github.com/TeaFishMeow/any-reader-ui/issues)
- 📧 **联系作者**: 通过 [app.exnju.top](https://app.exnju.top) 内的"开发者联系方式"

## 📄 许可证

> AnyReader 采用 **AGPL-3.0** 协议开源。你可以自由地使用、修改、分发本项目；如果你将修改版本作为网络服务对外提供，须以同等协议公开你的修改源代码。

## 🙏 致谢

AnyReader 的诞生离不开以下优秀开源项目：

[React](https://react.dev/) · [Vite](https://vitejs.dev/) · [TypeScript](https://www.typescriptlang.org/) · [TipTap](https://tiptap.dev/) · [KaTeX](https://katex.org/) · [MathLive](https://mathlive.io/) · [Markmap](https://markmap.js.org/) · [Monaco Editor](https://microsoft.github.io/monaco-editor/) · [unified](https://unifiedjs.com/) · [remark](https://remark.js.org/)

---

<div align="center">
<sub>Made with ☕ for deep readers and curious minds.</sub><br/>
<sub>如果 AnyReader 让你的阅读变得更深 —— 请给我们一颗 ⭐</sub>
</div>

any-reader-ui

any-reader-ui Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

any-reader-ui

any-reader-ui Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README