v0.1.1 · 已上架 npm

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

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

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

$npx atlas-dashboard GitHub npm

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
📄
从左侧选择一个文件预览

它能做什么

围绕"看 HTML 文档"做到底。每一个细节都为减少打扰服务。

嵌套目录树

按一级项目目录自动归类。手动新建子分组、拖拽文件 / 分组重排。拖到折叠 folder 头上停留 600ms 自动展开,让你直接拖进去。物理文件位置不动,只在虚拟层重组。
不想看的项目分组可以"归档"——下次扫描跳过它,但磁盘文件不动;设置面板里随时恢复。

未读红点

AI 改过哪个 HTML,文件名后立即出红点。点开预览即清除——精准锁定"还没看过"的内容。

桌面通知

HTML 新增 / 修改时弹系统通知。设置面板一键开关,浏览器原生 Notification API + chokidar + SSE。

备注名

给文件起一个你能记住的别名。原文件名不变。备注存在 Atlas 自己的存储里,零侵入扫描目录。

在访达 / 资源管理器中显示

每个文件一键定位。macOS 用 open -R、Windows explorer /select、Linux xdg-open,跨平台一致。

收侧栏 + 拖拽调宽

侧边栏宽度可拖拽调整,⌘B 一键收起。iframe 不会因为侧栏切换而抖动——动画曲线经过精心调优。

全文搜索 + 高亮跳转

搜索框同时匹配文件名 / 备注 / 路径 / HTML 内容。中文单字("灯")也能搜。打开命中文件后 iframe 内所有匹配自动高亮,顶栏出现 X / N 跳转栏,Enter / Shift+Enter 上下跳。/ 一键聚焦搜索框。

键盘导航

搜索框按 进入文件列表,↑↓ 切换,Enter 打开当前文件,Esc 回搜索框。完全的键盘流,鼠标可以放一边。

最近打开

侧栏顶部固定一个最近 10 个文件的 LRU 快捷栏,跨项目跳转秒回,可折叠。点过的文件优先显示在最上面。

多扫描根

设置面板里增删扫描根目录,立即生效。"浏览…"按钮可视化选择文件夹,不用手输绝对路径。增删成功 / 重复添加 / 失败都会在右下角弹出 toast 提示,不再静默无感。配置存在 ~/.atlas/,永远不会写入你扫描的项目。

一键自升级

新版本发布后 1 小时内自动推送到你所有打开的 tab——Dashboard 顶栏下方弹一条醒目 banner,点 立即更新 即可全程不碰终端:实时进度条、可展开 npm 日志、安装完成自动重启 + 重连刷新。失败也能在界面里看到错误原因,再点重试。

灵活排序

侧边栏一行 segmented control 切换三种模式:按名称(默认,系列文档自然聚合在一起)/ 按更新时间 / 自定义。直接拖动文件就自动切到自定义模式——不用先选模式再拖。选择跨会话保留。

导出 PDF

顶栏一键导出当前文档为 PDF——后端调本机 Chrome / Edge / Brave headless 渲染,布局 100% 保真(不是 html2canvas 那种像素截图)。带阶段进度条:启动 → 渲染 → 写入。一键直保存到 Downloads,toast 里直接"在访达中显示"。没装 chromium 系浏览器自动降级到打印对话框。

单文档刷新

预览中的 HTML 在外部被 AI 重新生成?顶栏单独一个刷新按钮重载当前 iframe——不刷整个 Dashboard,树展开、滚动、最近列表全保留。刷新后顺便把红点清掉,相当于"我看了这次更新"。

局域网分享 + 二维码

评审现场要让同事看一份 HTML?文件行 hover 出 🔗 按钮——一键生成不可猜的 token URL,弹出大二维码同事手机扫码即看(同 Wi-Fi 即可),顶栏 dashboard 仅本机访问、其他人只能通过分享链接访问被分享的文件。可标记多个文件,一键停止全部评审完即关。Atlas 重启 token 不失效。

归档分组

有些项目暂时不想看到?删除一个项目分组不再"删了又自动回来"——而是进入"已归档",下次扫描跳过。磁盘上 HTML 文件不会被删,设置面板里随时一键恢复

三步上手

不需要开发环境。一条 npx 命令搞定。

1

启动

不需要安装,直接 npx

npx atlas-dashboard

或全局安装后用 atlas

npm i -g atlas-dashboard
atlas
2

首次配置

第一次启动会问几个问题,全部都有合理默认值,回车跳过:

? 要扫描哪些目录的 HTML?(逗号分隔)
  默认: ~/Documents
? 监听端口?  默认: 4321
? 要忽略的目录名?
  默认: node_modules,.git,…
3

访问

浏览器打开:

http://localhost:4321

建议加到书签栏。再让你的 AI 不要 open HTML,把规则写到全局配置即可。

命令

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

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 显示未读红点。