wx_channels_download v260110 更新解析：公众号 RSS、视频号分页接口与 /play 流代理播放

桌面应用视频网络MCP 服务【免费下载链接】wx_channels_download微信视频号下载器项目地址https://gitcode.com/gh_mirrors/wx/wx_channels_download点击查看免费下载导读本文围绕微信视频号下载器 wx_channels_download 的 v260110 版本发布说明展开逐一拆解该版本引入的公众号 RSS 功能以及暂停任务续传、批量下载去重、next_marker分页、/play流代理播放、下载完成音效开关等关键变更。读完本文你将掌握该版本各新功能的配置方法、接口调用参数与底层实现原理可直接对照仓库源码与 OpenAPI 文档验证和上手使用。一、版本概览v260110 更新了什么v260110 是一次以公众号 RSS 能力 接口能力补齐 下载体验修复为核心的版本迭代。对照 docs/releases/260110.md 中的更新清单变更可以归纳为四类类别变更点新增功能增加公众号 RSS 功能增加创建视频号下载任务接口视频号列表/详情接口能力扩展新增/play流代理播放接口下载体验修复暂停任务无继续按钮修复批量下载重复下载优化下载面板样式并显示总下载任务数直播下载直播下载按钮增加rate与质量描述配置能力支持配置下载完成后是否播放音效其中公众号 RSS是本版本的标题特性作者在后续版本中已将其定位为过渡方案详见 docs/releases/260118.md最终由公众号文章下载功能取代但 v260110 作为 RSS 能力的首发版本其接口与实现仍值得梳理。二、公众号 RSS 功能入口与后续走向2.1 功能定位v260110 在原有公众号内容抓取能力基础上新增了 RSS 输出能力让用户可以通过标准 RSS 阅读器订阅公众号推送。结合视频号侧的实现/rss/channels路由可以推断公众号侧同样以 Atom/RSS 格式对外输出文章条目便于第三方阅读器聚合。2.2 为什么说是过渡方案作者在 v260118 的发布说明中明确写道实际用下来并不稳定后面会移除掉该功能改为公众号文章下载功能。这意味着公众号 RSS 属于实验性能力实际使用中稳定性不佳后续版本将其替换为公众号文章下载方案核心能力变为下载单篇文章与下载指定公众号所有文章。因此如果你是 v260110 及相邻版本的用户建议以文章下载功能作为主力工作流如果只想了解 RSS 的接入方式可参考视频号侧已保留的 RSS 路由实现见下文第三节。三、视频号 RSS 路由/rss/channels的源码实现虽然公众号 RSS 已被后续版本移除但视频号侧的 RSS 能力依然保留在仓库中可作为理解 v260110RSS 输出机制的最佳源码样本。3.1 路由注册位置在 internal/adapter/wxchannels/routes.go 中视频号适配器注册了如下路由registrar.RegisterGET(/rss/channels, r.HandleFetchFeedListOfContactRSS)3.2 处理流程HandleFetchFeedListOfContactRSSroutes.go#L361-L383的执行链路为读取查询参数username与next_marker调用r.client.FetchChannelsFeedListOfContact(username, next_marker)拉取指定账号的视频列表失败则返回 400将账号视频列表封装为 Atom FeedFeedID为usernameGenerator标识为FindRSSLink包含relself指向当前请求 URI与relalternate指向https://channels.weixin.qq.com视频条目entry由atom_entry结构体承载包含title、id、updated、published、link、content、author等字段routes.go#L339-L347以Content-Type: application/atomxml; charsetutf-8输出 Atom XML。从源码结构看RSS 的核心价值在于把微信私有的账号视频列表能力转化为开放的标准订阅格式从而让任意 RSS 阅读器都可以跟踪某个视频号账号的更新。四、接口能力升级分页与详情入参v260110 对视频号接口做了三处直接可观测的增强这些改动全部落在 internal/adapter/wxchannels/routes.go 中。4.1 视频号视频列表支持next_marker翻页此前视频列表接口只能拉取第一页v260110 起支持游标翻页。涉及接口及对应处理函数接口处理函数分页参数GET /api/channels/contact/feed/listHandleFetchFeedListOfContactusernamenext_markerGET /api/channels/live/replay/listHandleFetchLiveReplayListusernamenext_markerGET /api/channels/interactioned/listHandleFetchInteractionedFeedListflagnext_markerGET /api/channels/follow/listHandleFetchFollowListnext_markerGET /api/channels/play/historyHandleFetchPlayHistorynext_markerGET /api/channels/feed/comment/listHandleFetchFeedCommentListoidnid/comment_idnext_marker以 HandleFetchFeedListOfContact 为例其实现即把next_marker原样透传给底层客户端func (r *WebsocketRoutes) HandleFetchFeedListOfContact(ctx *gin.Context) { username : ctx.Query(username) next_marker : ctx.Query(next_marker) resp, err : r.client.FetchChannelsFeedListOfContact(username, next_marker) ... result.Ok(ctx, resp) }游标使用要点与 docs/cli/mcp.md 和 docs/feature/bridge.md 的说明一致列表接口保留微信原始分页字段视频号列表类接口使用上一页返回的data.lastBuffer只有账号搜索接口/api/channels/contact/search使用data.lastBuff继续翻页时把上一页的lastBuffer/lastBuff原样传给下一次调用的next_marker不要自行解码或改写。OpenAPI 文档中同样声明了该参数contact_feed_list.json、contact_search.json、feed_comment_list.json。4.2 视频号详情接口支持直接传入页面地址HandleFetchFeedProfileroutes.go#L282-L295原先依赖oid/nid定位视频v260110 起增加url与eid参数并在normalize_feed_profile_argsroutes.go#L297-L312中做了入参归一化当传入页面地址url且其中携带eid参数时自动提取eid并清空url交给底层按eid解析当oid与nid同时提供时清空url避免浏览器端解析相对地址导致超时。这意味着调用方现在可以直接丢一个视频号视频页面地址给详情接口由服务端完成参数提取与解析而不必自己拆解oid/nid。4.3 新增创建视频号下载任务接口v260110 新增了创建视频号下载任务接口将浏览即下载从页面按钮扩展为可编程接口。从 docs/feature/bridge.md 看桥接协议中的download.create支持request或url_request两种入参形态用于在执行设备上创建并启动下载任务docs/feature/mcp/commands.md 中的 MCP 工具download_content同样支持通过job_id/fetch_id/url三选一创建并启动下载任务。结合 OpenAPI 中的 download_task/create.json批量创建平台下载任务可以确认该接口底层复用统一的任务创建链路支持目录、文件名、视频规格、重复任务策略等参数为批量与自动化下载提供入口。五、/play接口视频流代理播放与解密5.1 接口语义v260110 新增的/play接口是一个视频流代理与视频号页面地址无关只接受视频地址 解密密钥两个参数参数位置必填说明urlquery是目标视频地址非视频号页面地址需 URL 编码keyquery否解密密钥用于解密被微信加密的视频流OpenAPI 定义见 channels/play.json并在 docs/public/openapi/index.json 中登记为全局路由/play。5.2 源码实现HandlePlayroutes.go#L79-L105的处理逻辑分为四步参数校验url为空返回 400missing targetURL非http开头自动补https://url.Parse失败返回 400Invalid URL密钥解析key通过strconv.ParseUint(key, 0, 64)按进制自动识别解析支持十进制/十六进制等写法解析失败返回 400invalid decryptKey解密直出当key非空时调用wxchannels.NewChannelsVideoDecryptor().DecryptOnlyInline(...)以131072即 128KB为分块粒度边解密边输出视频流routes.go#L93-L103纯代理未提供key时调用decryptor.SimpleProxy(target_url, ...)直接转发远端视频流。该解密粒度常量131072与本地视频解密接口HandleDecryptVideoroutes.go#L386-L412中使用的wxchannels.DecryptData(data, 131072, key)保持一致说明/play与本地解密共用同一套视频号加密算法与分块参数。在 internal/api/handler_frontend.go 中/play已被列入前端静态资源放行路径浏览器可直接访问该代理地址播放。5.3 典型使用场景下载完成后用本地保存的key 已下载的视频地址通过/play?url...key...在线播放验证未提供key时退化为普通流代理适合直接转发未加密或已解密的视频源。六、下载体验与配置增强6.1 暂停任务恢复继续修复了暂停的任务没有继续开始按钮的问题下载面板中暂停的任务现在可以重新发起继续下载下载任务管理链路创建、暂停、续传恢复完整闭环。6.2 批量下载去重修复了批量下载会出现重复下载的问题。结合 docs/feature/wxchannels/batch.md 可知批量下载会在作者详情页插入「批量下载」按钮获取该作者全部视频并批量创建下载任务且按每次 3 个任务的节奏执行。v260110 的修复确保同名/重复视频在任务创建阶段即被过滤避免产生冗余下载任务。6.3 重复启动时第二终端正常退出修复了重复启动下载器时第二个终端无法正常退出的问题。从仓库的进程管理代码pkg/system/proc.go 及平台相关变体可以推断该修复涉及单实例检测与重复启动时的优雅退出流程避免端口/资源被第二个实例占用导致卡死。6.4 直播下载按钮增加rate与质量描述直播页面下载按钮现在会展示码率rate与质量描述用户在下发直播下载任务前即可确认目标清晰度。直播下载的整体流程可参考 docs/feature/wxchannels/live.md点击「下载图标」创建直播下载任务下拉菜单可将ffmpeg命令复制到剪贴板。6.5 下载面板样式与总任务数下载面板样式优化并增加总下载任务数展示方便批量场景下实时核对任务总量与进度也与此前展示的下载任务数与实际下载数不一致类问题的修复目标一致。6.6 下载完成音效可配置v260110 将下载完成播放音效从固定行为改为可配置项。配置位于config.yamldownload: playDoneAudio: true取值true/false默认true后台下载模式下下载完成后播放完成音效生效范围后台下载模式。配置说明见 docs/config/download.md。音效播放的底层实现位于 internal/assets/audio.go通过//go:embed done.wav内嵌 WAV 资源解析 RIFF/WAVE 头采样率、声道、位深后用oto音频库播放并以 0.4 音量系数做 PCM 音量缩放applyVolumeInt16同时做了 1 秒节流time.Since(last_played) time.Second时直接跳过避免短时间多任务完成时的音效叠加。Linux 下的音效能力依赖libasound2t64见 docker/webtop/Dockerfile。七、总结v260110 的价值与后续演进v260110 的实质是一次接口开放化 下载体验闭环化的版本接口层视频列表游标分页next_marker、详情接口直传页面地址、/play流代理播放、创建下载任务接口共同把视频号下载能力从页面按钮升级为可编程 API为后续桥接docs/feature/bridge.md与 MCP 工具docs/feature/mcp/commands.md的深度集成打下基础体验层暂停续传、批量去重、面板总任务数、直播质量展示、完成音效开关让长时间批量下载更可控、更可感知演进方向公众号 RSS 作为实验性功能登场后因稳定性问题在 v260118 被公众号文章下载docs/feature/wxmp/guide.md取代体现了项目以实际使用反馈驱动功能迭代的思路。对于开发者和自动化使用者v260110 引入的next_marker分页约定与/play代理参数是理解后续所有视频号接口调用的基础建议以此版本为起点熟悉 internal/adapter/wxchannels/routes.go 与 docs/public/openapi/channels 中的接口定义。赞分享桌面应用视频网络MCP 服务【免费下载链接】wx_channels_download微信视频号下载器项目地址https://gitcode.com/gh_mirrors/wx/wx_channels_download点击查看免费下载相关推荐wx_channels_download Cloudflare 配置指南公众号 mp-rss Worker 部署参数详解wx_channels_download Cloudflare 配置指南公众号 mp rss Worker 部署参数详解 本文围绕 wx_channels_d桌面应用视频网络MCP 服务wx_channels_download v260830 更新详解视频号直播「边下载边播放」与下载菜单自定义能力wx_channels_download v260830 更新详解视频号直播「边下载边播放」与下载菜单自定义能力 本文基于仓库内版本发布文档 docs/rel桌面应用视频网络MCP 服务上一篇Nuxt public/ 目录详解静态资源如何被原样托管以及 Vite 与 Nitro 背后的处理机制下一篇Amazon Bedrock Workshop服务网格流量管理虚拟服务与目标规则创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考