任务列表

「所有任务」页面以表格形式展示项目中的全部任务,支持多维度筛选和搜索,适合快速定位和管理大量任务。

页面采用全宽布局,不会出现文档级横向滚动条:表格在自身容器内滚动,只有「标题」列是弹性列,其余列宽固定。筛选控件在真正放得下时保持一行;「清除筛选」只在确有激活筛选时渲染,不占用隐形空间。滚动条使用与主题匹配的细样式,亮色与暗色模式下都保持低调。

进入任务列表页面

启动 Web 界面后,点击顶部导航栏的「所有任务」标签,进入任务列表页面。页面以表格布局展示任务 ID、标题、状态、优先级、负责人、标签和关联里程碑等关键信息。

使用筛选器

表格上方提供一组筛选控件,可叠加使用以精确查找任务。

按状态筛选

点击「状态」下拉框,勾选需要查看的状态。支持同时选择多个状态,例如同时勾选 Todo 和 In Progress,表格将展示待办和进行中的全部任务。

点击「清除」或取消所有勾选,恢复显示所有状态的任务。

按状态排除

「状态」筛选旁还提供一个排除状态下拉框(StatusExcludedDropdown),用于反向过滤:勾选的状态对应的任务将被隐藏。例如勾选 Done 后,表格只展示未完成的任务。包含与排除两个下拉可以叠加使用,筛选状态会同步到地址栏 URL 查询参数,方便分享。

按优先级筛选

点击「优先级」下拉框,选择 High、Medium 或 Low。优先级筛选为单选模式,切换后将只展示对应优先级的任务。

按标签筛选

点击「标签」下拉框,勾选目标标签。支持多选,任务只需包含任一选中标签即可匹配显示。

标签下拉按字典序(不区分大小写)排列,方便快速浏览定位;大小写混合与重音、全半角 Unicode 等价字符均能稳定排序。

按里程碑筛选

点击「里程碑」下拉框,选择特定里程碑,表格将只展示归属于该里程碑的任务。选择「无里程碑」可筛选出未分配里程碑的任务。

显示已完成任务

筛选栏还提供「显示已完成」复选框:勾选后 backlog/completed/ 中的历史任务与活跃任务一并展示(带 Completed 徽章),状态同步到 URL,点击打开只读弹窗。详见 看板视图 的同名小节。

验收标准进度条

状态为 In Progress 且含验收标准的任务,标题列会显示固定宽度的圆角进度条与 已勾选/总数 分数,每行占位一致;无验收标准的任务不显示。

全局搜索

任务列表顶部的搜索框是一个触发按钮(显示「搜索 (⌘K)…」)。点击它,或按 Ctrl+K / Cmd+K,会打开全局搜索对话框,在其中检索任务、文档、决策与 Wiki 页面。

对话框的完整说明(类型过滤、分组结果、键盘操作、分享链接、位置记忆)见 全局搜索。

  • 搜索支持中文和英文,关键词在结果的标题与资源 ID 中高亮
  • 对话框始终是全局范围,不与列表页的筛选条件叠加;要按状态、优先级、标签或里程碑缩小任务范围,请使用页面上的筛选下拉框
  • 侧边栏与列表页不再提供内联搜索结果下拉

进入任务详情

在表格中找到目标任务,点击该行任意位置(通常为任务标题或 ID),即可打开任务详情模态框。

模态框与背景页面

任务详情以模态框(Modal)形式展示在屏幕中央,底层页面(任务列表)保持可见:

  • 模态框覆盖在当前页面上方,背景页面略微变暗但仍可辨识
  • 关闭模态框后自动回到原来的任务列表页面,不会丢失当前的筛选和排序状态
  • 直接访问 /task/:id 链接(如 /task/506)时,系统会以任务列表为背景打开对应任务模态框

稳定 URL 与分享

打开任务详情时,地址栏会自动更新为 /task/:id/:title 格式:

http://localhost:6420/task/506/Fix-CLI-actualStart-actualEnd-missing-local-to-UTC-conversion
  • URL 支持前缀无关匹配:/task/123 和 /task/back-123 都能正确打开同一任务
  • 裸 /task/:id 链接会自动重定向到带标题 slug 的完整 URL
  • 你可以直接复制地址栏链接分享给团队成员,对方打开后将以默认视图(看板)为背景显示该任务详情

依赖项钻取

在任务详情的 Dependencies 区域,每个依赖任务以蓝色标签展示。点击标签即可钻取进入该依赖任务,无需返回列表重新查找:

  • 钻取后模态框标题栏左侧出现 ← 返回 按钮,点击回到上一层任务
  • 支持连续钻取多层依赖关系(如 A → B → C)
  • 浏览器的前进/后退按钮也能正确遍历钻取历史
  • 点击右上角 × 关闭按钮与浏览器后退等价:每次关闭退一层。从列表直接打开的任务点一次 × 即回到列表;已钻取到子任务时,点 × 先回到上一层父任务,回到最外层后再点一次才关闭模态框
  • 返回箭头 ← 与 × 的行为一致,都只消费一层历史

钻取导航仅在预览模式下可用,新建或编辑任务模式下点击依赖标签无效。

父子任务层级

若当前任务有父任务或子任务,模态框标题下方会出现层级区块:

  • PARENT 行:显示父任务的 ID、标题与状态标签;点击该行直接在模态框内打开父任务
  • SUBTASKS 区:显示子任务完成计数(如 1/6)、进度条与折叠箭头;点击区块标题行即可展开或折叠
    • 每条子任务显示完成指示圆点、ID、标题、状态标签与钻取箭头,点击即在模态框内打开该子任务

既没有父任务也没有子任务的任务不会显示该区块,模态框外观与以往完全一致。

验收标准编号

任务详情中的验收标准(AC)列表项会显示序号编号(#1、#2 …),便于在讨论或命令行中引用具体条目。

大纲抽屉(弹窗目录)

任务详情、Wiki 预览与文件预览等弹窗在左边缘中部探出一个书签式「目录」标签:点击标签后标签隐藏,在弹窗左侧打开一个与弹窗等高的浮动大纲面板——弹窗本身宽度不变,没有布局抖动;点击条目平滑滚动到对应章节(scrollspy 高亮当前位置),关闭面板后书签恢复。

窗口很窄、外侧停靠会越出屏幕时,抽屉自动切换为悬浮模式浮在弹窗内容上方:不渲染关闭按钮,点击任意条目或半透明背景即关闭。窄屏下书签标签也会移入面板内侧,保证入口始终可达。

文件预览弹窗的宽度已同步加大,长文档预览更舒展。

依赖关系图切换

任务详情模态框的 Dependencies 区域标题右侧有一个关系图按钮,点击后将模态框正文切换为以当前任务为中心的可交互依赖子图(缩放、拖拽、图例过滤、节点钻取),每个任务的视图状态独立记忆。详见 图谱视图。

模态框还会按跳数列出「等待谁 / 被谁等待」的依赖闭包,标注根阻塞任务与无法解析的引用;被拒绝的依赖编辑(如构成循环)会回滚并显示原因。

引用与修改文件标签页

模态框中的 References(引用)与 Modified Files(修改文件)合并为一个标签页面板,标签标题附带条目计数(如 References(5)):

  • 默认标签随任务状态选择:已完成任务默认落在 Modified Files,其余任务默认 References;点击切换仅对当前任务生效
  • 修改文件以等宽路径 chip 展示,点击可在文件预览中打开;只允许项目相对路径,URL 形式的输入会被拒绝
  • 文件预览打开含 YAML frontmatter 的文档时,顶部 --- … --- 块会作为独立的元数据面板呈现,不再混进正文渲染(部分预览、行范围预览与无 frontmatter 的文件保持原行为)
  • 两个列表都支持在编辑模式下增删,保存后写入任务文件

日期的 UTC 悬停提示

界面中的日期时间以本地时区显示;将鼠标悬停在带时间的日期上,提示框会显示 Markdown 文件中存储的原始字符串并标注 (UTC)。纯日期值(YYYY-MM-DD)不带悬停提示。该规则覆盖任务详情、任务列表、看板卡片、里程碑、草稿与统计页面。

已完成任务的只读弹窗

从「显示已完成」或搜索结果打开的已完成任务,弹窗为只读:不显示编辑、状态变更等操作按钮,标题栏下方显示只读提示横幅;跨分支任务的只读行为与此一致。

实体 ID 自动链接

任务描述、备注、评论等 Markdown 正文中写出的任务 / 文档 / 决策 ID(如 back-123、doc-5、decision-3)在渲染时会自动转为可点击链接,点击后按对应的导航方式打开:

  • 解析采用 fail-closed:无法唯一解析的 ID 原样显示为纯文本,不会猜测目标
  • 前缀无关匹配:123 与 back-123 指向同一任务
  • 区间与列表:形如 back-101~105 的区间、形如 back-101/102/103 的斜杠列表会被渲染为单个触发器,点击展开 portal 下拉列出区间内每个 ID 的链接,便于在一处引用一段连续或相关的任务
  • 在 Web 编辑器的输入框里输入裸数字时会按上下文自动补全前缀,并提供插入链接的提示
  • 三种实体共用同一套规范化身份键,渲染端与输入端行为一致

未保存编辑保留

在编辑任务时,如果任务文件在后台被其他进程修改(如他人编辑、外部编辑器保存),模态框不会重置你未保存的输入——系统只合并刷新后未触碰的字段,你在标题、描述、计划、备注、日期、AC、DoD、引用和文档上未保存的改动都会保留。

评论

在任务详情的 Comments 区域,你可以查看该任务的所有评论:

  • 评论列表:以只读形式展示,包含序号、作者(如有)、时间戳和 Markdown 渲染后的正文
  • 输入表单:只要任务可编辑(包括预览模式),区域底部就会显示评论输入表单,无需先进入编辑模式
    • Author 输入框(占位提示「评论人」):可选,填写评论作者名称
    • Add a comment... 文本框:使用富 Markdown 编辑器,带工具栏、粘贴转 Markdown、图片 / Word 文档拖入上传与 [[ 实体链接自动补全;粘贴的图片在保存时自动从临时目录提升到 assets/paste/(单独一行的 --- 仍被保留为分隔符,不能作为评论内容)
    • Add comment 按钮:提交后评论列表立即刷新,并保持当前模式——在预览模式添加评论不会把模态框切换成编辑模式
  • 删除评论:鼠标悬停在某条评论上时出现删除按钮;Comments 区域标题栏另有 Clear comments 按钮一次性清空全部评论。命令行对应 --remove-comment <序号> 与 --clear-comments
  • 跨分支的只读任务显示评论列表,但不提供输入表单与删除操作
  • 评论正文支持 Markdown,但单独的 --- 行不能出现在评论中(保留为分隔符)

表格排序

任务列表的所有表头列(ID、标题、状态、优先级、里程碑、创建时间)均支持点击排序。

默认序号排序

列表默认按任务序号(ordinal)排序,与看板一致,无需显式操作。当没有任何列处于激活排序状态时,表格恢复为序号排序模式。

三击循环

点击任意表头列,排序按三击循环切换:

  1. 第一次点击:按该列升序排列
  2. 第二次点击:切换为降序
  3. 第三次点击:清除该列的排序,恢复默认序号排序

双箭头排序图标

每列表头右侧显示一组双箭头图标:

  • 未激活:↑ 和 ↓ 两支箭头均为淡灰色
  • 升序激活:左侧 ↑ 高亮显示,右侧 ↓ 保持灰色
  • 降序激活:右侧 ↓ 高亮显示,左侧 ↑ 保持灰色

三种状态的外框宽度完全一致,切换排序方向时表头文字不会产生抖动。

results matching ""

    No results matching ""