SuperAPI AI 工具集

getnote-tag

办公与效率

查看项目

更新于 10-15 22:38

技能介绍

用途:通过官方 getnote CLI 管理得到大脑笔记的真实标签,包括查看、添加和删除。机器调用统一使用 -o json;退出码为 0 但 success=false 仍视为失败。

主要能力与用法:查看标签用 getnote tag list <note_id> -o json,成功时 success=true,data.note_id 须与目标笔记一致,data.tags[].name 展示给用户,data.tags[].id 仅用于后续删除,data.tags[].type 标明普通或系统标签;若 tags=[],回复“这条笔记目前没有标签”,这属于成功结果。添加标签用 getnote tag add <note_id> "产品优化" -o json,只新增指定标签,不覆盖原标签,成功需有 success=true、data.note_id 与更新后的 data.tags[],回复“已添加「产品优化」”,不要说“已替换标签”。删除标签用 getnote tag remove <note_id> <tag_id> -o json,删除前必须先从 tag list 取得真实 tag_id,并确认不是系统标签,成功返回 success=true 才能回复“已删除「标签名」”。替换标签属于覆盖性操作,需先读取当前标签再交给 getnote note update --help,且必须先确认。

限制与安全边界:不要自行构造标签 ID,也不要把标签名当作删除参数;笔记 ID、标签 ID 及任何雪花 ID 始终作为字符串原样传递。系统标签不可删除;权限不足、标签不存在或笔记不存在时不能说“已经删掉”。失败时展示实际 error.message / error.reason、是否可重试和 request_id,不要把“标签不存在”“系统标签”“无权限”归为通用网络错误。同名标签无法确定时先列出名称和类型让用户确认,不要按第一个结果擅自删除。群聊中仅展示用户当前要求的标签信息,不通过标签列表推断或泄露笔记其他正文。