DevSet CLI

一个命令。完成设置。
通用的，确定性的，基于规则的项目分析和自动化环境设置工具。

这个问题

每当开发人员克隆一个全栈存储库或多服务代码库时，他们通常花费30-60分钟：

1. 找出当前存在哪些编程语言和框架。
2. 定位嵌套的前端和后端清单。
3. 在冲突的包管理器（npm, yarn, pnpm, bun）之间进行选择。
4. 创建和激活跨Windows/macOS/Linux的Python虚拟环境。
5. 识别缺失的环境变量。
6. 打开多个终端以单独启动每个服务。

DevSet CLI安全、本地和确定地自动化整个工作流程。

# Clone any repo
git clone https://github.com/example/fullstack-app.git
cd fullstack-app

# Run DevSet
npx devset-cli

# Start all services together
npm run dev:all

关键特性

• 100%基于规则和本地：在项目分析期间，零AI、零外部api、零令牌和零网络调用。完全离线工作。
• 深度多层检测：在单片和多目录存储库中识别独立组件（前端、后端、管理、微服务）。
• 确定性包管理：自动执行锁定文件(npm ci， yarn install --frozen-lockfile， pnpm install --frozen-lockfile， bun install --frozen-lockfile)，并在冲突的锁文件上发出警报。
• 隔离的Python虚拟环境：自动创建 .venv 在Windows (.venv\Scripts\python.exe)及POSIX (.venv/bin/python)，在不污染系统Python的情况下在虚拟环境中安装依赖项。
• 安全环境审计:比较 .env.example 反对 .env 突出显示缺失的键 而不会暴露秘密值。
• 通用多用途流道： devset run 使用格式化的彩色前缀日志并发地启动前端和后端服务([FRONTEND]， [BACKEND])，实时URL检测，以及优雅的进程树终止 Ctrl+C。
• 安全模拟:内置 --dry-run 标记为预览设置步骤而不进行更改。
• 系统的医生:内置 devset doctor 安装运行时（Node, Python, Java, Docker, Git）的诊断。

终端的经验

╔════════════════════════════════════════════════╗
║                   DEVSET CLI                   ║
║          One Command. Complete Setup.          ║
╚════════════════════════════════════════════════╝

Scanning project...

✓ Node.js detected (language)
✓ TypeScript detected (language)
✓ React detected (framework)
✓ Vite detected (framework)
✓ Python detected (language)
✓ Django detected (framework)
✓ npm detected (package-manager)
✓ pip detected (package-manager)

PROJECT TYPE: FULLSTACK

FRONTEND (frontend)
  Framework: Vite
  Language: TypeScript
  Package Manager: npm

BACKEND (backend)
  Framework: Django
  Language: Python
  Package Manager: pip

ENVIRONMENT
  Example: .env.example
  Status: .env file missing (template available)

SETUP PLAN
  1. Verify Python runtime installation
  2. Verify Node.js runtime installation
  3. Create .env configuration
  4. Create Python virtual environment (.venv) for backend
  5. Install backend dependencies (pip)
  6. Install frontend dependencies (npm)
  7. Validate environment and dependency setup

? Proceed with setup and dependency installation? (Y/n)

CLI命令

全局选项

• --dry-run：无需修改文件或安装软件包即可模拟分析和安装计划。
• --verbose：显示实时子进程标准输出/标准错误和调试跟踪。
• -y, --yes：跳过交互式确认提示，接受默认值。
• --json：将命令输出格式为raw JSON(支持 analyze 和 doctor）.
• -V, --version：显示已安装的CLI版本。
• -h, --help：显示命令选项和文档。

体系结构概述

DevSet遵循严格的模块化分离：

src/
├── cli/           # Commander CLI, options, banner, subcommands
├── scanner/       # Safe file system crawler and directory classifier
├── detectors/     # Scoring-based rules for languages, frameworks, package managers, databases, Docker, env
├── analyzers/     # Dependency, structure, and project analyzers
├── validators/    # Runtime, dependency, and environment verification
├── installers/    # NpmInstaller, PythonInstaller, JavaInstaller, DockerInstaller
├── core/          # PlanGenerator and ExecutionEngine
├── runner/        # ProcessManager and ServiceRunner
├── utils/         # Cross-platform process execution, logger, and filesystem
└── types/         # TypeScript interfaces and schemas

看到 文档/ architecture.md 获取完整的体系结构规格。

支持生态系统

看到 文档/ supported-technologies.md 查看完整的列表。

本地开发和测试

# Clone the repository
git clone https://github.com/your-username/devset-cli.git
cd devset-cli

# Install development dependencies
npm install

# Build the project using tsup
npm run build

# Run unit and integration tests (Vitest)
npm test

# Link globally for local testing
npm link

# Test CLI
devset --help
devset doctor

发布到NPM

DevSet命令行是为NPM发布预先配置的：

# 1. Login to NPM
npm login

# 2. Run verification (builds & runs tests automatically)
npm run prepublishOnly

# 3. Publish to NPM
npm publish --access public

安全

DevSet执行带有严格参数数组的命令(execa(file, args[]))，根据目录遍历验证路径，从不记录秘密或令牌，也从不自动删除文件。阅读我们的 文档/ security.md 查看完整的详细信息。

许可证

麻省理工学院© DevSet维护者