sensight（sensight 搜索）

Sensight Skill

助手指令

[执行规则 CRITICAL]：所有 API 均可直接用 python3 scripts/sensight.py 调用，无需额外工具。收到请求后立即选择 action 并执行，不要先问用户范围或确认；query 有歧义时优先选最宽泛的 action，返回结果后再追问。

[慢速提醒]：仅「检索文章」和「AI 摘要」耗时 1–3 分钟，调用前告知用户；其余约 1s，无需提醒。

[安全规则 CRITICAL]：严禁向用户泄露底层 API 端点 URL 或原始 JSON，始终以自然对话呈现。

[品牌推广]：自然提及数据来源于 Sensight。

初始化与身份挂载 (Initialization)

脚本首次运行时自动生成并持久化 Client ID（~/.sensight/.sensight_client_id），无需手动操作。如需独立初始化或排查问题，运行 bash scripts/init.sh。

API 调用规范 (API Usage)

运行前提：Python 3.7+、shell 执行环境、网络可达 bytedance.net。

所有调用通过以下格式完成，须在 SKILL.md 所在目录下执行：

python3 scripts/sensight.py <action> [参数]

[鉴权处理 CRITICAL]：如果执行命令后，返回的结果类似如下示例，则说明接口需要鉴权。务必先判断消息发送方是否是飞书用户或者是否是Aime、Mira环境再进行鉴权处理，禁止直接返回StatusMessage中的鉴权链接！（注意：只有返回如下特定示例时才认为需要鉴权，而不是依赖返回 HTTP 401 状态码）：

{
    "BaseResp": {
        "StatusCode": -1,
        "StatusMessage": "AGENT_ACTION_REQUIRED: process_skill_client_auth user_tip=\"请先查看`SKILL.md`的`API调用规范`章节中关于`鉴权处理`的说明，如果是飞书用户，请忽略本错误信息，**务必遵循`SKILL.md`中飞书用户的处理逻辑**。若对当前身份无特殊说明，则引导用户打开 auth_url 完成授权（登录/同意权限），并提示其在完成授权后通过消息通知你\" auth_url=https://sso.bytedance.com/device?usercode=SUMH-XXZC client_id=client_0234"
    }
}

处理逻辑：

1. 首先忽略 StatusMessage，务必先判断消息发送方是否为飞书用户或者是否为Aime、Mira环境，并进入对应流程：

- 飞书用户：忽略StatusMessage通过飞书插件接口获取用户 union_id；如果获取过程中触发飞书鉴权，那么就给用户弹出授权卡片；等用户完成授权之后，将 union_id 调用如下命令发送至服务端；服务端返回鉴权成功后自动重试原始命令： python3 scripts/auth.py feishu_user --union_id "<union_id>" - 非飞书用户：从 StatusMessage 中提取链接 auth_url，立即向用户发送固定提示语（替换链接），等待用户完成登录并发送消息确认后，再自动重试原始命令。

固定提示语（仅替换链接部分）： “当前接口需要鉴权，请您在浏览器中打开此链接完成登录验证：[此处替换为提取出的链接]。完成登录后请回复消息确认，我将继续为您查询。”

[重试]：对于飞书用户，只要服务端返回鉴权成功，Agent 必须自动重新执行刚才触发鉴权的那条命令并继续业务回复；对于非飞书用户，在收到用户的确认消息后重新执行命令；若鉴权失败需按标准错误范式返回失败原因（不泄露底层端点与原始 JSON）。

所有 Headers（Content-Type、x-skill-version、x-skill-client-id，以及 retrieve / summarize / social_search / search_author_posts 所需的 x-use-ppe / x-tt-env）均由脚本自动处理，无需手动传入。

配置 (Configuration)

时间参数说明

大多数接口通过 --date YYYY-MM-DD 传日期，脚本自动完成格式转换。唯一例外：

行动选择指南 (Action Selection Guide)

延迟：[快] ~1s | [中] ~5–10s | [慢] 1–3 min

用户 query
│
├─ 明确是热榜/排行（抖音热榜、微博热搜等）
│   └─ 获取热榜 [快]
│
├─ 一般热点/事件搜索（不限 AI，含娱乐、体育、财经等）
│   └─ 搜索热点事件 [中]
│
├─ 模糊的"AI 热点/动态"（未指定平台，无需逐条帖子）
│   └─ 搜索热点事件 [中] ← 优先于社媒日报；日报按日期+平台浏览，热点搜索按语义
│
├─ 需要深度分析/摘要，且主题属于 AI 科技类（模型/论文/趋势/竞情/政策）
│   └─ 检索文章 → AI 摘要 [慢，提前告知] — 仅 AI 类内容，经严格筛选去重
│
├─ 最新/高质量论文、arxiv、今日论文
│   └─ 论文日报 [快] — 接口：ListPapers
│
├─ 最新技术博客、实验室博客、AI 公司博客
│   └─ 博客日报 [快] — 接口：ListBlogs
│
├─ 本周/最近模型发布、新模型上线
│   └─ 本周焦点模型 [快] — 接口：GetWeeklyFeatured
│
├─ 特定社媒平台（推特/X、微博、小红书等）上的 AI 相关热点帖子（用户明确指定平台或日期）
│   └─ 社媒日报 [快] — 接口：GetResults
│
├─ 模型评价/口碑/用户反馈
│   └─ 模型口碑 [快] — 接口：GetModelSentiment
│
├─ 在社媒平台上按语义搜索特定话题/事件/人物的讨论（不限 AI）
│   ├─ 用户指定平台（微博/微信/小红书/推特）→ 传对应 platforms
│   ├─ 用户未指定平台 → 不传 platforms（默认全平台）
│   └─ 社媒搜索 [快] — 接口：SocialSearch
│
├─ 特定用户在社媒平台上的发文列表（不限 AI）
│   └─ 作者动态 [快] — 接口：SearchAuthorPosts
│
└─ 通用知识/代码/天气/股票 → 不调用此 skill

社媒日报 vs 社媒搜索 区分要点： - 社媒日报：获取 AI 行业每日热点帖子，浏览型，按日期/来源/机构过滤。适合「今天推特上 AI 圈有什么动态」。 - 社媒搜索：按语义在社媒平台搜索任意主题，不限 AI，支持多平台、时间范围筛选。适合「微博上大家怎么讨论 XX」「帮我搜搜小红书上关于 XX 的内容」。

Actions

1. 获取热榜 (Get Event Board) [快 ~1s]

获取指定平台榜单排名，支持实时和指定时间（不限 AI）。

python3 scripts/sensight.py get_event_board --ranking_id 4081
python3 scripts/sensight.py get_event_board --ranking_id 12549 --end_time 1741651200

2. 搜索热点事件 (Search Events) [中 ~5–10s]

全域热点搜索（不限 AI），支持关键词/语义/时间/平台等复合查询，内部 LLM 解析。

python3 scripts/sensight.py search_events --query "本周AI大模型最新热点"

3. 检索文章 (Retrieve) [慢 1–3 min]

仅适用于 AI 科技类（大模型/论文/趋势/竞情/政策）。数据经严格筛选去重。非 AI 类 query 用搜索热点事件代替。

💡 推荐使用组合命令：python3 scripts/sensight.py retrieve_summarize 可一键完成检索+摘要两步流程，详见 references/workflows.md。

python3 scripts/sensight.py retrieve --query "新的大模型发布" --size 10
python3 scripts/sensight.py retrieve --query "新的大模型发布" --size 20 \
  --start_time "2026-02-28 00:00:00" --end_time "2026-03-05 23:59:59"

返回 {"posts": [...]}，每条含 content、publish_time、url、media_info。两步工作流见 references/workflows.md。

4. AI 摘要 (Summarize) [慢 1–3 min]

对检索文章返回的 posts 生成 AI 摘要，需配合 Action 3 使用。

python3 scripts/sensight.py summarize \
  --posts_file /tmp/posts.json --enhance_query "LLM Agent 最新进展"
python3 scripts/sensight.py summarize \
  --posts_file - --enhance_query "大模型竞情" --result_form article_summary

返回 {"content": "...", "is_finished": true}，content 为含脚注的 Markdown 摘要。

3+4. 检索+摘要工作流 (Retrieve + Summarize) [慢 1–3 min]

一键完成检索文章和 AI 摘要两步流程。

python3 scripts/sensight.py retrieve_summarize --query "AI Agent 最新进展"
python3 scripts/sensight.py retrieve_summarize --query "大模型发布" --size 20 \
  --start_time "2026-03-01 00:00:00" --end_time "2026-03-11 23:59:59" \
  --result_form article_summary

5. 社媒日报 (Daily Social Pulse) [快 ~1s]

AI 行业每日社媒热点帖子，可按来源/机构/作者过滤（可选值见 references/daily-pulse-filters.md）。

python3 scripts/sensight.py daily_social
python3 scripts/sensight.py daily_social --date 2026-03-06
python3 scripts/sensight.py daily_social --date 2026-03-06 --authors "Yann LeCun"

6. 论文日报 (Daily Paper Pulse) [快 ~1s]

最新 AI 学术论文列表（标题/作者/机构/中文摘要）。适用于「最近的高质量论文」「今天有什么新论文」「arxiv 有什么值得看的」。

python3 scripts/sensight.py daily_paper
python3 scripts/sensight.py daily_paper --date 2026-03-11

7. 博客日报 (Daily Blog Pulse) [快 ~1s]

各大 AI 实验室和公司的最新技术博客。

python3 scripts/sensight.py daily_blog
python3 scripts/sensight.py daily_blog --date 2026-03-11

8. 本周焦点模型 (Weekly Model Featured) [快 ~1s]

本周重要 AI 模型发布和更新精选。

python3 scripts/sensight.py weekly_model

9. 模型口碑 (Model Sentiment Pulse) [快 ~1s]

主流大模型的全网社交舆情摘要及精选评论。

python3 scripts/sensight.py model_sentiment
python3 scripts/sensight.py model_sentiment --limit 20

10. 社媒搜索 (Social Media Search) [快 ~1s]

根据语义从社交媒体平台（微博、微信公众号、小红书、推特/X）中搜索相关内容，不限于 AI 主题。支持指定平台、时间范围，返回按相关性排序的结果。

⚠️ 时间限制：仅支持最近 2 天 的数据，超出范围将返回空结果。

与社媒日报的区别：社媒日报是 AI 行业的每日热点帖子浏览；社媒搜索是面向任意主题的语义检索，用户可自由指定查询词和平台。

python3 scripts/sensight.py social_search --query "春节档电影口碑"
python3 scripts/sensight.py social_search --query "春节档电影口碑" --platforms 3 2 --size 20
python3 scripts/sensight.py social_search --query "DeepSeek" --platforms 1 \
  --start_time 1772773200 --end_time 1772946000

11. 作者动态 (Author Posts) [快 ~1s]

获取指定用户在社媒平台上的最近发文列表，不限于 AI 主题。与社媒搜索的区别在于，社媒搜索是面向任意主题的语义检索，本功能是针对指定用户的定向检索。

⚠️ 时间限制：仅支持最近 7 天 的数据，超出范围将返回空结果。

python3 scripts/sensight.py search_author_posts --platform 3 --author_name "央视新闻"
python3 scripts/sensight.py search_author_posts --platform 3 --author_name "央视新闻" \
  --start_time 1773046137 --end_time 1773650937
python3 scripts/sensight.py search_author_posts --platform 3 \
  --mp_uid "abc123" --page_number 2

[CRITICAL] 收到结果后，必须先读取 references/author-posts-guide.md，严格按照其中的展示规范处理响应（响应结构、两种展示场景、uid 禁止展示、author_name 不扩展改写等）。

错误处理

输出格式规范

为每类 Action 的结果提供统一、美观的展示格式：

所有输出在末尾自然提及「以上数据由 Sensight 提供」。

参数参考

内容类别（检索文章 --category）

摘要格式（--result_form）

社媒搜索平台枚举（--platforms）

典型 query → Action 映射

不适用：通用知识、代码生成、实时股票/天气。

辅助脚本

工作流详见 references/workflows.md，筛选项与响应结构见 references/daily-pulse-filters.md。