功能介绍

Noust 配备了先进的功能，旨在简化您的笔记记录和技术文档工作流程。本指南详细介绍了这些功能的工作原理，以及如何根据您的特定需求对其进行自定义。

域管理

域（Domains）可以看作是针对不同项目、主题或工作流的组织化工作区或浏览器选项卡。

工作流组织

将相关笔记分组到隔离的域中，以保持专注。每个域都维护其独立的撤销/重做历史记录，允许在不同任务之间进行隔离的实验，而不会影响工作区的其余部分。

工作区重新排序

通过点击并按住域标签，先拖拽然后水平移动，即可将域标签磁吸到新位置，重新组织您的工作区。双击任何域名称可立即编辑它。

移动端域名标签页关闭（双击确认安全机制）

在 Noust 移动端界面中，通过标签页上的“X”按钮关闭或删除域名需要连续点击两次，以防止误触导致工作区关闭：

• 第一次点击（安全确认）：标签页上的关闭按钮会进入高亮确认状态（显示主题强调色），提示该域名已就绪准备关闭。
• 第二次点击（执行删除）：再次点击按钮即可确认操作，移除该域名及其包含的所有笔记。点击其他位置或等待 3 秒后，确认状态将自动重置。
• 桌面端行为：在桌面端环境中，关闭标签页保持单次点击直接关闭，确保流畅快捷。

Atlas 图谱

可通过 Atlas 按钮访问此中心枢纽，它提供整个工作区层次结构的鸟瞰图，实现高层组织、多域概览和快速数据检索。

• 深度搜索：使用搜索输入框中的切换按钮搜索标题、内容或同时搜索这两者。

  • 专业提示：自定义标识

    由于搜索是按字面量匹配的，您可以通过在笔记内容中的任何位置添加诸如 #Vuln、#Task 或 @FollowUp 的标签来创建自己的标签系统，以便日后立即找到它们。

• 上下文预览：在搜索内容时，匹配文本的 2 行片段会显示在标题下方，以提供即时上下文。
• Hashtag 分析与计数器：
  • Hashtag 计数器：搜索 hashtag（例如 #tag）时，搜索框旁边会出现一个实时徽章，显示该 hashtag 在整个工作区中重复出现的总次数。
  • 分析面板：点击图表图标可打开 Hashtag 分析滑出式面板，展示代表最常用 hashtag 排名的交互式水平条形图。点击列表中的任何 hashtag 会自动筛选您的笔记。
• 笔记管理：
  • 重命名：点击笔记标题即可直接在 Atlas 中进行编辑。
  • 移动：在不同域之间拖放笔记以重新组织您的工作流程。
  • 删除：使用垃圾桶图标立即删除笔记。
• 域管理：
  • 重命名：点击域标签标题可直接重命名整个选项卡。
  • 排序：拖动域组可更改它们在工作区中的顺序。
  • 删除：一键删除整个域（及其中包含的所有笔记）。
  • 可见性：开启或关闭窗口顶部的水平域标签。如果您使用大纲侧边栏，强烈建议隐藏域标签，因为它消除了冗余的选项卡并释放了垂直画布空间。

配置

Atlas 和域标签的行为与布局可以在 设置 > 行为 的 Notes Overview Manager 部分下进行自定义。

Atlas 与域标签设置

• Atlas 网格布局：调整 Atlas 视图中显示的列数。
• 显示扇区：切换扇区标题是否在列表中索引。
• 域标签：切换水平域标签是否显示在页眉中。禁用此项以获得更多垂直画布区域。

工作区 Analytics 仪表板

通过全局操作中 Atlas 旁的四面板按钮打开仪表板。它将 Atlas、Objectives、路径 和 Topology 现有的 analytics 集中到同一个工作区视图中，而不会替代各自独立的 analytics 页面。

• 按域查看：仪表板会跟随当前活动的域标签。它只显示该域中拥有相关数据的模块和 analytics 区段；Topology 则保留自己的交互式图表范围选择。
• 响应式布局：模块会根据可用宽度及其内容自动调整。拖动模块即可重新排序；通过悬停时出现的细微边缘调整大小。所选顺序和尺寸会保存到工作区中。
• 全局模式 ：仪表板打开时，使用域标签上的地球按钮可汇总所有域的 Atlas、Objectives 和 路径 analytics。此模式不会改变 Topology；请通过其范围控件选择要包含的图表。

工作区导航

工作区是一个动态的 2D 画布（canvas），为您的想法提供无限空间。

平移与导航

在背景的任何空白区域按住 鼠标左键 以“抓取”并移动整个工作区。为了获得更流畅的体验，Noust 提供了 Free Canvas Drag（自由画布拖动） 模式：

• 按住模式 / Hold（默认）：在拖动 鼠标右键 时按住 Alt 键（Alt + 右键拖拽）可以从任何位置平移画布，即使您的光标位于笔记或按钮上方也是如此。
• 切换模式 / Toggle：按一次 Alt 键开启自由画布拖动（类似于 FPS 游戏中的准星瞄准切换），再次按下可关闭。开启后，在任意位置点击并拖动即可平移画布。在笔记内部单击（无拖动）会正常插入文本光标，而拖动单个笔记则需要先关闭自由拖动模式。

您可以在 设置 > 行为 中配置自由拖动模式（按住 与 切换）。

您还可以使用 Alt + 鼠标滚轮滚动 来放大和缩小画布，从而更轻松地浏览大量的工作。使用 Alt + 左键单击 可将缩放比例重置为 1:1，并将视图置于单击位置的中心（如果单击笔记，则使该笔记居中）。或者，您可以使用键盘快捷键 Alt + W / A / S / D 将画布视口平移一个页面或目标区域。

Alt 键冲突（Linux/Unix 用户）

如果您的操作系统使用 Alt 键来移动或拖动窗口（在若干 Linux 窗口管理器中很常见），画布缩放功能可能会受到干扰。要解决此问题，请遵循以下步骤：

1. 打开您的 窗口管理器微调（或桌面环境的辅助功能设置）。
2. 转到 辅助功能。
3. 将 “用于抓取和移动窗口的按键” 设置为 无。

大纲侧边栏 Atlas

如果需要持久性结构化的工作区视图，您可以在 设置 > 行为 下启用 大纲侧边栏（在 Notes Overview Manager 部分下）。

与中央 Atlas 模态框（充当临时弹出窗口）不同，大纲侧边栏停靠在画布的左侧。它提供了整个工作区布局的固定、可折叠的树状表示：

• 层次化布局：在一个紧凑的带有导向线的垂直列表中，显示所有的域、扇区（水平书签）、聚类和笔记。
• 即时操作：
  • 活动笔记高亮：自动高亮显示画布上当前处于活动状态或获得焦点的笔记。
  • 模糊搜索过滤器：使用侧边栏顶部的搜索栏模糊筛选节点。
  • 展开/折叠控制：点击方向箭头折叠或展开域和聚类，保持视图整洁。
• 交互性：点击任何域标签标题可切换活动标签页。点击笔记、聚类或水平书签会立即平移画布并使这些元素居中。当焦点在大纲侧边栏时按 Escape 可立即将其关闭。
• 触发模式：在设置中配置侧边栏的展开方式：
  • 悬停（默认）：鼠标移动到屏幕左边缘时自动滑出，鼠标移开 300ms 后自动收回。
  • 手动：通过点击预览把手或使用快捷键显式开启/关闭。
• 键盘快捷键与手势：
  • 使用 Alt + E 立即切换侧边栏。
  • 在悬停模式下，通过 Alt + E 开启侧边栏会将其钉住，防止在鼠标移开时自动收回。它将保持固定，直至手动再次切换或关闭。

动态自动滚动与自动缩放

在工作区中移动笔记时，Noust 采用了基于工作区占用情况与移动意图的智能内容感知自动缩放系统，以满足您的各种导航需求：

• 3 级动态缩放阶段：
  • 阶段 1（局部微调）：跨越屏幕边缘时的轻柔缩小，非常适合在边框或相邻笔记群附近进行精准放置，且不丢失局部细节视野。
  • 阶段 2（域穿梭）：持续向域内的活跃内容区域移动笔记时启用的平衡视野，适合在域各笔记群间跨越。
  • 阶段 3（全局全景）：专为跨越庞大、密集的工作区而设计的全景鸟瞰视图，让您能从工作区一端快速到达另一端。
• 意图驱动激活：镜头根据用户的拖拽意图动态切换阶段——当前方目标方向存在笔记内容并施加持续的边缘推力时逐步展开。
• 虚无保护：如果您将笔记推向前方没有内容的空白区域，系统将阻止进入更深层次的缩放并施加阻尼摩擦力，以防止迷失方向。
• 受限空间拖拽优化：当笔记占据屏幕很大比例时，系统会立即提供更宽广的视野，确保笔记始终完全可见且易于操控。
• 平滑降落：释放笔记的瞬间，画布将平滑恢复之前的缩放比例，并以智能方式将视口重新定位在笔记新位置周围。

配置

您可以在 设置 > 行为 中微调自动滚动与自动缩放。

自动滚动设置

• 拖动自动缩放：切换在笔记拖拽期间画布是否自动缩小以显示目的地。
• 边缘阈值：定义距屏幕边缘的距离（以像素为单位，最大 200px），在该距离处开始介入标准自动滚动（默认保持在 40px，但可完全自定义至 200px）。
• 最大速度：设置将笔记推向屏幕边界时画布能达到的最大像素/帧速度（从 15 提高到 40 以加快导航）。

电影般滚动导航

使用鼠标滚轮或触控板浏览庞大的工作区时，引入了基于物理的摩擦和惯性引擎，将高速滚动转变为平滑、电影般的低空滑行。

• 惯性触发缩放：给您的滚轮或触控板一个强力、有意的滑动。引擎检测到爆发的速度，并将画布自动拉回到 60% 宏观缩放，使您在穿梭时能鸟瞰全景。
• 居中飞行路径：与跟随光标的常规缩放不同，电影般滚动严格锚定在您的显示器中心。这提供了一条稳定、可预测的飞行轨道。
• 内容感知保护：只有当您的工作区足够庞大并且滚动方向上有实际内容时，宏观缩放才会开启。
• 自动降落机制：引擎监测您的静止状态。当您的滚动暂停 400 毫秒时，计算机会优雅地“降落”，平滑地插值变回您飞行前偏好的具体缩放比例。

配置

您可以在 设置 > 行为 中自定义电影般滚动的自动缩放行为。

滚动自动缩放设置

• 滚动自动缩放：切换在快速滚动期间画布是否自动缩小。

离散缩放级别

为了精确控制您的视野，您可以启用“离散缩放级别”。启用后，手动缩放（使用 Alt + 鼠标滚轮滚动）将严格贴合预定义的自定义步骤，而不是连续缩放。

当离散缩放处于活动状态时，切换域或加载应用将自动将视口初始化在配置的 Zoom Base Level 处，而不是 100%，从而保留了您首选的默认工作比例。

配置

您可以在 设置 > 行为 中切换和自定义这些步骤：

离散缩放设置

• 离散缩放：切换以启用或禁用离散步骤缩放逻辑。
• Zoom Max Level (%)：最大手动缩放级别（最小：10%，最大：100%，默认：100%）。聚焦操作（Alt + 点击、锚点导航）不会超过此限制。
• Zoom Base Level (%)：默认的初始缩放级别（最小：10%，最大：90%，默认：80%），在打开工作区或重置视图时使用。
• Zoom Macro Level (%)：优化用于读取笔记群集的缩放级别（最小：10%，默认：50%）。
• Zoom Overview Level (%)：用于扇区全局预览的缩放级别（最小：10%，默认：35%）。
• Zoom Global Level (%)：用于整个域鸟瞰图的缩放级别（最小：10%，默认：15%）。
• Focus Zoom：选择在聚焦笔记（Alt + 点击）或跳转至锚点时应用的目标缩放级别（Max、Base 或 Keep）。

NOTE

验证与限制：为了保持导航层次的连贯性，每个连续的缩放级别必须比其上方的级别至少低 10 个百分点。如果配置的设置违反了这一差距，设置面板会自动调整并夹紧相邻级别以保留此限制。

自动扩展逻辑

当您在画布边界内拖动笔记或调整其大小时，Noust 会动态创建更多空间。当笔记被释放时，域会自动收缩以贴合笔记的包围盒，消除多余的浪费空间。

配置

您可以在 设置 > 行为 中微调画布扩展方式和导航行为。

导航设置

• 域扩展：定义每次域增长时添加的像素空间量。
• 扩展触发：设置触发自动扩展行为的边缘距离。
• 缩略图启用：切换右下角的缩略图（Mini-Map）以进行快速定位。
• 画布平移模式：在 Alt + W/A/S/D 键盘快捷键的两种行为之间进行选择：
  • Smart（默认）：动态扫描画布移动方向上的内容，自动居中和构图笔记组以避免剪切内容。
  • Static：恢复为标准的固定平移，视口正好平移一整个物理屏幕尺寸。

缩略图

缩略图（Mini-Map）位于右下角，提供整个域的缩小版表示，突出显示当前视口位置以及所有笔记的分布位置。

• 快速导航：点击缩略图的任意位置，画布将立即在该位置居中。
• 定位：根据所有笔记的整体包围盒自动调整自身大小，确保在大型域中绝不会遗失孤立的数据。
• 自定义：如果需要更干净的界面，可以在 设置 > 行为 中完全禁用缩略图。

工作区锚点 (智能定位)

在每个域中设置一个主要的“大本营”，以快速在画布中导航定位。

• 交互：一个可拖动的靶心图标代表您的大本营。可将其放置在任何地方以定义主要的原点位置。或者，按住 Ctrl + Alt + 单击 画布或缩略图上的任意位置，可立即将锚点移动到该位置。
• HUD 指示器：左下角的悬浮面板实时跟踪您与锚点的距离，充当导航指南针。
• 返回原点：按下 Alt + X 或点击 HUD 按钮即可立即返回您的锚点。
• 智能拖拽：在拖动锚点时，缩略图将完全显示，展示当前框选区域的实时预览，实现像素级的完美定位。

配置

您可以在 设置 > 行为 中自定义锚点的定位逻辑。

锚点设置

• 会话锚点：切换锚点元素和导航 HUD 的可见性。
• 锚点模式：在两种特定行为中进行选择：
  • Smart Framing (默认)：自动检测并框选距离锚点最近的笔记群组，将其与视口的左上角对齐。
  • Classic Center：恢复为标准的固定居中对齐，即视口精确定位于锚点位置的中央。

工作区与跨标签页同步

Noust 提供了强大的多工作区架构以及灵活的跨标签页实时同步能力：

• 独立工作区：创建并在不同工作区之间无缝切换，以便组织不同的项目、客户或研究场景。每个工作区均独立隔离其画布笔记、域、Nexus 文档、拓扑图谱、环境变量以及云同步绑定。
• 原生后台持续自动保存 (Auto-Save)：本地数据持久化在后台全自动且实时运行。每一次编辑、笔记移动和结构调整都会异步写入 IndexedDB，无需手动保存，彻底消除数据丢失的担忧。
• 跨标签页同步 (Event Storage)：在 设置 > 行为 中，您可以启用或禁用多个打开的浏览器标签页之间的实时同步：
  • 已启用（默认）：在一个窗口中所做的更改或切换工作区操作，会通过 Event Storage / BroadcastChannel 实时同步广播给所有其他打开的活动标签页。
  • 已禁用（多工作区并行多任务）：关闭跨标签页同步后，每个浏览器标签页将作为完全独立的会话运行。这允许您在不同的标签页或窗口中同时打开并处理不同的工作区而互不干扰，同时后台自动保存依然会确保所有工作区数据安全存储在本地。

Nexus & Chronos (多面板工作区)

Nexus 系统将 Noust 从普通的 2D 画布转换为强大的多面板文档引擎。它允许您在可调整大小的并排布局中，同时查看历史时间戳记和多个长篇自由文本页面。

打开工作区

点击主工具栏中的 Nexus 图标以切换分割面板视图。默认情况下，它将打开 Chronos —— 一个汇聚您整个工作历史的中央鸟瞰时间线。

Chronos

Chronos 是高层次的按时序列合并聚合器。它扫描当前域中的每个笔记，提取所有的时间戳记块，并在统一、可搜索的时间线上呈现。

• 统一时间线：精确查看当前域内所有笔记中每条信息的添加或更新时间。
• 按日期搜索：使用搜索框按天、月、年或特定时间过滤时间线（例如输入 Today、01/05/2026 06:15、01/05 或 /05/）。
• 切换排序：使用页眉中的排序按钮在 最近优先（默认）和 最早优先 之间进行切换。
• 交互式片段：点击 Chronos 中的任何项目可将其展开，以查看完整原始内容。
• 点击复制：悬停在任何记录上并点击剪贴板图标，即可立即复制精确的 ISO 时间戳，以便用于您的报告中。

自由文本页面

除了标准的画布笔记外，Nexus 还允许您维护独立的、长篇幅的自由文本页面。这些页面非常适合撰写结构化报告、发现总结或详细的技术规程。

• Markdown 支持：Nexus 自由文本页面支持 Markdown 语法子集以提供技术文档结构：
  • # 标题 1，## 标题 2，### 标题 3 代表标题层级。
  • ```（三个反引号）代表立即插入 代码块。
• 代码块：专为技术数据、代码片段或日志设计的容器。
  • 自动转换：键入三个反引号（```）可立即使当前行转换为代码块。
  • 选区包裹：选择任意文本，并使用工具栏中的“代码块”按钮将其包入容器。
• 格式化工具栏：在编辑自由文本页面时会出现一个紧凑的格式化工具栏。它支持将文本转换为 H1、H2、H3 标题，并包含一个 Normal Text 按钮，以快速清除标题格式并使文本块恢复为普通段落。
• 完整编辑：享受与画布笔记相同强大的列表制作、复选框和折叠块功能，但其呈现在更加专注的文档类界面中。
• 内联图像与标注：直接在文档中粘贴图像。选择图像后会显示一个浮动工具栏，用于调整对齐方式（左、中、右）或动态调整其大小。标准内联图像与绘制管理器完全集成，允许您使用矢量标注工具栏（自由手绘、箭头、形状、自定义颜色）直接在图像上进行绘制。
• 时间线集成：直接在自由文本页面内追踪文档的演变。手动模式（Alt + T）和自动模式均完全支持 — 当 Auto Chronos 激活时，将在您键入时自动创建带时间戳的块，就像在标准笔记中一样。点击页面标题中的时钟图标以切换内联时间线视图：时间戳以紧凑的标记形式显示在页面左侧边距，支持悬停高亮显示，每个标记上还有一个删除按钮。
• 页面边距自定义：在使用分页页面视图模式时，您可以使用页边距切换按钮（带虚线边框的页面图标）为编辑和 PDF 导出自定义页面边界：
  • 标准边距 (推荐)：默认启用，这会在 A4 尺寸中应用 10mm 25mm 的专业阅读优化边距。强烈建议在标准报告时采用此布局，因为它能确保完美的文本对齐、最佳的阅读行长以及一致的视觉风格。
  • 浏览器自定义边距：禁用边距会移除页面的 @page 样式覆盖，并将页面容器扩大至全宽（100%）。这很实用，因为它能将完整的排版控制权交还给用户，允许您直接在浏览器的打印对话框中配置自定义页边距（例如最小、无或自定义宽度）。
• 全局页面搜索：在 Nexus 侧边栏的 PAGES 部分下的实时搜索输入框可以实时过滤文件夹和文档。
  • 动态范围：搜索文件夹名称、文档标题以及文档中纯化的文本内容。
  • 上下文感知：在搜索过程中，包含匹配文档的文件夹会自动保持可见并临时展开。
  • 刀锋式展开：当侧边栏折叠时，搜索栏由一个紧凑的图标按钮表示。点击它会立即展开侧边栏并聚焦搜索输入框。

多面板编排

Nexus 的真正威力在于其灵活的布局引擎，允许您构建研究所需的精确工作面板。

• 并排编辑：同时打开多个页面。您可以在左侧打开 Chronos 用于参考，同时在右侧撰写报告。
• 拖放组织：
  • 从 Atlas 打开：从 Atlas 中拖拽任何文档并将其投放到 Nexus 区域。
  • 定位：将页面放置在现有面板的 左边缘 或 右边缘 以拆分视图。蓝色指示器将精确地向您显示新面板的磁吸对齐位置。
• 独立大小调整：在面板之间悬停以找到调整把手。每个面板均可独立调整以最大化屏幕利用率。
• 布局持久化：Noust 自动记住您打开了哪些页面、侧边栏的折叠状态（NEXUS_IS_SIDEBAR_COLLAPSED）以及 Nexus 面板的宽度，这会动态触发自动保存。
• PDF 导出：将您的自由文本页面导出为专业的 PDF 文档。
  • 打印友好：导出使用白底明亮主题以保证打印效率，同时保留代码块的深色美学。
  • 本地处理：PDF 生成完全在您的浏览器本地进行，以保护您的隐私。
  • 嵌入式拓扑与路径图表：嵌入的快照呈现为矢量图形，能够自适应平滑缩放到可打印页面宽度。
  • 交互：点击任意 Nexus 文档顶部的 PDF 图标以触发导出。

用于 PDF 报告的图表尺寸建议

由于 A4 规格的 PDF 页面为纵向（垂直方向），嵌入的拓扑图会自动根据文档列宽进行缩放。为了确保文字的最大清晰度与出色的视觉呈现，建议在设计图表时采用垂直流或均衡的多列模块布局（推荐图表宽度：约 600px–850px），而不是超长的单行横向排布。

导航提示

如果仅活动了一个面板，Chronos 将始终保持开启状态作为您的“大本营”。要关闭它，您必须打开至少另一个自由文本页面。您也可以使用 Alt + V 快捷键快速切换整个 Nexus 侧边栏的显示。

Nexus 目标

目标（Objectives）系统允许您直接在当前域中定义、跟踪和关联项目目标。与笔记和时间线一样，目标具有域范围属性，这意味着每个选项卡维护其独立的目标集和相关笔记链接。这在高级任务管理与笔记中的原始信息之间架起了一座桥梁，而不会污染其他工作阶段。

• 目标追踪与排序：创建带有截止日期的目标（快捷键：目标面板处于活跃状态时按 Alt + Q）。使用内置的日期微调器微调时间线，点击 按截止日期排序 按钮整理活动目标，或在无截止日期排序和筛选器活动时通过拖拽手动重排。将目标拖动到顶部的 进行中 区域进行专门跟踪。排序首选项按域保存。新创建的目标默认关闭路径。
• 目标优先级：切换任何活动目标上的星标图标以优先考虑它。高优目标会被钉在其各自列表（活动 或 进行中）的顶部。拖放边界确保不能将非高优目标拖动到高优目标之上，但允许在同一优先级层级内进行手动重排。
• 快速目标：您可以直接在笔记的浮动上下文侧边栏中将笔记关联到目标，或创建一个新的目标。这会自动将笔记关联到新目标，使您可以立即将想法转化为行动。
• 一对多关联：
  • 一个目标，多个笔记：一个目标可以由同一域内的多个笔记提供支持。
  • 一个笔记，一个目标：为了保持逻辑清晰，每个笔记一次只能关联到 一个主要目标。将笔记关联到新目标会自动将其从以前的目标中移除。
• 视觉状态：每个目标都有一个进度复选框。已完成的目标会视觉变暗，以使您的精力集中在未完成的目标上。
• 笔记关联 (目标定位模式)：
  • 点击目标上的靶心图标进入定位模式。
  • 智能导航：画布将自动 缩小 (60%) 并聚焦在您的锚点上，为您定位相关笔记提供全局视野。
  • 交互关联：只需点击画布上的任意笔记，即可将其与当前目标进行关联或取消关联。
  • 快速退出：按下 Esc 或再次点击靶心图标退出定位模式。
• 双向交互：
  • 从 Nexus 到画布：每个目标下列出了其关联的笔记。点击“转到笔记”即可将画布视口立即定位到该笔记。
  • 从画布到 Nexus：活动或悬停的笔记会显示一个浮动上下文侧边栏。点击侧边栏中的 Objective 图标以打开 Nexus 并高亮显示相应的目标，或使用 路径 图标在路径看板中切换其可见性。
• 侧边栏编辑：在侧边栏中展开关联的笔记，可以实时编辑其 标题 或 内容。更改将立即同步到画布笔记上。
• 集成 Flag 管理：点击目标页眉中排序按钮旁边的旗帜图标可以切换 flag 侧边栏配置面板，能够创建、编辑、着色或导出域旗帜。
• 动态缩略图：当 Nexus 开启时，缩略图会自动向左滑动以保持可见。如果您扩大 Nexus 面板至几乎占满屏幕，缩略图将优雅隐藏以腾出空间。

Nexus 路径 (Path) 视觉化

路径视觉化系统为您的里程碑和目标提供交互式、可视化的路径图。这有助于跟踪进度、定义依赖关系以及在项目的各个阶段可视化时间线模式。

启用路径模式与布局集成

要进入路径视图，请单击 Nexus 侧边栏页眉中的 路径 按钮。您可以使用页眉中的模式选择器来自定义路径面板与工作区的集成方式：

• Canvas 模式：切换中央工作区，将 2D 笔记画布替换为交互式路径视觉化面板。
• Nexus 模式（嵌入式）：将路径视觉化直接嵌入到 Nexus 编辑器的侧边栏面板中，同时保持主屏幕上的 2D 笔记画布完全可见和可编辑。

您的偏好将保存到您的本地工作区设置中，并在会话之间保持。

组织模式

• 成就路径 (Achievement Path)：一条时间线路径，根据完成顺序依次显示里程碑。
• 生命周期追踪 (Lifecycle Trace)：追踪里程碑和目标从开始日期到结束日期的完整持续时间，突出显示重叠和并行路径。
• 泳道 (Swimlanes)：根据分配给里程碑的亲属类别标签，将它们分组到专用的泳道中。

时间线顺序 vs. 手动顺序

默认情况下，路径视图中的里程碑是按时间顺序组织的，遵循其对应卡片上设置的日期。但是，您可以拖放卡片以手动调整它们的顺序。 当您手动重新定位卡片时，自定义布局顺序具有优先权。用户应该注意，这可能会导致日期在视觉化路径上以非时间顺序显示。

工作区交互

• 卡片与泳道的拖放：
  • 重新排序泳道：拖放类别页眉或泳道以重新对齐布局序列。
  • 重新排序卡片：拖放里程碑卡片以手动调整它们的顺序。
  • 跨类别分配：在泳道模式下，将卡片从一个泳道拖动并放置到另一个泳道中，会动态更新卡片的标签以匹配新的亲属类别或子类别，从而简化任务分类。
• 智能标签分组：带有多个标签的里程碑被智能地分组到代表序列中最新阶段的亲属标签中（例如，优先考虑“初始访问”而非“侦察”）。
• 插入里程碑：通过单击卡片之间连接路径上的“+”按钮，在行内插入新的手动里程碑。当卡片是序列中最后一张或唯一的一张时，“+”按钮会自动显示在它的前方（跟随一条短虚线），以便于方便地继续路径。
• 动态传播类别颜色：在泳道模式下，连接线、里程碑标签（obj 或 ms）以及插入按钮（+）都将动态继承其亲属类别的颜色代码，便于进行视觉细分。

路径分析 (Path Analytics)

路径分析引擎提供有关您的里程碑和目标的时间线和类别的详细分析。您可以通过单击路径页眉中的分析 (Analytics) 图标来启动它。

• 阶段拆分：按生命周期阶段和类别标签显示活跃里程碑的视觉拆分，跟踪任务在工作流中的分布情况。
• 统计摘要：总结已完成的目标、活跃的里程碑和类别数量，以便实时测量项目进度。

文档集成（/flow 命令）

您可以将动态路径视觉化直接嵌入到 Nexus 自由文本页面中，以丰富您的报告：

• 插入：在任何 Nexus 自由文本页面中输入 /flow 以打开行内选择器并选择要嵌入的路径。您可以直接在弹出窗口中从 8 种布局配置中进行选择，其中包括 成就路径、生命周期追踪 或 6 种分类泳道的排列方式。
• 就地编辑：选择一个嵌入的路径快照以在其调整大小工具栏中显示配置齿轮按钮。单击此按钮可打开布局模式选择器，以便您就地更改布局配置。
• 对齐与大小：插入后，选择路径快照以使用控制柄动态调整其大小，或使用悬浮图像工具栏对其进行对齐（左对齐、居中、右对齐）。
• 撤销/重做支持：对嵌入路径的所有操作（插入、调整大小、对齐、拖动重新排序和删除）都完全集成到浏览器的原生历史记录中，从而实现无缝的撤销 (Ctrl + Z) 和重做 (Ctrl + Y) 操作。

Intel Board

Intel Board 是一个交互式的图可视化与关系映射引擎，它将您工作区中的笔记、聚类（Clusters）和扇区转换为动态的视觉情报图谱。它允许您分析关联、绘制调查路径并可视化依赖关系，而无需更改原始画布的布局。

激活 Intel 模式与 Board 可视化

• 页眉 Intel 操作：点击顶部页眉操作栏中的 Intel 按钮（或按下 Alt + I）以在工作区上启用 Intel 模式。
• 浮动工具栏与模式：当 Intel 模式处于激活状态时，屏幕上会出现一个浮动工具栏：
  • 链接模式（Linking Mode）：用于在笔记之间创建和管理连接线的默认状态。浮动工具栏显示 打开 Intel Board 按钮。
  • Intel Board 模式：点击浮动工具栏上的 打开 Intel Board 可切换至自动排列的图可视化模式。在此模式下，浮动工具栏更新显示：
    • 链接模式（Linking Mode）：点击可退出 Intel Board 模式并返回标准的链接模式。
    • Reset Layout（重置布局）：点击可清除所有手动拖拽的自定义位置，并恢复图的自动布局结构。

关系映射与链接

• 八边形连接控制柄：在链接模式下，每个笔记卡片和聚类容器都会显示一个视觉 八边形控制柄，作为关系路径的交互式锚点。
• 可视化连接线：直接从一个笔记的八边形控制柄拖拽到另一个笔记的控制柄，即可生成带有方向箭头的动态弯曲 SVG 关系线。
• 跨域连接（Alt + 点击）：要在不同工作区域选项卡之间连接元素：
  • 在当前活动域中，按住 Alt + 点击 一个或多个源笔记/聚类的 八边形控制柄。浮动 HUD 提示将突出显示待连接的源节点。
  • 切换到任何目标域选项卡。
  • 点击该域中目标笔记或聚类的 八边形控制柄，即可立即建立跨域连接线。
• 链接管理与重新拖拽：点击任何现有的连接线可检查关系详情或立即将其删除。拖拽现有的连接线允许您将关系路径重新分配给新的目标节点。

自动图布局引擎

• 结构化分组：Intel Board 会自动将笔记分组在其各自的扇区标题和聚类下方，将它们组织为清晰可读的结构化组件流。
• 重叠预防：图布局引擎会自动计算空间边界和垂直间距，确保标题、笔记卡片和聚类永远不会相互重叠或遮挡。

自定义定位与图操作

• 拖放重新排序：点击并拖动任何扇区标题、独立笔记或聚类容器，即可将其重新放置在看板上的任何位置。
• 锚定标题的流动：移动扇区标题时，其关联的笔记会自动锚定到新位置，保持相关信息整洁地分组在一起。
• 独立的撤销/重做：Intel Board 拥有专属的历史记录栈。在可视化模式下使用 Ctrl + Z 和 Ctrl + Y 可以撤销和重做看板移动与链接修改，而不会影响标准画布的撤销步骤。
• Reset Layout（重置布局）：随时点击浮动工具栏中的 Reset Layout 按钮，即可清除自定义看板位置并恢复自动化图结构。

拓扑画布

拓扑画布 (Topology Canvas) 是一个交互式、可视化的拓扑图设计引擎，旨在绘制网络基础设施、数据流、威胁模型或执行路径。它与您的工作区笔记和域完全集成。

拓扑图生命周期与列表视图

拓扑画布支持在每个工作区中维护多个拓扑图：

• 拓扑图列表：当您打开拓扑工作区时，系统会为您呈现所有已创建的拓扑图列表，允许您创建新拓扑图或打开现有拓扑图。
• 自动状态重置：关闭拓扑面板（单击 X）或切换到另一个 Nexus 选项卡会重置活跃拓扑图的状态。当您重新打开拓扑面板时，它会从列表视图重新开始，而不是强制您返回到上一个活跃的拓扑图。
• 数据持久化：拓扑图的配置和状态会自动保存到您的工作区存储中。
• 标签导出与导入：将光标悬停在拓扑图列表中的任何项目上以访问 导出标签（下载图标）和 导入标签（上传图标）操作。这允许您使用安全标准 .noust 数据包（带有 AES-GCM 加密）或替代的 .json / .npad 格式备份、恢复或共享自定义标签定义（名称和颜色）。
  • 合并：将导入的标签添加到拓扑图的现有集合中，而不复制名称（不区分大小写）。
  • 替换：覆盖所有标签。自动过滤并清理节点中对不再存在的标签的引用，以避免孤立引用。
  • 安全保护：应用 5 MB 的最大文件大小限制，将标签名称截断为 100 个字符，将导入限制为 500 个标签，并防止 ID 冲突，以保持系统完整性和 SVG 画布的流畅性能。

节点管理与自定义

节点是拓扑图的构建基块。

• 创建节点：在拓扑工作区内按下 Alt + Q 可立即生成一个新节点。
• 定义形状：从三种结构形状中进行选择，以代表不同的资产或概念：
  • 卡片 (矩形)：适用于主机、服务器或常规笔记。
  • 圆形：适用于路由器、网关或关键事件。
  • 八角形：非常适合决策点、防火墙或终端。
• 笔记关联：双击任何节点以将其直接链接到工作区笔记。
  • 链接的节点会显示一个专用的 笔记图标，表明它们的关系。
  • 双击链接的笔记（或双击展开节点上的笔记表示形式）可立即在画布中打开并居中显示相应的笔记。如果拓扑画布处于覆盖模式 (Overlay)，它会自动关闭以显示笔记。如果处于嵌入模式（在 Nexus 内），侧边栏面板保持打开状态。
• 标签与 Tags：使用多个自定义颜色标签对节点进行标记，以表明严重性、状态或资产类别。标签会动态显示在节点内部或通过精致的提示框显示。

笔记侧边栏 (拖放创建)

一个交互式侧边抽屉列出了您当前域中所有可用的笔记，从而实现了笔记到节点的无缝映射。

• 按域过滤：使用侧边栏顶部的域药丸按钮过滤列表，以显示属于工作区其他域的笔记。
• 拖动创建：从侧边栏中拖动任何笔记并将其直接放置到拓扑画布上，以立即创建一个预先链接到该笔记的节点。
• 多选拖动：单击侧边栏列表中的多个笔记以将其选择（以彩色边框突出显示）。拖动任何选择的笔记会将其全部一起拖动。将其放置在画布上时，它们会被创建为单个节点，并以 220px 的间距自动排列在一条水平线上。
• 交互式映射：在画布上配置任何标准节点时，您也可以从下拉菜单中选择要链接的笔记。
• 实时同步：对笔记标题所做的任何更改（无论是手动键入还是通过自动标题引擎自动生成）都会立即传播到侧边栏笔记列表以及活跃拓扑图中的所有相应节点。

连接线 (方向性边缘)

将节点连接在一起以说明通信路径或数据流。

• 绘制连接线：将光标悬停在节点上以显示四个侧面的连接句柄。从任何句柄单击并拖动到另一个节点以建立一条有方向的线。
• 避让与曲线路由：连接线绘制为平滑的贝塞尔曲线。如果一条线要穿过节点的下方或上方，路由引擎会自动计算避让，使路径绕过节点弯曲，以保持拓扑图的可读性。
• 方向指示器：连接线通过集成的箭头显示方向，以代表信息流。
• 连接线标签合并：冗余连接线标签（共享相同的标签且在同一句柄上开始/结束）可以通过悬停在连接线上并单击“合并”来统一为单个视觉标签。合并后的标签会自动在所有成员连接线上同步任何标题编辑，悬停在其上会显示一个“拆分”按钮以取消分组。
• 共享线段上的标签定位：合并后的标签会自动定位在共享的直线段上（准确地说，在连接线合并的 T 字路口起 16px 处）。标签在数学上居中于线的轴线上，使其远离箭头或节点句柄。
• 串联连接节点：选择画布上的两个或多个节点，然后按下 Alt + S（或使用悬浮选择工具栏上的按钮）将它们串联连接起来。系统根据它们的位置（水平布局从左到右，垂直对齐节点在 20px 阈值内从上到下）自动对选择的节点进行排序，并依次连接它们。

节点分组 (Clusters)

通过将节点分组到定义的区域来组织复杂的网络。

• 创建 Cluster：选择两个或多个节点（使用 Ctrl + 单击 或框选），然后按下 Alt + E 将它们分组到一个 cluster 中。
• 视觉边界：Cluster 由有颜色且有标签的边界框表示，边界框会自动调整大小以容纳其所有成员节点。
• 就地编辑标题：双击 cluster 的页眉以通过就地文本输入直接编辑其名称。按下 Enter 或单击外部以保存新标题，或按下 Escape 取消并还原更改。
• 关联笔记到 Cluster：您可以将一个或多个工作区笔记直接链接到 cluster（而不是单个节点）。链接的笔记在 cluster 主体内部显示为独特的“玻璃态”样式徽章，并且可以使用其快速取消关联按钮立即删除。
• 样式与颜色传播：放置在 cluster 边界内的节点会自动继承 cluster 的主题颜色（背景、边框、阴影和悬停时的过渡），以保持一致的视觉形象。
• Cluster 之间的连接：可以直接连接不同 cluster 内的分组节点，以绘制区域之间复杂的通信。

智能布局 (整理 / Tidy Up)

无需手动微操作即可保持拓扑图整洁且有结构。

• 整理 (Tidy Up)：按下 Alt + W 以触发布局算法。它会自动检测节点链，并以恒定间距水平或垂直对齐它们。
• 节点钉住 (锁定)：
  • 要防止节点被整理引擎自动重新定位，请单击其角落的 图钉 (Pushpin) 图标。
  • 视觉指示器：钉住的节点会显示一个填充为绿色（或 cluster 颜色）的图钉图标。
  • 布局锚点：钉住的节点在整理期间保持锁定在其手动坐标处，作为固定的对齐锚点，其余自由节点将向其对齐。

智能辅助线与磁性对齐

为了在设计拓扑图时提高对齐精度，拓扑画布实现了一个智能对齐引擎：

• 磁性对齐：在拖动任何节点或 cluster 时，它会自动对齐到相邻元素（包括节点和 cluster）的边缘或中心线，对齐阈值为 6px，该阈值会根据当前的缩放比例进行动态调整。
• 动态智能辅助线：画布上会渲染 SVG 对齐线，显示当前对齐了哪些边缘或中心。
• 悬浮距离徽章：精致的悬浮标签会显示对齐组件之间的精确像素距离。这些徽章悬浮在画布选择轮廓上方，以便在任何缩放级别下都完全可读。

交互与选择

• 多选：按住 Ctrl 键并单击单个节点，或按住 Ctrl 键并在背景上拖动选择框以选择多个节点。
• 多选协调拖动：拖动多选中的任何元素将同时移动所有选择的节点和 cluster 作为一个协调的整体，保持它们的相对偏移。子 cluster 及其包含的节点将自动一起移动，在整个移动过程中保持画布的选择状态。
• 悬浮选择工具栏：当选择两个或多个节点时，悬浮操作工具栏会显示在选择范围的顶部中央。它提供了用于 创建 Cluster (Alt+E) 或 串联连接节点 (Alt+S) 的快速按钮。
• 画布导航：使用与 Noust 主工作区相同的平滑导航控制，在拓扑视图中进行平移和缩放。

布局集成模式

与路径系统类似，拓扑画布支持两种布局集成模式：

• 覆盖模式 (Overlay)：将中央 2D 笔记画布工作区替换为交互式拓扑画布。
• 嵌入模式 (Embedded)：将拓扑画布工作区直接嵌入到 Nexus 编辑器的侧边栏选项卡中，允许您在笔记旁绘制拓扑图。

报告与 PDF 导出的图表布局最佳实践

当设计的拓扑图用于嵌入 Nexus 文档或导出为 PDF 时：

• 优先采用垂直与均衡布局：标准文档页面均为纵向方向。垂直组织架构（例如自上而下的多层流或堆叠的 cluster 列）可以最大化利用页面版面，并确保节点标题与标签大而清晰。
• 避免过长的单行横向排布：过宽的单行水平图表必须大幅缩小才能适应页面边距，这会导致文字过小、影响视觉体验。
• 最佳推荐宽度：将图表总体宽度保持在 600px 至 850px 之间，可确保导出的报告中节点、连线与徽章均以最佳缩放比例和清晰度渲染。

拓扑分析 (Topology Analytics)

拓扑分析引擎提供有关网络拓扑和通信路径的深层结构见解和指标。您可以通过单击拓扑侧边栏中的分析 (Analytics) 图标来启动它。

• 范围选择：分析单个活跃拓扑图，或同时选择多个拓扑图以计算聚合统计信息（总拓扑图数、节点数、连接线数、cluster 数）。
• 包括 Hashtag：启用“包括链接笔记的 hashtag”选项。启用后，分析引擎会自动解析链接到节点/cluster 的所有笔记的标题和 HTML 内容，提取 hashtag（例如 #firewall、#vulnerability）并将其与节点标签并排汇总。

分析图表与指标

• 标签频率图表：渲染一个整洁且动态的 SVG 水平条形图，可视化所选范围内最频繁出现的 8 个节点标签和 hashtag。
• Cluster 相关性：生成表示每个定义 cluster 中标签出现情况的分布，显示绝对出现次数和百分比，以可视化安全区域内的资产/威胁密度。
• 标签共现选择器：一个交互式查询卡，显示共享多个所选标签/hashtag 的节点。它显示匹配数，并允许直接在画布上突出显示匹配的节点。
• 连接路径相关性：计算并显示 5 个最常见的有方向路径模式（例如，源标签 ➔ [连接线标签] ➔ 目标标签）并允许在活跃拓扑图上突出显示这些路径。

文档集成与内联图表

您可以将交互式拓扑图表直接嵌入到 Nexus 自由文本页面中，以增强您的报告：

• 复制嵌入代码：单击分析面板中任何频率或相关性图表上的 复制嵌入代码 按钮。这会将诸如 [topology-chart:<scope>:<type>]（其中类型为 label-freq 或 cluster-dist）的嵌入代码复制到您的剪贴板。
• 渲染与交互：将此标签粘贴到任何 Nexus 自由文本页面中。Noust 会解析它并将其动态呈现为交互式、风格化的图表。您可以使用标准布局控制柄对齐这些内联图表（左对齐、居中、右对齐）或调整其大小。

标签管理与冲突防止

一个统一且健壮的标签管理系统在 Nexus 目标模块和 路径 模块之间共享（可在路径主设置面板、侧面板和悬浮设置面板中找到）：

• 唯一名称生成：添加新标签时，系统会自动分配一个唯一的占位符名称（例如 新标签、新标签 2 等），以避免直接的名称冲突。
• 不区分大小写的重复防止：重命名任何标签会对该域中的所有现有标签进行严格的、不区分大小写的检查。如果输入了重复的名称或字段留空，更改将被拒绝，输入将还原，并向用户显示错误通知。
• 导入期间的自动去重：从 JSON 导入标签时，导入管道会解析并清理标签，并为在文件中检测到的任何重复名称自动添加增量计数器，以确保标签集合无冲突。

笔记交互与布局

完全控制您的文档在画布上的视觉组织方式。

多选与拖动

使用 Ctrl + 单击 或只需 按住 Ctrl 并拖动鼠标 即可一次选择并移动多个笔记。主笔记充当对齐线和对齐的锚点，使得在保持相对布局的同时轻松重新定位整个信息 cluster。

要在无需专门单击其页眉的情况下快速移动单个笔记，请按住 Alt 键并使用 鼠标右键 从笔记的任何部分（包括文本内容）进行拖动。这会覆盖手动文本编辑以优先进行移动。

笔记上下文侧边栏

悬停或聚焦任何笔记会显示其右边缘的悬浮上下文侧边栏。该侧边栏包含快速访问工具：

• 目标（目标图标）：允许将笔记关联或取消关联到目标，打开 Nexus 并突出显示关联的目标。
• 路径（路径图标）：切换笔记的目标/里程碑在路径视觉化面板中是否可见。

自定义上下文菜单

为了增强导航、工作流和生产力，Noust 在右键单击画布空白背景和单个笔记时提供自定义上下文菜单。这些菜单取代了浏览器的标准右键菜单，除非按下 Alt 或 Shift（这保留了浏览器原生菜单和带有 Alt + 右键拖拽 的画布平移手势）。

• 画布右击菜单：右键单击画布的空白区域以访问快速操作：
  • 添加笔记：在单击的坐标处创建文本笔记。
  • 添加图片笔记：提示用户选择图片文件并将其放置在指定的坐标处。
  • 粘贴剪贴板为笔记：立即读取剪贴板内容，并在目标坐标处创建文本笔记或图片笔记。
  • 设置锚点：在指定的坐标处设置域锚点。
  • 视图在此居中：平滑滚动并使视口在指定的坐标处居中。
  • 重置缩放：平滑地将缩放级别转回您配置的基准缩放（例如 80%）。
• 笔记右击菜单：右键单击任何笔记卡以触发操作：
  • 与目标关联/取消关联：使笔记与目标关联或取消关联。
  • 从路径中添加/删除：切换笔记在路径面板中的可见性。
  • 复制内容：复制笔记的文本内容（或者为图片笔记复制图片 blob）。
  • 切换折叠：展开或折叠笔记。
  • 删除笔记：开始删除笔记。
• 无冲突放置：通过画布上下文菜单放置笔记时，螺旋搜索算法会检查与其他元素（笔记、扇区、cluster）的重叠，并自动找到最近的非重叠位置。
• 设置切换：在 设置 -> 行为 菜单的 笔记交互与流 下，您可以切换 Hover Note Context Menu 设置。启用时，悬浮悬停或聚焦笔记时会显示悬浮按钮。禁用时，这些悬浮按钮隐藏，用户只能通过右键菜单访问路径和目标链接。

画布上的独立图片笔记

图片笔记不是在普通文本笔记中内联插入图片，而是直接在画布上创建为独立的一等卡片。它们拥有带可编辑标题的页眉、大小调整控制柄，并且可以使用智能面板 (workspaceEdges) 进行移动、选择、在 cluster 中分组和连接。

• Chronos集成: 图像笔记可以集成到Chronos时间轴中。在自动模式下，它们会自动获得创建时间戳。在手动模式下，右键单击图像笔记并选择 Assign Timestamp 将其注册在时间轴上。

• 延迟加载 (Lazy Loading)：图片笔记从 IndexedDB 获取解密的二进制数据，仅在其处于活跃状态时将其缓存到内存中，以保持系统性能。

• 图片绘制与标注：图片笔记在上方带有一个专用的悬浮工具栏，可进行手绘涂鸦、绘制直线、箭头和圆圈。标注作为矢量笔划保存在笔记数据中，并自动同步到 IndexedDB。

  • 绘制模式切换：在绘制模式下，拖动笔记的功能会被自动禁用，使您可以专心作画而不会意外移动笔记。
  • 基于主题 dissolution 的动态颜色：从与您工作区主题动态匹配的 5 种预设颜色中进行选择，或使用显示仅包含授权主题颜色的 HSL 色谱的颜色选择器。
  • 撤销 (Undo) 支持：使用工具栏中的**撤销 (Undo)**按钮或在笔记内部按下 Ctrl + Z，可以轻松撤销上一次的绘制笔划。

• 复制选项：右键单击图片笔记可提供两个复制功能：

  • Copy Content (复制内容)：将原始图片与您的绘制内容合并，并将合并后的结果作为 PNG 图片直接导出到剪贴板。
  • Copy Original Image (复制原始图片)：仅将原始上传的图片复制到剪贴板，不包含任何绘制内容。

• 拖动、大小调整和灯箱：图片笔记可以正常移动和调整大小。双击图片笔记可打开带有“玻璃态”样式的优质灯箱查看器，显示高分辨率图片及其标题。

• 剪贴板与拖放支持：

  • 拖放：将图片文件从您的操作系统直接拖放到画布上，会在放置的精确坐标处创建图片笔记。
  • 粘贴：在画布处于聚焦状态时（在文本输入外部）粘贴剪贴板中的图片 (Ctrl + V) 会自动在当前鼠标位置创建图片笔记。

• 成比例的长宽比：从文件创建图片笔记时，系统会自动测量图片的尺寸，并将大文件缩放以使其适应 350x300px 的最大边界框内，同时保持自然的长宽比。

笔记 Cluster (视觉分组)

除了动态扇区外，您还可以手动将笔记分组到 Clusters 中，以在画布上可视地组织复杂的数据。

• 创建 Cluster：选择两个或多个笔记（使用 Ctrl + 单击 或框选），然后按下 Alt + C 将它们分组到一个 cluster 中。
• 视觉边界：Cluster 在您的笔记周围创建一个独特的虚线边界，并带有可编辑的标题。
• 智能重排：创建 cluster 会自动将重叠的未选择笔记推开，从而确保整洁的分组，而无需手动重新定位。
• Cluster 移动：拖动 cluster 会自动将所有成员笔记作为一个整体一起移动，保持它们的相对位置。

折叠与流动 (Collapse & Flow)

单击笔记页眉中的箭头以切换其高度。直下方的笔记将自动被拉起或向下推，以保持布局。

Noust 实现了一个专门的布局引擎，称为 组织单元 (Unity of Organization)。该系统确保您的笔记作为一个凝聚力强的组而不是孤立的元素来运行。它理解笔记之间的空间关系，并递归地应用移动。

Cluster 的连锁反应

与仅分析直接碰撞的标准布局引擎不同，组织单元会触发递归的 cluster 连锁反应：

1. 锚点笔记：您直接折叠或展开的笔记充当 锚点。它仅触发直接位于其垂直路径上的笔记的移动。位于锚点侧面的任何笔记（如图中的侧边笔记）保持 隔离。
2. 递归传播：一旦笔记开始移动（如次级笔记 1），它就成为 移动 Cluster 的一部分。
3. 全向流动：对于移动 Cluster 中的每个笔记，组织单元会应用到进入其邻近范围的 所有周围笔记（下方、左侧或右侧）。
4. 组完整性：这确保了整个结构（即使是具有复杂水平和垂直排列的结构）保持为一个单一的逻辑单元。请注意，整个笔记 cluster 是如何一起移动的，因为它们垂直或水平地链接到移动链。

可视化组织单元

下图说明了锚点笔记中的笔记折叠如何触发整个 cluster 中的级联拉起。请注意，侧边笔记由于位于锚点垂直路径外部而保持隔离，而整个绿色笔记 cluster 一起向上移动以填补空间。

设置

定义哪些笔记属于 组织单元 的逻辑距离可以在 设置 > 行为 中进行调整。

笔记交互设置

• 分组半径 (Group Radius)：调整笔记被视为“链接”的范围。增加此值会使布局引擎更敏感，从而将相距更远的笔记分组到同一个组织单元中。
• 自动重排 (Auto-Reflow)：启用或禁用折叠/展开时周围笔记的自动移动。禁用此功能允许纯粹在本地执行笔记大小调整，而不影响工作区的其他部分。

删除时拉起 (Pull Up on Delete)

为了防止在删除笔记时在画布上留下空白间隙，Noust 包含了针对堆叠列表（如一个放在另一个下方的折叠笔记）的布局优化功能。

• 相邻堆叠检测：删除笔记时，布局引擎会搜索同一域中其正下方的笔记。如果检测到垂直对齐的堆叠（垂直间距 $\le 24\text{px}$），则会在已删除笔记的位置显示一个悬浮操作按钮。
• 悬浮操作工具栏：符合创建 cluster 工具栏的设计。它包含一个带双上箭头图标的紧凑圆形按钮。悬停在其上会显示提示框：拉起下方的笔记。
• 交互与重排：
  • 在提示活跃时单击按钮或按下 Alt 键，可利用硬件加速的重排动画将堆叠中的所有笔记向上移动以填补间隙。
  • 操作是非阻塞的。单击画布的其他位置、按下 Escape 键或等待 6秒无操作会自动关闭提示，布局保持不变。
• 撤销支持：布局调整完全集成到历史记录系统中，允许您随时撤销拉起操作 (Ctrl + Z)。

移动端笔记删除（双击安全防误触机制）

在 Noust 的移动端版本中，笔记以专为触屏优化的自适应卡片界面呈现。为防止因误触造成数据意外丢失，删除笔记需要连续点击两次删除按钮：

• 第一次点击（安全确认）：删除按钮进入视觉高亮确认状态（显示主题告警色），提示该笔记已进入待删除准备状态。
• 第二次点击（执行删除）：再次点击该按钮确认操作，立即从界面移除该笔记并同步数据存储模型。若点击其他位置，确认状态将安全退出，不会删除笔记。

自动展开与内容自适应 (Auto-Expand & Auto-Fitting)

Noust 配备了具有碰撞感知的多向自动展开引擎，旨在根据笔记文本内容自适应调整尺寸，同时完全不干扰画布的既有布局。

手动展开（双击调整手柄/边角）

• 触发方式：双击笔记的任意调整手柄（Resize Handle）或边角。
• 内容自适应：笔记会自动计算显示其完整内容所需的理想尺寸，彻底消除内部垂直和水平滚动条。
• 邻居零位移 (Zero Neighbor Displacement)：展开操作严格受限于笔记周围现有的空闲空间。画布上的邻近笔记与其他元素绝不会被推挤、拉拽或位移——它们的坐标 $(x, y)$ 保持 100% 固定。
• 2D 多向智能生长：引擎不会沿单一方向机械拉长，而是在所有 4 个基本方位（上、下、左、右）评估空闲空间，向有可用空间的方向平滑分配展开量。
• 严格的安全间距与扇区避让：
  • 扇区/子扇区线：与水平和垂直扇区分割线保持严格的 14px 安全呼吸间距，确保笔记绝不会触碰或跨越分区边界。
  • 邻近笔记：与周围的其他笔记保持配置的边距（默认 8px）。
• 和谐比例与反转限制：
  • 展开时优先追求在设置中配置的长宽比（默认：水平 60% / 垂直 40%）。
  • 如果某一轴向空间受阻（例如笔记正下方紧挨着扇区线），引擎会智能地在垂直方向的可用空间中扩展宽度，最高可自适应至反转比例极限（如 40% H / 60% V），从而在不产生滚动条的情况下容纳全部内容。
• 保留手动调整底线：如果您曾手动将笔记拉大，该手动尺寸将作为最小底线保留——自动展开引擎绝不会将笔记缩小到您手动指定的尺寸以下。

实时自动展开 (Live Typing & Paste)

当您的工作流程需要笔记在撰写过程中随内容动态延展时：

• 实时生长：当键入或粘贴的内容超出笔记当前可见区域时，笔记会在空闲空间内平滑自动展开，无需反复手动双击。
• 安全边界钳位：若笔记周围被障碍物完全封堵而无法继续扩展，它会安全地停留在空闲空间的最大边界处，多余内容保留在内部滚动条中，绝不破坏周围布局。

聚焦时展开 (Expand on Focus / 动态 2D 覆盖模式)

适用于在不改变画布既有排版的前提下，快速阅读和编辑紧凑型便签：

• 点击与聚焦激活：当点击内部带有垂直滚动条的便签时，便签会临时展开以显示全部文字，无需内部滚动。
• 和谐 2D 比例展开：便签在宽度与高度上成比例展开，提供舒适的阅读长宽比，防止长文本拉伸成细长的垂直窄条。
• 覆盖层模式（零位移）：展开采用悬浮覆盖层（z-index 提升）并带有突出的投影效果，绝不推挤或位移周围的任何邻近笔记。
• 视口感知智能 (Viewport-Aware)：引擎会自动感知笔记在当前屏幕窗口中的位置。若笔记紧贴屏幕底部或侧边，它会平滑向上或向左延伸位移，确保展开后的全部内容始终完整呈现在可视区域内。
• 鼠标移开即时收起 (Mouseleave)：将鼠标光标移出展开的笔记后，笔记会平滑缩回其原始尺寸。为避免意外触发，仅将鼠标悬停回笔记上方不会重新展开——重新激活必须通过显式的编辑点击。
• 拖拽与调整大小安全机制：在覆盖层预览期间调整手柄处于隐藏状态，以保护笔记的真实尺寸。从顶部标题栏发起拖拽时，笔记会立刻在光标下方收起并紧跟移动，绝不会出现光标脱离或凌空悬浮。
• 通过上下文菜单手动“预览展开”：即使设置中未开启自动聚焦展开，您也可以随时按需触发此 2D 覆盖层预览，只需点击便签浮动工具栏或右键上下文菜单中的“预览展开”按钮即可。如果便签已处于展开状态，再次点击该按钮将作为安全的切换开关（Toggle）将其收起。

放置在狭窄空隙时的自动调整 (Drop Auto-Fit)

如果您将笔记放置在狭窄的空间中，Noust 将尝试调整其大小以适应间隙。这仅在笔记内容较短（$\le 80$ 个字符）且可用面积至少为原始大小的 40% 时才会触发，从而确保诸如 IP 或 ID 等高密度数据可以整洁地放置在布局中，而无需手动调整。

设置

自动展开行为与比例偏好可在 设置 > 行为 的 Auto-Expand 部分中进行配置：

Auto-Expand 设置

• Auto-Expand：开启或关闭键入与粘贴时的实时自动展开（默认关闭）。
• 聚焦时展开 (Expand on Focus)：激活聚焦时临时浮动展开以无滚动显示完整内容（默认关闭）。
• 长宽比 H (%) 与长宽比 V (%)：配置自适应笔记的目标长宽比例（默认：60% H / 40% V）。

聚焦笔记 (Focus Note)

如果笔记部分在屏幕外，请单击它以使其完全显现。这对于在承受高压力的项目期间将您的注意力快速集中在特定数据点上至关重要。

设置

聚焦行为可以在 设置 > 行为 中进行调整。

聚焦设置

• 聚焦滚动偏移 (Focus Scroll Offset)：自定义在使被聚焦的笔记居中时使用的垂直安全页边距。

对齐与间距

拖拽时会显示垂直和水平对齐辅助线，帮助笔记与其他元素对齐。动态智能间距指示器会显示相邻元素之间的精确距离，并将笔记吸附（"snap"）到保持一致间距的位置。

设置

笔记之间的全局间距在 设置 > 行为 中进行管理。

间距设置

• 笔记页边距 (Note Margin)：定义所有笔记的全局外部页边距，以确保内容块之间有一致的呼吸空间。

::: important 组织关联完整性 为确保 组织单元 逻辑正常运行，笔记页边距在逻辑上受到限制，不能超过 分组半径 (Group Radius) 的值。这可以防止视觉间隙变得比布局引擎用于识别连接笔记的距离还要大。 :::

媒体嵌入 (Media Embeds)

Noust 允许您将外部媒体和富文档直接嵌入到画布笔记中，既不占用本地保险库的存储配额，又严格保持零知识（Zero-Knowledge）隐私。

隐私与安全架构

• 零存储占用的配额节省：嵌入的媒体文件（视频、文档、设计稿）不会上传或复制到您的加密保险库中。仅保存外部 URL，保持本地数据库极度轻量，并确保即时同步。
• 客户端沙箱隔离：所有外部 iframe 均运行在严格的 HTML5 沙箱中（sandbox="allow-scripts allow-same-origin allow-forms allow-popups allow-presentation"），并带有 referrerpolicy="strict-origin-when-cross-origin"。严禁顶层窗口重定向和模态框劫持。嵌入的 iframe 无法访问您的笔记、加密保险库数据或本地凭据。

画布交互保护层 (Interaction Shield)

为了确保流畅的画布导航，嵌入笔记配备了智能交互保护层：

• 导航模式（默认）：不可见的遮罩层保护嵌入内容，允许您在画布上自由拖动平移和缩放，而不会被 iframe 捕获鼠标手势。
• 交互模式：单击嵌入笔记一次以选中它，即可解锁与播放器控件的直接交互（播放、暂停、进度条拖动、音量、全屏或文档滚动）。点击画布任意空白处即可重新激活导航保护层。
• 资源保护：折叠嵌入笔记时会自动暂停原生 HTML5 视频播放，以节省内存和 CPU。

如何嵌入

1. 粘贴：复制任意支持的白名单链接，并在画布上直接按下 Ctrl + V（或 Cmd + V）。
2. 拖放：将浏览器地址栏或网页中的链接直接拖动并放置在画布上的目标位置。

支持的服务白名单

为了消除安全漏洞、网络钓鱼和点击劫持风险，Noust 实施了经过验证的严格封闭式白名单：

• YouTube 与 Shorts：通过增强隐私的 youtube-nocookie.com 进行完整视频和短视频播放。支持时间戳查询参数（如 ?t=120s）。
• Google Drive：文档、电子表格、演示文稿和文件的嵌入预览（drive.google.com/file/d/...、docs.google.com/document/d/...）。

  Google Drive 权限设置

  Google Drive 文件必须将其共享设置配置为**“知道链接的任何人都可以查看”**，以便在嵌入预览中正常渲染。

• Vimeo：启用严格 Do-Not-Track 头信息（dnt=1）的视频播放，保护您的观看隐私。
• Figma：交互式设计文件、画板和原型。
• Loom：视频演练与屏幕录制。
• 直接视频链接：以 .mp4、.webm、.ogg 或 .mov 结尾的直接 HTTPS 链接，使用浏览器原生硬件加速 HTML5 播放器渲染。

请求支持其他服务

如果您希望支持其他服务，请发送电子邮件至 [email protected]。

逻辑细分 (扇区与分界线)

扇区允许您在工作区中创建结构化的逻辑边界，非常适合用于分离渗透测试的不同阶段、组织基础设施组件或在无需多个域的情况下可视地分组相关数据块。

创建与生成

扇区可以手动创建，也可以根据您的笔记布局动态生成：

• 手动创建：按住 Shift 键并在背景空白区域上拖动鼠标以手动绘制扇区分界线。方向（水平或垂直页眉）根据您的拖动方向进行动态确定。
• 动态建议：当您将笔记彼此靠近放置时，Noust 会检测到一个空闲空间的“通道”。会出现一条预览线，建议进行逻辑划分。
• 边界：扇区分界线的长度和位置由周围笔记或其他现有扇区的“边界”决定。邻近逻辑确保线能够整洁地对齐到您的内容边缘。
• 相交：您可以交叉垂直线和水平线。系统会智能地处理交点，允许您创建复杂的组织网格或矩阵。

设置

扇区布局系统是高度可定制的，可以在 设置 > 行为 中进行调整或禁用。

扇区设置

• 建议已启用：切换整个动态发现系统的开启/关闭。禁用时，现有的扇区仍然存在，但不会检测到新的空间通道。
• 水平线/垂直线：选择哪些轴应该触发自动发现。非常适合只想在一个方向上切分工作区的用户。
• 最小建议长度：调整发现算法的敏感度。较高的值可防止出现较短的线，从而减少高密度区域中的视觉噪音。

交互与操纵

一旦创建，扇区就会成为您工作区的永久部分，除非将其删除：

• 拖动与定位：单击并按住拖动控制柄（圆点网格图标）以移动线。移动时它会对齐到其他通道。
• 调整大小：使用线两端的控制柄手动调整其长度。
• 延伸箭头：单击任一端上的箭头可自动将线延伸到下一个可用的边界（笔记边缘或其他扇区）。
• 多选与组拖动：按住 Ctrl 键并单击扇区和笔记以进行组选择，或按住 Ctrl 键并在画布空白背景上拖动选择框以一次选择多个笔记和扇区。选择后，拖动组中的任何元素将同时在任何方向移动所有选择的笔记和扇区。在组拖动期间会自动绕过对齐对齐，以防止布局卡顿。按下 Delete 将从画布和数据模型中删除所有选择的笔记和扇区。

Atlas 集成

为了便于在庞大的 2D 工作区中进行导航与探索，具有自定义标题的扇区会在 Atlas 中进行索引。

• 转到扇区：在 Atlas 中单击扇区以立即将您的视图居中在它上面。
• 自动发现切换：如果您的工作区变得过于密集，您可以通过 设置 > 行为 > 显示扇区 选择在 Atlas 列表中隐藏扇区。

样式与偏好

您可以通过上下文菜单自定义每个扇区的视觉标识：

• 样式：在 实线 (Solid) 或 虚线 (Dashed) 之间进行选择。
• 标题位置：将标题定位在线上方 (Over)（作为遮罩）、一侧 (Side)，或完全隐藏它。
• 标题方向：旋转标题使其为 水平 或 垂直，以符合您的布局美学。
• 全局持久化：与笔记内容不同，扇区的样式偏好（颜色、粗细、透明度）会保存为 全局行为设置。这意味着，通过自动保存系统设置，您偏好的样式会在会话之间立即保持。

选择隐私

扇区的标题是完全可编辑的。为了确保您能够快速复制或编辑数据，当鼠标移到标题上时，拖动控制控件会自动隐藏，从而优先进行文本选择和内容修改。

自动标题生成

Noust 可以根据内容的前几行自动为您的笔记生成标题，确保您的工作区保持条理，而不会中断您的工作流。

逻辑与优先级

应用程序会监控您的键入，并根据以下优先级规则自动提取最相关的单词：

• 第一行：如果第一行简短明了，则将其优先作为主要来源。
• 技术关键字：专业术语（例如 CVE、API、IP、SQLi）充当锚点，更有可能出现在标题中。
• 大写：以 大写字母 开头的单词会被算法赋予更高的优先级。
• 常用词：停用词（如 the、is、at 等）会被忽略，以保持标题简洁。

性能提示

知道了 大写单词 具有优先级后，您可以故意将想要在标题中看到的特定术语大写，以优化您的工作流。

设置

自动标题生成算法可以在 设置 > 行为 中进行完全自定义或禁用。

自动标题设置

• 已启用/已禁用：切换整个自动生成系统的开启/关闭。
• 单词限制：设置生成的标题中允许的最大单词数。
• 生成延迟：控制键入时算法运行的频率，以防止过度处理。

文本与块格式化

Noust 支持功能强大的受 Markdown 启发的格式化，以实现技术清晰性。

视觉自定义

为单个笔记应用四种定义颜色之一（快捷键：Ctrl + 1 至 4），或使用自定义颜色选择器中的颜色 (Ctrl + ')。这允许根据严重性或主题对项目进行颜色编码。

交互块

Noust 可立即识别几种 Markdown 模式：

• 列表：键入 * 创建无序列表，或键入 1. 创建有序列表。
• 复选框：键入 < 创建交互式待办事项。
• 折叠块 (Toggles)：键入 > 使内容可折叠。
• 水平线：键入 --- 后按 Enter 键以创建带标题的分割线。

工具栏转换

选择任何文本并使用工具栏按钮逐行格式化整个块，立即将纯文本转换为列表或待办事项列表。

浮动面板与工作区窗口

Noust 拥有用于交互式工作区工具的模块化浮动面板系统。浮动面板可以在屏幕上的任何位置自由移动、调整大小、折叠或吸附。

窗口架构与智能边缘吸附

• 自由移动与调整大小：按住标题栏句柄拖动面板，并从任何边缘或角落调整其大小。
• 智能吸附与画布空间管理：
  • 连续屏障（自动缩放与自动滚动）：仅当堆叠面板形成覆盖可用画布区域任意边缘（左、右、顶、底）90%+ 的连续壁垒时，才会缩减 Canvas 的全局安全区域，在存在孤立面板时保持可用空间。
  • 碰撞避让（锚点/Anchor）：锚点系统将贴靠顶边和左边的面板识别为虚拟墙壁垒。在跳转至锚点时，摄像机会在保持安全边距的前提下偏移焦点笔记，避开这些面板，即使只有单个孤立面板贴靠边缘也会触发。

浮动面板工具

以下工作区功能作为浮动面板运行：

• 环境变量 (Vars)：定义全局键/值对 (TARGET_IP=192.168.1.1)，以在代码块和命令模板中计算并注入动态变量。
• Agent Chat：交互式 AI 助手面板，用于对话、分析上下文篮中的笔记以及运行 Prompt 转换。
• 技术模块：专门的实用程序窗口（如 JWT 分析器和编码器/解码器），可以动态启用、切换和持久化。

高级技术模块

由安全研究人员为安全研究人员打造的技术模块。可选模块（如 JWT 分析器 和 编码器/解码器）可以通过应用程序界面动态启用或禁用，以自定义您的工作区范围。

模块管理与面板分组

您可以单独切换模块，在悬浮面板中灵活组织它们，并自定义保存偏好：

• 解耦至新面板：将模块标签拖出其当前窗口，即可创建一个新的独立悬浮面板，以便并排对比视图。
• 重新分组 / 吸收：将独立模块面板的标签拖入另一个模块容器的标签栏中，即可将其重新吸收并合并为一个多标签面板。
• 自动保存模块：在键入时在本地保存模块的启用/禁用状态。
• 模块云同步：在设备之间安全同步您的活跃模块配置。

这些选项可以在 设置 > 行为 中进行切换。

环境变量

通过 Vars 图标设置全局键/值对（例如 TARGET_IP=192.168.1.1）。在您的模板中使用这些变量以保持一致的文档记录，并便于快速在模板中生成命令。

变量注入

当光标悬停在代码块上时，会显示一个悬浮图标 。单击它会复制内容，并自动评估和注入所有匹配的环境变量。

易复制模式 (Easy Copy Mod)

使用 Alt + C 或工具栏图标进行切换。一旦启用，选择块将使它们转变为完全可单击的元素，从而立即将它们的内容复制到您的剪贴板，这非常适合在 Noust 和您的终端之间快速移动数据。

存储与持久化

您的数据以隐私优先、本地优先的方式处理。

会话安全盾牌

页眉中会出现一个盾牌图标以指示您的会话安全状态。盾牌会根据启用的保护进行动态填充：

• 左侧填充：本地加密（At-Rest）已启用。
• 右侧填充：云端自动同步已启用。
• 完全填充：本地加密和云端自动同步均已启用。
• 空白轮廓：安全密码已设置，但目前两项功能均已禁用。 点击盾牌可直接打开安全设置面板。

会话持久性

Noust 会在您键入时持续将您的会话（笔记、域、设置、变量）保存到浏览器的本地存储中，确保即使没有互联网连接也不会丢失数据。

会话历史（版本）

随时通过 Menu Shell 中的 历史 (History) 标签页访问您工作区的历史状态。

• 历史版本检查点：查看自动记录的具有精确日期和时间戳的会话版本。
• 当前版本指示灯：绿色的脉冲指示灯突出显示当前处于活跃状态的会话。
• 一键恢复：点击任何历史版本上的 恢复 按钮，即可将您的整个工作区回滚到该特定时间点。

备份与便携式数据

将您的整个工作区备份到便携式二进制包 .noust 中。此格式支持嵌入式图片和技术资产。强烈建议对导出进行加密，以安全传输敏感的审计数据。

云同步

可选的零知识 (zero-knowledge) 同步允许您在多台设备上访问您的笔记，而不会损害安全性。

同步细节

云同步安全架构通过您的 设置 和 同步 (Sync) 控件进行管理。

同步安全性与架构

• 零知识：数据在传输前在您的浏览器中进行本地压缩和加密（256 位 AES-GCM）。我们永远看不到您的密钥或您的内容。
• 协作：通过昵称 (username) 共享只读访问权限。由于共享使用匿名索引的精确昵称，因此可以完全防止用户枚举。
• 安全状态推送 (Safe State Pushing)：如果您打开了一个已同步但尚未在本地解密的工作区，您仍然可以推送您未同步的本地笔记。系统允许您在不解密的情况下覆盖锁定的云端工作区（其作用类似于重置密码）。这可以保护您的本地进度在解密操作期间不会意外丢失，并消除了生成重复工作区以保存离线工作的需要。
• 断开同步：查看共享工作区并“切断”链接以立即保留本地离线副本，允许您继承共享数据的可用版本。

时间线与时间戳

Noust 允许您跟踪笔记随时间推移的演变，提供关于特定信息何时添加或修改的清晰审计线索。该系统在画布笔记和Nexus 自由文本页面中均可用，确保整个工作区中拥有统一的历史记录。

时间块

启用时，笔记会在视觉上分割为时间块。每个块由虚线边界和显示在行右上角的交互式时间戳（引用）来识别。

• 块标识：每个块都跟踪其创建时间和最后修改时间。
• 子块：如果您在最初的 60 秒窗口过后返回到旧块进行修改，Noust 会将它们跟踪为子块。悬停在文本中的引用（例如 [1]、[2]）上将更新时间显示以显示该特定编辑的时间戳。

块合并 (吸收)

为了保持历史记录整洁，Noust 使用 60 秒滑动窗口 来决定新内容应该开始一个新块还是被“吸收”到当前块中：

• 吸收：如果在块的最后一次活动后 60 秒内键入或编辑，更改将合并到当前块中。
• 新块：如果等待超过 60 秒，下一次交互自然会启动一个新的时间线片段。

操作模式

您可以在 设置 > 行为 中自定义块的生成方式：

• 手动模式 (默认)：使用快捷键 Alt + T 或工具栏上的时钟图标将当前文本手动合并到固定块中。
• 图像笔记: 与基于文本的笔记不同，独立的图像笔记不支持文本片段分割。在手动模式下，您可以通过右键单击笔记并选择 Assign Timestamp 将其手动添加到时间轴。
• 自动模式：适用于画布笔记和 Nexus 自由文本页面。Noust 会监控您的键入流，并在配置的非活动期过后，自动将当前内容合并到带时间戳的块中，并为您的下一次输入准备一个新片段。

历史面板

单击笔记中的任何时间戳指示器以打开侧边历史面板。

• 审计线索：查看每个修改块的完整列表。
• 子块详细信息：查看块内每个中间步骤的准确时间。
• 复制时间戳：使用任何条目旁边的复制图标快速获取用于报告的精确 ISO 时间戳。

设置

在 设置 > 行为 中调整时间线引擎：

时间线设置

• 分配模式：在手动或自动块生成之间进行切换。
• 自动日志延迟：在自动模式下，定义触发块合并的非活动秒数。
• 最小更改阈值：定义生成新条目所需的最小字符数，从而防止由于微小修正而产生视觉噪音。

智能体功能

Noust 包含一个隐私优先、本地优先的智能体 (Agent) 系统，直接为您的工作空间带来智能化的辅助功能。

隐私优先设计

智能体默认处于禁用状态。

• 本地处理：使用本地提供商（如 Ollama 或浏览器内置 AI）时，您的数据绝不会离开您的设备。
• 云端处理：如果您选择使用云端提供商，请求将直接从您的浏览器发送到提供商的 API（仅发送附加到聊天的内容）。
• 密钥安全：您的 API 密钥仅存储在浏览器的本地存储中，绝不会通过 Noust 的服务器。

提供商集成

Noust 同时支持本地和基于云端的模型：

• 浏览器 (Browser)：利用浏览器内置的 AI 功能。完全离线运行，无需任何配置。
• Ollama：连接到本地 Ollama服务器，在本地运行私有模型（例如 Llama 3、Mistral）。
• WebGPU（即将推出）：浏览器内硬件加速的模型执行。
• Gemini：直接连接到 Google 的 Gemini API，以获得先进的云端推理。
• OpenAI / 自定义：连接到 OpenAI 或任何与 OpenAI API 规范兼容的自定义 API（例如 Groq、LM Studio 或 OpenRouter）。

配置与设置

您可以在侧边栏面板中管理智能体：

• 总开关：完全启用或禁用智能体。
• 系统指令：设置全局指令，引导智能体的行为和回复格式。
• 测试连接：在开始使用智能体之前，轻松验证您的 API 端点和密钥是否配置正确。

使用智能体

启用后，智能体提供了多种与您的内容进行交互的方式：

1. 智能体聊天与上下文

侧边栏提供了一个智能体聊天界面，您可以在其中与活动模型进行对话。

• 添加上下文：
  • Ctrl + 点击 / 悬停：按住 Ctrl 键并点击画布上的笔记（或将鼠标悬停在上方）或 Nexus 列表中的文档，可将其直接作为上下文标签附加到聊天中。
  • Ctrl + 拖拽框选：在画布空白区域框选多个笔记，一键将它们批量添加到聊天上下文篮中。
  • Ctrl + L：选中文档或笔记中的任意文本片段，或将焦点移至元素后按下快捷键，立即将其发送到上下文篮。
  • 引用符号（# 与 #!）：输入 # 紧随笔记 HumanID（如当前域为 #C5，跨域为 #1C5）、扇区（如当前域为 #;2，跨域为 #1;2）、聚类（如当前域为 #:1，跨域为 #1:3）、限定笔记（如当前域为 #:1B2 或 #;2B2，跨域为 #1;2B6 或 #1:3B6）或 #! 紧随 Nexus 文档编号（如 #!1），自动转换为可交互的上下文标签。
• 语法速查指南：点击智能体聊天标题栏中的说明按钮 (?)，即可展开快捷语法参考，涵盖笔记、扇区、聚类与文档 ID、域范围限定符、显式定界符及上下文添加方式。
• 交互模式 (问答, 计划, 执行)： 输入框底部的专属模式切换器可控制执行环境的安全边界：
  • 问答 (Ask)：严格的只读查询模式。智能体回答疑问、阐述概念或总结已附加的内容。系统彻底屏蔽所有变更与写入工具，确保零副作用。
  • 计划 (Plan)：分析与探索性规划模式。智能体生成拆解为独立方案卡片的结构化行动计划。您可以检查依赖关系、预览空间布局，并有选择地仅批准部分操作。
  • 执行 (Act)：自然语言驱动的直接执行模式。智能体快速拟定并在工作空间中执行所请求的操作。遵循核心安全准则，**所有写入操作均需要明确的人工确认（接受 / 拒绝）**并展示事务性预览，绝不会在静默中应用任何修改。
• 上下文感知对话：在聊天输入框中输入您的提示。智能体将分析上下文篮中的所有文件，以回答问题、撰写摘要或执行分析任务。

2. 内联选择工具栏

当您在任何笔记或页面中突出显示文本时，会显示选择工具栏，其中包含智能体驱动的快速操作：

• 总结：立即生成突出显示选区的简明摘要。
• 纠正语法：检测并纠正拼写和语法错误，同时保留原有风格。
• 扩展：对选定文本进行详细阐述，以提供更多细节和上下文。

3. 自然语言操作与事务性提案

智能体通过聊天中的自然语言指令进行交互与操作。智能体不会直接进行无序修改，而是输出类型严谨的事务性提案：

• 内容修改与差异提案：智能体在用户批准前不会更改原文档，而是生成直观的插入、替换或局部重写预览。
• 键盘接受 / 拒绝与安全锁定：每个提案卡片都提供 接受 (Enter) 与 拒绝 (Esc) 选项。复合计划支持精细选择并自动解析依赖项。在提案等待确认期间，新提示词的发送将被锁定，以防止意外输入覆盖或丢失智能体生成的更改。
• 历史记录与可逆性：已确认的事务无缝接入工作空间全局历史，完整支持撤销与重做（Ctrl+Z）。

4. 画布笔记操作与空间布局引擎

智能体可以通过自然语言结合 HumanID 标识符，在画布上精准创建、编辑和重新排列笔记：

• 相对空间指令：使用直观的相对方位指引智能体，例如：
  • "在 3C5 的左侧创建两篇笔记"
  • "在 Sector 1;2 下方放置一篇总结笔记"
  • "在 A0 旁边生成头脑风暴笔记"
• 确定性布局引擎 (NotePlacementEngine)：采用纯几何算法对笔记进行排版，保持间距规整、主动避让已有笔记碰撞，并在不破坏现有画布结构的前提下自动吸附至可用空白区。
• 虚影预览 (Ghost Overlays)：在接受空间操作前，画布上的精确计算坐标处会呈现半透明虚影轮廓，展示拟建笔记的标题与内容预览。
• 彻底清除：点击拒绝、切换域或清空聊天时，所有虚影预览将立即销毁，不留任何冗余数据。

5. 目标、标签与路径里程碑管理

智能体将画布笔记与 Nexus 路径执行紧密联结：

• 无约束基数：智能体根据实际上下文自由生成恰当数量的目标项，摆脱每篇笔记仅限一个目标的机械限制。
• 多笔记关联 (linkedNoteIds)：支持将多个相关笔记双向绑定至同一个目标，并在已有链接冲突时提供明确策略（拒绝、重新分配或跳过）。
• 自定义路径标签：对话指令可要求在同一原子事务中自动创建并为目标分配业务标签（如 #紧急、#后端、#待评审）。
• 路径里程碑集成：指示智能体将关键战略目标直接提升为 路径 时间轴上的阶段里程碑。
• 动态目标过滤：直接让智能体在聊天中按状态或标签筛选目标，或将过滤状态同步应用至 Nexus 界面。

画布与文档引用 (HumanID)

Noust 为您工作空间中的每个元素配备了简短、易于人类识别的标识符 (HumanID)，使内容的导航、组织和引用变得快速且明确。

各元素类型的标识符

• 域 (Domains)：
  • 按照域标签页的顺序从 1 开始顺序编号（1、2、3...）。
  • 重新排列域标签页的顺序会自动更新每个域的编号以反映其新位置。
• 画布笔记：
  • 格式为 字母 + 数字（例如：A0、A1... Z9、AA0），作为不可编辑的徽章显示在笔记标题的正前方。
  • 将笔记移动到另一个域会将其 HumanID 重新分配到该目标域序列的末尾，就像刚在该域创建一样。
• 扇区 (Sectors)：
  • 由独立的连续数字标识（例如：1、2、3...）。在聊天中结合域上下文引用时，使用分号定界符：[域];[扇区]（例如：1;2）。在当前活动域中，可直接寻址为 ;[扇区]（例如：;2）。
• 聚类 (Clusters)：
  • 由独立的分组数字标识（例如：1、2、3...）。在聊天中结合域上下文引用时，使用冒号定界符：[域]:[聚类]（例如：1:3）。在当前活动域中，可直接寻址为 :[聚类]（例如：:1）。扇区或聚类内的笔记也可以寻址为限定笔记（例如当前域中的 :1B2 或 ;2B2，跨域为 1;2B6 或 1:3B6）。
• Nexus 自由文本文档：
  • 格式为 感叹号加连续数字（!1、!2、!3...）。
  • 文件夹在编号计数中被忽略：编号遵循 Nexus 侧边栏折叠时可见的列表线性顺序。
  • 在 Nexus 列表中重新排序文档会根据新顺序更新其相应的 HumanID。

显示与高亮

• 使用 Alt 键高亮：
  • 在画布上按住 Alt 键可提高所有引用徽章的亮度和不透明度，便于在密集的工作空间中快速找到标识符。
• 可见性设置与智能体关联 (Settings > Behavior)：
  • 画布上的 Human ID 默认处于禁用状态，保持工作空间整洁。
  • 在侧边栏启用智能体（启用智能体）时，会弹出确认对话框，询问是否在便签和区域上显示可视化标识符以便在聊天中引用。
  • 禁用智能体时，画布上的 Human ID 将自动隐藏。
  • Settings > Behavior 中的偏好设置需要智能体处于启用状态才允许开启引用显示。
• Atlas 与 Navigator 侧边栏：
  • 引用徽章显示在 Atlas 的卡片和 Navigator 侧边栏项目旁边，方便一目了然地快速识别。

在智能体聊天中引用

您可以直接在发送给智能体的聊天消息中引用工作空间元素：

• 寻址语法：
  • 笔记：当前域直接使用 [笔记]，跨域为 [域][笔记]（例如：C5 或 1C5）。
  • 扇区：当前域直接使用 ;[扇区]，跨域为 [域];[扇区]（例如：;2 或 1;2）。
  • 聚类：当前域直接使用 :[聚类]，跨域为 [域]:[聚类]（例如：:1 或 1:3）。
  • 限定笔记：当前域为 :1B2 或 ;2B2；跨域为 1;2C5（扇区 2 中的笔记 C5）或 1:3C5（属于聚类 3 的笔记 C5）。
  • Nexus 文档：![编号]（例如：!1、!2）。
• 带有 # 的上下文芯片（内容读取权限）：
  • 在任何地址前添加 # 前缀（例如：#C5、#:1、#;2、#:1B2、#1C5、#1;2、#1:3、#1:3B6、#!1）会将其转换为交互式上下文芯片。

  • 智能体读取授权

    AI 智能体仅在笔记或文档作为芯片显式附加到聊天时，才被授权读取其标题和内容。纯文本引用（如 1C5 或 !1）仅用作导航指针或操作目标，不会授予 AI 内容读取权限。

• 域范围指令 (@Domain)：
  • 使用 @ 紧随域序号或名称（例如 @1、@2、@1,2 或 @"项目 Alpha"），引导智能体聚焦或跨域检索对应工作空间的数据。
• 显式定界符：
  • 含有特殊字符的笔记标题或文本内容可使用引号或括号（"..."、[...]、{...}、(...)）包裹，彻底规避指令解析歧义。

实时聊天输入框验证

• 错误预防：聊天输入框实时验证引用的标记。如果引用不存在（例如：1Z9 或 !99），则会显示内联错误提示并暂时禁用发送按钮。
• 已移动笔记提醒：如果笔记已移动到另一个域，聊天会提示该引用已失效，防止智能体针对错误的笔记进行操作。
• 防止误报：常规电子邮件地址（[email protected]）、代码变量和句子标点符号绝不会被误认为是画布引用。

本地自动化与计划任务

Noust 内置了纯本地运行的自动化 (Automations) 引擎，可实现定时提示词执行、预定通知以及目标截止日期追踪，无需依赖外部服务器或云端 Cron 服务。

入口与组织架构

在顶部应用主菜单 (Shell) 中直接打开自动化管理器。所有自动化任务均按工作空间分组管理，确保定制的定时规则仅在关联的业务上下文中被触发。

自动化任务类型

1. 智能体提示词 (Agent Prompts)：
   • 查询模式 (Query)：以只读模式周期性执行分析提问或生成摘要。结果直接通过通知横幅/弹窗交付，绝不改动工作空间内容。
   • 变更模式 (Mutate)：生成结构化、事务性的操作方案卡片，等待人工审核确认（接受 / 拒绝）：
     • 创建笔记 (Create Note)：在指定领域及集群中生成新笔记，自动解析并递增序号标题。
     • 修改笔记 (Modify Note)：针对目标笔记提议更新内容，支持直观的差异 (diff) 对比。
     • 创建目标 (Create Objective)：在目标领域中构建具有上下文驱动描述的战略目标。
   • 必须提供显式授权附件：为贯彻零知识与绝对隐私保障，智能体自动化严格要求用户显式添加关联的笔记或文档附件。未经授权的上下文，智能体绝不擅自读取。
   • 零副作用原则：自动化提示词绝不会静默修改您的工作空间。
2. 确定性提醒通知 (Deterministic Notifications)：
   • 在设定的时间或间隔弹出的自定义消息提醒，无需调用 AI 模型。
   • 适用于工间休息、例行检查或固定日程提醒。
3. 目标截止日期预警 (Objective Deadline Alerts)：
   • 自动监测工作空间（或当前活跃领域）内处于进行中的目标项，在临近截止期限（支持自定义提前预警时间）或已逾期时发出警报。

通过智能体管理自动化

• 您可以在聊天窗口中直接使用自然语言指令要求智能体创建、调整、暂停或立即执行自动化（例如：“每周一上午9点创建自动化以检查笔记 !1”）。
• 智能体会生成一项待确认变更 (Staged Change) 并呈现在自动化面板中，等待您手动确认后方会正式生效。

调度触发器

• 单次触发 (Once)：在指定的本地日期与时间执行一次。
• 时间间隔 (Interval)：按设定的分钟或小时周期重复触发（例如：每 30 分钟、每 2 小时）。
• 每日定时 (Daily)：每天在特定时间点触发，与本地设备时区自动对齐。
• 每周定时 (Weekly)：在每周设定的多个星期几及时间点触发。

执行机制与安全性保障

• 紧凑型顶部横幅：任务触发时，顶部标题栏下方会展示交互横幅，提供快捷操作入口（查看任务详情或查阅智能体生成的新方案）以及活跃窗口倒计时关闭器。
• 多标签页并发协调：通过 navigator.locks 与 BroadcastChannel 选主机制，确保在同一浏览器打开多个工作空间标签页时，定时任务仅被精准执行一次。
• 错过执行处理：当设备休眠或关闭应用导致触发时间窗口错过时，系统会安全丢弃过期的待执行项并重新调度下一次轮询，避免应用重新启动时产生通知雪崩。
• 纯本地隔离存储：自动化调度仅在工作空间保持打开且解锁的状态下在浏览器本地执行。所有规则保存在本地 Noust_Automations_Personal (IndexedDB)，绝不上报或同步到外部服务器。