@mdsfe/mds-cli

MDS 命令行工具，旨在高效完成项目初始化、规范配置及环境维护。

🚀 快速开始

安装/更新

# 安装
npm install -g @mdsfe/mds-cli

# 快捷更新
mds up

常用命令

• 项目初始化: mds init <project-name>
  根据 MDS 标准模板快速创建应用。
• SDD 初始化: mds sdd
  一键配置“规范驱动开发”环境（生成 .agent、.specify、项目宪法等）。
• 版本更新: mds upgrade (别名: up)
  检测并升级 CLI 到最新版本。
• 环境诊断: mds doctor
  检查当前网络、Registry 认证及 NodeJS 环境。

🛠 开发流程 (SDD)

1. 初始化: 在项目根目录下运行 mds sdd。
2. 编写规范: 遵循提示在 .specify 中定义需求。
3. AI 辅助: 利用生成的工作流（如 /speckit.plan）进行自动化开发。

📦 发布指南 (核心维护者)

# 修订号更新 (0.0.x)
npm run release:patch

# 特性更新 (0.x.0)
npm run release:minor

注意: 发布前请确保已配置 .npmrc 且具有 @mdsfe作用域权限。

❓ 常见问题排查 (Troubleshooting)

如果您在安装或升级时遇到问题，请先运行 mds doctor 进行快速诊断。

1. 权限不足 (EACCES)

如果在执行 mds upgrade 或 npm install -g 时报 EACCES 错误：

• 方案 A: 使用 sudo 执行：sudo npm install -g @mdsfe/mds-cli
• 方案 B: 修复 npm 全局目录权限（推荐），参考 npm 官方文档。

2. 文件冲突 (EEXIST)

如果报错 EEXIST: file already exists, symlink...：

• 方案: 执行强制覆盖安装：npm install -g @mdsfe/mds-cli --force

3. 命令不存在 (Command Not Found)

如果安装后提示 mds: command not found：

• 请检查您的环境变量 PATH 是否包含了 npm 的全局 bin 目录。您可以运行 npm config get prefix 来查看安装位置。