企信链接识别卡片产品需求文档初稿

版本：v0.1

创建日期：2026-06-23

需求来源：用户沟通 + 竞品截图实测 + 企信运行态 HTML

优先级：待确认

文档状态：草稿

需求变更记录

依赖需求 Story 列表

一、需求概述

1.1 需求背景

当前企信消息中发送 URL 链接时，仅展示纯文本链接，用户需要先点开链接才能判断链接内容。竞品 IM 普遍对单条纯链接消息生成链接预览卡片，展示站点 logo、域名、标题和摘要，能降低误点风险，也能让群聊中的业务资料、文档、产品页更容易识别。

本需求目标不是做一个通用“漂亮卡片”，而是在企信会话消息流中，为符合条件的 URL 自动生成低打扰、可识别、可回退的链接预览卡片。

1.3 竞品现状

竞品	截图
飞书
企业微信
钉钉

竞品规则归纳

1.4 产品价值

1. 让群聊中的链接可被快速识别：用户无需点开即可判断链接是产品官网、文档、PDF、WPS 文档、TAPD 还是内部系统链接。
2. 降低链接误点和信息误判：登录态、PDF、抓取失败场景不伪装成完整网页卡片，明确按弱卡片或纯链接展示。
3. 保持企信消息流稳定：优先处理单条纯链接消息，混排消息和多条链接消息默认不强制展开，避免把普通沟通消息撑高。

1.5 需求目标

1. 当用户发送单条纯 URL 消息时，系统自动识别链接并生成链接预览卡片，展示站点 logo、域名、标题、摘要或文件信息。
2. 当链接无法获取有效网页信息时，系统按登录态、文件型、通用站点型或纯链接进行降级展示，不生成误导性内容。
3. 当消息为文字 + 链接混排或多条链接消息时，本期默认不自动展开卡片，仅保留原消息和可点击链接。

1.6 范围与非目标

二、产品方案

2.1 最终设计稿

本期 Web 端链接卡片视觉样式以以下设计图为准。该图用于确认消息流中的卡片宽度、链接文本换行、站点 logo / 域名 / 标题 / 摘要的层级，以及未识别 logo 时的占位图标。设计图中包含移动端展示参考，但本期交付范围仍仅包含 Web 端；移动端不纳入本期上线范围。

设计稿中已确认的展示规则：

2.2 整体方案

企信发送消息后，系统识别消息内容中的 URL。若消息内容是“单条纯链接”，则尝试生成链接预览卡片；若消息是“文字 + 链接混排”或“多条链接消息”，本期默认保留为文本消息，不自动生成卡片。

链接卡片展示应贴近 IM 消息流：卡片宽度不宜过大，优先展示站点身份、标题和摘要；信息不足时降级展示，不用空白字段撑 UI。

flowchart TD
  A["用户发送消息"] --> B{"是否包含 URL"}
  B -->|否| C["按普通文本消息展示"]
  B -->|是| D{"是否单条纯链接消息"}
  D -->|否| E["保留文本消息和可点击链接"]
  D -->|是| F["提取 URL 并请求链接元信息logo/域名/网址标题/摘要信息"]
  F --> G{"是否获取到有效网页标题/摘要"}
  G -->|是| H["展示网页预览卡片"]

2.3 链接识别规则

2.4 卡片信息结构

卡片中展示的域名是来源标识，不等同于完整链接。点击打开、消息转发、消息搜索、卡片重新渲染均以原始完整 URL 为准。

本期卡片采用飞书、企业微信方向：链接卡片是原链接消息的渲染结果，卡片本身不展示复制、关闭预览、打开按钮等额外操作。钉钉在卡片上提供复制能力，是因为其渲染卡片后原始链接文本被移除；企信本期不采用该交互。

2.6 卡片交互

2.7 多链接不生成卡片的原因

竞品普遍只在“单条纯链接消息”时触发卡片识别，多条纯链接不生成卡片，主要是因为多链接消息的语义更接近“链接清单”而不是“分享某一个页面”。如果逐条展开，会带来几个问题：

1. 一条消息被多张卡片撑得过高，影响 IM 消息流阅读效率。
2. 多链接之间没有明确主次，系统无法判断用户真正想重点预览哪一个链接。
3. 多张卡片同时触发抓取，会增加发送后解析压力和失败噪音。
4. 转发、搜索、合并聊天记录等场景会变复杂，容易出现一条消息里嵌套多个预览块的问题。

因此企信本期建议与竞品保持一致：只有单条纯链接消息生成卡片；多条纯链接、文字混排链接、聊天记录卡片内链接均不自动生成卡片。

2.8 安全与权限边界

1. 链接预览服务不得携带当前用户登录态去抓取第三方页面，避免越权读取内部文档或业务页面。
2. 登录态链接不能展示当前用户才有权限看到的业务标题、客户名称、文档正文等敏感信息。
3. 内部系统链接、WPS/KDocs、TAPD 等企业工具链接，若只能公开获取站点级信息，应展示站点级弱卡片或纯链接。
4. 卡片中展示的标题、摘要、logo 来源于目标站点公开元信息或文件名，不应由前端根据 URL 路径自行编造。

四、规范检查项

4.1 业务文案多语言 Key

无

4.2 需求埋点

无

4.3 沙盒 / 更改集能力

不涉及。

4.4 PaaS 国际化兼容检查

4.5 操作日志说明

无。链接预览生成属于消息展示增强，不建议生成用户可见操作日志。

4.6 风险点

4.7 上线策略