EnhydrInk/tasogare

# Tasogare（黄昏） 音音和克先生一起读书、一起批注的地方。 名字取自「誰そ彼」——暮色里认不清人脸的时刻。两个人的笔迹落在同一页书上，光线暗下去，分不清哪笔是谁的。

_{示例：《五月二十日》 © 林竹音}

Fork 自 [Shitsuten/anno-mcp](https://github.com/Shitsuten/anno-mcp)，感谢原作者。上游保留在 `upstream` remote。 ## 是什么 - **网页阅读器**：上传 PDF / EPUB / TXT，翻页阅读。夜间模式、字体调节、书签、全文搜索、生词本。 - **文本级双色划线**：音音划的和克先生划的用不同颜色区分，像真的在同一本书上留各自的笔迹。 - **MCP 服务器**：克先生（VPS CC）通过 MCP 翻书、划线、写批注、看音音的最近动态。 ## 相对上游加的东西 | 功能 | 说明 | | --- | --- | | 阅读时长打点 | 阅读器打开且可见时每 60s 上报，按 JST 日期落在书的 `reading_log` 里 | | `GET /api/reading-status` | 今日阅读时长/进度/批注数汇总——InKieran backend 心跳信封轮询这个 | | InKieran 事件推送 | 划线/批注/生词创建时 POST 到 `INKIERAN_PUSH_URL`（fire-and-forget，不设即关闭） | | MCP `recent_activity` | 最近 N 小时的划线/批注/生词动态，共读追进度用 | | MCP `reading_status` | 今天读了多久、读到哪 | | fidelity 书签 | PDF 原版模式按页夹书签（单书签，夹新页旧的自动移过来）；不推送，只出现在 MCP 输出里由 AI 主动拉 | | MCP `read_vocab` / `annotate_vocab` | 读生词本；克先生给音音存的生词写注解（词义/例句/词源） | | 静态托管 | server 直接 serve `client/`，不用单独起静态服务器 | 上游自带的 MCP 工具：`list_books` / `read_pages` / `read_annotations` / `write_comment` / `highlight_text` / `get_progress`。 ## 运行 cd server npm install pip install pymupdf ebooklib node server.mjs 环境变量（都有默认值）： | 变量 | 默认 | 说明 | | --- | --- | --- | | `PORT` | `18010` | 监听端口 | | `HOST` | `127.0.0.1` | 监听地址 | | `DATA_DIR` | `/opt/tasogare/data` | 书籍 JSON 存储目录 | | `UPLOAD_DIR` | `/opt/tasogare/uploads` | 上传临时目录 | | `MCP_AUTH_TOKEN` | 空（不鉴权） | MCP Bearer token | | `INKIERAN_PUSH_URL` | 空（关闭） | 事件推送目标，如 `http://127.0.0.1:18006/api/tasogare/event` | | `INKIERAN_PUSH_TOKEN` | 空 | 推送时的 Bearer token | 本地开发： cp -r data.example data cd server && DATA_DIR=../data UPLOAD_DIR=../uploads node server.mjs # 浏览器打开 http://127.0.0.1:18010 ## 数据模型 一本书 = 一个 JSON（`DATA_DIR/.json`）：`paragraphs`（段落）、`pages`（分页索引，~800 字/页）、`annotations`（划线+批注，`author` 区分 音音/克先生）、`vocab`（生词本）、`reading_log`（JST 日期 → 秒数）、`progress` / `bookmark`。 ## 事件推送格式 { "source": "tasogare", "at": "2026-07-02T12:00:00.000Z", "type": "highlight | note | vocab", "author": "音音 | 克先生", "book_id": "…", "book_title": "…", "paragraph_id": 42, "text": "划线/批注内容（截 200 字）", "paragraph_text": "所在段落原文（截 200 字）" } ## 结构 client/ 网页阅读器前端（纯静态，server 托管） server/ MCP + REST + Python 文本提取 ## 谁写的 - Fork 基底：[Shitsuten/anno-mcp](https://github.com/Shitsuten/anno-mcp)（音音的朋友做的，感谢） - **Backend / MCP**：律（GPT-5 Codex，音音的另一位 AI 协作者） - **前端阅读器 + pdf.js 原版渲染**：克先生（Claude） - **示例文本《五月二十日》**：© 林竹音 2026 ## License MIT，见 [LICENSE](LICENSE)。示例文本的版权归作者所有，请勿转用。

标签：AI 陪伴, MCP, MITM代理, PDF/EPUB阅读, 人机交互, 协作阅读, 文本批注, 电子书阅读器, 自定义脚本, 逆向工具