dsh-mobile-plugin 0.5.27 → 0.5.29

package/knowledge/apps/qqmail.md

@@ -0,0 +1,30 @@
+---
+name: qqmail
+display: QQ邮箱
+description: 收发邮件，多账号、记事本、日历和文件云盘
+packages: ["com.tencent.androidqqmail"]
+aliases: ["QQ邮箱", "QQ Mail", "QQMail", "qq邮箱", "qqmail"]
+sites: ["mail.qq.com"]
+open: QQ邮箱
+pace: careful
+---
+## 是什么
+QQ邮箱是邮件 App，包名 `com.tencent.androidqqmail`。可同时登录几个邮箱账号一起收发，另带通讯录、记事本、日历、文件云盘、附件管理。
+
+## 界面
+没有底部标签。打开首页是「邮箱」文件夹页：
+- 顶部左边头像按钮（元素名是「返回」），进「我的邮箱」页：账号资料卡（编辑）、我的账号列表、添加账号、设置。
+- 顶部右边「+」（元素名「写邮件和设置等功能」），弹出菜单：写邮件、写记事、扫描文件、设置、时光信使。
+- 标题下面搜索框；列表分常用文件夹（全部收件箱、全部未读、全部已发、全部星标）、待发送、我的邮箱（每个账号一行）、我的应用（通讯录、文件云盘、附件管理等），未读数在行右边。
+
+## 功能
+- 邮件列表：首页点文件夹进去。顶部返回、标题「全部账号」（带下拉切换账号）、写邮件；下面文件夹下拉（如「全部收件箱」）、未读、管理。每行有发件人、日期、主题、摘要，未读带蓝点。
+- 搜索：点首页搜索框，顶部输入框和「取消」；下面可限定在邮件、通讯录、记事本、日历、文件云盘、文档里搜。
+- 设置：从「+」菜单或「我的邮箱」页进。上面是已登录账号（每个带升级）和添加账号；下面是新邮件提醒、通用、邮件、储存，隐私组、手势密码与指纹、帮助与反馈。
+
+## 已知现象
+- 版本更新后第一次打开，先是几页功能介绍，右上角有「跳过」。
+- 账号登录失效时，打开弹出「登录失效，请重新验证账号」，按钮「取消」「设置」。
+- 首页搜索框按元素点可能没反应，点框里「搜索」字样的位置能进搜索页。
+- 元素列表里有画面上看不到的文字：文件夹行带「全标已读」「首页不显示」，邮件行带「标为已读/未读」「拒收」「删除」（左滑才露出的按钮）。
+- 收件箱列表最上面可能有一条标「广告」的推广，不是邮件。

package/knowledge/apps/telegram.md

@@ -0,0 +1,27 @@
+---
+name: telegram
+display: Telegram
+description: 即时通讯，聊天、群组与频道
+packages: ["org.telegram.messenger"]
+aliases: ["Telegram", "电报", "TG", "telegram"]
+sites: ["telegram.org", "web.telegram.org"]
+open: Telegram
+pace: careful
+---
+## 是什么
+Telegram 是即时通讯 App，包名 `org.telegram.messenger`。个人聊天、群组、频道都是其中的会话对象；网页版在 `web.telegram.org`。
+
+## 界面
+主界面是会话列表（Chats），有搜索、新消息入口，另有 Contacts（联系人）页。进入后默认停留的页面不一定是 Chats，可能是上次看到的会话。会话列表每行显示名称、最后一条消息和未读标记；群组和频道名称旁有成员数或订阅数。
+
+## 功能
+- 读消息：在会话列表点目标进入，滚动看历史，每条有发送人和时间；群、频道、联系人是不同对象，频道通常只有管理员能发言。
+- 发消息：在已有会话输入，或从 Contacts、新消息入口选收件人，发出后会话里出现新气泡，气泡右侧的勾表示送达状态。
+- 联系人页可看资料；频道和群可从名称或简介进入详情。
+
+## 已知现象
+- 首次登录要输入手机号并接收验证码，可能还要求两步验证密码；换设备会重新验证。
+- 界面语言随系统，不一定是中文。
+- 「保存的消息」（Saved Messages）是发给自己的一条会话，不是联系人。
+- 频道、群与同名联系人可能重名，进入后看标题和成员/订阅信息才分得清。
+- 部分群开启「限制保存内容」，转发和截图会受限。

package/knowledge/apps/toutiao.md

@@ -0,0 +1,32 @@
+---
+name: toutiao
+display: 今日头条
+description: 新闻资讯信息流、短视频和商城
+packages: ["com.ss.android.article.news"]
+aliases: ["今日头条", "头条", "Toutiao", "toutiao"]
+sites: ["toutiao.com"]
+open: 今日头条
+pace: careful
+---
+## 是什么
+今日头条是新闻资讯 App，包名 `com.ss.android.article.news`。有图文信息流、竖屏视频和商城。
+
+## 界面
+底部标签：首页、视频、中间「+」（发布）、商城、最右个人页（没登录显示「未登录」）。
+- 首页：顶部搜索框（轮换显示热门词）和右边「豆包 AI」；下面频道：关注、推荐、热榜、发现、所在城市、视频等，最右「听一听」开关；内容是推荐信息流，每条有标题、来源、评论数。
+- 视频：全屏竖屏，上下滑切换；顶部搜索、频道（关注、精选、推荐、找短剧）、发布、更多；右侧作者头像、点赞、评论、收藏、分享。
+- 商城：顶部频道直播、商城、国家补贴，下面商品搜索框、购物车、我的订单、签到、领券、关注店铺、购物消息，再往下商品流。
+- 个人页：没登录点进去是登录页，右上角「设置」。
+
+## 功能
+- 搜索：点首页搜索框。顶部返回、输入框、相机图标、「搜索」；下面推荐词、搜索历史（带删除）、猜你想搜、头条热榜、影视热搜榜，底部有 AI 搜索、语音搜索、无痕搜索模式开关。
+- 设置：扫一扫、隐私设置、深色模式、长辈模式、字体大小、自动开启阅读模式、清除缓存、播放与网络、推送通知、安全浏览。没登录时从登录页右上角进。
+- 个人页登录后可看收藏、历史、作品等。
+
+## 已知现象
+- 没登录时打开会出现登录页（「一键登录」用抖音账号，另有其他登录方式），左上角「关闭」可关掉，不登录也能看首页和视频。
+- 刚打开可能叠着 App 自己的通知询问「是否允许“今日头条”发送通知?」，按钮「始终允许」「暂不开启」。
+- 搜索框元素名是当前轮换到的热门词，不是用户输入内容；搜索页输入框也预填推荐词。
+- 首页信息流标题常被拆成一个字一个元素，整条标题在外层可点元素名里。
+- 进商城可能弹领签到现金大弹窗（「关联抖音并领取」），有关闭「×」，读不到元素。
+- 没登录时商品价格显示不全，底部提示「登录查看商品价格」。

package/knowledge/apps/uber-eats.md

@@ -0,0 +1,26 @@
+---
+name: uber-eats
+display: Uber Eats
+description: 外卖，餐厅、菜单与订单
+packages: ["com.ubercab.eats"]
+aliases: ["Uber Eats", "UberEats", "uber eats", "ubereats"]
+sites: ["ubereats.com"]
+open: Uber Eats
+pace: careful
+---
+## 是什么
+Uber Eats 是外卖 App，包名 `com.ubercab.eats`。点餐、看餐厅菜单、购物车和订单都在里面；网页版在 `ubereats.com`。
+
+## 界面
+有 Home/搜索、餐厅菜单、Cart 和 Orders。外卖餐饮和 Grocery、Convenience、Retail 等是分开的频道。Home 顶部是配送地址和搜索，下面是餐厅/商品列表。
+
+## 功能
+- 餐厅：按配送地址查看，能看到名称、评分、点评、预计送达时间、配送费、优惠、营业状态，有 Delivery 和 Pickup 两种方式；已打烊的餐厅没有预计送达时间。
+- 菜单：菜名、分类、原币种价格、选项、是否售罄，通常不登录也能看。
+- 购物车：显示规格、数量、起送门槛、各项费用、地址与门牌详情和总额；Add 点一次加一份。
+- 订单：Orders 里有历史订单和当前订单的配送进度。
+
+## 已知现象
+- 餐厅和超市零售商品属于不同频道，切换频道才能看到不同品类。
+- 界面可能出现登录或验证；下单和支付前会显示费用明细。
+- 部分商品和餐厅只在特定配送地址范围内显示。

package/knowledge/apps/uber.md

@@ -0,0 +1,27 @@
+---
+name: uber
+display: Uber
+description: 打车，车型、价格与行程
+packages: ["com.ubercab"]
+aliases: ["Uber", "优步", "uber"]
+sites: ["uber.com"]
+open: Uber
+pace: careful
+---
+## 是什么
+Uber 是打车 App，包名 `com.ubercab`。叫车、看车型和价格、管理行程与支付都在里面；网页版在 `uber.com`。
+
+## 界面
+底部入口有 Home、Services、Activity、Account。Home 里的「Where to?」填行程；Later 等入口预约指定时间的行程。Activity 里是历史和当前行程。
+
+## 功能
+- 估价：填上车点和目的地后得到车型列表，有车型名、原币种估价、预计到达时间、容量、动态加价。价格通常登录后才显示。
+- 行程：Activity 里是历史和当前行程；已叫车的行程能看到司机、车牌和到达时间。
+- 支付与账号在 Account 里管理，可加付款方式、看订单。
+
+## 已知现象
+- 默认上车点是设备 GPS，但能改成别的城市的地址，界面上有「Search another city」入口。
+- 地址输入框有清除按钮 X；输入后从建议列表里选匹配项。
+- 机场地址会追问 Which airline 等，有 Skip 可以跳过。
+- 输入框内容可能在输入过程中变化，输入后要重新读一遍。
+- 叫车、改价、取消都可能涉及费用，页面会单独提示。

package/knowledge/apps/whatsapp.md

@@ -0,0 +1,27 @@
+---
+name: whatsapp
+display: WhatsApp
+description: 即时通讯，聊天、群组与状态
+packages: ["com.whatsapp"]
+aliases: ["WhatsApp", "Whats App", "whatsapp", "WA"]
+sites: ["whatsapp.com", "web.whatsapp.com"]
+open: WhatsApp
+pace: careful
+---
+## 是什么
+WhatsApp 是即时通讯 App，包名 `com.whatsapp`。以手机号注册，聊天、群组、语音视频通话都在里面；网页版在 `web.whatsapp.com`。
+
+## 界面
+底部标签一般是 Chats、Status（动态）、Calls（通话）、Communities、Settings（不同版本略有差异）；顶部有搜索和新聊天入口。搜索结果分 Chats、Contacts、Messages 三组。会话列表每行是头像、名称、最后一条消息、时间和未读绿点。
+
+## 功能
+- 读消息：进入会话看内容和时间，双勾表示对方已读；群里不确定的成员就是不知道。
+- 发消息：选好联系人后输入正文，发出后看气泡旁的状态图标。
+- 新聊天可从右上角新聊天按钮，从联系人或搜索里选人。
+- 状态（Status）是 24 小时消失的动态，和聊天分开。
+
+## 已知现象
+- 注册和登录靠手机号验证码；浏览器扫码关联（WhatsApp Web）是另一件事，和手机号验证不同。
+- 界面语言随系统，不一定是中文。
+- 未读消息数和「@」提及会在列表和会话里单独标出。
+- 换手机号后旧会话仍在，但新号需要用新号码验证。

package/knowledge/apps/x.md

@@ -0,0 +1,32 @@
+---
+name: x
+display: X
+description: 社交平台，帖子、趋势与私信
+packages: ["com.twitter.android"]
+aliases: ["X", "Twitter", "推特", "twitter", "小蓝鸟"]
+sites: ["x.com", "twitter.com"]
+open: X
+pace: careful
+---
+## 是什么
+X（原推特 Twitter）是社交平台，包名 `com.twitter.android`。内容按「帖子」（post）组织，可关注、发帖、转帖、私信，还有 Grok 对话；网页版是 `x.com`。
+
+## 界面
+底部五个标签：主页、探索、Grok、通知、私信，右下角悬浮发帖按钮。
+- 主页分「为你推荐」「正在关注」；帖子卡片下有回复、转帖、喜欢、展示量、书签、分享，信息流里夹着标 Ad 的广告。
+- 顶部「显示导航栏」打开抽屉：个人资料、Premium、社群、历史、列表、空间、创作者工作室、自动化工作、设置和隐私、帮助中心。
+- 探索页顶部搜索栏，下面按探索、当前趋势、新闻、体育、娱乐分标签。
+- 个人页分帖子、回复、转帖、视频、文章，右上角可分享和编辑资料。
+
+## 功能
+- 搜索：从探索页搜索栏进入，结果页分热门、最新、用户、媒体、列表，筛选有来自、日期、语言、帖子活动、排除回复、应用。
+- 看帖：点开是详情页，有作者、关注按钮、时间戳和查看次数，下方回复/转帖/喜欢/书签/分享，回复框「发布你的回复」。
+- 发帖：悬浮按钮打开全屏编辑器，可加相片、GIF、投票、定位；内容为空时发布按钮不可点。
+- 通知分全部、提及、已认证；私信列表顶部有「全部」下拉和搜索，右下角新私信。
+- Grok 标签是对话界面，可开新对话、看历史。
+
+## 已知现象
+- 首页广告带认证企业徽标，和普通帖子看起来一样。
+- 发帖编辑器是全屏页，系统返回键不退出，要按左上角关闭。
+- 未登录时只能浏览部分内容，点赞、发帖、私信会跳到登录。
+- 视频点开是全屏播放器，有倍速、隐藏、悬浮、全屏，底部进度条。

package/knowledge/apps/xiaohongshu.md

@@ -4,6 +4,7 @@ display: 小红书
 description: 笔记、搜索与社区
 packages: ["com.xingin.xhs"]
 aliases: ["小红书", "Xiaohongshu", "REDnote", "xhs"]
+sites: ["xiaohongshu.com"]
 open: 小红书
 pace: careful
 ---

package/knowledge/apps/zhihu.md

@@ -4,6 +4,7 @@ display: 知乎
 description: 问答与专栏
 packages: ["com.zhihu.android"]
 aliases: ["知乎", "Zhihu", "zhihu"]
+sites: ["zhihu.com"]
 open: 知乎
 pace: careful
 ---

package/knowledge/sites/bilibili.com/SITE.md

@@ -0,0 +1,50 @@
+---
+name: bilibili.com
+display: 哔哩哔哩
+domains: ["bilibili.com", "b23.tv"]
+aliases: ["哔哩哔哩", "B站", "bilibili", "b站"]
+apps: ["bilibili"]
+open: www.bilibili.com
+mode: desktop
+pace: standard
+description: 视频社区网页版，看视频、弹幕与评论
+---
+## 是什么
+哔哩哔哩（B站）是视频社区，网页主域名 `bilibili.com`，站内短链常是 `b23.tv`。内容以中长视频、番剧、直播为主，特色是弹幕和评论区。另有同名手机 App（见 `bilibili`）。
+
+## 页面与网址
+- 首页：`https://www.bilibili.com/`
+- 视频页：`https://www.bilibili.com/video/BV1xx411c7mD/`，BV 号以 `BV` 开头、共 12 位字母数字；旧式 av 号写成 `/video/av170001`，两者指向同一视频。
+- 分P：`/video/<BV号>?p=2`，`p` 从 1 开始。
+- 起播位置：`?t=30` 表示从第 30 秒开始。
+- 番剧：`/bangumi/play/ss<季id>`（整季）或 `/bangumi/play/ep<集id>`（单集）。
+- 直播：`/live/<房间号>`。
+- UP 主空间：`/space/<mid>`，投稿列表 `/space/<mid>/video`；`mid` 是数字用户 ID。
+- 搜索：`https://search.bilibili.com/all?keyword=<关键词>&search_type=video|media|upuser|article`。
+- 排行榜：`/v/popular/rank/all`；热门：`/popular`。
+- 短链 `b23.tv/<code>` 会 302 跳到上面某一种地址，按跳转后的 URL 匹配。
+
+## 界面
+首页顶部是搜索框和分区导航，下面是推荐视频卡片网格，卡片带封面、时长、播放量、弹幕数。左侧导航有首页、番剧、直播、游戏中心、会员购、动态、热门、频道等。
+
+视频播放页：上方是播放器，控制条里有弹幕开关、画质、倍速、音量、网页全屏/全屏；播放器下方是标题、UP 主与关注按钮、播放量、点赞/投币/收藏/分享，再接简介和分P，最下面是评论区与相关推荐。动态、稍后再看、历史、收藏在个人中心里。
+
+## 功能
+- 搜索：结果分视频、番剧、用户、专栏等分组，视频给标题、UP 主、播放量、时长。
+- 弹幕：按时间飘过，可开关、调透明度、屏蔽词。
+- 评论区分主楼与楼中楼回复，可按热度或时间排序。
+- 关注、点赞、投币、收藏（三连）；可以建收藏夹。
+- 番剧、直播、专栏各有独立入口；直播页有实时弹幕。
+
+## 接口
+- 视频详情（打开播放页就会调）：`https://api.bilibili.com/x/web-interface/view?bvid=<BV号>`（也可用 `aid=<av号>`），GET。返回 `data`：`title`、`owner.name`、`owner.mid`、`stat.view`（播放）、`stat.danmaku`（弹幕数）、`stat.reply`（评论数）、`stat.favorite`、`stat.coin`、`stat.share`、`stat.like`、`pages[]`（分P，含 `cid`）、`desc`、`pubdate`。字段全表见 `references/view-fields.md`。受限视频要登录 Cookie（SESSDATA），`code` 非 0（如 -352、-403）表示风控/权限。
+- 新版接口是 `https://api.bilibili.com/x/web-interface/wbi/view`，参数与上面基本一致，但多带 `w_rid`、`wts` 签名参数，签名前端自己算，具体规则随版本变，待确认。
+- 评论：`https://api.bilibili.com/x/v2/reply?type=1&oid=<aid>&pn=1`，`type=1` 表示视频，`oid` 用数字 aid（不是 BV 号），返回 `data.replies[]`。
+- 弹幕：`https://api.bilibili.com/x/v1/dm/list.so?oid=<cid>`，`cid` 取自 view 接口的 `pages[].cid`，返回的是 XML 不是 JSON。
+
+## 已知现象
+- 高清画质、部分番剧和大会员内容与账号等级、会员相关。
+- 部分内容需要登录后才能看或参与互动。
+- 读到的评论通常只是排在前面的一批，不是全部（接口分页）。
+- 受版权和地区限制，个别视频在特定地区不可见。
+- 部分新页面用站点自定义字体画数字，读屏可能读成方块，而接口里是明文（是否仍如此待确认）。

package/knowledge/sites/bilibili.com/references/view-fields.md

@@ -0,0 +1,17 @@
+# 视频详情接口字段（x/web-interface/view）
+
+`GET https://api.bilibili.com/x/web-interface/view?bvid=<BV号>` 返回的 `data`：
+
+- `bvid` / `aid`：视频的 BV 号与数字 av 号。
+- `title`、`desc`、`pic`（封面图 URL）、`pubdate`（发布时间戳，秒）。
+- `duration`：总时长（秒）。
+- `owner`：`{ mid, name, face }`（UP 主的用户 ID、昵称、头像）。
+- `stat`：`{ view 播放, danmaku 弹幕, reply 评论, favorite 收藏, coin 投币, share 分享, like 点赞, now_rank, his_rank }`。
+- `pages[]`：分P 列表，每项 `{ cid, page, part, duration }`；`cid` 是取弹幕要用的。
+- `tname` / `tid`：分区名与分区 ID。
+- `videos`：分P 数量。
+- `copyright`、`dimension{width,height,rotate}`、`state`。
+
+评论 `GET https://api.bilibili.com/x/v2/reply?type=1&oid=<aid>&pn=<页码>` 的 `data.replies[]` 每项：`member{uname,mid,avatar}`、`content.message`、`like`、`rcount`（楼中楼数）、`ctime`、`replies[]`。
+
+弹幕 `GET https://api.bilibili.com/x/v1/dm/list.so?oid=<cid>` 返回 XML，每条 `<d p="时间,模式,字号,颜色,时间戳,弹幕池,uid,行ID">文字</d>`。

package/knowledge/sites/github.com/SITE.md

@@ -0,0 +1,51 @@
+---
+name: github.com
+display: GitHub
+domains: ["github.com"]
+aliases: ["GitHub", "github", "代码仓库"]
+apps: []
+open: github.com
+mode: desktop
+pace: standard
+description: 代码托管与协作平台，仓库、Issue 与 PR
+---
+## 是什么
+GitHub 是代码托管与协作平台，主域名 `github.com`。核心单位是「仓库」（repository）：一个项目的代码、提交历史、Issue、Pull Request、Actions 等都挂在仓库下。我们暂无 GitHub 的 App 知识，`apps` 先留空，日后补了 APP.md 再加反链。
+
+## 页面与网址
+- 仓库首页：`https://github.com/<owner>/<repo>`。
+- 文件：`/blob/<分支>/<路径>`；目录：`/tree/<分支>/<路径>`。
+- 提交历史：`/commits/<分支>`；某次提交：`/commit/<sha>`；单文件历史：`/commits/<分支>/<路径>`；Blame：`/blame/<分支>/<路径>`。
+- Issue 列表：`/issues`；单条：`/issues/<编号>`；新建：`/issues/new`。
+- PR 列表：`/pulls`；单条：`/pull/<编号>`；文件改动：`/pull/<编号>/files`。
+- 标签 `/labels`、里程碑 `/milestones`、讨论 `/discussions`、Actions `/actions`、某次运行 `/actions/runs/<run_id>`。
+- Releases：`/releases`；标签：`/tags`。
+- 搜索：`https://github.com/search?q=<关键词>&type=repositories|code|issues|pullrequests|users`，`type` 决定搜哪个范围。
+- 用户/组织：`/<name>`；Gist：`gist.github.com/<user>/<gist_id>`（`gist.github.com` 是 `github.com` 的子域，按子域命中）。
+
+## 界面
+仓库页顶部是一排标签：Code、Issues、Pull requests、Actions、Projects、Wiki、Security、Insights、Settings。Code 页左侧是分支切换与文件树，中间是文件列表，下面渲染 README；右侧 About 栏有简介、Topics、Releases、语言占比。
+
+文件页顶部显示路径和分支，右上角是「Raw / Blame / 历史」等按钮；代码行可以点行号定位。顶部全局搜索框可切「仓库 / 代码 / Issue / 用户」等范围。个人主页顶部是头像与关注信息，下面是置顶仓库和贡献热力图。
+
+## 功能
+- 浏览目录与单个文件、查看提交历史、对比分支、看某一行是谁改的（Blame）。
+- Star、Watch、Fork 一个仓库；Releases 页下载发行包。
+- Issues 与 Pull Requests 各有列表和筛选，PR 里有 Files changed、Commits、Checks 三个视图。
+- Actions 跑 CI 工作流；代码搜索可按语言、仓库过滤。
+- 支持 Markdown 渲染、任务清单、代码块、表格。
+
+## 接口
+- 仓库信息：`https://api.github.com/repos/<owner>/<repo>`，GET，返回 `full_name`、`description`、`stargazers_count`、`forks_count`、`open_issues_count`、`language`、`license.spdx_id`、`topics[]`、`default_branch`、`pushed_at` 等。字段全表见 `references/repo-fields.md`。
+- 目录/文件：`https://api.github.com/repos/<owner>/<repo>/contents/<path>?ref=<分支>`，返回 `name`、`type`（file|dir）、`size`、`download_url`；文件内容在 `content`（base64）。
+- 文件原文：`https://raw.githubusercontent.com/<owner>/<repo>/<分支>/<路径>`（纯文本，不是 JSON）。
+- Issue/PR：`https://api.github.com/repos/<owner>/<repo>/issues/<编号>`，PR 也能从这里取（带 `pull_request` 字段），返回 `title`、`state`、`body`、`user.login`、`labels[]`、`comments`、`created_at`。
+- 搜索：`https://api.github.com/search/repositories?q=<关键词>`、`/search/issues?q=...`。
+- 未登录按 IP 限流（每分钟约 60 次），登录后更高；响应头 `X-RateLimit-Remaining` 可看余量。
+
+## 已知现象
+- 部分操作（提交、开 PR、评论、Star）需要登录。
+- 大文件走 Git LFS，页面上是占位说明而不是内容。
+- 未登录时对 API 和页面有访问频率限制，刷太快会临时被挡。
+- 私有仓库只有授权账号看得到。
+- 代码搜索需要登录，未登录只能搜仓库/Issue。

package/knowledge/sites/github.com/references/repo-fields.md

@@ -0,0 +1,13 @@
+# GitHub REST 字段
+
+## GET /repos/{owner}/{repo}
+`id`、`full_name`、`owner.login`、`description`、`private`、`html_url`、`language`、`stargazers_count`、`watchers_count`、`forks_count`、`open_issues_count`、`subscribers_count`、`topics[]`、`license{spdx_id,name}`、`default_branch`、`created_at`、`updated_at`、`pushed_at`、`size`（KB）、`archived`、`fork`。
+
+## GET /repos/{owner}/{repo}/contents/{path}?ref={branch}
+`name`、`path`、`sha`、`size`、`type`（file|dir|symlink|submodule）、`download_url`、`content`（base64）、`encoding`。
+
+## GET /repos/{owner}/{repo}/issues/{n}
+`number`、`title`、`state`、`body`、`user.login`、`labels[]{name,color}`、`assignees[]`、`comments`、`created_at`、`updated_at`、`closed_at`、`pull_request{url,merged_at}`（是 PR 时才有）。
+
+## GET /search/repositories?q=...
+`total_count`、`items[]`（每项是 repo 字段的子集）。

package/knowledge/sites/x.com/SITE.md

@@ -0,0 +1,47 @@
+---
+name: x.com
+display: X（原推特）
+domains: ["x.com", "twitter.com"]
+aliases: ["X", "推特", "Twitter", "twitter"]
+apps: []
+open: x.com
+mode: desktop
+pace: careful
+description: 社交平台，短帖、时间线与实时话题
+---
+## 是什么
+X（推特 Twitter 改名后）是社交平台，主域名 `x.com`，旧地址 `twitter.com` 仍会跳转过来。核心内容是「帖子」（post）：一段短文字，可带图片、视频、链接和投票。X 的 App 还没在我们的 App 知识里，`apps` 先留空，补了 APP.md 再加反链。
+
+## 页面与网址
+- 单条帖子：`https://x.com/<用户名>/status/<帖子id>`，id 是约 19 位数字。
+- 用户主页：`https://x.com/<用户名>`，媒体页 `/media`，喜欢 `/likes`。
+- 搜索：`https://x.com/search?q=<关键词>&f=live|media|user`，`f=live` 看最新、`f=media` 看媒体、`f=user` 看用户。
+- 探索/趋势：`/explore/tabs/trending`、`/explore/tabs/news`。
+- 视频查看器：`/<用户名>/status/<id>/video/1`。
+- 旧域名 `twitter.com/<...>` 与 `x.com/<...>` 是同一路径；`t.co/<code>` 是外链短链，会跳到站外。
+- 参数 `f=` 是搜索过滤，`src=typed_query` 是来源标记，可忽略。
+
+## 界面
+桌面网页左侧是一列导航：首页、探索、通知、私信、书签、列表、社区、个人资料，底部还有发帖入口。中间是时间线，右侧是搜索框和趋势榜。移动网页把导航收进顶部与底部标签，时间线占满屏。
+
+帖子的固定结构：作者头像与昵称、正文、媒体、以及下面一排操作——回复、转帖、点赞、查看数、书签、分享。点开一条帖子是同一条的详情页，下面接回复。
+
+## 功能
+- 发帖：文字、图片（最多四张）、视频、投票、引用另一条帖子。
+- 时间线有「为你推荐」和「正在关注」两种排序。
+- 转帖分两种：直接转帖，和带评论的引用转帖。
+- 搜索可按「热门 / 最新 / 用户 / 媒体」切换；趋势榜按地区列当前热门话题。
+- 私信是独立入口；列表可把指定账号聚成一条时间线；社区（Communities）是按主题的圈子。
+- 个人资料页有帖子、回复、媒体、喜欢等标签；订阅用户可发长文。
+
+## 接口
+- 页面自己走的是私有 GraphQL：`https://x.com/i/api/graphql/<queryId>/TweetDetail?variables=...`、`/UserTweets`、`/SearchTimeline` 等，POST/GET，需要登录 Cookie（含 `auth_token`、`ct0`）和配套的 `x-csrf-token`、`authorization` Bearer。`<queryId>` 随前端发版变，不稳定，待确认。web_capture 能读到页面已发出的响应正文，但自己重放要先登录。
+- 公开只读兜底（不登录也能取单条帖元数据）：`https://cdn.syndication.twimg.com/tweet-result?id=<帖子id>&token=<占位>`，返回 JSON 含 `text`、`user.name`、`user.screen_name`、`created_at`、`favorite_count` 等。`token` 由前端算法生成，待确认（第三方库如 react-tweet 走的就是这条）。
+- 结论：这些接口随时会改，最稳的是只读页面自己发出的请求正文（web_capture）。
+
+## 已知现象
+- 未登录访问常被登录墙挡住，或只能看少量内容。
+- 时间线默认按推荐算法排序，不完全是时间顺序。
+- 视频和图片在单独的查看器里打开，可左右切换。
+- 长文、编辑帖子、部分私信功能与订阅账号相关。
+- 内部 GraphQL 的 `queryId` 会随发版变，今天能读的接口明天可能换路径。

package/knowledge/sites/xiaohongshu.com/SITE.md

@@ -0,0 +1,48 @@
+---
+name: xiaohongshu.com
+display: 小红书
+domains: ["xiaohongshu.com", "xhslink.com"]
+aliases: ["小红书", "xiaohongshu", "RED"]
+apps: ["xiaohongshu"]
+open: www.xiaohongshu.com
+mode: desktop
+pace: careful
+description: 生活方式内容社区，图文与视频笔记
+---
+## 是什么
+小红书是生活方式内容社区，主域名 `xiaohongshu.com`，分享链接常见 `xhslink.com` 短链。基本单位是「笔记」：图文或视频配上标题、正文和标签。另有同名手机 App（见 `xiaohongshu`）。
+
+## 页面与网址
+- 笔记详情：`https://www.xiaohongshu.com/explore/<noteId>`，noteId 是 24 位十六进制；旧式 `/discovery/item/<noteId>` 也能打开。
+- 发现/首页：`https://www.xiaohongshu.com/explore`。
+- 搜索：`https://www.xiaohongshu.com/search_result?keyword=<关键词>&source=web_explore_feed`（`type=` 等筛排序/类型的取值待确认现值）。
+- 用户主页：`/user/profile/<userId>`，userId 24 位十六进制。
+- 话题页：`/page/topics/<id>`。
+- 短链 `xhslink.com/<code>` 会 302 跳到上面地址，App 里分享出来的多为短链。
+- 参数：笔记 URL 后面常跟 `xsec_token`、`xsec_source`，缺了有些笔记会打不开（风控），待确认。
+
+## 界面
+首页是瀑布流的信息流，一张张笔记卡片带封面、标题、作者头像和点赞数；顶部是搜索框，左侧导航有发现、发布、通知、我。
+
+笔记详情页：上方是图片轮播（或视频播放器），下面是标题、正文、话题标签、点赞/收藏/评论数、作者信息与关注按钮，再往下是评论区与相关推荐。个人主页有笔记、收藏、赞过等标签。
+
+## 功能
+- 发布图文或视频笔记，可加标题、正文、话题标签和地点。
+- 搜索笔记、用户、商品等，可按最新、最热排序。
+- 点赞、收藏（可建专辑）、评论、关注作者。
+- 关注页看关注的人发的笔记；消息里有评论、赞、新增关注等分类。
+- 有直播入口；商品笔记可关联店铺或商品卡。
+
+## 接口
+- 笔记详情：页面调 `https://edith.xiaohongshu.com/api/sns/web/v1/feed`（POST，body 里 `source_note_id`）。返回 `data.items[]`，每项 `note_card` 里含 `display_title`、`user.nickname`、`user.user_id`、`interact_info.liked_count`/`collected_count`/`comment_count`、`cover.url_default`、`type`（normal|video）。字段全表见 `references/note-fields.md`。
+- 搜索：`https://edith.xiaohongshu.com/api/sns/web/v1/search/notes`（POST），返回结构同上，另带 `xsec_token`。
+- 这些请求必须带 `x-s`、`x-t` 签名头（前端 JS 现算）和登录 Cookie，不签名直连会被拒（返回空或 `code` 非 0）；签名算法随版本变，待确认。
+- 图片/视频直链在 `cover.url_default`、`video.media.stream...` 里，是 CDN 域名（`sns-img-*.xhscdn.com` 一类），带时效。
+- 结论：读页面已发出的响应正文（web_capture）最稳；自己重放要签名，不建议。
+
+## 已知现象
+- 未登录时浏览和互动功能受限，常提示登录。
+- 信息流按推荐算法分发，不完全按发布时间。
+- 图片是竖向长图轮播，视频笔记会自动播放。
+- 部分笔记的评论或收藏需要登录后才看得到。
+- 少带 `xsec_token` 的笔记链接会打不开或跳登录。

package/knowledge/sites/xiaohongshu.com/references/note-fields.md

@@ -0,0 +1,18 @@
+# 笔记卡片字段（sns/web/v1/feed 的 data.items[]）
+
+- `id`：笔记 ID（24 位十六进制）。
+- `model_type`：条目类型。
+- `note_card`：
+  - `type`：`normal`（图文）或 `video`（视频）。
+  - `display_title`：标题。
+  - `user`：`{ user_id, nickname, avatar, images }`。
+  - `interact_info`：`{ liked, liked_count, collected, collected_count, comment_count, share_count, followed }`。
+  - `cover`：`{ url_default, url_pre, width, height }`。
+  - `image_list[]`：`{ url_default, width, height, live_photo }`。
+  - `video`：`{ media: { stream: { h264[]{master_url}, h265[] } }, image{...} }`。
+  - `tag_list[]`：`{ name, type }`。
+  - `time`、`last_update_time`、`ip_location`。
+
+搜索接口 `sns/web/v1/search/notes` 的条目结构相同，另带每条自己的 `xsec_token`。
+
+注：需 `x-s` / `x-t` 签名头与登录 Cookie，签名算法随版本变。

package/knowledge/sites/youtube.com/SITE.md

@@ -0,0 +1,49 @@
+---
+name: youtube.com
+display: YouTube
+domains: ["youtube.com", "youtu.be"]
+aliases: ["YouTube", "油管", "youtube"]
+apps: []
+open: www.youtube.com
+mode: desktop
+pace: standard
+description: 视频平台，看视频、订阅频道与 shorts
+---
+## 是什么
+YouTube 是视频平台，主域名 `youtube.com`，短链域名 `youtu.be`。内容以频道上传的视频为核心，另有 Shorts 短视频、直播和播放列表。我们暂无 YouTube 的 App 知识，`apps` 先留空。
+
+## 页面与网址
+- 观看页：`https://www.youtube.com/watch?v=<videoId>`，videoId 固定 11 位（字母数字加 `-`、`_`）。
+- Shorts：`https://www.youtube.com/shorts/<videoId>`。
+- 频道：新式 `https://www.youtube.com/@<handle>`；旧式 `/channel/<UC...>`、`/c/<name>`、`/user/<name>`。
+- 播放列表：`/playlist?list=<listId>`，listId 常以 `PL`、`UU`、`LL` 开头。
+- 搜索：`/results?search_query=<关键词>&sp=<筛选串>`。
+- 起播位置：`/watch?v=<id>&t=90s`；嵌入：`/embed/<videoId>`。
+- 短链 `youtu.be/<videoId>` 会 302 跳到 watch 页。
+- 参数 `sp=` 是筛选编码（上传时间/类型/时长/排序），是位压缩串，不宜手拼，在页面上选即可。
+
+## 界面
+桌面网页左侧是导航：首页、Shorts、订阅、我（媒体库）、历史、播放列表，顶部是搜索框。首页是缩略图组成的视频网格，每张卡片带时长、标题、频道名、观看数和发布时间。
+
+观看页分三块：上方是播放器（进度条、播放/暂停、音量、字幕、设置、剧场模式、全屏）；播放器下方是标题、频道与订阅按钮、点赞/点踩、分享、保存，再接简介和评论区；右侧是相关推荐列表。
+
+## 功能
+- 搜索可按上传时间、类型、时长、排序方式过滤（即 URL 里的 `sp=`）。
+- 播放器里可调画质、播放速度、字幕（含自动生成字幕）、循环。
+- 播放列表、稍后观看、点赞的视频都在「媒体库」里。
+- Shorts 是上下滑动切换的竖屏短视频流。
+- 频道页有首页、视频、Shorts、直播、播放列表、社区、简介等标签。
+- 直播页有实时聊天栏。
+
+## 接口
+- 观看页背后是 InnerTube：`https://www.youtube.com/youtubei/v1/player`（POST JSON），body 里 `videoId` 加 `context.client`（`clientName`、`clientVersion`、`hl`、`gl`）。返回 `playabilityStatus.status`（OK / LOGIN_REQUIRED / AGE_VERIFICATION_REQUIRED 等）、`videoDetails`（`title`、`author`、`channelId`、`lengthSeconds`、`viewCount`、`shortDescription`、`keywords[]`）、`streamingData`（`formats`/`adaptiveFormats`，含直链与 `signatureCipher`）、`captions`。字段全表见 `references/innertube-fields.md`。
+- 轻量公开接口：`https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=<id>&format=json`，返回 `title`、`author_name`、`thumbnail_url`，不需要 key，但只有标题/作者，没有播放量。
+- 首屏数据也塞在页面 HTML 的 `ytInitialData` / `ytInitialPlayerResponse` 里，可从页面源码直接取。
+- 注：InnerTube 的 `context.client` 版本号与相关请求头会随前端变化，待确认；oEmbed 最稳。
+
+## 已知现象
+- 播放前和播放中会插播广告。
+- 点赞、订阅、看年龄限制内容通常要先登录。
+- 部分视频有地区限制或会员（Premium）限制。
+- 自动生成的字幕可能不完全准确；评论默认按「热门」排序。
+- `sp=` 筛选码手改容易失效，用页面勾选更稳。

package/knowledge/sites/youtube.com/references/innertube-fields.md

@@ -0,0 +1,14 @@
+# InnerTube /player 响应字段
+
+`POST https://www.youtube.com/youtubei/v1/player`，body：`{ videoId, context: { client: { clientName: "WEB", clientVersion: "2.xxxxx", hl, gl } } }`。
+
+响应：
+
+- `playabilityStatus`：`{ status, reason, playableInEmbed }`。`status` 常见 `OK`、`LOGIN_REQUIRED`、`AGE_VERIFICATION_REQUIRED`、`UNPLAYABLE`。
+- `videoDetails`：`{ videoId, title, lengthSeconds, keywords[], channelId, shortDescription, thumbnail.thumbnails[], viewCount, author, isLiveContent }`。
+- `streamingData`：`{ expiresInSeconds, formats[]{ itag, url, mimeType, bitrate, width, height, contentLength, qualityLabel, audioQuality }, adaptiveFormats[]{ ..., signatureCipher } }`。
+- `captions.playerCaptionsTracklistRenderer.captionTracks[]`：`{ baseUrl, name.simpleText, languageCode }`。
+- `microformat.playerMicroformatRenderer`：`{ publishDate, uploadDate, category, viewCount, ownerChannelName }`。
+
+## oEmbed
+`GET https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=<id>&format=json`：`title`、`author_name`、`author_url`、`thumbnail_url`、`thumbnail_width`、`thumbnail_height`、`html`。

package/knowledge/sites/zhihu.com/SITE.md

@@ -0,0 +1,47 @@
+---
+name: zhihu.com
+display: 知乎
+domains: ["zhihu.com"]
+aliases: ["知乎", "zhihu"]
+apps: ["zhihu"]
+open: www.zhihu.com
+mode: desktop
+pace: careful
+description: 问答社区，问题、回答、文章与话题
+---
+## 是什么
+知乎是问答社区，主域名 `zhihu.com`。核心内容是「问题」下方的一条条「回答」，另有文章、专栏、想法等内容形式。另有同名手机 App（见 `zhihu`）。
+
+## 页面与网址
+- 问题页：`https://www.zhihu.com/question/<qid>`，qid 是数字。
+- 单条回答：`https://www.zhihu.com/question/<qid>/answer/<answerId>`。
+- 文章：`https://zhuanlan.zhihu.com/p/<id>`（专栏子域名，按 `zhihu.com` 子域命中）。
+- 用户：`/people/<slug>`；专栏：`/column/<slug>`；想法：`/pin/<id>`；话题：`/topic/<id>`。
+- 搜索：`https://www.zhihu.com/search?type=content&q=<关键词>`（`type=content|people|topic`）。
+- 热榜：`https://www.zhihu.com/hot`。
+- 分页：回答列表滚动时前端按 `limit`/`offset` 自动取（见接口节），URL 不变。
+
+## 界面
+首页默认是推荐流，顶部有「关注 / 推荐 / 热榜」等切换；左侧或顶部是搜索框。问题页顶部是问题标题与描述，下面是回答列表，每条回答带作者、正文、赞同/反对、评论数，长回答会折叠成「展开阅读全文」。右侧常有「相关问题」和话题标签。
+
+导航栏有首页、会员、发现、等待回答、我的等入口。个人主页分动态、回答、提问、文章、专栏等标签。
+
+## 功能
+- 提问、写回答、评论、赞同或反对，赞同可在赞同/喜欢之间切换。
+- 收藏回答到收藏夹；关注问题、话题、用户。
+- 写文章与专栏；发「想法」（短内容）。
+- 搜索覆盖问题、回答、文章、用户、话题，可只看某一类。
+- 盐选专栏是付费内容；私信与通知在消息入口。
+
+## 接口
+- 回答列表：`https://www.zhihu.com/api/v4/questions/<qid>/answers?include=data[*].content,voteup_count,comment_count,author.name,author.headline,created_time&limit=20&offset=0&sort_by=default|created`。返回 `data[]`，每条 `id`、`content`（HTML）、`voteup_count`、`comment_count`、`author.name`、`created_time`；`paging.is_end` 判断到底。字段全表见 `references/api-fields.md`。
+- 问题信息：`https://www.zhihu.com/api/v4/questions/<qid>?include=title,detail,answer_count,follower_count`，返回 `title`、`detail`、`answer_count`、`follower_count`。
+- 单条回答：`https://www.zhihu.com/api/v4/answers/<answerId>?include=content,voteup_count,comment_count,author.name,created_time`。
+- 注：`include` 里的字段用 `,` 或 `;` 分组指定，不加 `include` 只回默认字段；未登录/风控时可能返回 `error` 或跳登录，需要带常规浏览器头与 Cookie，是否需要额外签名/验证待确认。
+
+## 已知现象
+- 未登录浏览常弹出登录框，或只能看部分内容。
+- 长回答显示为摘要，点「展开阅读全文」才展开。
+- 推荐流里会混入广告和推广内容。
+- 部分回答和盐选内容需要会员或付费才能看全。
+- 列表接口有风控，连续快速请求或缺少浏览器头会返回错误或空。

package/knowledge/sites/zhihu.com/references/api-fields.md

@@ -0,0 +1,21 @@
+# 知乎 v4 接口字段
+
+## GET /api/v4/questions/{qid}/answers
+参数：`limit`（每页，最大 20）、`offset`（从 0 开始）、`sort_by`（`default` 或 `created`）、`include`（逗号分隔，或 `;` 分组）。
+
+返回 `data[]`，每条回答：
+- `id`：回答 ID。
+- `content`：回答正文（HTML）。
+- `voteup_count`：赞同数。
+- `comment_count`：评论数。
+- `author`：`{ name, headline, url_token, avatar_url_template }`。
+- `created_time`、`updated_time`：时间戳（秒）。
+- `is_collapsed`：是否被折叠。
+
+`paging`：`{ is_end, next, totals }`。
+
+## GET /api/v4/questions/{qid}
+`include=title,detail,answer_count,follower_count,comment_count` → 返回 `title`、`detail`（问题描述 HTML）、`answer_count`、`follower_count`、`comment_count`。
+
+## GET /api/v4/answers/{answerId}
+`include=content,voteup_count,comment_count,author.name,created_time` → 单条回答同上的字段。