# Claude Code VOC Intelligence npm 发布包

这个文件夹用于沉淀 `@gangvy/claude-code-voc-intelligence` 的 npm 发布流程。

## 用户安装方式

全局安装：

```bash
npm install -g @gangvy/claude-code-voc-intelligence
claude-voc install
```

免全局安装：

```bash
npx @gangvy/claude-code-voc-intelligence install
```

两种方式都会把技能包安装到：

```text
~/.claude/plugins/voc-intelligence
```

然后按提示用 `claude --plugin-dir` 加载。

## 发布前验证

在仓库根目录执行：

```bash
npm run claude-voc:npm-pack
```

这个命令会：

1. 校验 `package.json`、CLI 入口和必要文件。
2. 生成 `dist/npm/nkkj-claude-code-voc-intelligence-<version>.tgz`。
3. 模拟全局安装后的 `claude-voc install --smoke`。
4. 模拟 `npx` 方式的 `claude-voc install --smoke`。

也可以直接运行本目录脚本：

```powershell
powershell -ExecutionPolicy Bypass -File release/npm/claude-code-voc-intelligence/verify.ps1
```

## 正式发布

方式一：本机已 `npm login`

```powershell
powershell -ExecutionPolicy Bypass -File release/npm/claude-code-voc-intelligence/publish.ps1
```

方式二：使用 token

```powershell
$env:NPM_TOKEN="你的 npm automation token"
powershell -ExecutionPolicy Bypass -File release/npm/claude-code-voc-intelligence/publish.ps1
```

也可以放到本目录的本地文件，不提交 git：

```text
release/npm/claude-code-voc-intelligence/.env.local
```

内容：

```text
NPM_TOKEN=你的 npm automation token
```

`.env.local` 已在仓库 `.gitignore` 中忽略。

发布脚本会先跑完整验证，再执行：

```bash
npm publish <tgz> --access public
```

## 后续版本更新

1. 修改技能包代码、文档或 MCP 工具。
2. 升级版本号：
   - `claude-code-voc-intelligence/package.json`
   - `claude-code-voc-intelligence/package-lock.json`
   - `claude-code-voc-intelligence/skill-package-manifest.json`
   - `claude-code-voc-intelligence/.claude-plugin/plugin.json`
3. 如涉及 MCP server 或记忆 schema，同步更新对应版本字段。
4. 执行 `npm run claude-voc:npm-pack`。
5. 执行 `npm run claude-voc:npm-publish`。

用户升级：

```bash
npm install -g @gangvy/claude-code-voc-intelligence@latest
claude-voc install
```

或：

```bash
npx @gangvy/claude-code-voc-intelligence@latest install
```