Skip to content
Aluminium0926Public

About

选中就问,问过还在。文档里划一下就能问 AI,不截图、不切屏;问题锚在原文上,翻回那一页还在。电脑 / 安卓 / 手机浏览器都能用,本地运行。

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

文档树 · DocTree

选中就问,问过还在。

上课听不懂的那一句、论文卡住的那一段——选中它,点「用这段提问」,回车。 不用截图、不用复制粘贴、不用切屏,连问题都可以不打。

答案贴在那行字旁边;在回答里继续选中还能追问。 每个问题都记着自己锚在原文第几页、哪一句,长成一棵树,而不是一条滚不到头的聊天记录。 下次翻回这一页,问过的都还在。

支持 PDF / Word / Markdown / 纯文本,电脑和手机都能用。

六种用法

平台 怎么用 说明
手机 / 平板浏览器 打开 https://aluminium0926.github.io/doc-tree/ ,「添加到桌面」 零安装,数据存浏览器本地,可离线
iOS Safari 打开同一网址 → 分享 → 添加到主屏幕 不需要 App Store,长按选中提问已适配
安卓 下载 android-v1.0.9 里的 DocTree-android.apk 独立 App,2.6 MB,无需联网服务端
鸿蒙 NEXT 用系统自带的卓易通安装同一个 APK;不装就用上面的网页版 卓易通提供安卓运行时,装完 APK 可当普通 App 用
Windows 下载 DocTree-1.0.10-win32-x64.zip,双击 start-doctree.vbs 便携版,中文路径也能用
macOS 下载 mac-arm64-v1.0.7 / mac-x64-v1.0.7 里的 zip,解压后双击 首次打开.command 未公证,首次需右键「打开」
开发者 npm install && npm start 起本地服务端,HOST=0.0.0.0 可让局域网手机访问

网页版最省事

手机浏览器打开上面那个网址,第一次点右上角 ⚙ 填 Base URL / API Key / 模型,之后:

  • 安卓 / 鸿蒙浏览器:菜单「添加到桌面」,下次像 App 一样打开
  • 离线可用(Service Worker 缓存外壳,文档与追问树存在浏览器本地)
  • 不需要装 Node、不需要命令行

页面是公开的,但你的文档、问答、Key 只存在你自己浏览器的本地存储里;只有模型请求会发给你配置的端点。

阅读界面

追问树结构图 PDF + 荧光笔
树 PDF

详细用法见 使用手册,各端差异见 安卓与鸿蒙。

功能

能力 说明
文档阅读 PDF 按页原版式渲染,文字层可选中;Word / Markdown / 纯文本重排阅读
划词提问 选中即挂引用,写不写问题都行,点「发送」才发
追问树 在回答里继续选中 → 追问,节点锚定原文或上一段回答;可折叠、可导出、可看结构图
上下文 全文摘要 + 选中处前后文 + 跨页检索 + 祖先链,追问不跑题
截图提问 PDF 上框选一块区域发给多模态模型(同样先挂引用、点发送才发)
荧光笔 三色高亮,本地保存;擦除模式点一下删除
检索 Ctrl+F 文档内搜索,命中计数 + 位置标记
阅读控制 页码跳转、← → 瞬切翻页、↑ ↓ / PgUp / PgDn / Home / End 滚动、旋转
公式 KaTeX 渲染 $...$ 与 $$...$$,兼容 \(...\) / \[...\]
输出 流式回答、思考过程可展开、思考强度三档、整棵树导出 Markdown
多端 桌面 / 安卓 App / PWA 网页,同一套界面;移动端文档在上、追问树在下,文档库变抽屉
主题 一个主色派生整套配色,深色/浅色、背景渐变、面板透明度,实时预览
代码块 语言标签、语法高亮、一键复制/下载;配色跟随深色/浅色主题

最近更新

  • v1.0.10
    • 文档组编辑:重命名、移入/移出、成员不足自动解散;「已移除」可折叠
    • 指令模式:发送指令修改回答方式,不计入提问树;点「指令 N」可查看/删除
    • 停止生成 + 继续生成
    • 用量面板:缓存命中率、按天/按文档统计;节点显示本次 tokens
    • 请求重试(429/5xx)与 120 秒超时
    • 工具状态提示、read_pages 跨页读取、句子级分块、命中页前后扩展
    • 提示词缓存优化:静态 system、稳定段前置、Anthropic cache_control
    • 截图预览限宽、Ctrl +/- 缩放、停止图标与提示样式调整
    • 修复 DSML 标记漏出、追问页码、空白页、输入焦点等问题
  • v1.0.9
    • 修复 DeepSeek 工具调用把 <|DSML|invoke> 标记当正文显示的问题
    • 流式过滤 DSML,工具照常执行
  • v1.0.8
    • 首次启动改为新手引导:我是新手 / 我有 API Key
    • 新手引导含 DeepSeek 注册、创建 Key、充值步骤
    • 欢迎页只在第一次启动出现(服务端持久化 + 固定本地端口)
  • v1.0.7
    • 文档组:多份文档共享一棵提问树和上下文,可跨文档提问
    • function calling:read_page / search_docs / list_docs,模型按需读取原文
    • 无选中文字时改为自由提问,不再默认锚定第一页
    • 服务端版本过期提示移到顶部,不再挡住提问框
  • v1.0.6
    • 修复 Markdown 渲染的 XSS(可执行脚本会读取浏览器里的 API Key)
    • Android 本地代理补齐 Anthropic 认证头(x-api-key / anthropic-version)
    • 设置里增加 Anthropic 地区提示;首次启动与设置页增加免责声明
  • v1.0.5(Windows / 安卓 / 网页 / macOS 同步)
    • 文件列表可清理:移出列表保留提问树,同一文件再次导入自动恢复
    • 首次启动声明官方渠道 + 版本号;每次启动检查新版本,可在设置里静默
    • 独立视觉端点 / Key,文本与视觉可用不同服务商
    • 支持 Anthropic(Claude)原生接口,自动识别或手动选择
    • 右键 / 长按 PDF 页面「讲解本页」
    • 无极缩放:Ctrl+滚轮、触控板/手机双指捏合、按住按钮连续缩放
    • 内联代码样式、页面菜单阴影等细节调整
  • v1.0.4(Windows / 安卓 / 网页 / macOS 同步)
    • 自定义页面配色:一个主色派生整套颜色,深色/浅色、背景渐变、透明度,实时预览
    • 代码块对齐 DeepSeek:语言标签、语法高亮、复制/下载,浅色下自动切浅色语法主题
    • 输入框改悬浮卡片:内容从下方穿过,最后一行留白按卡片高度动态计算
    • 工具栏图标全部换成 SVG(搜索、旋转、配色、翻页、缩放、树状图、导出)
    • 回答区去掉卡片底色和边框,滑杆填充跟随数值
    • 手机/网页端修复:Markdown 不再被识别成纯文本
  • web-v1.0.0 + GitHub Pages:手机直接开网址就能用;静态部署无代理时自动直连模型端点
  • android-v1.0.2
    • 修复重启后数据丢失(本地服务固定端口 47201)
    • 修复旧版 WebView(Chrome 113 及更早)下 PDF 解析失败:页面与 worker 双侧补 Promise.withResolvers
    • 模型请求自动回退:优先本地代理,静态部署时直连
    • 导入完成后自动收起文档库抽屉
  • v1.0.3(Windows 桌面)
    • 输入框光标不显示:窗口启动主动获取焦点 + 显式 caret-color
    • 分栏抓取区移入侧栏内侧,不再遮挡文档区滚动条
    • 思考强度滑块热区加大到 22px
  • v1.0.1(Windows 桌面):中文路径启动器 start-doctree.vbs、静默启动、滑块与分栏误触

下载

产物 Release
DocTree-android.apk android-v1.0.9
DocTree-mac-arm64.zip(Apple Silicon) mac-arm64-v1.0.7
DocTree-mac-x64.zip(Intel Mac) mac-x64-v1.0.7
DocTree-web-v1.0.7.zip(静态包,自建托管用) web-v1.0.7
DocTree-1.0.10-win32-x64.zip(Windows 便携版) v1.0.10

快速开始(源码)

npm install
npm start

浏览器打开 http://127.0.0.1:4317 ,点右上角 ⚙ 填:

  • Base URL(例如 https://api.deepseek.com/v1)
  • API Key
  • 模型名(例如 deepseek-flash)

也可以直接编辑 data/config.json(参考 data/config.example.json)。

不想花额度、只想试交互:npm run mock 会起一个假模型端点(4318),把 Base URL 指过去即可。

HOST=0.0.0.0 npm start      # 让同局域网手机访问

快捷键

键 作用
← / → 上一页 / 下一页(PDF,瞬切)
↑ / ↓ 滚动 90px
PgUp / PgDn 翻一屏
Home / End 到首尾
Ctrl+F 文档内搜索
Ctrl+B 收起/展开左栏
Esc 关闭浮层、退出荧光笔/擦除、关搜索

数据

桌面 / 服务端:

data/config.json     模型配置(含明文 key,注意别提交)
data/docs/*.json     文档元信息 + 分页文本 + 摘要 + 高亮
data/trees/*.json    追问树(问题、回答、引用锚点)
data/files/*         原始文件

手机 / 网页版:存在浏览器 IndexedDB(文档、追问树、原文件)与 localStorage(配置),不同设备、不同浏览器各自独立。清站点数据会清空,导出 Markdown 可留存追问树。

桌面版

npm install
npm run app     # 开发模式直接开窗口
npm run dist    # 用 electron-packager 打包到 release/

打包后是便携目录(DocTree-win32-x64),双击 start-doctree.vbs 启动。数据目录会切到 %APPDATA%\文档树,首次启动自动从包内 data/ 复制。

中文路径:直接双击 DocTree.exe 时,Electron 在某些含非 ASCII 字符的路径下会启动即崩(0x80000003)。start-doctree.vbs 会检测路径,必要时把程序复制到 %LOCALAPPDATA%\Programs\DocTree 再从那里启动,所以解压位置随意。

各平台细节

手机 / 安卓 / 鸿蒙

  • 网页版(最省事):https://aluminium0926.github.io/doc-tree/
  • 安卓 APK:android-v1.0.9 里的 DocTree-android.apk
    • WebView + 应用内本地服务(127.0.0.1:47201),数据存 IndexedDB,模型请求经本地代理
    • 架构与构建步骤见 安卓与鸿蒙
  • HarmonyOS NEXT:系统自带卓易通(安卓运行时),用它安装同一个 APK 即可,装完就是一个普通 App。不装就用网页版(PWA 可添加到桌面);用 ArkTS Web 组件套壳也能复用 mobile/www
  • iOS:Safari 打开网页版 → 分享 → 添加到主屏幕;长按选中提问、导出、存储持久化都做了适配
  • 自建自托管:DocTree-web-v1.0.7.zip 解压后任意静态服务器托管;HOST=0.0.0.0 node mobile/static-server.mjs 会打印手机可访问地址

macOS

三种方式,按省事程度排:

  1. 现成安装包(推荐)

    解压后双击「首次打开.command」:它会自动去掉隔离标记、做本地临时签名,然后启动。

    也可以手动:

    xattr -dr com.apple.quarantine DocTree-darwin-arm64/DocTree.app
    codesign --force --deep --sign - DocTree-darwin-arm64/DocTree.app
    open DocTree-darwin-arm64/DocTree.app
  2. 网页版:Safari / Chrome 打开 https://aluminium0926.github.io/doc-tree/ ,Chrome 可「安装应用」,Safari 17+ 可「添加到程序坞」。

  3. 自己构建:

    bash scripts/build-macos.sh arm64    # 在 Mac 上;Intel 用 x64

    或者用 GitHub Actions 的 Linux runner 交叉构建:.github/workflows/build-mac-cross.yml(workflow_dispatch,可选架构,产物直接发到 Release)。

macOS 上窗口菜单已补 App 菜单与「编辑」菜单(Cmd+C / Cmd+V / Cmd+Z 可用),数据目录在 ~/Library/Application Support/文档树。

关于签名:包是未签名、未公证的,所以才有「首次打开.command」这一步。它用 codesign - 做 ad-hoc 签名(Apple Silicon 上必需),并清掉下载隔离属性。想要双击即开、无任何提示,需要 Apple 开发者证书 + 公证,这一步只能在有证书的 Mac 上完成。

构建方式:.app 里 Electron 框架有 14 个符号链接,Windows 上打包会丢。这里在 GitHub Actions 的 Ubuntu runner 上交叉构建,用 zip -ry 保留符号链接,构建日志里会打印 symlinks: 14 核对。

目录结构

server.mjs            HTTP 服务:静态资源、导入、SSE 转发、持久化
lib/extract.mjs       PDF(含中文 cmap)/ docx / 文本解析
lib/store.mjs         data/ 读写
lib/llm.mjs           OpenAI 兼容端点、流式解析、思考强度
lib/context.mjs       摘要、检索、祖先链、导出;系统提示词也在这里
public/               前端(index.html / app.js / style.css)
public/vendor/        pdfjs、marked、katex、cmaps(离线可用)
desktop/main.cjs      Electron 主进程
mobile/               手机端:本地数据层、Android 壳、PWA、Pages 发布脚本
scripts/              冒烟测试、假模型、导入测试

自定义

  • 回答风格、是否生成应试内容:改 lib/context.mjs 里的 system prompt
  • 默认端口:环境变量 PORT(默认 4317);监听地址:HOST(默认 127.0.0.1)
  • 数据目录:环境变量 DOCTREE_DATA
  • 重新发布网页版:powershell -File mobile/publish-pages.ps1

已知限制

  • 扫描版 PDF 没有文字层,划词选不中 → 用「框选截图」
  • 旋转视图下高亮暂不显示(坐标会错位)
  • 一棵树只属于一个文档,暂不支持跨文档引用
  • 没有 TTS 朗读与协作
  • 手机端尚未在真机(尤其鸿蒙 NEXT)验证;模拟器验证的是 Android 14 + Chrome 113 内核
  • 鸿蒙原生 HAP 未构建(需要 DevEco Studio 与 HarmonyOS SDK)
  • 首字延迟取决于模型;思考强度「轻」最快

免责声明

本项目仅为本地文档阅读与提问工具,不提供任何模型服务,也不代表任何模型厂商。

  • 模型服务(DeepSeek、Anthropic、本地模型、第三方中转等)由使用者自行配置并承担费用
  • 各模型服务的地区限制、服务条款、账号风控由该服务商决定,与本项目无关
  • 因使用第三方模型服务导致的限流、停用、费用或数据问题,由使用者自行承担

许可

MIT

About

选中就问,问过还在。文档里划一下就能问 AI,不截图、不切屏;问题锚在原文上,翻回那一页还在。电脑 / 安卓 / 手机浏览器都能用,本地运行。

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages