v0.24.1 · npm + macOS App

你让 AI 写了 30 份 HTML / Markdown 报告——
它们现在在哪?

Atlas 扫你硬盘上指定的目录,把所有 .html.md 收进一棵本地目录树。更新过的标红点,看完即清。

一个浏览器 Tab 替代之前的 30 个。

MIT License·Node 18+·macOS / Linux / Windows

它解决了什么?

你让 AI 在多个项目里到处生成 HTML 报告、原型、文档——时间一长就乱了。

没有 Atlas

  • Tab 越积越多——AI 每次更新都自动 open 一次
  • 找文件靠记忆——HTML 散在各个项目目录里,没有统一入口
  • 看不到更新——AI 改了哪个,没法一眼看出

有 Atlas

  • 一个 Tab 看全部——所有 HTML 集中在 localhost:4321
  • 更新即标红——基于 mtime,未读自动出红点
  • 看完即清——点开预览即标已读,专注没看过的
这是一个真实可交互的 mini Atlas — 试试搜索、点击、拖拽
localhost:4321
试试拖 q3-okr-reviewprototypes
📄
从左侧选择一个文件预览

它能做什么

只做一件事:让你轻松看完 AI 散落各处的 HTML / Markdown,并一眼认出哪些变了、还没看。按用途分成五组。

看文档

多 Tab 浏览

像浏览器一样多开文档:每篇一个标签,切换不重载、滚动位置和页面状态都留着。⌘W 关、Ctrl+Tab 切、⌘1–9 跳;关掉再开也记得上次开着哪几篇。

HTML + Markdown 双模

默认扫描 HTML 与 Markdown,另可选开 CSV / JSON / 文本 / SVG,各自渲染成干净可读的样子。

Mermaid 图表与公式

```mermaid 渲染成图、$…$ 交给 KaTeX;出错显示原始报错而非空白,按需加载、离线可用。

精排的 Markdown

本地图片、任务列表、代码块复制、GFM 提示块、可折叠目录、三档阅读宽度、规整表格,一应俱全。

HTML 沙箱预览

AI 写的 HTML 默认隔离在沙箱里预览,脚本能跑却碰不到你的数据;需要更多能力时点盾牌按篇信任。

导出 PDF

一键把 HTML / Markdown 导出为布局保真的 PDF,存到 Downloads;桌面版用内置渲染器,无需另装浏览器。

追踪 AI 的改动

未读红点

AI 改过的文档亮红点、看完即清,并按新鲜度分两档——几百篇里也一眼看出刚动过的那几个。

版本对比与回退

和你上次看到的那一版逐行 diff(以内容为准,不只看时间);保留最近 5 版,可对比、可一键回退。

首页概览

没打开文档时,首页用一句大标题回答"今天 AI 改了几篇",配一条 24 小时活动脉冲;待看队列铺成彩色封面墙,最近与收藏收在下方,点封面直接进文档。

桌面通知

文档新增 / 修改时弹一条系统通知,设置里一键开关。

组织与查找

嵌套目录树

按项目目录自动归类,可拖拽重排、一键全部折叠 / 展开,展开折叠带平滑动画;深滚时顶层分组名自动吸顶,几百篇文档也不迷路。只在虚拟层重组,磁盘文件不动。

全文搜索

文件名 / 备注 / 路径 / 正文一起搜,多词取交集、引号锁短语;命中后正文自动高亮并逐处跳转。

⌘K 快速打开

敲几个字母模糊匹配文件名,也搜正文;键盘选中直达并滚到命中处,鼠标可以放一边。

⌘F 文档内查找

在当前文档里逐词查找并高亮,Enter / ↑↓ 在命中处间跳。搜完按 Esc 或点命中条的 ✕ 就地清掉高亮——不必离开文档。

收藏与标签

收藏跨文件夹聚到一处;给文件打标签后可按标签筛选,多标签取交集。收藏 / 最近 / 标签收进侧栏顶部的「快捷区」面板,与下面的全量目录树各归其位、一眼分得清。

多扫描根 & 归档

设置里可视化增删扫描目录、即时生效;暂时不看的项目分组可归档隐藏,磁盘文件不动、随时恢复。

编辑与分享

预览区轻量编辑

点「编辑」直接在预览里改文案、拖动排序、改链接;保存只重写你碰过的块,写前自动备份。

Markdown 分栏编辑器

源码 / 预览分栏、滚动同步、双向块高亮,⌘B ⌘I ⌘S 与自动草稿恢复。

局域网分享 + 二维码

hover 出 🔗 生成带 token 的链接、弹二维码手机扫码即看;默认 2 小时失效,只放行文档引用到的资源。

顺手的细节

全键盘操作

⌘K 快速打开、⌘F 文档内查找、/ 聚焦搜索、Esc 逐级退出、? 出速查表;多标签用 ⌘W / Ctrl+Tab / ⌘1–9——完整键盘流。

深浅色主题

默认跟随系统,也可固定浅 / 深色,Markdown 预览页一起钉住,不会外壳浅、正文深。还能选界面色调(冷灰 / 暖灰),和浅深主题自由搭配。

自动更新

桌面 App 自动检查并安装新版本;npm 版在界面里一键自升级,全程不碰终端。

备注名与定位

给文件起个记得住的别名(不改原文件名);一键在访达 / 资源管理器里定位到磁盘位置。

两种安装方式

不装 Node、不碰终端,就下载 App;已有 Node 环境、想用 atlas 命令,就走 npm。两者共用同一份配置与看板。

推荐给不熟悉终端的人

下载 macOS App

  1. 下载 Atlas-mac-arm64.dmg(Apple Silicon / M 系列芯片)
  2. 双击打开,把 Atlas 拖到「应用程序」
  3. 启动即用——首次会用默认目录(~/Documents)开始扫描,之后可在设置里改

已签名并经 Apple 公证,不会被 Gatekeeper 拦。菜单栏常驻,关窗不退出;PDF 导出用内置渲染器,无需另装浏览器。

下载 DMG
推荐给开发者

用 npm 安装

不想安装,直接 npx 跑:

npx atlas-dashboard

或全局安装后用 atlas 命令常驻:

npm i -g atlas-dashboard
atlas start

首次启动会问几个问题(扫描目录 / 端口 / 忽略项),都有合理默认值,回车跳过即可;随后浏览器打开 http://localhost:4321。需要 Node 18+,支持 macOS / Linux / Windows。

命令

前台启动用于调试,后台守护进程用于日常常驻。

atlas
前台启动(首次会引导配置;Ctrl+C 退出)
atlas start
后台启动,立即返回,写 PID 与日志
atlas stop
停止后台服务
atlas restart
重启后台服务
atlas status
查看运行状态(pid / url / uptime / 扫描根)
atlas log
tail -f 日志
atlas init
重新进入交互引导(仅配置,不启动)
atlas --port <n>
临时换端口(不写回配置)
atlas --root <path>
临时加扫描根(可重复,不写回配置)
atlas --config
打印配置 / 日志 / PID 文件位置
atlas --help
查看完整帮助

让 AI 不再每次打开 HTML

Atlas 解决了"散乱",但自动 open xxx.html 是 AI 端的行为。把这条规则加到 AI 工具的全局配置(如 ~/.claude/CLAUDE.md):

生成或更新 HTML 文档后,不要执行 open / xdg-open 打开浏览器。
本机运行着 Atlas dashboard(http://localhost:4321),
它会自动通过 mtime 显示未读红点。