---
id: system-setting.task-visibility.howto
title: 任务可见性选项显示策略
type: howto
feature: system-setting
scope: admin
locale: zh
aliases:
  - 任务可见性怎么设
  - task_visible
  - 任务可见性选项
  - 可见性 保持 自动
  - 任务详情看不到可见性
prerequisites:
  - 需要系统管理员权限
  - 部署环境变量 SYSTEM_SETTING 不为 disabled
related_tools: []
related_pages: []
negative:
  - 该字段只控制任务详情 UI 上"可见性"控件是否常驻显示，不直接改任务的可见范围
  - 不是「公开 / 项目内 / 仅负责人」三选一，只有 open / close 两档
  - 已有任务的实际可见性数据不受本开关影响
last_verified: v1.7.90
---

# 任务可见性选项显示策略

## 入口
桌面端：左上角头像 →「系统设置」→「系统设置」标签 →「任务相关」→「可见性选项」。

字段名：`task_visible`，枚举 `open` / `close`，默认 `close`。

## 两档含义

| 取值 | UI 文案 | 含义 |
|---|---|---|
| `open` | 保持 | 任务详情页**始终**显示「可见性」字段；用户每次进任务都能看到当前可见范围与切换入口 |
| `close` | 自动 | 仅当任务的可见性为**非默认值**或处于「合并项目」上下文时才显示；默认值情况下"可见性"控件隐藏，减少干扰 |

前端 `TaskDetail.vue` 通过 `systemConfig.task_visible === 'open'` 计算 `visibleKeep`，控制控件是否常驻。

## 任务真实可见性来自哪里
任务的实际可见范围由任务自身的 `visibility_*` 字段决定，新建任务时按所在项目继承默认值。本开关 **不改变默认可见性**，只影响 UI 是否把这个字段始终亮出来。

## 改了对存量任务的影响
- 不重写任何任务的可见性数据
- 已打开的任务详情页需刷新后才按新策略渲染控件
- 历史任务的可见性范围维持不变

## 操作步骤
1. 进入「系统设置」→「系统设置」→「任务相关」
2. 「可见性选项」选「保持」(open) 或「自动」(close)
3. 「提交」保存，下次打开任务详情即按新策略显示

## 不支持
- 不是 ACL 配置，不能限制谁能看任务
- 不支持按项目差异化（全局生效）
- 没有"完全隐藏可见性入口"的第三档