Atlas 扫你硬盘上指定的目录，把所有 .html 与 .md 收进一棵本地目录树。更新过的亮起未读标记，看完即清。
一个浏览器 Tab 替代之前的 30 个。
你让 AI 在多个项目里到处生成 HTML 报告、原型、文档——时间一长就乱了。
open 一次localhost:4321q3-okr-review 到 prototypes
只做一件事：让你轻松看完 AI 散落各处的 HTML / Markdown，并一眼认出哪些变了、还没看。按用途分成五组。
像浏览器一样多开文档：每篇一个标签，切换不重载、滚动位置和页面状态都留着。⌘W 关、Ctrl+Tab 切、⌘1–9 跳；关掉再开也记得上次开着哪几篇。
默认扫描 HTML 与 Markdown，另可选开 CSV / JSON / 文本 / SVG，各自渲染成干净可读的样子。
```mermaid 渲染成图、$…$ 交给 KaTeX；出错显示原始报错而非空白，按需加载、离线可用。
本地图片、任务列表、代码块复制、GFM 提示块、可折叠目录、三档阅读宽度、规整表格，一应俱全。
按 ⌘. 或点顶栏的专注按钮，侧栏、顶栏、标签栏一起收起，只留正文（Markdown 和已信任的 HTML 顶部还有一条阅读进度条）；Esc 退出。Markdown 的推荐 / 加宽 / 占满三档宽度照常可切（左下角，或按 [ ]）。Safari 里 ⌘. 被浏览器占用，请用按钮。
鼠标在目录树、标签、首页封面或星图上停留约半秒，旁边弹出小预览（标题、更新时间、缩略图），不打开也不标已读；键盘选中后按 Space 同效。悬停预览会像打开文档一样加载它引用的在线资源，不想要可以在设置里关掉悬停，Space 仍可用。
AI 写的 HTML 默认隔离在沙箱里预览，脚本能跑却碰不到你的数据；需要更多能力时点盾牌按篇信任。
一键把 HTML / Markdown 导出为布局保真的 PDF，存到 Downloads；桌面版用内置渲染器，无需另装浏览器。
每次升级后第一次打开，会告诉你带来了哪些新功能、怎么用；只是修 bug 就不打扰你。随时能在「设置 → 更新日志」翻看每个版本的改动。
AI 改过的文档亮起蓝紫色的未读标记、看完即清，并按新鲜度分两档——几百篇里也一眼看出刚动过的那几个。红色只留给错误和危险操作。
和你上次看到的那一版逐行 diff（以内容为准，不只看时间）；保留最近 5 版，可对比、可一键回退。
没打开文档时，首页最上方是按标签筛选条，下面一句大标题回答"今天 AI 改了几篇"，旁边竖排读数（文档 / 项目 / 未读 / 近 7 天改动），再往下是时间河流和待看封面墙。本机有 Chrome / Edge 时封面就是文档首屏的真实缩略图（后台断网截图，放大到能看清标题，Markdown 封面不带目录栏，深色主题下白底页面自动压暗），没有就用中性底色的生成式封面；最近与收藏收在最下方。
首页把过去 7 天每小时的改动次数画成一条柱状河流，一眼看出 AI 哪段时间最忙；某一小时的尖峰不会把别的柱压扁，柱顶直接标出次数。在河流上拖出一段时间（或点「24 小时」「3 天」），目录树、首页和星图就只看这段时间里改过的文档；Esc 或「清除」撤掉。
把全部文档画成一张星图：项目是星团、文档是星，亮度 = 新鲜度，连线 = 引用关系（A 链接到 B 才画线）。滚轮缩放看远景 / 中景 / 近景，悬停看名字和引用数，点一下打开。右侧星表可用键盘逐个浏览；标签、仅未读、时间段筛选同样生效。进星图时侧栏自动收起，离开后恢复。
文档新增 / 修改时弹一条系统通知，设置里一键开关。
分组视图按项目自动归类、可拖拽重排、归档、一键全部折叠展开；目录视图按磁盘真实层级展开二级 / 三级子目录，深层同名文件（多个 README）也一眼分得清；星图见上。同层文件名与文件夹名对齐，类型只看行尾 HTML / MD 角标。排序、仅未读和按标签筛选收进树头的排序按钮菜单，不占地方。
文件名 / 备注 / 路径 / 正文一起搜，多词取交集、引号锁短语；命中后正文自动高亮并逐处跳转。
敲几个字母模糊匹配文件名，也搜正文；键盘选中直达并滚到命中处，鼠标可以放一边。还没输入时列出最近打开和收藏，读文档时也能一步跳回。
在当前文档里逐词查找并高亮，Enter / ↑↓ 在命中处间跳。搜完按 Esc 或点命中条的 ✕ 就地清掉高亮——不必离开文档。
悬停文件行点星标收藏，收藏跨文件夹聚到首页的「收藏」轨道和 ⌘K 里。给文件打标签后，用首页最上方的标签筛选条（或树头排序菜单里的「按标签筛选」）筛选，多标签取交集；目录树、首页和星图一起生效，命中数处处一致。
设置里可视化增删扫描目录、即时生效；暂时不看的项目分组可归档隐藏，磁盘文件不动、随时恢复。
macOS 上可以在设置里一键添加 iCloud 云盘。只在云端、没下载到本机的文件照常列出，但显示为灰色并带「在 iCloud 中」标识；扫描、搜索、预览都不会读取它们，所以不会触发下载。需要时点「下载到本机」，下载完成后自动恢复正常（能否由 Atlas 发起下载取决于系统能力；不支持时可以在访达中下载）。
点「编辑」直接在预览里改文案、拖动排序、改链接；保存只重写你碰过的块，写前自动备份。
源码 / 预览分栏、滚动同步、双向块高亮，⌘B ⌘I ⌘S 与自动草稿恢复。表格可以直接在预览里改单元格、拖住行首把手重排整行，左边源码同步更新，不用手写 Markdown 表格语法。
hover 出 🔗 生成带 token 的链接、弹二维码手机扫码即看；默认 2 小时失效，只放行文档引用到的资源。
⌘K 快速打开、⌘F 文档内查找、/ 聚焦搜索、Space 快速查看、⌘. 专注阅读、Esc 逐级退出、? 出速查表；多标签用 ⌘W / Ctrl+Tab / ⌘1–9——完整键盘流。
深色是深空蓝黑、浅色是星图纸底，配色收敛到一个品牌强调色加中性色。默认跟随系统，也可固定浅 / 深色（Markdown 预览页一起钉住），另可选冷灰 / 暖灰色调。设置里的「界面动效」可选「减少」，转场和轻闪都停下，信息照常显示。
桌面 App 去掉了标题栏，红绿灯嵌进顶栏、和图标留足间距，侧栏透出桌面壁纸的毛玻璃材质（系统设置 → 辅助功能 → 显示 →「降低透明度」打开时换成实底）；固定浅 / 深色时窗口材质跟着变，切主题时整页柔和淡入。顶栏空白处可拖动，双击放大、再双击还原。专注阅读时红绿灯一起隐藏，顶部仍可拖动窗口。
桌面 App 自动检查并安装新版本，设置里还能主动「检查更新」→ 看下载进度 → 一键重启装上新版；npm 版在界面里一键自升级，全程不碰终端。
给文件起个记得住的别名（不改原文件名）；一键在访达 / 资源管理器里定位到磁盘位置。
桌面 App 现在注册为 .md / .html / 文本等文件的可选打开方式：在访达里双击或右键「打开方式」选 Atlas 即可直接看这篇；文件不在扫描范围时，会先问你要不要把它所在目录加进来。
不装 Node、不碰终端，就下载 App；已有 Node 环境、想用 atlas 命令，就走 npm。两者共用同一份配置与看板。
~/Documents）开始扫描，之后可在设置里改已签名并经 Apple 公证，不会被 Gatekeeper 拦。菜单栏常驻，关窗不退出；PDF 导出用内置渲染器，无需另装浏览器。
下载 DMG不想安装，直接 npx 跑：
npx atlas-dashboard或全局安装后用 atlas 命令常驻：
npm i -g atlas-dashboard
atlas start首次启动会问几个问题（扫描目录 / 端口 / 忽略项），都有合理默认值，回车跳过即可；随后浏览器打开 http://localhost:4321。需要 Node 18+，支持 macOS / Linux / Windows。
前台启动用于调试，后台守护进程用于日常常驻。
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 显示未读标记。