# 溪云谱韵

**Repository Path**: BambooScript-Dialogues/Stream-Cloud-Rhymer

## Basic Information

- **Project Name**: 溪云谱韵
- **Description**: 云生溪涧，韵起毫端
「溪云谱韵」以 ACE-Step 音乐制作大模型为弦索，在数字山水间拨响古今共振的音律诗篇。这方融合 AI 智慧与东方美学的创作场域，将诗词中的烟霞云影、竹露松风化作灵动音符 —— 输入 “疏影横斜水清浅”，可闻古琴泛音与合成器织就的寒梅冷月；描绘 “金戈铁马，气吞万里如虎”，即得管弦齐鸣中角声催战的磅礴交响。
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-06-09
- **Last Updated**: 2025-06-10

## Categories & Tags

**Categories**: ai

**Tags**: None

## README

# 溪云谱韵

## 项目简介

「溪云谱韵」是一款部署于**Gitee 模力方舟平台**的开源音乐创作工具，深度融合 AI 智慧与东方美学理念，凭借先进的音乐生成算法，打破文字与音乐的壁垒。用户仅需输入诗词、场景描述或情感文字，它便能将其中意境转化为灵动音符，实现古典与现代音律在数字世界的完美交融。

![效果展示](效果展示.png)

## 快速开始

### 环境要求


*   **Node.js**：必须安装 `v20.14.0` 或更高版本。推荐通过[官方](https://nodejs.org/dist/v20.14.0/node-v20.14.0-win-x64.msi)[网站](https://nodejs.org/dist/v20.14.0/node-v20.14.0-win-x64.msi)下载对应系统的安装包进行安装。安装完成后，可在命令行输入 `node -v` 和 `npm -v` 检查是否安装成功，若显示对应版本号，则安装无误。

*   **操作系统**：目前优先支持 Windows 系统，后续将逐步适配 macOS 与 Linux 系统。

### 操作步骤


1.  **启动程序**

*   **双击启动**：在项目根目录下找到 `start.bat` 文件，双击运行。此时会弹出命令行窗口，显示服务端启动信息，等待窗口中出现类似 “Server running on port 3000” 的提示，表示服务端启动成功。随后浏览器会自动打开前端界面，若未自动打开，可手动访问 `http://localhost:3000` 进入。


*   **命令行启动**：若双击启动失败，可通过以下步骤手动启动：

    *   按下 `Win + R` 组合键，输入 `cmd` 打开命令提示符。

    *   使用 `cd` 命令切换到项目根目录（例如，若项目在 D 盘的 “溪云谱韵” 文件夹，可输入 `cd D:\溪云谱韵`）。

    *   输入 `node server.js` 并回车，等待服务启动成功提示。

*   **常见问题**：若启动时提示 “端口被占用”，可通过任务管理器关闭占用端口的进程，或修改 `server.js` 中的端口号（将 `const port = 3001;` 改为其他未被占用的端口，如 `const port = 3002;`）。

1.  **配置 API 密钥**

*   **找到设置入口**：进入前端界面后，点击右上角的齿轮图标（设置按钮），会弹出设置窗口。


*   **填写 API-KEY**：在 “API-KEY” 输入框中填写您从 AI 服务提供商获取的有效密钥（如 OpenAI、阿里云等）。不同服务提供商获取密钥的方式不同，例如 OpenAI 需登录官网创建 API 密钥并复制粘贴到此。


*   **保存配置**：填写完成后，点击 “保存” 按钮，系统会自动验证密钥有效性。若提示 “验证失败”，请检查密钥是否正确或是否已过期。


1.  **开始音乐合成**

*   **输入文本**：在主界面的输入框中，输入您想要转化为音乐的诗词、场景描述或自定义文本（如 “落霞与孤鹜齐飞，秋水共长天一色”）。


*   **选择音乐风格**：点击 “音乐风格” 下拉菜单，目前支持 “古典雅韵（古琴 + 箫）”“现代电子”“交响乐融合” 等风格。后续版本将不断丰富风格库，例如新增 “民族风情（二胡 + 鼓）”“治愈钢琴曲” 等。


*   **生成与下载**：点击 “生成” 按钮，界面会显示进度条，等待 AI 解析文本并生成音乐。生成完成后，点击 “下载” 按钮，音乐将以 MP3 格式保存到本地。您还可以点击 “播放” 按钮，直接在界面上试听生成的音乐。

## 功能特性

| 功能模块
 | 说明
                                                    | 示例
                                         |
| --------- | ---------------------------------------------------------- | ----------------------------------------------- |
| **文本转音乐** | 基于先进算法，对输入文本进行语义分析，提取情感、意境等元素，转化为旋律、和弦、节奏与音效。
         | 输入 “怒发冲冠，凭栏处、潇潇雨歇”，生成激昂的鼓点与弦乐交织的旋律，展现壮志豪情。
 |
| **多风格融合** | 支持将古典乐器（如古琴、琵琶、古筝）与现代电子音色（合成器、电鼓）自由组合，满足多样化创作需求。
      | 用户可将悠扬的古琴音色与动感的电子节奏结合，创作出别具一格的古风电子音乐。
      |
| **可视化界面** | 采用简洁直观的交互设计，提供实时进度预览，用户可对生成的音乐进行基础参数微调，如节奏快慢、音色强度等。
   | 在生成音乐后，通过滑动条调整节奏速度，将舒缓的音乐变得轻快活泼。
           |
| **开源协议**  | 采用**木兰宽松许可证 v2（Mulan PSL v2）**，允许个人与企业自由使用、修改和分发项目代码。
 | 开发者可基于本项目代码开发商业音乐创作工具，但需遵守许可证相关条款。
         |
---

## 许可证声明



本项目严格遵循 **木兰宽松许可证 v2（Mulan PSL v2）** 进行授权，详细条款如下：

1.  **版权许可**：任何人都被允许永久、免费地使用项目中的贡献代码，但在使用过程中，必须完整保留原作者的版权声明，以尊重创作者的知识产权。


2.  **专利许可**：当涉及专利相关事宜时，此许可仅适用于原始贡献代码。如果对代码进行了修改，在使用修改后的代码时，需重新确认相应的专利授权，确保合法合规。


3.  **分发限制**：在分发项目代码或基于项目开发的衍生作品时，必须包含完整的许可证文件（`LICENSE`），并保留其中的免责声明等关键内容，不得擅自删除或篡改。


4.  **免责条款**：项目本身不提供任何形式的明示或默示担保，原作者及贡献者对于因使用本项目而产生的任何直接或间接后果，均不承担法律责任。


完整的许可证文本可在项目根目录的 `LICENSE` 文件中查看，也可访问 [http://license.coscl.org.cn/MulanPSL2](http://license.coscl.org.cn/MulanPSL2) 在线阅读。


## 贡献与反馈

*   **代码贡献**：我们热烈欢迎广大开发者提交 PR，共同优化项目功能。在提交之前，请务必遵循项目的代码规范，包括代码风格、注释要求等，并为新增功能添加相应的单元测试，以确保代码质量与稳定性。


*   **问题反馈**：如果在使用过程中遇到任何 BUG，或对项目有新的功能建议，欢迎通过 [Gitee 仓库 Issues](https://gitee.com/BambooScript-Dialogues/Stream-Cloud-Rhymer/issues) 进行提交。提交时请尽可能详细地描述问题现象、复现步骤及相关截图，以便我们快速定位并解决问题。


*   **联系方式**：若有任何疑问或合作意向，可通过微信 19112913292 与我们取得联系


## 未来规划

*   **自定义乐器库**：开发用户自定义功能，允许用户上传个人的音色包，自由组合乐器，进一步拓展音乐创作的自由度与个性化空间。


*   **移动端适配**：计划开发 H5 版本，并适配手机与平板设备，实现随时随地的音乐灵感捕捉与创作，提升用户创作的便捷性。


*   **社区创作生态**：搭建用户社区平台，支持作品分享、交流与合作，形成一个充满活力的音乐创作生态系统，激发更多创意灵感。


## 鸣谢

衷心感谢**Gitee 模力方舟平台**为「溪云谱韵」项目提供的技术支持与资源保障，让开源音乐创作得以高效落地。同时，向所有致力于古典诗词与现代音乐跨界融合的创作者致敬，项目的灵感源泉正是来自于《诗经》的悠远意境与现代电子音乐的创新实验。


**项目地址**：[https://gitee.com/BambooScript-Dialogues/Stream-Cloud-Rhymer](https://gitee.com/BambooScript-Dialogues/Stream-Cloud-Rhymer)**更新时间**：2025 年 6 月 9 日**当前版本**：v1.0.0（Beta）