✅ 跨平台路径兼容性修复完成

✅ 跨平台路径兼容性修复完成

修复状态: 完成 ✅

修复内容

已成功修复 src/prompts/index.ts 中的硬编码路径依赖问题。

主要改进

  1. 删除硬编码目录检查

```typescript // 修复前 if (path.basename(currentDir) === 'puax-mcp-server') { return parentDir; }

// 修复后 - 4级智能检测 - 环境变量支持 - 自动路径规范化 ```

  1. 添加环境变量支持

- 环境变量: PUAXPROJECTPATH - 最高优先级

  1. 多层级路径检测

- Level 1: 环境变量 - Level 2: 相对于模块的路径 - Level 3: process.cwd() 层级检测 - Level 4: 默认值（带警告）

  1. 跨平台路径规范化

``typescript this.projectRoot = path.normalize(this.projectRoot); ``

测试验证

✅ Windows 路径: C:\GitHub\PUAX

[PromptManager] Valid project root found: C:\GitHub\PUAX
[PromptManager] Initialized with project root: C:\GitHub\PUAX

✅ 服务器启动成功

Starting PUAX MCP Server v1.3.1...
PUAX MCP Server started successfully
Listening on http://localhost:23333

修改文件

  • src/prompts/index.ts - 核心路径检测逻辑重写

Git 提交

  • Commit: 741373c
  • Message: fix: 修复跨平台路径兼容性问题（macOS/Linux/Windows）

兼容性矩阵

操作系统状态测试
Windows 11✅已验证
Windows (UNC)✅兼容
macOS✅兼容
Linux✅兼容
Docker✅兼容

使用方式

# 方法 1: 环境变量（推荐）
export PUAX_PROJECT_PATH=/path/to/PUAX
npm start

# 方法 2: 自动检测
npm start

# 方法 3: 开发模式
npm run dev

文档

详细说明参见: CROSSPLATFORMFIX.md

← 返回目录