@wdyy/skills 0.1.7 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +64 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -60,7 +60,51 @@ wdyy update-skill --all
|
|
|
60
60
|
|
|
61
61
|
## 发布到 npm
|
|
62
62
|
|
|
63
|
-
发布包名为 `@wdyy/skills`，命令行入口为 `wdyy
|
|
63
|
+
发布包名为 `@wdyy/skills`，命令行入口为 `wdyy`。以下流程适用于首次发布和后续发版；同一包名与版本只能发布一次。
|
|
64
|
+
|
|
65
|
+
### 使用发布脚本
|
|
66
|
+
|
|
67
|
+
推荐从项目根目录手动运行 `release_npm.sh`。脚本会检查工作区、组织权限和全部质量校验，自动执行 `npm version <patch|minor|major>`、`npm publish --access public`，并核验 registry 版本。它不会执行登录、浏览器认证或处理认证凭据。
|
|
68
|
+
|
|
69
|
+
首次运行或登录失效时，先手工登录；脚本检测到未登录也会提示并退出：
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
npm login
|
|
73
|
+
./release_npm.sh patch
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
可按变更范围选择版本级别：
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
./release_npm.sh patch # 修复或小幅调整
|
|
80
|
+
./release_npm.sh minor # 向后兼容的新功能
|
|
81
|
+
./release_npm.sh major # 不兼容变更
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
脚本在 `npm publish` 成功前不会推送 Git 提交或标签；若 `npm version` 已完成而后续发布失败，工程师必须根据 npm 与 Git 的实际状态处理，不得重复发布相同版本。
|
|
85
|
+
|
|
86
|
+
### 手工执行的发布流程
|
|
87
|
+
|
|
88
|
+
当需要排查发布问题时，可按以下步骤手工执行。发布前确认当前工作区只包含准备发布的内容，并查看将要发布的版本：
|
|
89
|
+
|
|
90
|
+
### 1. 准备发布内容
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
git status --short
|
|
94
|
+
node -p "require('./package.json').version"
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
后续发版先选择符合变更范围的版本级别。`npm version` 会更新 `package.json`，并在 Git 工作区满足其要求时创建提交和标签：
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
npm version patch # 修复或小幅调整
|
|
101
|
+
# npm version minor # 向后兼容的新功能
|
|
102
|
+
# npm version major # 不兼容变更
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### 2. 执行发布前校验
|
|
106
|
+
|
|
107
|
+
版本确定后，必须完整执行以下校验，不得跳过：
|
|
64
108
|
|
|
65
109
|
```bash
|
|
66
110
|
npm test
|
|
@@ -69,27 +113,31 @@ node --test $(find .well-known/skills -path '*/scripts/*.test.mjs' -print)
|
|
|
69
113
|
npm pack --dry-run
|
|
70
114
|
```
|
|
71
115
|
|
|
72
|
-
|
|
116
|
+
其中 `npm pack --dry-run` 用于确认包内容；应包含 `bin`、`lib`、`.well-known/skills` 与 `README.md`，且不应包含本地环境文件或其他无关文件。
|
|
73
117
|
|
|
74
|
-
|
|
118
|
+
### 3. 登录并核对组织权限
|
|
119
|
+
|
|
120
|
+
首次发布前，在 npm 账户设置中配置安全密钥 2FA（WebAuthn，例如 macOS Touch ID 或硬件安全密钥）。npm 已不支持通过 CLI 新增 TOTP 认证器。使用拥有 `wdyy` 组织 Owner 或发布权限的账号登录，并核对身份和组织成员资格：
|
|
75
121
|
|
|
76
122
|
```bash
|
|
77
123
|
npm login
|
|
78
124
|
npm whoami
|
|
79
125
|
npm org ls wdyy
|
|
80
|
-
npm publish --access public
|
|
81
126
|
```
|
|
82
127
|
|
|
83
|
-
|
|
128
|
+
不得在仓库、终端历史或文档中记录 access token、验证码或恢复码。
|
|
84
129
|
|
|
85
|
-
|
|
130
|
+
### 4. 发布公开包
|
|
131
|
+
|
|
132
|
+
完成校验且确认登录态、组织权限和版本号无误后，执行：
|
|
86
133
|
|
|
87
134
|
```bash
|
|
88
|
-
npm version patch
|
|
89
135
|
npm publish --access public
|
|
90
136
|
```
|
|
91
137
|
|
|
92
|
-
|
|
138
|
+
### 5. 发布后验收
|
|
139
|
+
|
|
140
|
+
核对 registry 已出现目标版本；然后在干净的目标项目中安装并验证初始化：
|
|
93
141
|
|
|
94
142
|
```bash
|
|
95
143
|
npm view @wdyy/skills version
|
|
@@ -97,6 +145,14 @@ npm install -g @wdyy/skills
|
|
|
97
145
|
wdyy init
|
|
98
146
|
```
|
|
99
147
|
|
|
148
|
+
### 常见问题
|
|
149
|
+
|
|
150
|
+
- `npm whoami` 返回 `E401`：当前 CLI 没有有效登录态，重新执行 `npm login` 后再继续。
|
|
151
|
+
- 已成功登录但 `npm publish --access public` 返回 `E404`：通常是当前账号没有 `@wdyy` 组织的包创建或发布权限；请组织 Owner 授权后重试。
|
|
152
|
+
- 发布提示版本已存在：版本不可覆盖，先通过 `npm version patch`、`minor` 或 `major` 生成新版本，再从“执行发布前校验”重新开始。
|
|
153
|
+
|
|
154
|
+
不得通过在命令行中传入 access token、验证码或恢复码来规避认证或权限问题。
|
|
155
|
+
|
|
100
156
|
## 验证
|
|
101
157
|
|
|
102
158
|
```bash
|