空间

空间是 HiFox 里组织日常工作的范围。一个组织可以有多个空间，每个空间可以对应一个团队、部门、项目、产品线或长期计划。

你可以把组织理解成公司或团队的总工作区，把空间理解成其中一个具体部门的工作区。任务、成员、Agent、小队、项目、视图、自动化和代码库通常都会围绕空间来组织。

空间适合用来做什么？

空间适合表达一组人持续协作的范围，例如：

  • 甲项目研发空间
  • 乙客户项目支持空间
  • 丙产品运营空间
  • HR 团队工作空间

如果一组任务需要同一批成员、相近的工作流、固定的视图和自动化规则，就适合放在同一个空间里。

空间里包含什么？

一个空间通常会包含这些内容：

  • 任务：空间里的具体工作项，可以分配给成员、Agent 或小队；
  • 成员：能看到并参与这个空间工作的组织成员；
  • Agent 和小队：各自必须归属这个空间，供空间中的成员处理或协作任务；
  • 项目：把一组相关任务组织成阶段性目标；
  • 视图：按处理人、状态、标签、优先级等条件保存的任务列表或看板；
  • 自动化：围绕空间任务触发的规则或 Agent 工作流；
  • 代码库：Agent 处理空间任务时可能需要访问的仓库。

空间不是一个单独的聊天频道，也不只是一个文件夹。它决定了团队在哪里看任务、如何流转任务、哪些成员和 Agent 可以参与，以及哪些配置默认适用于这组工作。

创建空间

创建空间时，通常需要填写这些信息：

名称和图标

空间名称应该让团队一眼知道它承载什么工作，例如 Engineering、Marketing、Docs 或某个项目名。

图标用于在侧边栏、任务详情、筛选器和空间列表中快速识别空间。你可以选择一个容易区分的图标或颜色。

标识符

空间标识符会用于任务 ID，例如 ENG-123、MKT-42。

标识符通常由 2-7 个字母或数字组成，并且需要在组织内唯一。建议使用短而稳定的缩写，例如：

  • ENG：研发；
  • DOCS：文档；
  • WEB：官网；
  • OPS：运营。

创建后仍然可以修改标识符，但已有任务的显示 ID 会随之变化，因此最好一开始就选择稳定的写法。

访问权限

空间可以是公开或私有：

  • 对组织公开：组织中的成员可以找到并加入这个空间；
  • 私有：只有空间成员可以访问空间中的任务内容和成员列表。组织 Owner 和 Admin 可以查看空间元数据并管理不依赖空间成员身份的配置，但组织角色本身不会让他们成为空间成员，也不会绕过这条访问边界。

公开空间适合大多数团队协作场景，例如研发、产品、市场等常规工作。私有空间适合权限敏感或范围较小的工作，例如管理层事项、客户交付、未公开项目等。

空间设置里可以开启多人处理人。默认仍是单人；开启后，这个空间里的任务可以有多名人员处理人。

工作流和标签

创建空间时，可以选择预设工作流，也可以之后再调整。

工作流决定任务会经过哪些状态，例如 Backlog、Todo、In Progress、Review、Done。标签用于进一步分类任务，例如 bug、docs、urgent、frontend。

如果你从已有空间复制设置，HiFox 会复制源空间的工作流状态、标签和 Git 仓库配置，但不会复制成员。

空间和任务的关系

每个任务都属于某个空间。空间会影响任务的几个关键方面：

  • 任务 ID 的前缀来自空间标识符；
  • 任务使用该空间的工作流状态；
  • 空间成员决定谁能看到和处理任务；
  • 空间视图决定团队如何浏览和筛选任务；
  • 空间自动化可以在任务创建、更新或状态变化时触发；
  • Agent 处理任务时，可以根据空间上下文理解任务归属。

当你创建任务时，先选对空间很重要。一个任务如果放错空间，后续成员、视图、自动化和 Agent 处理方式都可能不符合预期。

空间和 Agent、小队的关系

每个 Agent 和小队必须且只属于一个空间。空间不仅提供任务上下文，也约束它们的可见、触发和任务指派：

  • 共享 Agent 和小队只对所属空间中有访问权限的成员可见和可用；
  • 任务只能指派给与任务位于同一空间的 Agent 或小队；
  • 在任务评论中提及 Agent 时，也只能使用当前空间中有权限使用的 Agent；
  • 创建或调整小队时，Leader 和 Agent 成员必须与小队属于同一空间；
  • 空间自动化只能选择同一空间的 Agent 或小队作为执行对象。

因此，创建任务时先选对空间很重要。任务放错空间会影响成员可见性、视图和自动化，也会影响可以指派或触发的 Agent 和小队。

成员如何加入空间

组织成员不一定自动属于所有空间。

对于公开空间，成员通常可以自行加入。对于私有空间，需要已有空间成员添加新成员。组织 Owner 和 Admin 可以查看空间元数据，但如果没有空间成员身份，仍不能访问任务内容或空间成员列表。

如果一个成员看不到某个任务，常见原因是：

  • 他还没有加入对应空间；
  • 空间是私有的；
  • 任务属于另一个组织或空间；
  • 空间已经停用，只能查看历史内容。

停用空间

当一个空间不再承载活跃工作时，可以停用它。

停用后的空间会变为只读。历史任务、项目和记录仍然保留，但不再适合作为新的工作入口。如果空间里还有未完成任务，停用前需要决定是取消这些任务，还是移动到另一个空间。

如果之后需要继续使用，可以从已停用空间中恢复。

建议的空间划分方式

刚开始使用 HiFox 时，不要创建太多空间。建议先从团队真实的工作边界出发：

  • 如果一组人每天一起处理同类任务，创建一个空间；
  • 如果一个项目有独立目标、成员和节奏，创建一个空间；
  • 如果只是临时分类，优先使用标签、项目或视图，而不是新建空间；
  • 如果权限不同，考虑拆成不同空间；
  • 如果工作流完全不同，考虑拆成不同空间。

一个好的空间应该让团队成员很容易回答：这个任务应该放在哪里？谁会看到它？它应该按什么流程推进？