Metame Release

发布前必查清单（不跳过，每次过一遍）

1. 未提交变更

git -C /Users/yaron/AGI/MetaMe status --short
git -C /Users/yaron/AGI/MetaMe diff --stat HEAD

2. ESLint（改过 daemon*.js 必须零错误才能发）

npx eslint /Users/yaron/AGI/MetaMe/scripts/daemon*.js 2>&1 | tail -5

3. 部署完整性验证（新文件是否全部到位）

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 用户路径）

cd /Users/yaron/AGI/MetaMe && npm run sync:plugin 2>&1 | tail -2

版本号规范

查当前版本：grep '"version"' /Users/yaron/AGI/MetaMe/package.json

完整发布步骤

# 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 是模板）

常见错误