里程碑管理

里程碑用于将任务分组到阶段性目标中，便于追踪项目整体进度。Web 界面提供完整的里程碑列表、详情查看和任务分配功能。

进入里程碑页面

启动 Web 界面后，点击顶部导航栏的「里程碑」标签，进入里程碑管理页面。页面分为左右两栏：左侧为里程碑列表，右侧为选中里程碑的详情视图。

查看里程碑列表

左侧列表展示项目中所有活跃的里程碑，每个条目显示里程碑名称、描述摘要和完成进度。点击列表中的任意里程碑，右侧详情区将加载该里程碑的完整信息。

查看里程碑详情

点击里程碑卡片的标题（卡片上的按钮为「详情」）会打开里程碑详情模态框，地址栏同步为 /milestone/:id，因此链接可直接分享或在刷新后重新打开（与任务详情相同的 modal-over-route 模式，底层页面保持可见）。

详情视图包含：

• 名称与描述（Markdown 渲染，包含 Mermaid 图表；无描述时显示占位提示）
• 顶部信息框显示「创建于 / 更新于」（仅在存在对应时间戳时显示）
• 五个日期字段：dueDate、plannedStart、plannedEnd、actualStart、actualEnd
• 关联文档（Documentation）卡片：以链接列表展示，可逐条移除
• 归属该里程碑的完整任务列表（支持表头排序）
• 完成进度与各状态任务数量

点击任务列表中的任意任务标题，可跳转到对应任务详情。

编辑里程碑

在详情视图的标题栏点击「编辑」按钮进入编辑模式，Add/Edit 与任务模态框共用同一套表单组件：

• 描述：PasteAwareMDEditor 富文本 Markdown 编辑器，支持从 Word/Google Docs/网页粘贴转换、doc 上传与剪贴板贴图（保存前调用 promote 接口写入 paste/）
• 文档卡片：预览与编辑模式下都可添加或移除关联文档，添加输入框支持路径自动补全
• 日期字段：五个日期在预览与编辑模式下均可行内直接修改（date 与 datetime-local 输入，自动完成 UTC ↔ 本地时区转换）
• 脏数据保护：描述有未保存改动时，按 Esc / Cancel / × 会弹出确认；描述中的链接点击也会被拦截，避免误离开丢失编辑
• 快捷键：Ctrl/Cmd+S 保存
• 保存后 Markdown 文件同步更新，对应任务文件的里程碑字段也会同步

里程碑卡片上会直接显示日期信息与「最近更新」（如有），便于在列表中快速识别时间节点。

归档与移除的确认对话框

「归档」与「移除」都使用样式化确认弹窗（不再使用浏览器原生 window.confirm），文案明确说明对文件的影响：

• 归档（Archive）：里程碑文件移入归档目录；任务文件不会被修改，任务保留对该里程碑的引用
• 移除（Remove）：里程碑文件同样移入归档目录，并按下述选项处理任务文件
  • 清空任务的里程碑字段（默认选项，即把任务上的里程碑字段置空，任务本身不变）
  • 保留任务上的引用，或改挂到另一个活跃里程碑

两个对话框的标题即为操作名（不再重复询问里程碑名称），移除对话框中的选项标签用词也已从「保持任务未分配」改为「清空任务的里程碑字段」——因为该操作实际执行的是清空任务文件里的里程碑字段，而"未分配"只是界面上的分组名。

未分配任务池

在里程碑列表上方或详情区附近，找到「未分配任务」区域。该区域展示当前未归属任何里程碑的任务列表，相当于任务分配前的暂存池。

浏览未分配任务，找到需要归类的目标条目。

拖放分配任务到里程碑

在未分配任务池中，按住目标任务卡片并拖动，移动到左侧目标里程碑的名称区域后松开，任务即被分配到该里程碑。

分配成功后：

• 目标任务从未分配池消失
• 目标里程碑的任务计数自动更新
• 对应 Markdown 文件中的里程碑字段同步修改

支持在同一里程碑详情页内调整任务顺序，拖放任务卡片到目标位置即可。

分组内排序

每个里程碑分组（包括「未分配任务」和各个里程碑）都配有独立的排序表头：

• ID：按任务 ID 数字升序/降序排列
• 标题：按任务标题字母顺序排列
• 状态：按状态名称排列
• 优先级：按优先级（高 → 中 → 低）排列
• 创建时间（Created）：按任务创建日期升序/降序排列

默认排序：每张里程碑卡片内的任务表默认按序号（ordinal）排序，与「所有任务」页对齐。

三击循环：点击任意表头列按三击循环切换——第一次升序、第二次降序、第三次清除该列排序并恢复默认序号排序。

点击表头列即可按该列排序，再次点击切换方向。各分组的排序状态完全独立，在一个里程碑中选择「按优先级排序」不会影响其他里程碑的显示顺序。

排序图标采用与任务列表相同的双箭头设计：左侧 ↑ 表示升序，右侧 ↓ 表示降序，激活方向高亮显示。里程碑卡片本身（各分组之间的排列顺序）保持不变。

已完成的里程碑

页面底部设有「已完成的里程碑」折叠区。点击折叠标题，可展开查看历史已完成或已归档的里程碑。已完成的里程碑通常不再接受新任务分配，但可点击查看历史记录。

搜索里程碑

在里程碑列表上方提供搜索框，输入关键词后，系统将以模糊匹配方式筛选里程碑名称和描述。搜索结果实时反映在列表中，方便在里程碑数量较多时快速定位目标。

清空搜索框后，列表恢复显示全部里程碑。