想要搭建属于自己的 NAS 音乐服务器，第一步往往就让人头疼——音乐资源从哪里来？即使开通了 QQ 音乐、网易云等会员，下载歌曲仍有每月数量上限，或者下载到的文件是加密格式，难以自由管理。如果你也卡在这一关，那么本期介绍的 GoMusicDL 很可能成为你的完美解法。它支持 Docker Web 部署、桌面应用、TUI 终端三种模式，定位远不止是“资源获取工具”，简单配置后，还可以直接当作一个轻量级 Web 播放器使用。

桌面应用目前覆盖 Windows (x64/x86/arm64)、macOS (x64/arm64)、Linux (x64)，大家可以直接前往项目发布页面获取对应版本。

项目概述

完整项目名称为 guohuiyuan/go-music-dl，可以在 GitHub 上直接搜索。GoMusicDL 是一款集搜索与下载于一体的音乐工具，同时提供 Web 界面、TUI 终端和桌面应用三种使用形态。除了常规的单曲搜索与下载外，它还支持歌单解析、专辑解析、整单/整专曲目查看与批量处理。你可以通过浏览器在线试听，也能在终端里批量下载，或者直接启动原生桌面应用，获取最佳体验。

核心亮点

• · 三种使用形态：不止于命令行，支持 Web、TUI 和桌面应用，按需选择。
• · 不止单曲：支持单曲、歌单、专辑的搜索、解析和批量下载，且下载文件已内嵌元数据。
• · 多平台聚合：聚合多平台搜索能力，支持试听、歌词、封面以及灵活换源。
• · Web 端功能齐全：包含本地收藏夹、自建歌单、批量下载/换源、全局播放栏，完全可以当作日常播放器使用。

Docker 部署指南（以威联通 NAS 为例）

这里以威联通 NAS 环境为例，采用 Docker Compose 的方式进行部署，操作简单且易于维护。

部署参考代码：

services:  
  music-dl:  
    image: guohuiyuan/go-music-dl:latest  
    container_name: music-dl  
    restart: always  
    user: "0:0"  
    ports:  
      - "9981:8080" # 左侧端口可按需修改  
    volumes:  
      - /share/Container/musicdl/data:/home/appuser/data # 配置目录，左侧映射路径可自行调整  
      - /share/Music:/app/downloads # 音乐存储目录，左侧路径可自行调整  
    environment:  
      - TZ=Asia/Shanghai  
    command: [ "./music-dl", "web", "--port", "8080", "--no-browser" ]

在威联通的 Container Station 中，直接创建新的应用程序并粘贴以上配置即可。

临近五一假期，为你推荐一款能独自解闷、也可与亲友同乐的趣味项目——AI狼人杀。每个角色背后都由不同的大语言模型驱动，拥有专属的性格和策略，能够根据场上局势推理、发言、投票，甚至编织谎言，让每一局都充满戏剧性。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀1.webp)

项目简介

完整项目名为onebai123/wolfcha-web，可在GitHub上搜索获取。

该项目是Wolfcha（猹杀）的二开版本，基于oil-oil/wolfcha改造而来，是一套纯前端实现的AI狼人杀游戏。它支持自定义API端点，仅需一个网页，所有人都能直接参与。

你将作为全场唯一的人类玩家，与其他9名AI角色共同经历一局完整的狼人杀。不同的AI不仅性格各异，其背后的博弈策略也千姿百态：它们会依据当前局势展开推理、发表言论、互投选票，甚至故意说谎。

作者在项目页面透露，未来会推出v2.0版本的无后台联机模式，基于Redis或对象存储实现房间同步，让多人远程对战成为可能，且依旧无须自建后端服务器。

产品亮点

• 🌐 纯前端运行：不依赖后端，一个网页即开即用
• 💾 本地存储：API Key仅保存在你的浏览器中，保障数据安全
• 🎮 零门槛开玩：无需注册账号，打开页面直接开始对局
• ✅ 灵活接入API：支持DeepSeek、硅基流动、OpenAI等任意兼容接口
• 📱 多设备适配：电脑、平板、手机均可流畅游玩
• 🔏 隐私至上：所有数据只存放在你本地的浏览器内

部署方式

以威联通NAS为例，使用Docker Compose来快速部署。由于原项目未提供现成镜像，我已自行构建并发布到了Docker Hub。

你可以使用下面的配置进行部署：

services:  
  wolfcha-web:  
    image: ydxian/wolfcha-web:v1  
    container_name: wolfcha-web  
    ports:  
      - "7860:7860"  
    restart: always

进入威联通的Container Station，创建一个新的应用程序，将上述内容粘贴保存即可。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀2.webp)

游戏初体验

部署完成后，在浏览器访问NAS_IP:7860，就能见到极具仪式感的主页：“签署名字后才可生效”。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀3.webp)

点击右上角的「设置」，你可以调整难度、玩家人数以及声音效果等参数。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀4.webp)

不同人数配置下的角色组成也各不相同，策略空间随之变化。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀5.webp)

以硅基流动为例，在设置页面填入你的API Key与模型名称，保存即可。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀6.webp)

保存后刷新页面，轻触指纹处的签名区域，游戏便正式开始。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀7.webp)

接着会进入等待其他“玩家”入场的环节。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀8.webp)

看，我抽到了女巫！

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀9.webp)

游戏还贴心地为新手准备了一些引导提示。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀10.webp)

即使使用的是免费的公开API，响应速度也丝毫不拖沓，节奏紧凑。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀11.webp) https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀12.webp)

另一个有趣的细节是，每位参与者的性格标签和背后调用的AI大模型都不完全相同，这极大增强了对局的多样性和娱乐性。

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀13.webp)

https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀14.webp)

结语

如果你也对这款纯前端的AI狼人杀感兴趣，不妨先部署体验起来，同时期待作者早日带来支持多人联机的v2.0版本。

你是否曾为无法永久保存喜爱的短视频而遗憾？是否希望离线学习在线课程，彻底摆脱网络依赖？是否想高效收集优质文档和媒体资源，却苦于工具繁杂？这些看似分散的需求，在OmniGet的帮助下都能一站式解决。

OmniGet是一款免费开源的桌面下载工具，以“全能兼容、轻量高效、纯净无广告”为核心理念，将多种资源获取能力聚合在一个简洁的界面里。它在GitHub上已收获超过2000颗星，受到众多开发者的认可。

与传统下载工具相比，OmniGet体积小巧、启动飞快，兼容arm等多种架构，电脑与平板都能轻松适配。代码完全公开，没有任何弹窗广告或捆绑软件，依靠社区力量持续迭代，即使低配机器也能流畅运行，同时支持Windows、macOS、Linux三大系统。

它原生支持50多个主流平台，并通过整合yt-dlp工具，将可解析的网站扩展到1000多个。无论是短视频、长视频、图片、音频还是文档，只需复制链接并粘贴到OmniGet中，软件就会自动识别可留存的资源，真正做到一键下载。

功能细节不再赘述，下面直接看安装步骤。首先前往GitHub获取安装包，项目地址如下：

https://github.com/tonhowtf/omniget

下载页面提供了多个系统版本，请根据你的操作系统选择对应文件。

下载完成后运行安装程序，按照向导设置语言、界面主题以及下载保存路径等偏好。

安装过程中会提示必须安装yt-dlp和FFmpeg两个组件。你可以尝试点击“全部安装”自动部署，若自动安装失败则需要手动配置。

先看yt-dlp的手动安装。从GitHub下载其程序，链接在此：

https://github.com/yt-dlp/yt-dlp

把下载好的文件放到你打算安装的目录，然后在文件夹空白处右键选择“在终端打开”。

在打开的终端窗口中输入 winget install yt-dlp 并回车（可直接复制命令），系统会自动下载并安装，耐心等待进度条走完。

当界面停止滚动且不再显示蓝色的下载进度条时，表示安装完毕，可以关闭终端窗口。

FFmpeg的安装流程类似，下载安装包地址为：

https://evermeet.cx/ffmpeg/

网上也有详细教程，遇到困难可以自行搜索。yt-dlp和FFmpeg既可以提前装好，也可以在OmniGet安装过程中跳过，稍后补装。注意首次运行OmniGet时可以选择需要启用的功能模块，建议全部勾选；如果跳过了，之后也能随时在插件市场安装。

进入主界面后，你可以在输入框中粘贴链接或直接搜索资源。

点击左侧的“插件市场”可以随时安装或卸载所需要的插件，灵活扩展功能。

在设置页中，你可以自由切换主题颜色、修改下载保存路径、选择视频质量，还可以启用字幕下载。软件还支持按平台整理文件，自动生成独立文件夹，让资源管理井井有条。

在“设置→工具”中，可以检查yt-dlp和FFmpeg是否成功安装。成功则会显示版本号，右侧按钮为“更新”；未安装则显示“安装”。其余参数保持默认即可。

OmniGet还能借助FFmpeg实现视频格式转换，转换速度依赖本地显卡性能，显卡越好速度越快。

软件还内置了一些课程下载平台的支持，不过这些平台通常需要配置代理并登录才能正常下载，否则会显示连接失败，有需要的话可以自行设置。

总的来说，OmniGet作为一款下载工具，功能强大人性化，完全没有广告弹窗，也无需登录或付费，相比许多同类付费产品，体验堪称“碾压级”存在。

🔥 GitHub、数据库、Slack、浏览器……想象一下，一个 AI 工具就能把这些全部串起来。

从 10 个必装 MCP 服务器到按代理角色精细化权限控制，再到自定义开发入门——本文带你把 OpenCode 从“能写代码”升级成“能操控一切”。

📌 MCP 核心理念与架构解析

一句话说明

MCP（Model Context Protocol） 是一套开放协议，让 AI 编程代理可以对接外部工具和数据源。如果把 OpenCode 比作大脑，那么 MCP 就是它的手和眼睛——不仅能读写代码，还让它有能力查数据库、管 Issue、搜文档、操作云服务。

OpenCode 能力体系

内置工具层14 个基础工具

MCP 扩展层无限外部工具

文件读写 / Bash / 搜索

Sentry 错误追踪

Context7 文档查询

数据库操作

GitHub / Jira 集成

Slack 通知

自定义 API

MCP 在架构中的位置

回顾 OpenCode 的三层架构：

你的指令 → 代理层（怎么思考） → 工具层（能做什么） → 代码库  
                                   ↑  
                              MCP 扩展层（能连什么）

• 内置工具：文件读写、Bash 执行、代码搜索等 14 个工具，开箱即用
• MCP 工具：连接外部世界的桥梁，按需安装，扩展性几乎没有上限

一旦添加 MCP，其工具会自动与内置工具一起提供给 LLM 调用，无需额外配置。

🔥 同样的代码，有人烧钱请人写，有人零成本轻松搞定——关键全在模型配置。

不绑定任何一家 AI 厂商——OpenCode 让你像换手机壳一样切换大模型。从零成本的免费模型，到最强的 GPT 5.4 Pro，完全由你说了算。

OpenCode 模型架构的核心概念

为什么模型选择至关重要？

AI 编程工具的灵魂是大模型。模型直接决定：

• 代码质量：产出的代码能不能拿来即用
• 理解能力：能否读懂整个项目的上下文
• 响应速度：要等多久才能拿到答案
• 使用成本：每月需要花多少钱

现实问题：绝大多数 AI 编程工具只能使用自家模型。Cursor 仅限自家模型，Copilot 仅限 OpenAI，Claude Code 仅限 Claude。

OpenCode 打破了这道围墙——75+ 家模型提供商，选择权在你手中。

三层模型架构

OpenCode 的模型体系分成三层：云端模型、本地模型、OpenCode Zen 精选网关。

OpenCode 模型体系

云端模型

本地模型

OpenCode Zen精选网关

国际大厂OpenAI / Anthropic / Google

国内厂商智谱GLM / 通义Qwen / Kimi

聚合平台OpenRouter / Together AI

垂直平台Groq / Cerebras / xAI

Ollama

llama.cpp

LM Studio

免费模型Big Pickle / GPT 5 Nano

一条 /init 命令，AI 就能完整掌握你的项目语境。这并非魔法，而是靠 AGENTS.md 体系实现。

通用 AI 不知道你们团队的工作约定、代码风格、目录结构——AGENTS.md 就是你为 AI 编写的「项目操作手册」，Skills 则是提供「专项技能包」。两者结合，把 OpenCode 从「通用助手」升级为「项目专家」。

核心思路：为什么必须使用 AGENTS.md

通用 AI 的真正短板

想象你刚招募了一位技术很强但对项目零了解的开发者。他产出的代码功能也许没问题，但大概率会出现：

• 变量命名风格随意，与 camelCase / snake_case 不符
• 无视 packages/core/ 是共享逻辑区的约束
• 部署前忘记执行 pnpm lint
• Git 提交信息与团队规范冲突

OpenCode 同样面临这个问题。 默认状态下它只是能力出众的 AI 编程助手——技术扎实，却对你的项目上下文一无所知。

AGENTS.md 就是项目的「上下文说明书」

AGENTS.md 是面向整个项目的 AI 配置文件，可以这样类比：

.editorconfig  →  指导编辑器如何格式化代码  
.gitignore     →  告知 Git 忽略哪些文件  
AGENTS.md      →  让 AI 懂得项目的运行规则

类比：.editorconfig 供编辑器阅读，AGENTS.md 供 AI 理解。两者均为项目级配置，理应纳入 Git 版本控制。

AGENTS.md 如何改变 AI 的行为

OpenCode 启动时，会把 AGENTS.md 的内容作为系统提示（System Prompt）的一部分注入每次对话。也就是说，无论你给 AI 分配何种任务，它都会自动遵循这里面定义的各项规则。

🔥 你有没有想过，AI 除了聊天，还能像一支真正的开发团队那样读代码、写代码、执行测试、甚至完成部署上线？

7 大智能代理 × 14 个内置工具——OpenCode 不只是一个“会写代码的聊天机器人”，它更像一个可以自主思考、分工协作、精准操控的 AI 开发团队。

📌 核心概念：两层能力架构

在上一篇文章《75+ 模型随心选——模型配置全攻略》中，我们完成了模型的挑选。但模型只是“大脑”，OpenCode 真正的能力来自它的指挥体系——代理（Agent） 和 工具（Tool）。

为什么需要代理和工具？

设想一个场景：你对 AI 说“重构整个用户认证模块”。如果只有一个通用 AI，它必须同时理解需求、规划步骤、读写文件、运行测试……什么都要做，什么都有可能搞砸。

OpenCode 的思路完全不同：让专业的代理去做专业的事，就像一个组织有序的开发团队：

你的自然语言指令

代理层 思考 · 规划 · 分工

工具层 读 · 写 · 执行 · 搜索

你的代码库 文件 / 命令 / 搜索

• 代理（Agent）：决定“怎么思考”——分析、规划、分工、协作
• 工具（Tool）：决定“能做什么”——读写文件、执行命令、搜索代码

💡 说明：OpenCode 还支持通过 MCP 连接外部工具链（数据库、API、云服务），这是第三层扩展能力。关于 MCP 的内容将安排在本系列第 4 篇《MCP 深度实战——连接开发工具链》中单独讲解，本文聚焦在代理与内置工具本身。

🤖 智能代理系统

7 大内置代理全景

OpenCode 内置了 7 个专用代理，按照职责可以分为三层：

子代理（@ 调用）

核心亮点

OpenDataLoader PDF 是一款由韩国 Hancom 公司开源的 PDF 解析引擎，专为 AI 数据流水线和 PDF 无障碍合规场景设计。在公开基准测试中，它以 0.907 的综合准确率位列第一，既支持完全确定性的本地模式，也能在 AI 混合模式下自动调度复杂页面，无需 GPU 即可 100% 本地运行。

20.7k

GitHub 星标

0.907

综合准确率

Apache 2.0

开源协议

项目简介：它能做什么

做 AI 应用时，你一定遇到过这些棘手问题：PDF 中的表格被拆成乱序文本、多栏排版读出来顺序错误、扫描件里的文字完全丢失。市面上的工具要么太慢，要么太贵，要么精度太差。

OpenDataLoader PDF 要解决的正是这些问题：把 PDF “看懂”并转成机器可用的结构化格式。它不仅能提取文字，更理解文档的内在结构——知道哪里是标题、何处是表格、图片放在什么位置、正常的阅读顺序是怎样的。输出可以是干净的 Markdown、带有坐标信息的 JSON，或者可直接嵌入网页的 HTML。

面向的核心用户包括：AI 应用开发者（构建 RAG 知识库时需从 PDF 中提取结构化信息）、企业合规团队（应对欧盟 EAA 对 PDF 无障碍化的要求）、数据工程师（批量处理文档）。如果你只是普通用户，想在网页上使用 AI 阅读 PDF，这个项目可能并非刚需。

项目背景与社区反馈

该项目由拥有 35 年文档处理技术沉淀的韩国老牌软件公司 Hancom 开发并开源。Hancom 在韩国的地位可类比为“金山办公”。截至 2026 年 5 月，GitHub 已收获 20,686 颗星，fork 数达 1,914，是目前增长最快的 PDF 开源项目之一。

今年以来，AI视频工具持续爆发。从年初字节跳动发布 Seedance 2.0，到可灵生成的 AI 短片《纸手机》火遍全网，再到阿里 HappyHorse 登上 Artificial Analysis 视频竞技场榜首。随后，内容创作者蜂拥而至，AI真人视频、AI漫剧、AI演唱会等内容频频刷屏，热度居高不下。

尽管内容创作的风口正盛，但真正动手做 AI 视频时才会发现，最让人崩溃的不是操作工具本身，而是在写脚本、调提示词、反复抽卡之间来回拉扯。我身边有位做 AI 短剧的朋友，拍到第三集时发现角色脸型开始飘移，和前两集已经不再是同一个人了，只能全部推倒重来，相当于白忙一天。

这并非个例，而是众多 AI 视频工具的共性缺陷——生成过程像黑盒，你看不见过程，更无法修改，只能一遍遍重新抽取。不过，最近体验了 RHTV 后，我眼前一亮：原来做 AI 视频可以不用苦苦编写提示词，也不必反复抽卡。

先看一个 RHTV 的优秀案例：

（视频来自Joe183，同时借这个视频提前祝所有妈妈们母亲节快乐！）

就让我们一起来看一看，这个AI工具到底有没有这么大的魔力。

RHTV是什么？

经常接触 AI 生图和视频的伙伴，大多听过或者用过 RunningHub——它是中国最大的 ComfyUI 平台。而 RHTV 正是由 RunningHub 出品的原生 AI 智能体全能内容创作平台。

通俗地说：你可以在同一张画布里完成文本创作→角色生成→场景搭建→分镜设计→视频生成→音频合成→剪辑输出的完整流程，再也不用在多个 AI 工具之间来回切换。

所有步骤清晰摆放在眼前，每一步做了什么，你都能看到；每一个环节都可以单独点进去修改。哪一帧不满意，直接改那一帧就好，其他部分原封不动。

或许有伙伴看到图示会觉得操作复杂，其实完全不用担心。你只需要说出想法，它就会帮你拆解流程：角色定稿、场景搭建、分镜规划、视频生成，全部由它推进，而你只需在每一步确认即可。

RHTV 实战：制作一条运动品牌短片

在 RHTV 中制作视频，同样可以一句话生成，就像其他 AI 视频工具那样。

比如，我想要做一条运动服装品牌推广短片，只给了它一句话的需求：

“都市街头风格，主角是穿运动服的年轻女生，展示跑步和跳绳的日常，要有节奏感，适合抖音发布。”

一般的 AI 工具会直接闷头生成视频，不满意的话就要反复抽卡，非常折腾。而 RHTV 的智能体会先自动思考，然后给出方案选项并让我确认一些信息。

确认方案后，画布会同步创建视频节点，并自动填好提示词和各项参数。我们只需核对一眼，点击确认执行，它就会立刻生成对应的素材。

接下来，它会让我们依次确认剧本、分镜、提示词等。

上下滑动查看更多

对所有信息逐一确认之后，RHTV 就能直接交付最终结果。

以 Superpowers 七阶段工作流为纲，借助 Claude Code 和 GLM 5.1 全程驱动，手把手构建一个可直接投产的 FastAPI + SQLAlchemy + Redis RESTful API 服务。

核心概念速览

这是什么？

这是一篇动手操作实录。我打开 Claude Code，使用 GLM 5.1 作为 Coding Plan 供应方，严格遵循 Superpowers 工作流，从空白项目开始，搭建一套完整的 Python FastAPI Server 脚手架。

最终交付物：一个提供用户注册、登录鉴权及受保护端点的 RESTful API 服务，可以直接作为任何 Python 后端项目的初始骨架。

为什么选择 Python？

2025–2026 年，Python 在 API 服务领域的采用率持续走高。FastAPI 的出现彻底扭转了“Python 不适合高性能 API”的旧印象：

• 异步原生：基于 Starlette 与 Pydantic，天生支持 async/await
• 自动文档：OpenAPI + Swagger UI 开箱即用，前端协作几乎零开销
• 类型安全：Pydantic v2 完成请求验证与序列化，运行时的类型检查能力甚至超过 Go 的 struct tag
• 生态无敌：覆盖 ML/AI、数据处理、自动运维，一站式解决能力无出其右

能解决哪些痛点？

• 想用 FastAPI 启动后端项目但缺乏完整参考实现
• 看过 FastAPI 官网教程，却不清楚生产级项目如何组织
• 需要一套可复用的 Python API 脚手架作为新项目的起点
• 想在 Go、Spring Boot、Rust、Python 这四种语言的脚手架间做横向对比

ClaudeCode 编码执行