mu-zi-lee / Tangentry

# Tangentry
**沿着好奇心继续发现 —— 本地优先的多平台内容聚合、阅读与笔记工具**
把 B站、YouTube、小红书、抖音、小宇宙播客、RSS 与网页文章收进同一个阅读器里：
看视频时读字幕、截帧做笔记、一键转录与翻译，所有数据都留在你自己的电脑上。
功能 · 快速开始 · 使用指南 · 配置 · 开发 · 架构 · 贡献
---
> [!NOTE]
> Tangentry 是个人项目，目前处于 **0.x 早期阶段**，接口和数据结构仍可能变化（数据库会自动迁移）。欢迎试用并反馈问题。
https://github.com/user-attachments/assets/79f4a123-2de2-429f-b302-0f1ad761ce26
## 📖 目录
- 为什么做 Tangentry
- 截图
- 功能
- 快速开始
- 使用指南
- 配置
- 开发
- 项目结构
- 隐私与安全
- 常见问题
- 路线图
- 致谢
- 许可证
## 💡 为什么做 Tangentry
内容散落在不同平台：B站的课程、YouTube 的讲座、小宇宙的播客、RSS 里的长文、小红书的图文笔记……
每个平台都有自己的推荐算法、自己的收藏夹，却没有一个地方能让你 **专注地读、认真地记、长期地留存**。
Tangentry 的思路是：
- **一个入口**：订阅、推荐、搜索、收藏统一到同一个界面；
- **阅读优先**：视频和播客也可以“读” —— 字幕跟随、全文搜索、双语对照、AI 摘要；
- **笔记即资产**：笔记锚定到时间点 / 原文段落 / PDF 位置 / 截帧，可导出为 Markdown（兼容 Obsidian）；
- **本地优先**：SQLite 存储在本机，不需要注册任何 Tangentry 账号，凭据从不进入源码或浏览器。
### Why Tangentry?
**Tangentry = Tangent + Entry**
- **Tangent** — 思维的发散、知识的延伸，以及探索过程中意想不到的发现。
- **Entry** — 进入知识世界的入口，也代表每一份值得记录和探索的内容。
**Tangentry** 是一个创造词，寓意着：每一份内容都是探索的起点，每一次好奇都可能通向新的知识。
无论是视频、播客、文章还是 PDF，我们希望打破内容形式的边界，让阅读成为一场自由延伸的知识探索。
> **Every curiosity leads somewhere.**
> 每一份好奇，都通向新的发现。
## 📸 截图
 发现 ：B站、YouTube、小红书、小宇宙的推荐汇聚在一个首页 
 播客文稿 ：小宇宙单集自动生成可阅读、可跳转的文字稿 
 YouTube ：内嵌播放、字幕同步，翻译与摘要一键可用 
 小红书 ：图文与视频笔记在同一个阅读器里查看、收藏和下载 
 笔记库 ：跨来源检索、按标签和时间筛选，一键导出 Markdown 
 设置 ：账号、AI、转录、下载与外观集中管理 
> 截图中的内容来自各平台公开推荐，版权归原作者所有，仅用于展示软件功能。
## ✨ 功能
| 模块 | 能力 |
| --- | --- |
| 🔭 **发现** | 聚合 B站 / YouTube / 小红书 / 抖音 / 小宇宙的推荐流，可调整来源偏好；“稍后看”推荐队列 |
| 📡 **订阅** | B站 UP 主、YouTube 频道、RSS / Atom / JSON Feed、小宇宙播客、linux.do 话题；分组、收件箱、已读状态、定时刷新、**OPML 导入/导出** |
| ➕ **添加内容** | 粘贴链接或 ID 解析视频、UP 主、频道、播客单集、网页文章、本地 PDF |
| 📺 **阅读与播放** | 内嵌播放器 + 字幕阅读器（跟随高亮、搜索、上下文跳转）、播放进度记忆、网页正文提取（Readability）、PDF 阅读 |
| 📝 **笔记** | 时间戳笔记、原文划线笔记、PDF 锚点、截帧附图、字幕引用、嵌套标签、置顶、全文搜索；导出 Markdown ZIP（含 Obsidian frontmatter） |
| 🎙️ **转录** | 本机：whisper.cpp / faster-whisper / Qwen3-ASR；云端：Groq、SiliconFlow、Cloudflare Workers AI 等；平台字幕优先，转录结果缓存 |
| 🤖 **AI 助手** | 接入任意 **OpenAI 兼容** 接口：视频/文章摘要、字幕与正文翻译（双语导出） |
| ⬇️ **下载** | 基于 yt-dlp + FFmpeg 的音视频下载、队列与超时控制 |
| ⭐ **收藏同步** | 同步 B站收藏夹到本地，支持过滤与断点续传 |
| 🕘 **历史** | 浏览历史与搜索历史，全部存于本地数据库 |
| 🖥️ **多端运行** | 原生桌面应用（macOS / Windows / Linux）或 Docker 自托管（NAS、家庭服务器），浏览器访问 |
## 🚀 快速开始
### 方式一：桌面应用（推荐普通用户）
前往 Releases 下载对应平台的安装包。发布流程只在推送 `v*` tag（例如 `v0.0.1`）时运行：它会编译桌面包、运行验证并构建 Docker 镜像。
| 平台 | 说明 |
| --- | --- |
| macOS（Apple Silicon） | 打开 `.dmg` 拖入“应用程序”。若提示“无法验证开发者”，右键 → 打开 |
| Windows（x64 / ARM64） | 下载 ZIP 并解压后运行 `Tangentry.exe`。未签名版本会触发 SmartScreen，点击“更多信息 → 仍要运行” |
| Linux（x64 / ARM64） | 安装 `.deb`，依赖 `ffmpeg` 与 `libgomp1` 会自动安装 |
桌面版自带运行时；**yt-dlp、Deno 与 Whisper 模型会在首次使用时自动下载并校验**，无需手动安装。
#### 一次性准备自动更新签名
桌面版的自动更新由 MyGo 的 Ed25519 签名保护。首次启用时，在本机运行：
 [code] 
将生成的 `mygo-update.pub` 公钥内容保存为 `src/updater/mygo-update.pub` 并提交；将 `mygo-update.key` 私钥的完整内容加入 GitHub 仓库的 **Settings → Secrets and variables → Actions**，Secret 名称必须是 `MYGO_UPDATER_PRIVATE_KEY`。私钥不要提交到仓库，请妥善离线备份；私钥丢失后，已经安装的应用将无法验证后续更新，只能重新安装。
发布工作流会把 MyGo 生成的 `update- - .json`、签名归档和增量文件作为 GitHub Release 资产上传。若未配置 Secret，构建仍会完成但会明确警告，并不会生成可安装的签名更新。
macOS 构建默