Skip to content

Feature request: manage pinned group chats in Feeds / message list #980

@LiaoyuanNing

Description

@LiaoyuanNing

Summary

希望 lark-cli 支持管理飞书 Feeds / 消息流会话列表里的「置顶群」能力。

这里指的是用户在飞书左侧消息流 / Feeds 里对群聊进行置顶管理:

  • 置顶某个群聊
  • 取消置顶某个群聊
  • 查询当前已置顶的群聊列表
  • 调整置顶群聊之间的顺序 / 位置

注意:这不是群内置顶消息或群公告(group top notice),也不是群内 Pin 消息。

Use case

对于重度使用飞书管理客户群、项目群、机器人通知群的用户,希望可以通过 CLI / AI Agent 自动维护一个更健康的消息流:

  • 把核心客户群、关键项目群置顶
  • 把阶段性结束的群取消置顶
  • 根据优先级或本周重点调整置顶群顺序
  • 周期性生成“重点群清单”,并同步到 Feeds 置顶区

这对客户群治理、项目管理、飞书工作台整理很有价值。

Proposed commands

建议增加类似下面的命令:

# 查询当前 Feeds 中已置顶的群聊
lark-cli im +feed-pinned-chat-list --as user

# 置顶某个群聊
lark-cli im +feed-pin-chat --as user --chat-id oc_xxx

# 取消置顶某个群聊
lark-cli im +feed-unpin-chat --as user --chat-id oc_xxx

# 调整置顶群顺序:把某个群移动到第 N 位
lark-cli im +feed-pinned-chat-move --as user --chat-id oc_xxx --position 1

# 或批量设置置顶顺序
lark-cli im +feed-pinned-chat-reorder --as user --chat-ids oc_a,oc_b,oc_c

命名上建议明确包含 feed / pinned chat,避免和以下能力混淆:

  • 群内置顶消息 / 群公告:top_notice
  • 群内 Pin 消息:im pins
  • 消息收藏 / flag:im flags

Expected behavior

  • 只操作当前授权用户的 Feeds / 消息流置顶设置。
  • 优先支持群聊 chat_id,未来也可以考虑单聊 / bot 会话。
  • 支持 --dry-run 展示将要调整的置顶列表。
  • 对顺序调整提供清晰语义,例如 --position--before-chat-id--after-chat-id 或批量 reorder。
  • 如果飞书开放平台暂时没有公开 API,希望 CLI 团队评估是否有可用的 Feeds/会话设置 API,或在文档/命令帮助中明确当前不可支持的原因。

Acceptance criteria

  • Can list the current user's pinned chats/groups in Feeds.
  • Can pin a group chat by chat_id.
  • Can unpin a group chat by chat_id.
  • Can reorder pinned group chats.
  • Commands work with user identity (--as user), since this is a per-user Feeds setting.
  • Help text clearly differentiates this from group top notice and message pins.

Why this helps

This would allow lark-cli and AI Agents to help users keep their Feishu message stream organized, especially for users managing many active customer/project groups. It turns Feeds pinning from a manual UI-only workflow into an automatable part of personal work management.

Metadata

Metadata

Assignees

No one assigned

    Labels

    domain/authAuthentication subsystemdomain/imPR touches the im domainenhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions