dw

开发服务管理器。后台运行命令，支持日志查看和重启。

特性

• 后台运行服务
• 实时日志查看 (tail -f)
• 优雅关闭和重启
• 生成项目脚本便于团队协作
• 无外部依赖，纯 Bash 实现

安装

# 方式一：复制到系统目录
sudo cp dw /usr/local/bin/

# 方式二：软链接（便于更新）
sudo ln -sf "$(pwd)/dw" /usr/local/bin/dw

# 方式三：用户目录（无需 sudo）
mkdir -p ~/.local/bin
cp dw ~/.local/bin/
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

验证安装：

dw help

快速开始

直接使用

cd ~/my-project
dw start "npm run dev"    # 启动
dw logs                    # 查看日志
dw restart                 # 重启
dw stop                    # 停止

生成项目脚本（推荐）

dw init "npm run dev"

# 生成以下脚本：
# service-start.sh   - 启动服务
# service-stop.sh    - 停止服务
# service-restart.sh - 重启服务
# service-logs.sh    - 查看日志

命令参考

命令	说明
dw start "命令"	后台启动服务
dw stop	停止服务
dw restart	重启服务
dw logs	实时查看日志（Ctrl+C 退出）
dw status	查看运行状态
dw clean	清理日志文件
dw init [命令]	生成项目脚本

常见用法

# 不同包管理器
dw start "npm run dev"
dw start "yarn dev"
dw start "pnpm dev"

# 指定端口
dw start "npm run dev -- --port 3001"

# 多服务同时启动
dw start "npm run dev & npm run storybook"

何时需要重启

文件类型	热更新	需要重启
.js/.ts/.vue/.jsx/.tsx	✓
.css/.scss/.less	✓
vite.config.*		✓
next.config.*		✓
tsconfig.json		✓
.env.*		✓
package.json (依赖变更)		✓

运行时文件

程序在项目目录下创建 .dw/ 存储运行时状态：

.dw/
├── pid    # 进程 ID
├── cmd    # 启动命令
└── log    # 服务日志

AI 助手集成

将以下内容添加到项目的 AI 指令文件（.cursorrules、CLAUDE.md 等）：

本项目使用 dw 管理开发服务。
- 启动: ./service-start.sh
- 重启: ./service-restart.sh
- 日志: ./service-logs.sh
- 停止: ./service-stop.sh

修改配置文件后请执行重启命令。

故障排查

# 查看详细日志
dw logs

# 端口被占用
lsof -i :3000
dw stop
dw start "npm run dev -- --port 3001"

# 强制清理
dw stop
rm -rf .dw/

License

MIT