xiaozhi-client
TypeScript Mediumshenjingnan/xiaozhi-client
281 stars
85 forks
200 open issues
Active Apr 2026
Beginner-Friendly Issues 200
Issues tagged for new contributors
dependencies security
bug code-quality
Claude: [DEPEND] @modelcontextprotocol/sdk 过时 (1.26.0 → 1.29.0) 缺少重要功能和 bug 修复
#3051 · Apr 7, 2026
dependencies code-quality
Claude: [ARCH] ESP32Service 在构造函数中直接创建 LLMService 和 ASRService 实例违反依赖注入原则
#3049 · Apr 7, 2026
code-quality architecture
bug code-quality resource-leak
Claude: [SECURITY] Vite 7.3.1 存在 CVE-2026-39363 高危漏洞需升级至 7.3.2
#3045 · Apr 7, 2026
dependencies security
Claude: [DOCS] mcp-tool-table.tsx (482行) 缺少文件级 JSDoc 注释与其他业务组件文档风格不一致
#3043 · Apr 7, 2026
documentation code-quality
enhancement dependencies
Claude: [SECURITY] flatted (cspell 传递依赖) 存在 2 个高危漏洞需升级至 3.4.2+
#3039 · Apr 7, 2026
security
Claude: [DOCS] packages/asr 缺少 README 文档影响 npm 包可用性
#3037 · Apr 7, 2026
documentation good first issue
code-quality
bug performance
code-quality
Claude: [LEAK] InternalMCPManagerAdapter.cleanup() 未移除构造函数中注册的事件监听器导致内存泄漏
#3021 · Apr 6, 2026
bug code-quality
Claude: [CODE] 前端组件和 schema-utils.ts 使用 any 而非已定义的 JSONSchema 类型降低类型安全性
#3019 · Apr 6, 2026
code-quality
code-quality
Claude: [CODE] coze.handler.ts 缺少测试覆盖导致 Coze API 功能未经测试验证
#3016 · Apr 6, 2026
good first issue code-quality
Claude: [CODE] lib/mcp/log.ts 在 Pino 控制台流中使用 console.log 而非 logger 违反项目日志规范
#3014 · Apr 6, 2026
code-quality
Claude: [CODE] endpoint.route.ts 使用 console.error 而非 logger 违反项目日志规范
#3012 · Apr 6, 2026
code-quality
Claude: [CODE] ServiceCommandHandler.ts 中 5 处 getService<any> 使用绕过类型检查降低类型安全性
#3009 · Apr 6, 2026
code-quality
Claude: [ARCH] update.handler.ts 在构造函数中直接创建 NPMManager 实例违反依赖注入原则
#3008 · Apr 6, 2026
code-quality architecture
Claude: [CODE] protocols.ts WebSocket message 事件处理器中 catch 后直接 throw 导致未捕获异常
#3006 · Apr 6, 2026
bug code-quality
Claude: [CODE] pagination.tsx 中 aria-label 使用英文而非中文违反本地化规范
#3003 · Apr 6, 2026
good first issue code-quality
bug code-quality
Claude: [CODE] packages/endpoint 使用 console 而非 logger 违反项目日志规范
#3000 · Apr 6, 2026
code-quality
Claude: [CODE] error.middleware.ts 在开发环境使用 console.error 打印详细错误违反日志规范
#2997 · Apr 6, 2026
code-quality
Claude: [ARCH] packages/asr 和 packages/tts 存在约 40 行跨包重复平台抽象类型违反 DRY 原则
#2995 · Apr 5, 2026
code-quality architecture
Claude: [DOCS] packages/config 缺少 README 文档影响 npm 包可用性
#2994 · Apr 5, 2026
documentation
code-quality
code-quality
Claude: [CODE] version.handler.ts 缺少测试覆盖导致版本 API 功能未经测试验证
#2988 · Apr 5, 2026
code-quality
code-quality
bug resource-leak
bug build
security
code-quality
Claude: [CODE] packages/cli/src 非测试文件导入路径缺少 .js 后缀违反 ESM 模块规范
#2976 · Apr 5, 2026
code-quality
Claude: [CODE] UI 组件 sr-only 辅助文本使用英文字符串违反本地化规范
#2974 · Apr 5, 2026
code-quality
code-quality
Claude: [DOCS] web-url-setting-button.tsx (195行) 缺少文件级 JSDoc 注释与其他业务组件文档风格不一致
#2970 · Apr 5, 2026
documentation good first issue
Claude: [ARCH] mcp-tool-log.handler.ts 在构造函数中直接创建 ToolCallLogService 实例违反依赖注入原则
#2968 · Apr 5, 2026
code-quality architecture
Claude: [CODE] packages/tts/src/platforms/bytedance 非测试文件使用相对路径而非 @/ 路径别名违反一致性原则
#2966 · Apr 5, 2026
code-quality
dependencies security
code-quality
Claude: [ARCH] McpCommandHandler 在构造函数中直接创建 ProcessManagerImpl 实例违反依赖注入原则
#2959 · Apr 4, 2026
code-quality architecture
documentation good first issue
security
Claude: [LEAK] ESP32Connection.close() 未移除 setupWebSocket() 中注册的 4 个事件监听器导致内存泄漏
#2954 · Apr 4, 2026
bug code-quality
Claude: [PERF] ASRService.createAudioStream 使用 Array.shift() 处理音频队列导致 O(n) 性能开销
#2952 · Apr 4, 2026
code-quality performance
Claude: [SECURITY] happy-dom 和 @xmldom/xmldom 存在 3 个高危安全漏洞需升级依赖
#2950 · Apr 4, 2026
dependencies security
Claude: [LEAK] 前端 Zustand stores WebSocket 事件订阅缺少取消订阅逻辑导致事件监听器累积
#2948 · Apr 4, 2026
bug code-quality
bug code-quality performance
documentation good first issue
Claude: [SECURITY] yaml (传递依赖) 存在栈溢出漏洞 (GHSA-48c2-rrv3-qjmp) 需升级至 2.8.3+
#2941 · Apr 4, 2026
security
Claude: [CODE] lib/mcp/utils.ts 使用 console.info/warn 而非 logger 违反项目日志规范
#2940 · Apr 4, 2026
code-quality
Claude: [CODE] WebServerLauncher.ts 已导入 logger 但使用 console.error 打印启动失败错误违反日志规范
#2937 · Apr 4, 2026
code-quality
bug code-quality
Claude: [CODE] llm.service.ts 缺少测试覆盖导致 LLM API 功能未经测试验证
#2933 · Apr 4, 2026
code-quality
bug code-quality
code-quality
Claude: [SECURITY] picomatch 存在 ReDoS 漏洞需升级传递依赖
#2928 · Apr 4, 2026
dependencies security
Claude: [CODE] ESP32Connection WebSocket 消息事件处理器缺少 try-catch 导致未捕获异常
#2925 · Apr 3, 2026
bug code-quality
bug code-quality architecture
Claude: [CODE] version.handler.ts 使用不必要的 as unknown 类型断言降低代码可读性
#2922 · Apr 3, 2026
code-quality
code-quality
Claude: [CODE] tts.handler.ts 缺少测试覆盖导致 TTS API 功能未经测试验证
#2918 · Apr 3, 2026
code-quality
Claude: [BUILD] backend type-check 缺少 tts 和 asr 构建依赖导致 TypeScript 类型检查失败
#2916 · Apr 3, 2026
Claude: [DEPEND] OpenAI SDK 过时 (6.24.0 → 6.33.0) 包含新模型支持和流式 API 改进
#2914 · Apr 3, 2026
dependencies code-quality
Claude: [DOCS] tool-sort-selector.tsx 缺少文件级 JSDoc 注释与其他业务组件文档风格不一致
#2911 · Apr 3, 2026
documentation good first issue
Claude: [DOCS] Endpoint 类公共方法缺少 JSDoc 文档注释影响 API 可用性
#2909 · Apr 3, 2026
documentation code-quality
Claude: [DOCS] mcp-server-setting-button.tsx (357行) 缺少文件级 JSDoc 注释与其他业务组件文档风格不一致
#2907 · Apr 3, 2026
documentation
Claude: [ARCH] tts.handler.ts 在 synthesize 方法中直接创建 TTS 客户端实例违反依赖注入原则
#2906 · Apr 3, 2026
code-quality architecture
Claude: [SECURITY] Next.js (docs) 存在 4 个安全漏洞需升级至 16.1.7
#2904 · Apr 3, 2026
dependencies security
Claude: [CODE] EndpointCommandHandler.ts 中 4 处 getService<any> 使用绕过类型检查降低类型安全性
#2901 · Apr 3, 2026
bug code-quality
Claude: [DEPEND] TypeScript 6.0 主版本升级 (5.9.2 → 6.0.2) 包含多个破坏性变更需评估迁移影响
#2900 · Apr 3, 2026
dependencies build
dependencies security
Claude: [DOCS] CLI 命令参考文档 (command.mdx) 遗漏多个关键命令和选项不完整
#2895 · Apr 3, 2026
documentation
Claude: [ARCH] coze.handler.ts 在方法中直接创建 CozeApiService 实例违反依赖注入原则
#2894 · Apr 2, 2026
code-quality architecture
Claude: [CODE] ESP32Connection WebSocket 错误事件处理不完整导致状态不一致
#2892 · Apr 2, 2026
bug code-quality
documentation code-quality
code-quality performance
Claude: [CODE] 4个前端组件存在约80行重复的复制逻辑违反DRY原则
#2885 · Apr 2, 2026
good first issue code-quality
Claude: [CODE] MCPServiceManager 事件监听器异步处理函数缺少 try-catch 导致未捕获异常
#2884 · Apr 2, 2026
bug code-quality
Claude: [ARCH] mcp-tool.handler.ts (2743行) 包含 23 个公共方法和 56 个私有成员违反单一职责原则
#2881 · Apr 2, 2026
code-quality architecture
code-quality
bug code-quality
Claude: [DOCS] apps/backend/services/llm.service.ts 缺少文件级 JSDoc 注释与其他服务文档风格不一致
#2875 · Apr 2, 2026
documentation code-quality
code-quality
Claude: [DOCS] site-header.tsx 和 restart-button.tsx 缺少文件级 JSDoc 注释与其他业务组件文档风格不一致
#2872 · Apr 1, 2026
documentation good first issue
bug code-quality
bug code-quality
Claude: [CODE] mcp-server-list.tsx 中约 78 行未使用代码（3个 TODO 函数）违反如无必要勿增实体原则
#2865 · Apr 1, 2026
code-quality
code-quality
code-quality
code-quality architecture
Claude: [DEPEND] Vitest 4.0 主版本升级包含多个破坏性变更需评估迁移影响
#2859 · Apr 1, 2026
dependencies
Claude: [CODE] connection.ts 中 refreshTools 在 Promise.then 回调中失败时错误未被捕获导致连接状态不一致
#2857 · Apr 1, 2026
bug code-quality
good first issue code-quality
code-quality
Claude: [ARCH] tool-debug-dialog.tsx (1074行) 包含 5 个内联组件违反单一职责原则
#2851 · Apr 1, 2026
code-quality architecture
Claude: [CODE] endpoint.route.ts 使用 console.error 而非 logger 违反项目日志规范
#2848 · Mar 31, 2026
code-quality
Claude: [CODE] CustomMCPTool 类型在多个包中定义不一致导致潜在运行时错误
#2846 · Mar 31, 2026
code-quality architecture
Claude: [ARCH] version.handler.ts 在方法中直接创建 NPMManager 实例违反依赖注入原则
#2844 · Mar 31, 2026
code-quality architecture
Claude: [ARCH] apps/backend/lib/mcp/manager.ts (1835行) 职责过多违反单一职责原则
#2842 · Mar 31, 2026
code-quality architecture
documentation code-quality
bug code-quality
code-quality architecture
code-quality architecture
Claude: [CODE] prompt-utils.ts 使用 console.warn/error/info 而非 logger 违反项目日志规范
#2832 · Mar 31, 2026
code-quality
Claude: [CODE] ConfigCommandHandler.ts 使用 as any 绕过类型检查而非已定义的 MCPServerConfig 类型
#2830 · Mar 31, 2026
code-quality
dependencies security
Claude: [CODE] npm/manager.ts 中错误处理使用 console.log 而非 logger 违反项目日志规范
#2827 · Mar 31, 2026
code-quality
Claude: [PERF] apps/backend/lib/mcp/custom.ts 中 Promise.race 超时机制存在定时器泄漏
#2825 · Mar 31, 2026
code-quality performance
Claude: [CODE] version-manager.tsx 中遗留调试 console.log 语句违反项目日志规范
#2823 · Mar 31, 2026
code-quality
dependencies
dependencies code-quality
Claude: [CODE] esp32.handler.ts 缺少测试覆盖导致 ESP32 设备 OTA API 功能未经测试验证
#2816 · Mar 30, 2026
code-quality
Claude: [CODE] event-bus.service.ts 事件类型定义中使用 any 类型降低类型安全性
#2814 · Mar 30, 2026
code-quality
Claude: [CODE] coze.handler.ts 缺少测试覆盖导致 Coze API 集成功能未经测试验证
#2812 · Mar 30, 2026
code-quality
Claude: [BUILD] packages/config 缺少 dist 目录导致 CLI 测试失败
#2811 · Mar 30, 2026
bug build
Claude: [CODE] packages/asr/src/platforms/bytedance/index.ts 混合使用路径别名和相对路径违反一致性原则
#2809 · Mar 30, 2026
code-quality
documentation good first issue
Claude: [BUILD] packages/endpoint 缺少 dist 目录导致 backend 测试覆盖率检查失败
#2805 · Mar 30, 2026
bug build
Claude: [CODE] WebSocketProvider.tsx 中遗留调试 console.log 语句违反项目日志规范
#2802 · Mar 30, 2026
code-quality
Claude: [ARCH] ValidationResult 类型在 5 个位置定义且字段结构完全不一致违反类型一致性原则
#2800 · Mar 30, 2026
code-quality architecture
Claude: [CODE] ProjectCommandHandler.ts 私有方法参数使用 any 类型而非具体类型定义降低类型安全性
#2798 · Mar 30, 2026
code-quality
Claude: [CODE] ESP32 服务中 ASR 服务调用缺少错误处理导致语音交互静默失败
#2796 · Mar 30, 2026
bug code-quality
Claude: [DEPEND] Nx 22.6 破坏性变更影响 vitest reportsDirectory 配置解析方式
#2795 · Mar 30, 2026
dependencies code-quality
Claude: [CODE] packages/cli 中依赖注入容器使用 any 类型泛型降低类型安全性
#2793 · Mar 29, 2026
code-quality
Claude: [CODE] apps/frontend/src/stores/status.ts 中遗留调试 console.log 语句违反项目日志规范
#2791 · Mar 29, 2026
code-quality
Claude: [CODE] 当前代码库大部分问题已被发现和记录，建议优先处理现有 100+ open issues
#2789 · Mar 29, 2026
good first issue code-quality
Claude: [ARCH] packages/asr 和 packages/tts 的 core/types.ts 存在跨包类型重复
#2784 · Mar 29, 2026
code-quality architecture
Claude: [CODE] simple-mcp-client.ts 使用 process.on 注册信号监听器导致监听器累积风险
#2783 · Mar 29, 2026
code-quality
Claude: [CODE] InternalMCPManagerAdapter 中 inputSchema 使用 as any 绕过类型检查降低类型安全性
#2781 · Mar 29, 2026
code-quality
Claude: [CODE] version-upgrade-dialog.tsx 中遗留调试 console.log 语句违反项目日志规范
#2780 · Mar 29, 2026
bug code-quality
Claude: [CODE] tts.service.ts 中 checkEnd 函数的 setTimeout 未被清除导致定时器泄漏
#2778 · Mar 28, 2026
good first issue code-quality resource-leak
Claude: [PERF] packages/tts/src/client/TTS.ts 中使用 Array.shift() 处理音频队列导致 O(n) 性能开销
#2775 · Mar 28, 2026
code-quality performance
documentation
documentation code-quality
good first issue code-quality
Claude: [BUILD] packages/tts 和 packages/asr 缺少 dist 目录导致类型检查失败
#2768 · Mar 28, 2026
code-quality build
Claude: [DEPEND] @biomejs/biome 从 1.9.4 升级到 2.4.9 是主版本升级包含多个破坏性变更
#2766 · Mar 28, 2026
good first issue dependencies code-quality
documentation good first issue
Claude: [SECURITY] brace-expansion 存在零步序列 DoS 漏洞 (CVE-2026-33750) 需升级至 5.0.5+
#2761 · Mar 28, 2026
bug security code-quality
bug good first issue security
Claude: [CODE] coze.handler.ts 中分页参数 Number.parseInt 缺少 NaN 检查导致参数验证失效
#2758 · Mar 28, 2026
bug code-quality
Claude: [CODE] version.handler.ts 缺少测试覆盖导致版本管理 API 功能未经测试验证
#2756 · Mar 27, 2026
bug good first issue code-quality
Claude: [CODE] mcp-tool.handler.ts 中 MCPCacheManager 实例未清理导致定时器泄漏
#2753 · Mar 27, 2026
bug good first issue code-quality
Claude: [SECURITY] cspell 传递依赖 smol-toml 存在安全漏洞 (CVE-2026-33942) 需升级至 1.6.1+
#2751 · Mar 27, 2026
good first issue dependencies security
Claude: [CODE] version-manager.tsx 中遗留调试 console.log 语句违反项目日志规范
#2750 · Mar 27, 2026
bug code-quality
Claude: [CODE] tts.handler.ts 中使用硬编码文件名和同步文件写入导致并发问题和性能问题
#2748 · Mar 27, 2026
bug good first issue code-quality
code-quality
Claude: [SECURITY] happy-dom 存在代码注入漏洞 (CVE-2026-33943, GHSA-6q6h-j7hj-3r64) 可导致 RCE
#2743 · Mar 27, 2026
bug security
Claude: [CODE] Container.ts 依赖注入容器中使用 as any 绕过类型检查降低类型安全性
#2742 · Mar 27, 2026
bug code-quality
Claude: [SECURITY] cspell 传递依赖 yaml 存在栈溢出漏洞 (CVE-2026-33532) 需升级至 2.8.3+
#2740 · Mar 27, 2026
bug security code-quality
code-quality
Claude: [CODE] NotificationService.destroy() 方法未移除事件总线监听器导致内存泄漏
#2734 · Mar 26, 2026
bug code-quality
Claude: [CODE] EndpointManager.cleanup() 方法中 MCP 事件监听器移除逻辑错误导致内存泄漏
#2732 · Mar 26, 2026
bug code-quality
Claude: [DOCS] connection-settings.tsx 缺少文件级 JSDoc 注释与其他业务组件文档风格不一致
#2729 · Mar 26, 2026
documentation
code-quality architecture
Claude: [ARCH] McpEndpointSettingButton 组件过大（625行）违反单一职责原则，建议拆分为多个子组件
#2726 · Mar 26, 2026
code-quality architecture
dependencies security
Claude: [CODE] 当前代码库大部分问题已被发现和记录，建议优先处理现有 200+ open issues
#2723 · Mar 26, 2026
code-quality
Claude: [CODE] service.handler.ts 中 setTimeout 回调使用可能失效的 Context.logger 导致错误日志丢失
#2720 · Mar 26, 2026
bug code-quality
code-quality
code-quality
Claude: [PERF] tts.service.ts 中使用 Array.shift() 操作队列导致 O(n) 性能开销
#2714 · Mar 25, 2026
code-quality performance
Claude: [PERF] asr.service.ts 中 createAudioStream 使用 Array.shift() 操作队列导致 O(n) 性能开销
#2713 · Mar 25, 2026
code-quality performance
Claude: [PERF] ESP32Connection 类的 close() 方法未移除 setupWebSocket 中添加的事件监听器导致内存泄漏
#2711 · Mar 25, 2026
bug good first issue performance
good first issue code-quality
Claude: [BUILD] CLI 包在 Nx 工作流中跳过类型检查隐藏了 3 个类型错误降低代码质量保障
#2706 · Mar 25, 2026
bug code-quality build
code-quality
Claude: [BUILD] CLI 包发布配置错误导致安装后无法使用
#2703 · Mar 25, 2026
bug code-quality build
Claude: [CODE] tts.handler.ts 缺少测试覆盖导致核心语音合成 API 功能未经测试验证
#2701 · Mar 25, 2026
bug code-quality
code-quality
Claude: [CODE] StatusStore 和 ConfigStore 的 reset() 方法未清理 WebSocket 事件监听器导致内存泄漏
#2697 · Mar 25, 2026
bug code-quality
code-quality
Claude: [CODE] timeout.ts 中 isTimeoutResponse 函数使用 any 类型而非 unknown 降低类型安全性
#2693 · Mar 24, 2026
code-quality
Claude: [CODE] ASR 类继承 EventEmitter 但 close() 方法未清理事件监听器导致潜在内存泄漏
#2691 · Mar 24, 2026
good first issue code-quality
Claude: [CODE] protocols.ts 中 getWriters 和 getReaders 函数存在重复的消息类型检查逻辑违反 DRY 原则
#2689 · Mar 24, 2026
code-quality
Claude: [PERF] toolsApi.ts 中 Promise.race 超时机制存在定时器泄漏导致内存浪费
#2686 · Mar 24, 2026
bug good first issue performance
Claude: [DOCS] add-mcp-server-button.tsx 缺少文件级 JSDoc 注释
#2685 · Mar 24, 2026
documentation code-quality
Claude: [ARCH] apps/backend/handlers/ 目录中 Handler 类继承模式不一致违反接口一致性原则
#2683 · Mar 24, 2026
code-quality architecture
Claude: [CODE] InternalMCPManagerAdapter 构造函数中添加的事件监听器未在 cleanup() 时移除导致内存泄漏
#2681 · Mar 24, 2026
bug good first issue code-quality
Claude: [ARCH] mcp-tool.handler.ts 文件过大（2743行）严重违反单一职责原则
#2679 · Mar 24, 2026
code-quality architecture
Claude: [DEPEND] TypeScript 5.9.3 升级到 6.0.2 是主版本升级包含多个破坏性变更
#2677 · Mar 23, 2026
dependencies code-quality
bug code-quality
Claude: [DOCS] apps/frontend/src/lib/schema-utils.ts 缺少文件级 JSDoc 注释
#2673 · Mar 23, 2026
documentation code-quality
Claude: [CODE] mcp-endpoint-setting-button.tsx 中遗留调试 console.log 语句违反项目日志规范
#2671 · Mar 23, 2026
code-quality
Claude: [BUILD] apps/backend/tsconfig.json 使用 composite 模式但缺少对 asr 和 tts 的项目引用
#2669 · Mar 23, 2026
code-quality build
Claude: [CODE] TTSController.ts 和 binary.ts 中音频数据合并逻辑存在 19 行重复代码违反 DRY 原则
#2667 · Mar 23, 2026
bug good first issue code-quality
Claude: [ARCH] ApiSuccessResponse 和 ApiErrorResponse 接口在两个位置定义且类型不一致
#2665 · Mar 23, 2026
code-quality architecture
Claude: [CODE] update.handler.ts 中 activeInstalls 状态管理功能不完整导致并发安装检查失效
#2663 · Mar 23, 2026
code-quality
Claude: [DOCS] packages/tts/src/index.ts 文件级 JSDoc 注释过于简单与 asr 包文档风格不一致
#2661 · Mar 23, 2026
documentation good first issue
Claude: [ARCH] mcp-manage.handler.ts 通过类型断言访问 MCPServiceManager 私有属性违反封装原则
#2659 · Mar 22, 2026
code-quality architecture
Claude: [CODE] buildByteDanceConfig 方法返回 any 类型而非已定义的 ByteDanceCompatConfig
#2657 · Mar 22, 2026
code-quality
Claude: [ARCH] packages/config/src/manager.ts 文件过大（2406行/257个方法）严重违反单一职责原则
#2655 · Mar 22, 2026
code-quality architecture
good first issue code-quality
Claude: [DOCS] packages/config/ 缺少 README.md 文件导致用户难以快速了解包的功能
#2652 · Mar 22, 2026
documentation good first issue
bug code-quality