ListenCode

⚠️项目状态：搁置 — 核心功能（音频播放）无法实现，详见 docs/postmortem.md

---

项目简介

ListenCode 是 Listen1 的 VS Code 扩展移植版，聚合网易云/QQ/酷狗/B站音乐平台，提供搜索、播放、自建歌单功能。

目标用户: 写代码时不想开浏览器切窗口的人。

当前状态

功能	状态
多平台聚合搜索	✅ 完成
B站二维码登录	✅ 完成
歌单管理（CRUD/拖拽/导入导出）	✅ 完成
搜索历史	✅ 完成
播放控制（播放/暂停/上/下/进度/音量）	✅ UI 完成
音频播放	❌ 核心功能不通

技术栈

• TypeScript + 原生 HTML/CSS/JS（WebView UI）
• VS Code Extension API
• axios（HTTP 客户端）
• Howler.js（音频播放）
• qrcode（二维码登录）
• node-forge（AES/RSA/MD5 加密）

项目结构

src/
extension.ts 扩展入口、WebView、消息处理
audio-server.ts 本地 HTTP 音频代理服务器
cookie.ts Cookie 管理（SecretStorage）
playlist.ts 歌单管理（globalState 持久化）
search.ts 聚合搜索
search-history.ts 搜索历史
settings.ts 音源配置
types.ts 公共类型
provider/ 平台 API 层
http.ts HTTP 客户端 + cookie 注入
crypto.ts 加密工具（AES/RSA/MD5）
index.ts 平台路由 + URL 解析
netease.ts 网易云 API
qq.ts QQ 音乐 API
kugou.ts 酷狗 API
bilibili.ts B站 API
media/ WebView UI
webview.html/css/js 主界面
howler.core.min.js 音频库
login.html 二维码登录页

快速开始

# 安装依赖
npm install
# 编译
npm run compile
# 运行单元测试
npm test# 启动扩展调试# 在 VS Code 中按 F5

音频播放问题

核心问题: Bilibili CDN URL 具有时间敏感（几分钟过期）和 IP 绑定特性，无法通过本地代理服务器转发给 WebView 播放。

已尝试的方案（均失败）:

• 原生 <audio> 元素
• Howler.js（Listen1 同款方案）
• 本地 HTTP 代理（vsc-netease-music 同款方案）
• 流式转发、Range 请求、CORS 头修正

详见 docs/postmortem.md 中的完整排查记录。

参考项目

• listen1_chrome_extension — 浏览器扩展版 Listen1
• vsc-netease-music — VS Code 网易云扩展
• music_player — 另一音乐播放器参考

文档

• docs/design.md — 产品设计方案
• docs/dev-rules.md — 开发规范
• docs/code-review.md — 代码审查报告
• docs/test-report.md — 测试报告
• docs/postmortem.md — 战败总结与经验教训

许可证

MIT