# 用户功能手册 [中文](./USER_GUIDE.md) | [English](../en/USER_GUIDE.md) 本文档面向 To-Do List Timeline 的普通用户和管理员，说明页面里的主要功能、使用路径和限制。接口细节不在这里展开，需要开发者接口说明时请看 [API.md](./API.md)。 ## 快速开始 1. 打开应用首页，例如 `http://localhost:8092`。 2. 点击右上角账号入口。 3. 注册账号或使用已有账号登录。 4. 在“DDL日期时间线”新增带截止时间的任务，或切到“每日安排”把任务拖进具体时间格子。 未登录时页面可以打开，但任务、每日安排、反馈等数据不会保存；需要先登录或注册。 ## 账号 ### 注册和登录 - 注册需要填写姓名、昵称和密码。 - 昵称用于登录，同一个昵称不能被多个账号重复使用。 - 密码至少 6 位。 - 注册成功后会自动登录。 ### 账号菜单 登录后，右上角账号入口会显示当前账号。普通用户可以： - 修改昵称：昵称不能为空，最长 32 个字符，不能和其他用户重复。 - 修改密码：需要输入原密码、新密码和确认密码；新密码至少 6 位。 - 退出登录：退出后会清空当前页面中的用户数据，并回到未登录状态。 管理员账号还可以从账号菜单进入“管理员后台”。 ## 新手指引 首次进入普通待办页面时，系统会显示新手指引。指引会说明： - 先登录账号。 - 从哪里新增任务。 - 左侧任务池的作用。 - “DDL日期时间线”和“每日安排”的区别。 - 如何把 DDL 拖进每天的时间格子。 - 如何提交反馈。 可以点击“跳过”结束指引。切换到需要操作的页签时，指引会要求先点击对应页签再继续。这里不绕弯子：如果你已经熟悉页面，跳过也完全没问题。 ## DDL 日期时间线 “DDL日期时间线”用于查看和管理带截止时间的任务。 ### 新增任务 点击“新增任务”后填写： - 标题：任务名称，不能为空。 - 科目：可以从下拉列表选择，也可以直接输入。 - 时间安排：可以设置截止时间，也可以先放入“待安排”。 - 截止日期和截止时间：只有选择“设置截止时间”时需要填写。 - 优先级：高、中、低，对应红、黄、绿标记。 - 备注：用于记录页码、题号、地点、材料或其他说明。 保存后： - 带截止时间的任务会自动出现在对应日期列。 - 未设置截止时间的任务会留在左侧“待安排”中。 - 任务会按截止时间、优先级和标题排序。 ### 查看和定位 - 页面按日期横向展示任务。 - 可以点击“定位今天”回到今天。 - 可以使用日期跳转快速定位某一天。 - 可以使用“后一周”等快捷操作移动时间线视图。 - 可以打开“显示已完成”，查看已经完成的任务；关闭后已完成任务会隐藏。 ### 编辑、完成和删除 点击任务卡片可以打开任务详情。详情中可以： - 修改标题、科目、截止时间、优先级和备注。 - 标记完成或取消完成。 - 删除任务。 需要注意两个联动规则： - 当一个未完成的 DDL 任务被标记完成时，该任务关联的所有未完成“每日安排”也会同步标记完成。 - 当一个已完成的 DDL 任务被取消完成时，已经完成的每日安排不会自动取消完成，需要在对应安排里单独处理。 - 删除任务会同时删除它关联的所有每日安排；删除安排不会删除原任务。 ## 每日安排 “每日安排”用于把任务拆到具体日期和时间段里执行。 ### 待安排 左侧“待安排”统一显示尚未确定截止时间，或需要灵活安排的任务。切到“每日安排”后，可以： - 点击栏目里的“新增”，创建一个没有截止时间的待安排任务。 - 把待安排任务拖到任意日期，再设置开始时间和持续时间。 - 点击任务卡片，补充截止时间或修改任务详情。 旧版弹性任务池中的任务也会继续显示在这里，不需要迁移数据。 ### 底部 DDL 列表 每日安排底部有“按时间排序的 DDL”。这里显示尚未完成、带截止时间的 DDL 任务。 可以对 DDL 做两件事： - 拖到上方某个时间格子，创建一次每日安排。 - 直接点击 DDL 卡片，打开任务详情，修改或标记完成。 同一个 DDL 可以重复拖动到不同时间格子，用来拆分成多次学习安排。 ### 创建安排 把待安排任务或底部 DDL 拖到某一天后，会打开“创建每日安排”窗口。需要确认： - 安排任务：来自被拖动的任务。 - 时间段：来自目标时间格子。 - 预计持续时间：默认不超过当前格子剩余容量。 - 备注：记录这次安排的具体目标，例如页码、题号或复习范围。 保存后，安排卡片会出现在该时间格子里。 ### 编辑、移动和完成安排 点击安排卡片可以打开“安排详情 / 编辑”。可以： - 修改预计持续时间。 - 修改备注。 - 标记完成或取消完成。 - 删除安排。 也可以把已有安排拖到其他时间格子，或拖到同一格子的不同位置来调整顺序。调整后会保存新的日期、时间段和排序。 安排完成只影响这一次安排本身，不会自动把原 DDL 任务标记完成。反过来，DDL 任务从未完成变为完成时，会同步完成关联的未完成安排。 已完成的安排不会继续参与时间冲突计算；即使当前隐藏了已完成安排，也不会让其他安排出现看不见的冲突对象。 ## 时间格子 每日安排依赖时间格子。每个格子有名称、开始时间和结束时间，例如“晚饭后 18:00-18:40”。 ### 一周模板 点击“编辑一周模板”可以维护一周内每天的默认时间格子。 - 模板从当前选择日期开始生效。 - 没有单独自定义的未来日期会使用对应的一周模板。 - 保存前会校验时间格式，支持 `H:mm` 或 `HH:mm`，例如 `9:00`、`18:40`。 - 结束时间必须晚于开始时间。 ### 单日时间格子 点击某一天上的编辑入口，可以只修改当天时间格子。 - 单日设置只影响这一天。 - 单日设置优先级高于一周模板。 - 可以新增或删除当天的时间段。 - 可以重置当天，让它重新使用一周模板。 ### 重置和容量限制 - “重置全部”会删除当前用户的一周模板版本和全部单日自定义，恢复系统默认模板。 - 如果修改或重置时间格子会导致已有安排所在时间段失效，系统会拒绝保存。 - 每个时间格子的安排总时长不能超过格子容量。例如 18:00-18:40 的容量是 40 分钟，已经安排 30 分钟时，最多只能再安排 10 分钟。 ## 科目模板 新增或编辑任务时，“科目”字段支持下拉选择，也支持直接输入。 下拉列表底部有“编辑科目模板”。进入后可以： - 启用或停用预设科目。 - 添加自定义科目。 - 删除自定义科目。 - 保存模板。 规则如下： - 预设科目不会被删除，只能启用或停用。 - 自定义科目名称最长 40 个字符。 - 科目名称会去除首尾空格，并按大小写不敏感方式去重。 - 任务保存的科目是普通文本，不强制必须来自模板。因此，模板只影响下拉列表，不会自动改掉已经保存的任务。 ## 反馈 登录后可以点击页面右上区域的“反馈”按钮。 ### 提交反馈 反馈内容最多 1000 个字符。可以填写： - 遇到的问题。 - 希望改进的地方。 - 页面显示或操作上的疑问。 提交后可以在“我的反馈”里查看历史记录。 ### 反馈状态和上限 每条反馈有两种状态： - 待回复：管理员还没有回复。 - 已回复：管理员已经填写回复。 系统限制的是“未回复反馈”数量，不是总反馈数量。也就是说： - 未回复反馈达到上限时，不能继续提交新反馈。 - 管理员回复后，该反馈不再占用未回复额度。 - 你也可以删除旧反馈来释放额度；删除反馈会同时删除管理员回复。 ## 主题和布局 - 页面支持浅色和深色主题切换。 - 左侧侧栏可以收起或展开。 - 侧栏收起后仍会保留快捷按钮和当前任务池数量。 - 在窄屏或移动设备上，侧栏默认更紧凑，方便给主时间线和每日安排留出空间。 ## 管理员后台 管理员账号登录后，可以从账号菜单进入“管理员后台”。后台只对 `admin` 角色开放。 ### 进入和退出 - 进入后台后，页面切换为管理员布局。 - 可以在后台左侧切换不同管理模块。 - 点击退出后台可以回到普通待办页面。 进入管理员后台时，系统会记录一次“管理员后台”访问。 ### 用户列表 “用户列表”用于查看所有用户的基础情况，包括： - 用户姓名。 - 昵称。 - 角色。 - 任务数量。 - 每日安排数量。 - 最近活动时间。 管理员可以编辑用户姓名，也可以删除用户。删除用户会删除该用户的任务、每日安排、时间格子配置和反馈等相关数据。当前登录的管理员账号不能删除自己。 ### 用户日志 “用户日志”需要先选择一个用户，然后查看该用户的操作记录。日志会覆盖常见操作，例如： - 注册和登录。 - 新增、更新、完成、取消完成和删除任务。 - 新增、更新、完成、取消完成和删除每日安排。 - 更新时间格子模板、单日时间格子、重置时间格子。 - 修改昵称和密码。 - 提交或删除反馈。 - 管理员回复或删除反馈。 - 更新科目模板。 日志用于排查问题和了解操作历史，不是普通用户的待办入口。 ### 用户反馈 “用户反馈”用于集中处理所有用户提交的反馈。 管理员可以： - 查看反馈提交人、反馈内容、状态、提交时间和管理员回复。 - 回复反馈。 - 编辑已有回复。 - 删除反馈。 - 设置每个用户的未回复反馈上限。 未回复反馈上限必须是 1 到 1000 之间的整数。这个上限只统计待回复反馈，已回复反馈不占额度。 ### 访问分析 管理员后台的“访问分析”链接会打开 NetHub Accounts 的统一访问分析页。Todo 不再单独上报或保存访问 IP；统计由 Caddy 日志统一提供。 ### 用户时间表 “用户时间表”用于只读查看某个用户的任务和安排。 使用方式： 1. 先选择用户。 2. 点击刷新时间表。 3. 按主页格式查看该用户的“DDL日期时间线”和“每日安排”。 这个视图是只读的，管理员不能在这里直接替用户拖动、编辑或删除任务。 ## 常见限制 - 没有登录时不能保存任务、安排、反馈或时间格子设置。 - 任务标题和科目不能为空。 - 设置截止时间时，日期和时间都要填写。 - 时间格式支持 `H:mm` 或 `HH:mm`。 - 每日安排不能超过目标时间格子的容量。 - 取消 DDL 完成不会自动取消关联安排完成。 - 删除 DDL 任务会删除关联安排，删除单个安排不会删除原任务。 - 反馈提交受“未回复反馈”上限影响，已回复反馈不占额度。