@streamapp/stream 0.0.1

package/resources/packages/Douyin_TikTok_Download_API/manifests.yaml

@@ -0,0 +1,521 @@
+# ------------------------------------------------------------------ douyin (handlers)
+# douyin-collection 已迁到 recipes/douyin/（登录态浏览器：进收藏页拦第一发 listcollection，
+# 其余批次在页内调站点自己的签名客户端）。这里的 HTTP 端点是死路：
+# `/aweme/v1/web/aweme/listcollection/` 恒 403 `Blocked by ArgusSecurityPlugin`——它挪到 Argus
+# 那套签名头（X-Argus/X-Gorgon/X-Ladon）后面了，和 bogus 无关（X-Bogus 与 a_bogus × GET/POST
+# 四种组合实测同样的 403），上游 video-service 至今没有任何 Argus 实现。
+- id: douyin-follow
+  adapter: Douyin_TikTok_Download_API
+  title: 我的关注
+  description: 获取已关注创作者的最新作品聚合时间线。
+  topics: [douyin, 抖音, 关注, 时间线, 作品, social-media, video]
+  categories: [social-media, video]
+  example_queries:
+    - 我在抖音关注的人最近发了什么
+    - douyin 关注时间线
+  capabilities: [timeline]
+  normalizer: douyin
+  auth:
+    type: cookie
+    domain: douyin.com
+    inject: { kind: env, name: DOUYIN_COOKIE }
+  cadence_hint_seconds: 1800
+  api: { handler: douyin-follow } # 注入 cookie 作 query
+  params_schema:
+    count: { type: number, required: false }
+# douyin-search 已迁到 recipes/douyin/（登录态浏览器拦 XHR）。这里的 HTTP 搜索端点是死路：
+# 无 cookie → 内层 status_code 2483「请先登录」（外层还是 200，静默空列表）；带 cookie →
+# CookieCloud 的 douyin cookie 有 7KB+，塞进 query 会被上游 h11 判为 Invalid HTTP request。
+- id: douyin-user
+  adapter: Douyin_TikTok_Download_API
+  title: 指定用户作品
+  description: 获取指定创作者个人主页发布的所有视频（支持个人主页链接或 sec_user_id 解析）。
+  topics: [douyin, 抖音, 用户, 作品, 视频, 博主, social-media, video]
+  categories: [social-media, video]
+  example_queries:
+    - 某个抖音博主的最新视频
+    - douyin user videos
+  capabilities: [timeline]
+  normalizer: douyin
+  auth:
+    type: none
+  cadence_hint_seconds: 3600
+  api: { handler: douyin-user } # url → sec_user_id 预解析 (get_sec_user_id)
+  params_schema:
+    url: { type: string, required: false, description: "个人主页链接" }
+    sec_user_id: { type: string, required: false, description: "直接指定 sec_user_id" }
+    count: { type: number, required: false }
+  radar:
+    - source: ["www.douyin.com/user/:sec_user_id"]
+# ------------------------------------------------------------------ bilibili
+- id: bilibili-video
+  adapter: Douyin_TikTok_Download_API
+  title: 视频详情
+  description: 获取特定 BV 号视频的详细元数据，包含标题、封面、播放时长以及 UP 主信息。
+  topics: [bilibili, 哔哩哔哩, b站, 视频, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - 查一下这个B站视频
+    - bilibili video detail
+  capabilities: [anchor]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/bilibili/web/fetch_one_video
+    query:
+      bv_id: { from: bv_id, required: true }
+    unwrap: data.data # video-service 透传 bilibili 官方 envelope → 内容在 data.data
+  params_schema:
+    bv_id: { type: string, required: true, description: "the video's BV id" }
+- id: bilibili-user-profile
+  adapter: Douyin_TikTok_Download_API
+  title: 用户信息
+  description: 查询指定 UID 创作者的个人主页名片，包括昵称、头像、个性签名等。
+  topics: [bilibili, 哔哩哔哩, b站, 用户, 主页, social-media]
+  categories: [social-media]
+  example_queries:
+    - 查一下这个B站用户
+    - bilibili user profile
+  capabilities: [anchor]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 86400
+  api:
+    endpoint: /api/bilibili/web/fetch_user_profile
+    query:
+      uid: { from: uid, required: true }
+    unwrap: data.data
+  params_schema:
+    uid: { type: string, required: true, description: "bilibili numeric user id" }
+- id: bilibili-user-videos
+  adapter: Douyin_TikTok_Download_API
+  title: 用户投稿视频
+  description: 拉取特定创作者在 B 站公开发布的投稿视频列表。
+  topics: [bilibili, 哔哩哔哩, b站, up主, 投稿, 视频, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - 某个B站up主的最新视频
+    - bilibili user videos
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/bilibili/web/fetch_user_post_videos
+    query:
+      uid: { from: uid, required: true }
+      pn: { from: pn, default: 1 }
+    unwrap: data.data.list.vlist
+  params_schema:
+    uid: { type: string, required: true, description: "bilibili numeric user id" }
+    pn: { type: number, required: false, description: "page number, default 1" }
+  radar:
+    - source: ["space.bilibili.com/:uid"]
+- id: bilibili-collection
+  adapter: Douyin_TikTok_Download_API
+  title: 收藏夹视频
+  description: 获取指定公开收藏夹（folder_id）内收录的视频列表。
+  topics: [bilibili, 哔哩哔哩, b站, 收藏夹, 视频, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - B站收藏夹里的视频
+    - bilibili favorites folder videos
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/bilibili/web/fetch_user_collection_videos
+    query:
+      folder_id: { from: folder_id, required: true }
+      pn: { from: pn, default: 1 }
+    unwrap: data.data.medias
+  params_schema:
+    folder_id: { type: string, required: true, description: "collection folder id" }
+    pn: { type: number, required: false, description: "page number, default 1" }
+- id: bilibili-popular
+  adapter: Douyin_TikTok_Download_API
+  title: 综合热门视频榜
+  description: 获取当前全站最热的视频榜单及推荐流。
+  topics: [bilibili, 哔哩哔哩, b站, 热门, 榜单, 发现, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - B站热门视频
+    - bilibili popular videos
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/bilibili/web/fetch_com_popular
+    query:
+      pn: { from: pn, default: 1 }
+    unwrap: data.data.list
+  params_schema:
+    pn: { type: number, required: false, description: "page number, default 1" }
+- id: bilibili-comments
+  adapter: Douyin_TikTok_Download_API
+  title: 视频评论
+  description: 获取视频下方的用户评论列表，支持按 rpid 获取子回复。
+  topics: [bilibili, 哔哩哔哩, b站, 评论, 视频, social-media]
+  categories: [social-media]
+  example_queries:
+    - 看看这个B站视频的评论
+    - bilibili video comments
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 1800
+  api: { handler: bilibili-comments } # rpid 有无 → 回复端点/评论端点
+  params_schema:
+    bv_id: { type: string, required: true, description: "the video's BV id" }
+    pn: { type: number, required: false, description: "page number, default 1" }
+    rpid: { type: string, required: false, description: "reply id — when set, fetches replies to this comment" }
+- id: bilibili-user-dynamic
+  adapter: Douyin_TikTok_Download_API
+  title: 用户动态
+  description: 追踪指定创作者的最新图文或转发动态流。
+  topics: [bilibili, 哔哩哔哩, b站, 动态, 用户, social-media]
+  categories: [social-media]
+  example_queries:
+    - 这个B站用户发了什么动态
+    - bilibili user dynamic feed
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 1800
+  api:
+    endpoint: /api/bilibili/web/fetch_user_dynamic
+    query:
+      uid: { from: uid, required: true }
+      offset: { from: offset }
+    unwrap: data.data.items
+  params_schema:
+    uid: { type: string, required: true, description: "bilibili numeric user id" }
+    offset: { type: string, required: false, description: "pagination offset from a previous page" }
+  radar:
+    - source: ["space.bilibili.com/:uid"]
+- id: bilibili-danmaku
+  adapter: Douyin_TikTok_Download_API
+  title: 视频弹幕
+  description: 获取指定视频最新的实时弹幕数据流。
+  topics: [bilibili, 哔哩哔哩, b站, 弹幕, 视频, social-media]
+  categories: [social-media]
+  example_queries:
+    - 这个B站视频的弹幕
+    - bilibili video danmaku
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 1800
+  api: { handler: bilibili-danmaku } # 两步: fetch_one_video 取 cid → fetch_video_danmaku 取 XML
+  params_schema:
+    bv_id: { type: string, required: true, description: "the video's BV id" }
+- id: bilibili-live-room
+  adapter: Douyin_TikTok_Download_API
+  title: 直播间信息
+  description: 查询直播间当前的播放状态、标题、分区及主播信息。
+  topics: [bilibili, 哔哩哔哩, b站, 直播, 直播间, social-media]
+  categories: [social-media]
+  example_queries:
+    - 查一下这个B站直播间
+    - bilibili live room detail
+  capabilities: [anchor]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 600
+  api:
+    endpoint: /api/bilibili/web/fetch_live_room_detail
+    query:
+      room_id: { from: room_id, required: true }
+    unwrap: data.data
+  params_schema:
+    room_id: { type: string, required: true, description: "live room id" }
+- id: bilibili-live-videos
+  adapter: Douyin_TikTok_Download_API
+  title: 直播视频流
+  description: 获取指定直播间当前的视频流播放地址。
+  topics: [bilibili, 哔哩哔哩, b站, 直播, 视频流, social-media]
+  categories: [social-media]
+  example_queries:
+    - 这个B站直播间的直播流
+    - bilibili live stream url
+  capabilities: [anchor]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 600
+  api:
+    endpoint: /api/bilibili/web/fetch_live_videos
+    query:
+      room_id: { from: room_id, required: true }
+    unwrap: data.data
+  params_schema:
+    room_id: { type: string, required: true, description: "live room id" }
+- id: bilibili-live-streamers
+  adapter: Douyin_TikTok_Download_API
+  title: 直播分区主播
+  description: 获取特定直播分区内正在进行直播的主播列表。
+  topics: [bilibili, 哔哩哔哩, b站, 直播, 分区, 主播, social-media]
+  categories: [social-media]
+  example_queries:
+    - 这个B站直播分区谁在播
+    - bilibili live area streamers
+  capabilities: [timeline]
+  normalizer: bilibili-web
+  auth: { type: none }
+  cadence_hint_seconds: 600
+  api:
+    endpoint: /api/bilibili/web/fetch_live_streamers
+    query:
+      area_id: { from: area_id, required: true }
+      pn: { from: pn, default: 1 }
+    unwrap: data.data.list
+  params_schema:
+    area_id: { type: string, required: true, description: "live area id" }
+    pn: { type: number, required: false, description: "page number, default 1" }
+# ------------------------------------------------------------------ tiktok
+# ⚠️ UNWRAP UNVERIFIED (except tiktok-user-profile): tiktok endpoints need a real
+# sec_uid / item_id (and likely a login cookie) to curl-verify against the live backend.
+# The unwrap paths below are the old-adapter values; treat them as PROVISIONAL and
+# re-verify with real data — video-service may wrap tiktok's official envelope like it
+# does bilibili (data.data.*). Tracked as a follow-up task.
+- id: tiktok-video
+  adapter: Douyin_TikTok_Download_API
+  title: 视频详情
+  description: 根据作品 ID 获取 TikTok 视频的详细数据（基于 Web 端接口）。
+  topics: [tiktok, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - look up this tiktok video
+    - tiktok video detail
+  capabilities: [anchor]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/tiktok/web/fetch_one_video
+    query:
+      itemId: { from: item_id, required: true }
+    unwrap: data.itemStruct
+  params_schema:
+    item_id: { type: string, required: true, description: "the video's item id" }
+- id: tiktok-app-video
+  adapter: Douyin_TikTok_Download_API
+  title: 视频详情(App)
+  description: 根据作品 ID 获取 TikTok 视频的详细数据（基于 App 端接口，签名机制不同）。
+  topics: [tiktok, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - look up this tiktok video via the app api
+  capabilities: [anchor]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/tiktok/app/fetch_one_video
+    query:
+      aweme_id: { from: aweme_id, required: true }
+    unwrap: data.aweme_detail
+  params_schema:
+    aweme_id: { type: string, required: true, description: "the video's aweme id" }
+- id: tiktok-user-profile
+  adapter: Douyin_TikTok_Download_API
+  title: 用户信息
+  description: 查询指定创作者的资料卡，支持 uniqueId（用户名）或 secUid。
+  topics: [tiktok, 用户, 主页, social-media]
+  categories: [social-media]
+  example_queries:
+    - look up this tiktok user
+  capabilities: [anchor]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 86400
+  api:
+    endpoint: /api/tiktok/web/fetch_user_profile
+    query:
+      uniqueId: { from: unique_id }
+      secUid: { from: sec_uid }
+    unwrap: data.userInfo.user # ✅ curl 确证
+  params_schema:
+    unique_id: { type: string, required: false, description: "the username in the profile url" }
+    sec_uid: { type: string, required: false, description: "TikTok's internal secUid, alternative to unique_id" }
+- id: tiktok-user-post
+  adapter: Douyin_TikTok_Download_API
+  title: 用户投稿视频
+  description: 获取指定用户主页公开发布的视频作品列表。
+  topics: [tiktok, 用户, 作品, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - this tiktok user's latest videos
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/tiktok/web/fetch_user_post
+    query:
+      secUid: { from: sec_uid, required: true }
+      cursor: { from: cursor, default: 0 }
+      count: { from: count, default: 35 }
+    unwrap: data.itemList
+  params_schema:
+    sec_uid: { type: string, required: true, description: "the user's secUid" }
+    cursor: { type: number, required: false, description: "page cursor, default 0" }
+    count: { type: number, required: false, description: "page size, default 35" }
+- id: tiktok-user-playlist
+  adapter: Douyin_TikTok_Download_API
+  title: 用户播放列表
+  description: 获取特定创作者名下的视频合辑或播放列表内容。
+  topics: [tiktok, 播放列表, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - this tiktok user's playlist
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/tiktok/web/fetch_user_play_list
+    query:
+      secUid: { from: sec_uid, required: true }
+      cursor: { from: cursor, default: 0 }
+      count: { from: count, default: 30 }
+    unwrap: data.itemList
+  params_schema:
+    sec_uid: { type: string, required: true, description: "the user's secUid" }
+    cursor: { type: number, required: false, description: "page cursor, default 0" }
+    count: { type: number, required: false, description: "page size, default 30" }
+- id: tiktok-user-mix
+  adapter: Douyin_TikTok_Download_API
+  title: 合辑视频列表
+  description: 根据合辑 ID（mixId）拉取归属于该合辑的视频列表。
+  topics: [tiktok, 合辑, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - videos in this tiktok mix/collection
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/tiktok/web/fetch_user_mix
+    query:
+      mixId: { from: mix_id, required: true }
+      cursor: { from: cursor, default: 0 }
+      count: { from: count, default: 30 }
+    unwrap: data.itemList
+  params_schema:
+    mix_id: { type: string, required: true, description: "the mix/collection id" }
+    cursor: { type: number, required: false, description: "page cursor, default 0" }
+    count: { type: number, required: false, description: "page size, default 30" }
+- id: tiktok-user-like
+  adapter: Douyin_TikTok_Download_API
+  title: 点赞列表
+  description: 获取指定用户公开展示的获赞/喜欢视频列表（列表需设为公开可见）。
+  topics: [tiktok, 点赞, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - this tiktok user's liked videos
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 3600
+  api:
+    endpoint: /api/tiktok/web/fetch_user_like
+    query:
+      secUid: { from: sec_uid, required: true }
+      cursor: { from: cursor, default: 0 }
+      count: { from: count, default: 30 }
+    unwrap: data.itemList
+  params_schema:
+    sec_uid: { type: string, required: true, description: "the user's secUid" }
+    cursor: { type: number, required: false, description: "page cursor, default 0" }
+    count: { type: number, required: false, description: "page size, default 30" }
+- id: tiktok-user-collect
+  adapter: Douyin_TikTok_Download_API
+  title: 收藏列表
+  description: 获取当前已登录账号自身收藏的视频列表。
+  topics: [tiktok, 收藏, video, social-media]
+  categories: [social-media, video]
+  example_queries:
+    - my tiktok favorites
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth:
+    type: cookie
+    domain: tiktok.com
+    inject: { kind: env, name: TIKTOK_COOKIE }
+  cadence_hint_seconds: 3600
+  api: { handler: tiktok-user-collect } # 注入 tiktok cookie 作 query
+  params_schema:
+    sec_uid: { type: string, required: true, description: "the user's secUid (your own, for this endpoint)" }
+    cursor: { type: number, required: false, description: "page cursor, default 0" }
+    count: { type: number, required: false, description: "page size, default 30" }
+- id: tiktok-comments
+  adapter: Douyin_TikTok_Download_API
+  title: 视频评论
+  description: 获取指定视频下方的评论列表，支持按 comment_id 进一步获取回复。
+  topics: [tiktok, 评论, video, social-media]
+  categories: [social-media]
+  example_queries:
+    - comments on this tiktok video
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 1800
+  api: { handler: tiktok-comments } # comment_id 有无 → 回复端点/评论端点
+  params_schema:
+    aweme_id: { type: string, required: true, description: "the video's item id" }
+    comment_id: { type: string, required: false, description: "comment id — when set, fetches replies to this comment" }
+    cursor: { type: number, required: false, description: "page cursor, default 0" }
+- id: tiktok-user-fans
+  adapter: Douyin_TikTok_Download_API
+  title: 粉丝列表
+  description: 获取指定用户的粉丝列表。
+  topics: [tiktok, 粉丝, social-media]
+  categories: [social-media]
+  example_queries:
+    - this tiktok user's followers
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 21600
+  api:
+    endpoint: /api/tiktok/web/fetch_user_fans
+    query:
+      secUid: { from: sec_uid, required: true }
+      count: { from: count, default: 30 }
+      maxCursor: { from: max_cursor, default: 0 }
+      minCursor: { from: min_cursor, default: 0 }
+    unwrap: data.userList
+  params_schema:
+    sec_uid: { type: string, required: true, description: "the user's secUid" }
+    count: { type: number, required: false, description: "page size, default 30" }
+    max_cursor: { type: number, required: false, description: "max pagination cursor, default 0" }
+    min_cursor: { type: number, required: false, description: "min pagination cursor, default 0" }
+- id: tiktok-user-follow
+  adapter: Douyin_TikTok_Download_API
+  title: 关注列表
+  description: 获取指定用户的关注创作者列表。
+  topics: [tiktok, 关注, social-media]
+  categories: [social-media]
+  example_queries:
+    - who this tiktok user follows
+  capabilities: [timeline]
+  normalizer: tiktok
+  auth: { type: none }
+  cadence_hint_seconds: 21600
+  api:
+    endpoint: /api/tiktok/web/fetch_user_follow
+    query:
+      secUid: { from: sec_uid, required: true }
+      count: { from: count, default: 30 }
+      maxCursor: { from: max_cursor, default: 0 }
+      minCursor: { from: min_cursor, default: 0 }
+    unwrap: data.userList
+  params_schema:
+    sec_uid: { type: string, required: true, description: "the user's secUid" }
+    count: { type: number, required: false, description: "page size, default 30" }
+    max_cursor: { type: number, required: false, description: "max pagination cursor, default 0" }
+    min_cursor: { type: number, required: false, description: "min pagination cursor, default 0" }

package/resources/packages/Douyin_TikTok_Download_API/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@streamapp/douyin-tiktok-download-api",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "stream": {
+    "id": "Douyin_TikTok_Download_API",
+    "name": "抖音 / TikTok",
+    "tagline": "视频平台搜索与解析服务",
+    "description": "抖音搜索、用户作品、关注流、合集与视频媒体解析。",
+    "backend": {
+      "image": "ghcr.io/jaggerh/video-service:latest",
+      "service": "douyin-tiktok-download-api",
+      "port": 80,
+      "health": "/health",
+      "standby": {
+        "idleMinutes": 30
+      }
+    },
+    "credentials": ["douyin.com", "tiktok.com"],
+    "normalizer": "douyin",
+    "sourceGrouping": {
+      "enabled": true,
+      "resolver": "plugin.groupByPlatform"
+    },
+    "code": {
+      "entry": "./activate.ts",
+      "adapters": ["Douyin_TikTok_Download_API"],
+      "normalizers": ["douyin"]
+    }
+  }
+}

package/resources/packages/alist/README.md

@@ -0,0 +1,14 @@
+# AList
+
+网盘聚合直链（内置托管容器，Stream 全权接管，不暴露 AList 自身 UI/密码）。
+
+## backend
+
+- `image: xhofe/alist:latest` —— 设施官方镜像（§1.2：Stream 永不重新打包）。
+- `service: alist` —— 同网络 DNS：`http://alist:5244`（仅内网，不发布宿主端口）。
+- `health: /ping` —— 2xx = ready（返回 pong）。
+- `volumes` —— 存储挂载配置 + 账号数据持久化，重启不丢。
+- `standby.idleMinutes: 240` —— 网盘挂载/播放随时可能来，不能像冷查询那样几十分钟就停——4 小时空闲
+  才睡，避免播放中途或紧接着的下一次点播撞上频繁启停。trade-off：AList 没有自带管理 UI 的 host
+  直发口（本插件未声明 `publish`），所以 standby 停它不影响外部可达性；但若日后为管理 UI 加
+  `publish`，停机窗口里那个口也会跟着不可达，直到下次唤醒。

package/resources/packages/alist/activate.ts

@@ -0,0 +1,12 @@
+import type { ActivateFn } from '../../src/packages/activate.ts'
+import { AlistAdapter } from './adapter.ts'
+import { alistNormalizer } from '../../src/content/alist.ts'
+
+/** 这个包贡献的东西：一个 adapter + 一个 normalizer。
+ *  `config.url` / `config.token` 都由宿主解析好——token 尤其：它来自 bootstrap 里那段可能跑
+ *  `provisionAlist` 的异步接管流程，所以 `activatePackages` 的调用点必须排在那之后
+ *  （`AlistAdapter` 构造时就把 token 收进字段，惰性的只有 client 的构造）。 */
+export const activate: ActivateFn = (ctx) => ({
+  adapters: { alist: new AlistAdapter(ctx.config.url as string | undefined, ctx.config.token as string | undefined) },
+  normalizers: { alist: alistNormalizer },
+})

package/resources/packages/alist/adapter.ts

@@ -0,0 +1,74 @@
+import type { Adapter, AdapterFetchResult } from '../../src/adapters/types.ts'
+import type { SourceManifest } from '../../src/manifest/types.ts'
+import { AlistClient } from '../../src/netdisk/alist-client.ts'
+import { displayTitle } from '../../src/content/alist.ts'
+
+/**
+ * token 解析：显式 ctor 参数（bootstrap 传 config.alist_token）→ ALIST_TOKEN env。
+ * 对齐 pansou 的三级回退风格（base url 的回退由 AlistClient.resolveAlistUrl 负责：
+ * 显式 → ALIST_URL env → 插件网关）。
+ */
+export function resolveAlistToken(explicit?: string): string | undefined {
+  return explicit ?? process.env.ALIST_TOKEN
+}
+
+/**
+ * AList 插件适配器 —— 一个 adapter 服务整个 alist 插件的两条 source：
+ *   - alist-list（fixed_params.mode = 'list'）：列目录/枚举文件；
+ *   - alist-resolve（fixed_params.mode = 'resolve'）：文件路径 → 临时直链 raw_url。
+ * 复用 src/netdisk/alist-client.ts（fs/list + fs/get + 30min 直链缓存），不重复 HTTP 逻辑。
+ *
+ * why 惰性建 client：token 走 config/env（非 manifest auth），未配置 token 时插件仍要在
+ * 插件页/Provider 成员候选里可见（source 已入 registry），但真正 fetch 才需要 token——
+ * 所以 client 到首次 fetch 才构造，未配置时不影响可见性，只在被实际调用时 fail loud。
+ */
+export class AlistAdapter implements Adapter {
+  readonly id = 'alist'
+  private client?: AlistClient
+
+  constructor(
+    private readonly baseUrl?: string,
+    private readonly token?: string,
+    /** 托管模式的 401 自动重登通道（bootstrap 注入 provision-login）；外接模式缺省。 */
+    private readonly refresh?: () => Promise<string>,
+  ) {}
+
+  async init(_env: Record<string, string>): Promise<void> {} // 凭证走 config/env，非 manifest broker
+
+  private ensureClient(): AlistClient {
+    if (this.client) return this.client
+    const token = resolveAlistToken(this.token)
+    if (!token) throw new Error('[alist] 缺少 token：请配置 config.alist_token 或 ALIST_TOKEN 环境变量')
+    this.client = new AlistClient({ baseUrl: this.baseUrl, token, refresh: this.refresh })
+    return this.client
+  }
+
+  async fetch(params: Record<string, unknown>, manifest: SourceManifest): Promise<unknown[] | AdapterFetchResult> {
+    const mode = String(manifest.fixed_params?.mode ?? params.mode ?? 'list')
+    const path = String(params.path ?? '/')
+    const client = this.ensureClient()
+    if (mode === 'resolve') {
+      const rawUrl = await client.rawUrl(path)
+      return [{ path, raw_url: rawUrl }]
+    }
+    if (mode === 'audio') {
+      const dir = path.replace(/\/$/, '')
+      const AUDIO_EXT = /\.(mp3|m4a|aac|flac|ogg|wav|opus)$/i
+      const files = await client.listDirRecursive(dir)
+      const items = files
+        .filter((f) => !f.isDir && AUDIO_EXT.test(f.name))
+        .map((f) => {
+          const abs = `${dir}/${f.name}`
+          const name = f.name.split('/').pop() ?? f.name
+          // title 用共享的 displayTitle（剥扩展名/水印/分享者电台名前缀）——前端各处显示的是
+          // 顶层 item.title，光在 normalizer 里清洗看不见效果。`name`/`path` 保留真实文件名。
+          return { guid: abs, title: displayTitle(name), path: abs, name, size: f.size }
+        })
+      // 一条 audio 流 = 一个目录，目录名就是电台/专辑名 → 订阅时自动填进流名（backfillLabel）。
+      // 只有这一档报：list/resolve 不产订阅流。scheduler 的作者推断兜不住网盘文件（没有 author）。
+      return { items, title: dir.split('/').pop() || undefined }
+    }
+    // 默认 list：枚举目录内文件（AlistFile[]），供绑定向导选目录与增量同步 diff。
+    return client.listDir(path)
+  }
+}