OrbitPilot 文件 — AI 读取的文件夹

它是什么

“OrbitPilot 文件”是你在 文件库中的一个特殊文件夹。它是你的 AI 阅读区：只有你放入该文件夹内（以及你在其中创建的任何子文件夹内）的文件才会被 OrbitPilot AI 读取。你保留在外部的任何内容对 AI 来说都是私密的。

在文件库中如何查看（重设计，2026-08）

• 主页上有一个显眼的 🤖 卡片 和一个侧边栏快捷链接，二者都有一个实时的 “AI 可以看到 N 个文件” 计数 — 这个数字与 AI 管道使用的相同。
• 说明横幅会出现在 文件夹内部的任何地方 （包括子文件夹），所以你总是知道自己在阅读区内。
• 每个 AI 可以读取的文件在浏览和搜索时都有一个小 🤖 徽章。

如何使用它

• 让 AI 读取文件 — 将其移动或上传到 “OrbitPilot 文件” 文件夹中（
   选择 → 移动在任何文件夹内均可使用）。
• 保持文件私密 — 将其放在其他地方。AI 不会读取。
• 组织 — 在内部创建子文件夹（例如 “合同”，“笔记”）；其中的所有内容也会被读取。你的子文件夹是你自己的：你可以移动或删除它们，这会改变 AI 可以读取的内容。
• 读取文件会消耗 AI 积分 — 只保留 AI 应该知道的内容。

为何该文件夹受到保护

根文件夹本身是 系统管理的 (🔒)：它无法被重命名、移动或删除，因此你的 AI 始终有一个稳定的读取位置。回收站中的文件永远不会被读取，即使它们来自该文件夹。

开发者专区

由 filemgmt.models.get_or_create_orbitpilot_folder(user) 提供 (ORBITPILOT_FOLDER_NAME = "OrbitPilot Files", is_protected=True 在应用驱动器下)。管道合同是 filemgmt.models.orbitpilot_visible_files_qs(user) — 孤立的 (blink__isnull=True), 在文件夹子树中的非回收文件 — 被 orbitpilot/pipeline/extract.py::_extract_files 和 工作区快照计数使用。UI 界面位于 filemgmt/views.py (ai_folder_id/ai_file_count/ current_in_ai/f.ai_visible 上下文) 和 templates/filemgmt/partials/_ai_banner.html; 子文件夹创建的 异常在 filemgmt/services.py::can_create_subfolder （OrbitPilot 文件 + 上传）。保护测试：filemgmt/tests.py （OrbitPilotFolderProtectionTests, HomeHubAndAiUxTests）。