你让 AI 在多个项目里到处生成 HTML 报告、原型、文档——时间一长就乱了。
open 一次localhost:4321q3-okr-review 到 prototypes
围绕"看 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——后端调本机 Chrome / Edge / Brave headless 渲染,布局 100% 保真(不是 html2canvas 那种像素截图)。带阶段进度条:启动 → 渲染 → 写入。一键直保存到 Downloads,toast 里直接"在访达中显示"。没装 chromium 系浏览器自动降级到打印对话框。
预览中的 HTML 在外部被 AI 重新生成?顶栏单独一个刷新按钮重载当前 iframe——不刷整个 Dashboard,树展开、滚动、最近列表全保留。刷新后顺便把红点清掉,相当于"我看了这次更新"。
评审现场要让同事看一份 HTML?文件行 hover 出 🔗 按钮——一键生成不可猜的 token URL,弹出大二维码同事手机扫码即看(同 Wi-Fi 即可),顶栏 dashboard 仅本机访问、其他人只能通过分享链接访问被分享的文件。可标记多个文件,一键停止全部评审完即关。Atlas 重启 token 不失效。
有些项目暂时不想看到?删除一个项目分组不再"删了又自动回来"——而是进入"已归档",下次扫描跳过。磁盘上 HTML 文件不会被删,设置面板里随时一键恢复。
不需要开发环境。一条 npx 命令搞定。
不需要安装,直接 npx:
npx atlas-dashboard
或全局安装后用 atlas:
npm i -g atlas-dashboard
atlas
第一次启动会问几个问题,全部都有合理默认值,回车跳过:
? 要扫描哪些目录的 HTML?(逗号分隔)
默认: ~/Documents
? 监听端口? 默认: 4321
? 要忽略的目录名?
默认: node_modules,.git,…
浏览器打开:
http://localhost:4321
建议加到书签栏。再让你的 AI 不要 open HTML,把规则写到全局配置即可。
前台启动用于调试,后台守护进程用于日常常驻。
atlasatlas startatlas stopatlas restartatlas statusatlas logtail -f 日志atlas initatlas --port <n>atlas --root <path>atlas --configatlas --help
Atlas 解决了"散乱",但自动 open xxx.html 是 AI 端的行为。把这条规则加到 AI 工具的全局配置(如 ~/.claude/CLAUDE.md):
生成或更新 HTML 文档后,不要执行 open / xdg-open 打开浏览器。
本机运行着 Atlas dashboard(http://localhost:4321),
它会自动通过 mtime 显示未读红点。