dootask/resources/ai-kb/zh/howto/favorite/add.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
favorite.add.howto	收藏一个对象	howto	favorite	end-user	zh	怎么收藏任务 收藏项目 收藏文件 收藏消息 加星 怎么加收藏		task_detail project_detail file messenger	当前用户对被收藏对象有可见权限	不能批量收藏多个对象，一次只能加一个 不能替别人收藏（收藏仅对自己生效） 没有「收藏分组」「收藏夹」概念，全部进同一个列表	v1.7.90

收藏一个对象

支持的对象类型

• 任务（task）：项目下的任意任务
• 项目（project）：自己加入或可见的项目
• 文件（file）：文件柜中的文件
• 消息（message）：群聊 / 私聊中的某条消息

操作步骤

进入对应对象的详情页或操作菜单，点击「收藏 / 加星」按钮即可。同一按钮再次点击为取消收藏（toggle 语义，见 favorite.remove.howto）。

• 任务：任务详情页 → 顶部「⋯」菜单 →「收藏」
• 项目：项目详情页 → 顶部「⋯」菜单 →「收藏项目」
• 文件：文件详情 / 文件柜右键 →「收藏」
• 消息：长按 / 右键消息气泡 →「收藏」

添加备注（可选）

收藏成功后，进入「我的收藏」（见 favorite.list.howto）列表，点击对应行的「备注」字段可编辑：

• ≤ 255 字符
• 备注仅本人可见，可随时修改清空

接口行为

后端使用 toggle 接口（POST api/users/favorite/toggle），传 type 与 id；已收藏则取消，未收藏则添加。前端按钮态由 users/favorite/check 实时回查。

不支持

• 不能批量收藏；每次操作一个对象
• 收藏不通知他人；不会出现在动态中
• 不能给收藏排序 / 分组 / 打标签