metame-release
MetaMe npm 发布流程（版本 bump、pre-publish 审计、OTP publish）。触发：发布/打包/出包/bump/release + MetaMe 代码上下文。勿触发：自媒体/内容发布。
Informações da origem
- Repositório
- Yaron9/MetaMe
- Última atividade na origem
- 28 de julho de 2026 às 01:10
- Idioma detectado do SKILL.md
- chinês
- Estrelas
- 18
- Forks
- 5
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- name
- metame-release
- description
- MetaMe npm 发布流程（版本 bump、pre-publish 审计、OTP publish）。触发：发布/打包/出包/bump/release + MetaMe 代码上下文。勿触发：自媒体/内容发布。
## 发布前必查清单（不跳过，每次过一遍）
### 1. 未提交变更
```bash
git -C /Users/yaron/AGI/MetaMe status --short
git -C /Users/yaron/AGI/MetaMe diff --stat HEAD
```
### 2. ESLint（改过 daemon*.js 必须零错误才能发）
```bash
npx eslint /Users/yaron/AGI/MetaMe/scripts/daemon*.js 2>&1 | tail -5
```
### 3. 部署完整性验证（新文件是否全部到位）
```bash
node -e "
const fs=require('fs');
const ex=new Set(['sync-readme.js','test_daemon.js']);
const src=fs.readdirSync('/Users/yaron/AGI/MetaMe/scripts')
.filter(f=>!ex.has(f)&&!/\.test\.js\$/.test(f)&&/\.(js|yaml|sh)\$/.test(f));
const dep=fs.readdirSync('/Users/yaron/.metame')
.filter(f=>/\.(js|yaml|sh)\$/.test(f));
const miss=src.filter(f=>!dep.includes(f));
console.log('Source:',src.length,'Deployed:',dep.length);
console.log('Missing from ~/.metame:',miss.length?miss:'NONE ✅');
"
```
### 4. plugin/scripts/ 同步（Windows 用户路径）
```bash
cd /Users/yaron/AGI/MetaMe && npm run sync:plugin 2>&1 | tail -2
```
---
## 版本号规范
| 类型 | 命令 | 适用场景 |
|------|------|----------|
| patch | `npm version patch --no-git-tag-version` | bug fix、小功能 |
| minor | `npm version minor --no-git-tag-version` | 新功能模块 |
| major | `npm version major --no-git-tag-version` | 架构变更、破坏性更新 |
查当前版本：`grep '"version"' /Users/yaron/AGI/MetaMe/package.json`
---
## 完整发布步骤
```bash
# 1. 提交变更（precommit 自动运行 sync:plugin）
git -C /Users/yaron/AGI/MetaMe add <files>
git -C /Users/yaron/AGI/MetaMe commit -m "fix/feat: <描述>"
# 2. Bump 版本
cd /Users/yaron/AGI/MetaMe && npm version patch --no-git-tag-version
git -C /Users/yaron/AGI/MetaMe add package.json
git -C /Users/yaron/AGI/MetaMe commit -m "chore: bump version to X.Y.Z"
# 3. 发布（需 OTP）
cd /Users/yaron/AGI/MetaMe && npm publish --otp=<6位数字>
# 4. 验证
npm view metame-cli version
```
**OTP**：来自 Authenticator app 的 6 位数字，不是版本号。等用户提供，不要猜。
---
## 架构要点（避免重蹈覆辙）
- **npm "files"** 包含 `"scripts/"` 通配符 → 所有 `scripts/` 文件自动发布，无需手动维护列表
- **`plugin/`** 是 Codex 插件目录，**不是** npm 发布路径
- **`sync:plugin`** 已改为自动扫描：新增文件无需更新任何列表
- **`BUNDLED_SCRIPTS`** 在 `index.js` 也已自动扫描：排除 `*.test.js` / `sync-readme.js` / `test_daemon.js`
- **Windows 用户**：`IS_DEV_MODE=false`，走文件复制，hooks/bin 均由 `index.js` 的 `syncDirFiles` 处理
- **`daemon.yaml`** 是用户配置，永远不被覆盖（`daemon-default.yaml` 是模板）
---
## 常见错误
| 错误 | 原因 | 解决 |
|------|------|------|
| `EOTP` | 需要二步验证 | 让用户提供 Authenticator 6位码 |
| `EPUBLISHCONFLICT` | 版本号已存在 | 再 bump 一次 patch |
| `E403` | 权限问题 | `npm whoami` 确认登录状态 |
| `Cannot find module` | 新文件未部署 | 跑清单第3项验证 |
| precommit `restart:daemon` 失败 | 正常，可忽略 | commit 仍然成功 |
Ver no GitHub