{ "library": "vercel/next.js", "topic": "routing", "version": "15.1.0" } ``` **支持的库示例**： - `vercel/next.js` - Next.js 框架 - `facebook/react` - React 库 - `vuejs/vue` - Vue.js 框架 - `spring-projects/spring-framework` - Spring 框架 - `mybatis/mybatis-3` - MyBatis ORM **配置说明**： - API Key（可选）：在设置页面的「MCP 工具」标签页中配置 - 配置 API Key 后可获得更高的 API 调用速率限制

MCP工具配置界面 - Context7文档查询工具设置

### 🎨 icon (图标工坊) - 图标下载与管理 > **"以图会意，取用自如"** - **图标搜索**：按关键词检索 Iconfont 图标库 - **批量下载**：支持多选、批量保存 SVG/PNG - **路径可配**：默认保存路径可在设置中调整 **使用方式（MCP 工具）**： ```json { "query": "search keyword", "style": "line", "save_path": "assets/icons", "project_root": "C:/path/to/project" } ``` **说明**： - `style` 可选：line / fill / flat / all - `save_path` 为相对项目根目录路径 - 工具名称为 `tu`，界面显示为“图标工坊” ### 🧩 skill (技能运行时) - Skill MCP > **"万技归一，随用随载"** 技能运行时用于发现、加载并执行本地 skills。说明：内置 `ui-ux-pro-max` 已退出主流程，统一改由核心 MCP 工具 `uiux` 对外提供能力；`skill` 运行时继续保留给其他本地 skills 使用。原 `skills/ui-ux-pro-max` legacy 入口文件已移除，不再作为历史调用路径保留。 **技能发现目录（默认扫描）**： - 项目内：`.codex/skills`、`.claude/skills`、`.continue/skills`、`.opencode/skills`、`.trae/skills`、`.windsurf/skills`、`.cursor/skills`、`.gemini/skills`、`.roo/skills`、`.kiro/skills`、`.qoder/skills`、`.codebuddy/skills`、`.agent/skills`、`.shared/skills`、`skills/` - 用户全局：`~/.codex/skills` **运行时约束**： - 仅支持 Python 入口 - 默认使用系统 PATH，可通过配置 `skill_python_path` 指定 Python 路径 **当前 UI/UX 推荐使用方式**： ```json { "query": "beauty spa wellness service elegant", "action": "beautify", "project_root_path": "/path/to/project", "current_file_path": "/path/to/project/src/pages/home.vue", "append_project_context": true } ``` 技能入口仍由 `skill.config.json` 声明；内置 UI/UX 能力已不再通过 skill 入口暴露。 --- ## 📦 安装与使用 ### 环境要求 | 依赖 | 版本要求 | 说明 | |------|----------|------| | Rust | 1.70+ | 后端编译 | | Node.js | 18+ | 前端构建 | | pnpm | 8+ | 包管理器 | ### 🚀 快速开始 #### 方式一：下载预编译二进制文件

**📦 通用安装方式 - 支持所有平台**

如果您选择直接下载预编译的可执行文件，请按照以下步骤完成安装和环境配置。 #### 1️⃣ 下载并放置可执行文件从 [Releases 页面](https://github.com/yuaotian/sanshu/releases) 下载对应平台的压缩包，解压后将可执行文件放置到以下推荐目录： | 平台 | 推荐安装路径 | 说明 | |------|-------------|------| | **Windows** | `C:\Program Files\sanshu\` | 需要管理员权限 | | **Windows** | `%LOCALAPPDATA%\sanshu\` | 无需管理员权限（推荐） | | **Linux** | `~/.local/bin/` | 用户级安装（推荐） | | **Linux** | `/usr/local/bin/` | 系统级安装，需要 sudo | | **macOS** | `~/.local/bin/` | 用户级安装（推荐） | | **macOS** | `/usr/local/bin/` | 系统级安装，需要 sudo | #### 2️⃣ 配置环境变量将可执行文件所在目录添加到系统 PATH 环境变量中：

🪟 Windows 配置方法

**方法一：通过系统设置（图形界面）** 1. 按 `Win + R`，输入 `sysdm.cpl`，回车 2. 点击「高级」选项卡 → 「环境变量」 3. 在「用户变量」或「系统变量」中找到 `Path`，点击「编辑」 4. 点击「新建」，添加可执行文件所在目录（如 `C:\Program Files\sanshu\`） 5. 点击「确定」保存，**重启终端**使配置生效 **方法二：通过 PowerShell 命令** ```powershell # 添加到用户级 PATH（无需管理员权限） $userPath = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$userPath;C:\Program Files\sanshu\", "User") # 或添加到系统级 PATH（需要管理员权限） $machinePath = [Environment]::GetEnvironmentVariable("Path", "Machine") [Environment]::SetEnvironmentVariable("Path", "$machinePath;C:\Program Files\sanshu\", "Machine") ``` > ⚠️ 配置完成后需要**重启终端**或**重新登录**使配置生效。

🐧 Linux 配置方法

根据您使用的 Shell，编辑对应的配置文件： ```bash # Bash 用户（编辑 ~/.bashrc） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc # Zsh 用户（编辑 ~/.zshrc） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # 或编辑 ~/.profile（对所有 Shell 生效） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.profile source ~/.profile ```

🍎 macOS 配置方法

根据您使用的 Shell，编辑对应的配置文件： ```bash # Zsh 用户（macOS 默认 Shell，编辑 ~/.zshrc） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # Bash 用户（编辑 ~/.bash_profile） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile source ~/.bash_profile ```

#### 🍺 macOS 用户的备选方案：Homebrew 安装 macOS 用户也可以选择更便捷的 Homebrew 安装方式： ```bash # 1. 添加三术的 Tap 仓库 brew tap yuaotian/tap # 2. 安装三术 brew install sanshu # 3. 验证安装（可选） sanshu --version ``` **Homebrew 优势**： - 🤖 **自动更新**：新版本发布后使用 `brew upgrade sanshu` 即可更新 - 🔧 **依赖管理**：自动处理所有依赖，无需手动配置 PATH - 🛡️ **安全验证**：自动验证二进制文件的完整性 **常用操作**： ```bash # 更新三术到最新版本 brew upgrade sanshu # 查看已安装版本 brew info sanshu # 卸载三术 brew uninstall sanshu # 移除 Tap 仓库 brew untap yuaotian/tap ``` > **💡 提示**：Homebrew 安装无需手动配置环境变量，安装完成后即可直接使用 `sanshu` 命令。 #### 3️⃣ 验证安装打开**新的终端窗口**，运行以下命令验证配置是否成功： ```bash # 使用中文命令名三术 --version # 或使用拼音命令名 sanshu --version ``` 如果正确显示版本号（如 `sanshu 0.2.x`），说明环境变量配置成功。 #### ⚠️ 重要说明 > **环境变量配置是 MCP 客户端正常工作的前提条件。** > > - ✅ **已配置环境变量**：MCP 配置中可直接使用 `"command": "三术"` 或 `"command": "sanshu"` > - ❌ **未配置环境变量**：需要在 MCP 配置中使用**完整路径**，例如： > ```json > { > "mcpServers": { > "sanshu": { > "command": "C:\\Program Files\\sanshu\\三术.exe" > } > } > } > ```

sanshu

Installation