# NPM 发布指南

## 步骤 1: 登录 NPM

```bash
npm login
```

输入你的npm用户名、密码和邮箱。

**如果没有npm账户：**
1. 访问 https://www.npmjs.com/signup
2. 注册账户
3. 验证邮箱

---

## 步骤 2: 检查包名

```bash
npm view molecular-visualizer
```

如果出现 `npm ERR! 404 Not Found`，说明包名可用。

**如果包名已被占用，修改 `package.json` 中的 `name`**

---

## 步骤 3: 发布到 NPM

```bash
cd /home/tanshiqian/code/VibeCoding/3dmol/molecular-visualizer
npm publish
```

如果成功，你会看到：
```
+ molecular-visualizer@1.2.0
```

---

## 步骤 4: 验证发布

```bash
# 查看包信息
npm view molecular-visualizer

# 或访问
https://www.npmjs.com/package/molecular-visualizer
```

---

## 用户安装方式

```bash
# 安装
npm install molecular-visualizer

# 查看包
npm explore molecular-visualizer
```

---

## 常见问题

### 1. 包名被占用

修改 `package.json`:
```json
{
  "name": "your-unique-name"
}
```

### 2. 权限被拒绝

```bash
# 确保使用的是你自己的包
npm owner add 你的用户名 molecular-visualizer

# 或联系之前的所有者
```

### 3. 发布失败 - 需要2FA

```bash
# 如果启用了2FA，需要在命令行输入验证码
npm publish --otp=123456
```

### 4. 更新包

```bash
# 修改 version 后重新发布
npm version patch  # 1.2.0 -> 1.2.1
npm version minor  # 1.2.0 -> 1.3.0
npm version major # 1.2.0 -> 2.0.0

npm publish
```

---

## 发布后

1. ✅ 在 GitHub 创建 Release
2. ✅ 更新项目文档
3. ✅ 通知用户新版本可用

---

## 快速发布命令

```bash
#!/bin/bash
# publish.sh

# 1. 登录 (需要手动)
echo "请先登录 npm:"
npm login

# 2. 更新版本
npm version patch

# 3. 发布
npm publish

echo "✅ 已发布到 npm!"
echo "📦 https://www.npmjs.com/package/molecular-visualizer"
```