空间 - Hifox Docs

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

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

空间适合用来做什么？

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

甲项目研发空间

乙客户项目支持空间

丙产品运营空间

HR 团队工作空间

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

空间里包含什么？

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

任务：空间里的具体工作项，可以分配给成员或 Agent；

成员：能看到并参与这个空间工作的组织成员；

项目：把一组相关任务组织成阶段性目标；

视图：按负责人、状态、标签、优先级等条件保存的任务列表或看板；

自动化：围绕空间任务触发的规则或 Agent 工作流；

代码库：Agent 处理空间任务时可能需要访问的仓库。

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

创建空间

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

名称和图标

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

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

标识符

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

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

ENG：研发；

DOCS：文档；

WEB：官网；

OPS：运营。

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

访问权限

空间可以是公开或私有：

对组织公开：组织中的成员可以找到并加入这个空间；

私有：只有空间成员和组织管理员可见。

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

工作流和标签

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

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

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

空间和任务的关系

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

任务 ID 的前缀来自空间标识符；

任务使用该空间的工作流状态；

空间成员决定谁能看到和处理任务；

空间视图决定团队如何浏览和筛选任务；

空间自动化可以在任务创建、更新或状态变化时触发；

Agent 处理任务时，可以根据空间上下文理解任务归属。

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

空间和 Agent 的关系

Agent 可以参与空间里的任务，但 Agent 不属于空间的一部分。

常见方式包括：

把空间里的某个任务分配给 Agent；

在任务评论中提及 Agent，让它分析、补充或继续处理；

创建只适合某些空间使用的 Agent；

用空间自动化把特定类型任务分流给指定 Agent。

空间提供任务上下文、权限范围和协作记录；Agent 在这个范围内执行具体工作。这样团队可以按空间管理工作，又能把明确任务委派给合适的 Agent。

成员如何加入空间

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

对于公开空间，成员通常可以自行加入。对于私有空间，需要空间成员或组织管理员添加成员。

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

他还没有加入对应空间；

空间是私有的；

任务属于另一个组织或空间；

空间已经停用，只能查看历史内容。

停用空间

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

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

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

建议的空间划分方式

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

如果一组人每天一起处理同类任务，创建一个空间；

如果一个项目有独立目标、成员和节奏，创建一个空间；

如果只是临时分类，优先使用标签、项目或视图，而不是新建空间；

如果权限不同，考虑拆成不同空间；

如果工作流完全不同，考虑拆成不同空间。

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

空间

空间适合用来做什么？#

空间里包含什么？#

创建空间#

名称和图标#

标识符#

访问权限#

工作流和标签#

空间和任务的关系#

空间和 Agent 的关系#

成员如何加入空间#

停用空间#

建议的空间划分方式#