# rhapsody-tools

**Repository Path**: coding_niann/rhapsody-tools

## Basic Information

- **Project Name**: rhapsody-tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rhapsody AI 工具包部署文档（精简版 / lite）

> 打包日期：2026-08-24 | 适用：任何安装了 WorkBuddy（或兼容 skills 机制）的机器

## 一、包内容

```
rhapsody-tools/
├── README.md               ← 总说明
├── install.ps1             ← Windows 一键安装（需 UTF-8 BOM，PS 5.1 可跑）
├── install.sh              ← macOS / Linux 一键安装
├── docs/
│   ├── md/                 ← 810 篇官方文档的 Markdown 版（约 2.5MB，含表格/代码块）
│   ├── attachments/133161134/133161135.xml  ← 通信点配置 XStream 范本（必留）
│   ├── xstream-template.xml ← 配置骨架模板
│   └── 部署文档.md          ← 本文档
├── skills/                 ← 5 个 skill 本体（含 rhapsody-cli）
│   ├── rhapsody-doc/          识别 Rhapsody 离线文档并回答架构/组件/配置问题
│   ├── rhapsody-create-interface/  中文说需求→建通信点 闭环
│   ├── rhapsody-vibe-coding/     vibe coding 操作 Rhapsody 引擎
│   └── ihe-toolkit-doc/         IHE 规范（XDS.b/XDR/PIX/PDQ/ATNA）速查
└── mcp/                    ← rhapsody-engine MCP（FastMCP stdio server + 配置样例）
```

**skills 与 `docs/md/` 是配套的**：skill 的索引全部按 `md/xxx.md` 相对路径引用文档库，两者必须一起部署。

## 二、部署步骤（目标机器）

### 步骤 1：解压
把 zip 解压到一个**固定目录**（之后不要再挪动），例如：

```
Windows：D:\Rhapsody\rhapsody-tools\
```

### 步骤 2：运行安装脚本
脚本会：占位符替换为真实路径、把 skills 复制到用户级 skills 目录、写入 MCP 配置。

```powershell
# Windows（PowerShell 5.1，已带 UTF-8 BOM）
powershell -ExecutionPolicy Bypass -File .\install.ps1 [-BaseUrl <引擎地址>] [-Username <用户>] [-Password <密码>] [-SkipDocs]
```

```bash
# macOS / Linux
./install.sh
```

- `-SkipDocs`：若 md/ 已单独部署、只需装 skills+mcp 时使用。
- 引擎地址/账号用于 MCP 配置；留空则仅装文档与 skill，MCP 稍后手动填。

### 步骤 3：登记文档路径（关键！）
若手动安装或脚本未覆盖，打开：

```
C:\Users\<你的用户名>\.workbuddy\skills\rhapsody-doc\SKILL.md
```

找到带 📍 的「文档根目录」行，把示例路径改成你本机实际解压路径，例如：

```
📍 文档根目录：D:\Rhapsody\rhapsody-tools\
```

**不改这一行，AI 读不到 md/ 文档库**（skill 内所有 `md/xxx.md` 都以此为基准）。

### 步骤 4：信任 MCP（如启用）
重启客户端后，在连接器管理页面对 `rhapsody-engine` 点「信任」。

### 步骤 5：验证
新开一个会话，问：

> Rhapsody 的 TCP 通信点怎么配？

如果 AI 的回答里引用了类似 `md/TCP-Client-and-Server_133162494.md` 的文件，说明部署成功、文档库打通。

## 三、使用方式

| 方式 | 说明 |
|---|---|
| 自动触发 | 直接问 Rhapsody 相关问题（怎么配/报错/概念），`rhapsody-doc` 自动生效 |
| 手动指定 | 对 AI 说「用 rhapsody-doc skill 查一下 XX」 |
| 查询链路 | AI 先查 `skills/*/references/` 速查库 → 不够再按索引读 `docs/md/` 原文 |
| 改配置 | 用 `rhapsody-create-interface` / `rhapsody-vibe-coding` 描述需求，经 MCP 操作引擎 |

## 四、常见问题

**Q1：在多台机器部署？**
每台机器重复「步骤 1-3」即可；md 库可放共享盘，但 `SKILL.md` 里的文档根目录每台机器要各自登记。