Blinks — 用户指南

使用 Blinks

Blinks 是 OrbitingFox 的构建块。一个 Blink 可以是笔记、任务、事件、开支、提醒，或者您想要捕捉的任何其他信息。

创建一个 Blink

1. 从应用菜单中打开 Blinks。
2. 点击 新建 Blink 并选择类型：笔记、任务、事件、开支、提醒等等。
3. 填写标题、正文、截止日期（对于任务/事件）和任何标签。
4. 保存。您的 Blink 立即在支持链接 Blinks 的应用中可用。

Blink 类型

• 笔记 — 自由文本捕捉。想想数字便签。
• 任务 — 可操作项，包含截止日期和完成标志。
• 事件 — 显示在您的日历上。
• 开支 — 财务条目；供财务仪表板使用。
• 提醒 — 在截止时间触发通知。

链接 Blink

Blinks 可链接到目标、项目、业务和 FoxCom 空间，以提供更丰富的上下文。它们在添加到看板时也会显示在看板上。

OrbitPilot

您所有的 Blinks 都可以在 OrbitPilot 中访问。可以询问诸如 "本周到期的任务是什么？" 或 "总结我 5 月的开支。"

在 Blink 描述中插入图像 (2026-08)

您可以直接将图像粘贴或拖放到 Blink 的 描述 中 — 适用于图像应该出现在文本之间的笔记。这些图像现在是完全可调整形状和易于查找的：

• 调整大小和移动：悬停在图像上以选择它，然后拖动任何角部手柄以调整大小，或使用小工具栏设置尺寸 (S / M / L / 全部) 并对齐 左侧、中心或右侧。在手机和平板上也可以用触摸操作。
• 显示在图像部分：住在描述中的图像也会出现在 Blink 的 图像 列表中（以及编辑页面上的 "现有图像"），并带有一个 📍 "在笔记中" 徽章，以便您能区分它们与单独附加的图像。它们那里 没有删除按钮 是故意的 — 要删除一个图像，请在描述文本中删除它，这样您就不会意外丢失笔记中引用的图像。
• 打开全尺寸：点击任何图像（附加或在笔记中）以在新标签中全尺寸打开。

对开发者：调整大小/对齐的小模块位于 templates/blink/_blink_form.html（覆盖固定在编辑器包装器上，位于 Quill 的 contenteditable 外部，以便 Quill 不会去除它；宽度作为 img 的 width 属性保存，对齐作为 text-align 在块级 — 二者都通过 render_description 清理器传递）。
blink_extras.description_images 过滤器可以显示文中图像（政策匹配：data:image/* 除了 svg, http(s), 站点相对）。数据 URI 图像通过 blob URL 打开（templates/blink/_note_image_open_js.html），因为浏览器阻止对 data: URL 的顶级导航。

格式化您的笔记和更整洁的编辑页面 (2026-08)

点击 Blink 描述上方的  格式化 以显示样式工具栏。它现在包括 文本颜色 和 高亮 以及加粗、斜体、标题、列表、引用、代码和对齐。

• 如何设定样式：选择您想要的单词，然后点击一个样式。如果您只是将光标放置在 一个单词内 然后点击样式，则它会应用于整个单词 — 无需选择。工具栏下方的提示会提醒您。
• 颜色和高亮与笔记一起保存，并在 Blink 的页面上显示。

编辑页面 现在被组织成清晰标记的卡片 — Blink 详细信息、图像、文件 和 语音笔记 — 因此每个部分都容易识别。更新 · 预览 · 取消 按钮放在表单下方，并在页面底部重复出现，所以您可以在不向上滚动的情况下保存。

对开发者：颜色/高亮使用 Quill 行内样式属性（attributors/style/color + /background）；描述清理器（blink_extras.render_description）逐声明验证样式 — 文本对齐 + 颜色/背景采用十六进制/rgb()/rgba()/命名值被保留，其他所有（位置，url()，……）均被丢弃。光标上的字样式是 _blink_form.html 中的鼠标按下捕获辅助程序。底部操作栏通过 form="blink-edit-form" 提交表单。

将一个 Blink 保持私密于 OrbitPilot (2026-08-23)

您捕捉的一些事情与其他人无关 — 甚至连您的助手都不行。每个 Blink 现在在 Blink 表单的基本选项卡底部都有一个紧凑的开关（点击旁边的小 "i" 阅读其作用），"将此 Blink 从 OrbitPilot 中保密"。它默认是 关闭 的，这意味着 OrbitPilot 可以读取它 — 您不需要切换任何东西。

开启后，该 Blink 对您来说变得私密：OrbitPilot 无法再读取它，它还失去了对该 Blink 的 语音备忘录、图像和文件 的访问权限。它之前记住的任何内容将会 立即删除 — 您不必重建任何内容或等待。在您的库中，该 Blink 带有一个小 私密 徽章，以便您一眼就能看到 AI 无法看到哪些。

您随时可以将其切换回去；该 Blink 下一次重建您的记忆时会返回到 AI 的知识中。这与您已经拥有的两个更广泛的控制并存：选择 OrbitPilot 可以读取的工作区的哪些部分，以及 OrbitPilot 文件夹用于文档。

术语：Blink 是主要词 (2026-08-23)

拥有者决定 Blink 是主要面向用户的词。Wink 有意作为遗留别名存在：它在我们的哲学、常见问题解答和术语的命名故事中有提及，OrbitPilot 的检索器仍然能够匹配它，以便旧的表述和旧的链接继续工作。当您编写新内容时，请使用 Blink。

这次转换是分阶段的 — 参见 docs/brand/BLINK-RENAME-PLAN.md 和 docs/BACKLOG.md §1c — 并且由 manage.py terminology_audit 以及 adminapp/test_terminology.py 进行保护，这是一个可能减少但永远不会增加的工具。

6a0 读取 blink 的代码标识符被冻结，并不待处理。 max_winks 是计划限制后一个活动 Feature.key — 重命名它会导致缺口失效。相同的规则适用于模板文件名、URL 名称、会话密钥、CSS 类和 {wink_title} 风格占位符。完整冻结列表在计划中和 terminology.ALLOWED_IDENTIFIERS 中。

保存 Blink 后"获取另一个" (2026-08-28)

在 Blink 仪表板上，Blink 已保存！接下来呢？ 横幅提供了四个选项。其三个将带您去其他地方。第四个，获取另一个，过去指向仪表板 — 您已在的页面 — 所以它重新加载了一切以显示已经开放且为空的 Blink 表单，在同一屏幕下方几百像素处。

现在它直接带您 到 该表单：它跳到 "获取一个 Blink" 面板，若面板收起则打开它，并将光标放入标题中，以便下一个想法可以立即输入。无需页面重新加载，什么都不会丢失。

开发者备注： 控件是 #blinkCatchAnother 在 templates/dashboard.html 中，锚点到 #blink-create-panel，在该模板自己的脚本块中打开并聚焦该行为。该横幅本身依赖于 blink_just_saved 上下文标志（blink/views.py，通过 ?blink_saved=1 设置）。由 blink/test_post_save_where_next.py 定位，包括其他三按钮仍然将页面留在原处。

长描述不再跳到顶部 (2026-08-28)

如果一个 Blink 的 详细信息 太长，点击退出再返回会将页面抛到最顶部，远在您输入的位置之上。在手机上，约六十段描述会在光标与您落脚点之间放置大约两千像素的距离。

现在详细信息框具有最大高度并自行滚动，就像编辑器通常做的那样。您的位置得以保留，页面保持合理长度，且没有任何内容被隐藏 — 长文本会在框内滚动，而不是拉长页面。

写作或保存没有变化；只更改了框的形状。

开发者说明 — 为什么会发生 (BL-66)

原因并不是我们代码中的错误。 描述编辑器是一个没有边界的可编辑区域：在长描述中，它测量为4933px 高 （375px 宽）。聚焦元素会使浏览器滚动 该元素 进入视图，并且该元素开始时距离光标上方数千像素 — 因此浏览器的行为是正确的，而编辑器形状不对。

在测量前后，使用 60 段描述：

• 之前 — 375px: scrollY 2379 → 134 再次聚焦；1280px: 1032 → 0; 页面长 6729px
• 之后 — 375px: 213 → 213 → 213; 1280px: 311 → 308; 页面长 2056px

改变 在 templates/blink/_blink_form.html 中：#desc-editor 获取 max-height 和 overflow-y: auto （420px，260px 在标准 575.98px 突破下），它的尺寸从内联 style= 移动到模板的样式表中 — 线内样式无法被电话媒体查询覆盖，因此必须一起移动。白色填充变成了新的 .of-desc-editor-wrap 类中的 --of-surface-strong 令牌，以便其他内容不会继承它。

测试。 blink/test_description_editor_scroll.py 固定上限、电话专用上限、标准突破和缺少内联样式。blink/test_description_editor_visual.py 驱动真实的 Chromium 并测量在 375 和 1280 的滚动位置；它在 Playwright 缺失时跳过，因此 CI 不受影响且未增加任何依赖。

一个捕获文件记录，以备下次实际服务器测试： LiveServerTestCase 是 TransactionTestCase，并在每个测试后截断表，在此期间也将迁移种子计划行一起移走。没有计划的情况下应用会重定向到 /billing/plans/，因此第一次测试通过，之后的每一次都加载 500 页面。修复是通过 setUp 在页面需要的内容中再种子（通过 apps.get_model, 从不跨应用导入 — 这种耦合抓手也会在测试中算入）。