qianduan（前端多项目一键启动助手）

短命令：qd ≡ qianduan（安装后两者均可；示例一律用 qd）。

全局配置：~/.config/qianduan/projects.json
规格全文：docs/SPEC.md
人话文档：INSTALL.md · USAGE.md

Setup

qd -h
qd 帮助
qd 功能
# 不在 PATH 时：
python3 ~/.agents/skills/qianduan/scripts/qianduan.py -h

未安装见 INSTALL.md（需同时链上 ~/bin/qianduan 与 ~/bin/qd）。

When triggered

用 CLI 读写配置；启动/重启在终端执行（见下）。示例命令均用 qd。

字段：shortName（简称）· chineseName（中文名，来自页面 title）· nodeVersion · packageManager · startCommand · name

• 扫描从 HTML title（及 vue.config / .env*）提取 → chineseName；缺省时从 README / AI_GUIDE / AGENT.md / CLAUDE.md 描述推断，并默认同步到 shortName
• 文档 Node 版本：优先「建议/推荐」及更完整版本（如 16.17.0 优于 16+）
• 扫描时若无法推断 Node，则用本机默认版本，nodeVersionSource 记为「用户默认」
• issues 为中文问题描述
• 改属性（英文推荐）：qd set <项目> <属性> <值>，例：qd set demo startCommand npm run sit-dev（值可多词、无需引号）
• 改属性（中文）：qd <项目> <属性> 改 <值>，例：qd 保洁管理系统 nodeVersion 改 12.22.12（均写入 manualFields）

Start（默认当前终端）

优先直接执行：

qd 启动保洁管理系统
qd run 保洁管理系统
# 已在登记项目的 path 下：
qd 启动
qd run

会先在启动进程内进入项目目录，再 nvm use + 启动命令（无需 shell 函数也能启动）。
裸 qd 启动 / qd run：仅当 cwd === 已登记 path 时解析该项目，否则提示指定项目名。
若用户需要「当前终端提示符也切过去」，见 INSTALL.md 可选步骤。

Agent 用 Shell 时：可先 qd resolve 取 path，再在该 working_directory 下执行，或直接跑 qd 启动…。
勿手写版本/命令；以配置为准。开发服务为长跑进程：可用 block_until_ms: 0。

Restart

1. qd resolve <称呼>
2. qd cwd-match <称呼> --cwd "$(pwd)"（或终端元数据里的 cwd）
3. match != true → 只提示返回的 message（当前项目不是 xx），禁止 cd / 启动。
4. match → 中断当前终端里的开发服务，再执行与 Start 相同的 nvm use + startCommand。

v1 不做强制跨目录重启。

Agent rules

• 配置只写 ~/.config/qianduan/，勿把真实 projects.json 提交进仓库。
• 扫描后务必向用户展示摘要 + issuesSummary。
• 称呼歧义（CLI ambiguous）时请用户消歧或改 shortName，勿猜。
• 用户问支持什么功能时，执行 qd 帮助 或按其输出回复。
• 对用户演示或代跑命令时优先写 qd（与 qianduan 等价）。

Output tips

扫描/检查后用简洁列表回复：项目简称、Node、启动命令、问题标记。启动成功则说明终端策略（当前/新开）与实际命令。