wpops 0.3.1 → 0.4.0

package/README.md

@@ -23,8 +23,8 @@ WordPress REST 操作工具。只依赖 Node 内置能力(无第三方包),用
 **最快:一条命令装好(含 skill)**
 
 ```powershell
-npm i -g wpops     # 装 CLI;postinstall 会自动把 skill 装到 ~/.agents/skills/wpops
-wpops setup        # 交互式配置站点:问 URL / 用户名 / 应用密码,写 sites/<名字>.env 并自动体检
+npm i -g wpops     # 装 CLI(无 postinstall,不会被 pnpm 等的「构建脚本确认」拦住)
+wpops setup        # 配置站点 + 自动装好内置 skill(写到 ~/.agents/skills/wpops)
 ```
 
 第二条是配置站点(密码必须你亲自输入,不回显)。之后即可 `wpops posts list` 等。
@@ -60,9 +60,9 @@ curl -fsSL https://raw.githubusercontent.com/qnnp-me/wpops/main/install.sh | sh
 npm publish
 ```
 
-> 凭据不进仓库 / 包:`sites/*.env` 与 `.env` 已忽略,且 `package.json` 的 `files`
-> 白名单不含 `sites/`。每台机器各自 `wpops setup`,工具与 skill 都不携带密钥。
-> `WPOPS_SKIP_SKILL=1 npm i -g wpops` 可跳过自动装 skill;`wpops install-skill` 可手动补装。
+> 凭据不进仓库 / 包:配置默认写在**用户目录**(见「1. 配置」),`package.json` 的 `files`
+> 白名单也不含它。每台机器各自 `wpops setup`,工具与 skill 都不携带密钥。
+> `WPOPS_SKIP_SKILL=1` 可跳过装 skill;`wpops install-skill` 可手动装/刷新。安装不再用 postinstall,免得被 pnpm 等包管理器的脚本确认拦住。
 
 ### 本机(开发) vs 其他机器(使用)
 
@@ -88,15 +88,13 @@ WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
 
 > `sites/*.env` 已在 `.gitignore` 中,不会被提交。
 
-**配置位置**:默认读**包目录**下的 `.env` / `sites/`(git clone 就在仓库里)。
-若用 `npm i -g wpops` 全局安装,建议设环境变量 `WPOPS_HOME` 指向固定目录,
-把配置放那里,升级/重装不会丢:
+**配置位置**:默认在**用户级稳定目录**,升级/重装不会丢:
 
-```powershell
-# 例如(Windows)
-setx WPOPS_HOME "%USERPROFILE%\.config\wpops"
-# 然后把 sites\<名字>.env 放到该目录下
-```
+- Windows:`%APPDATA%\wpops`(即 `C:\Users\<你>\AppData\Roaming\wpops`)
+- macOS/Linux:`$XDG_CONFIG_HOME/wpops` 或 `~/.config/wpops`
+
+可用环境变量 **`WPOPS_HOME`** 覆盖(开发时想放仓库内,指向仓库即可)。
+旧版本把配置放在**包目录**里、升级会被清掉;wpops 首次运行会自动把旧配置**迁移**到上面的用户目录,旧文件保留、可自行删除。
 
 ## 2. 先体检
 
@@ -249,12 +247,12 @@ wpops --all plugins activate akismet/akismet --yes  # 写操作必须 --yes
 
 ## 4. 多站点
 
-所有站点都放在 `sites/`,一个站点一个文件:
+所有站点都放在**配置目录**的 `sites/` 下,一个站点一个文件(默认配置目录见「1. 配置」,如 Windows 的 `%APPDATA%\wpops`):
 
 ```
-App\wpops\
+%APPDATA%\wpops\        (macOS/Linux:~/.config/wpops/)
 └── sites\
-    ├── qnnp.env          ← 站点:qnnp.me
+    ├── qnnp.me.env      ← 站点:qnnp.me
     ├── blog-a.env
     └── blog-b.env
 ```

package/bin/wpops.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync, writeFileSync, rmSync, renameSync } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { loadEnv, listSites, configHome } from '../lib/env.js';
+import { loadEnv, listSites, configHome, migrateLegacyConfig } from '../lib/env.js';
 import { WpError } from '../lib/client.js';
 import { UsageError } from '../lib/errors.js';
 import { parseArgs, isMutation } from '../lib/args.js';
-import { installSkill } from '../lib/skill.js';
+import { installSkill, skillStale } from '../lib/skill.js';
 import { configureOutput } from '../lib/util.js';
 import { runOne } from '../lib/run.js';
 import { generalHelp, groupHelp, commandsJson, usageHint } from '../lib/help.js';
@@ -178,6 +178,26 @@ async function main() {
     return;
   }
 
+  // 首次运行:把旧版「包目录内」的配置迁到稳定目录,并静默刷新内置 skill。
+  // best-effort;不污染 --json(提示走 stderr),--quiet 静默;测试环境跳过。
+  if (!process.env.NODE_TEST_CONTEXT) {
+    try {
+      const moved = migrateLegacyConfig();
+      if (moved && !flags.quiet) {
+        console.error(
+          `注意:已把 ${moved} 个旧配置从包目录迁移到 ${configHome()}(以后升级不再丢;旧文件仍在,可自行删除)`,
+        );
+      }
+    } catch {
+      // 忽略
+    }
+    try {
+      if (skillStale()) installSkill({ quiet: true });
+    } catch {
+      // 忽略
+    }
+  }
+
   if (group === 'sites') {
     await withOutput(flags, () => sitesCommand(action, rest));
     return;

package/lib/commands.js

@@ -1,7 +1,8 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { basename, join } from 'node:path';
 import { createInterface } from 'node:readline';
-import { loadEnv, configHome } from './env.js';
+import { loadEnv, configHome, hardenConfigPerms } from './env.js';
+import { installSkill } from './skill.js';
 import { buildConfig, createClient, WpError } from './client.js';
 import { stripTags, printJson, dry, warn, pick, listRequest, parseJson, readJsonFile } from './util.js';
 import { UsageError } from './errors.js';
@@ -988,8 +989,14 @@ export async function setup(flags) {
     '',
   ].join('\n');
   writeFileSync(file, content, 'utf8');
+  hardenConfigPerms();
 
-  console.log(`\n✓ 已写入 ${file}\n正在体检...`);
+  const skillDirs = installSkill();
+  const skillNote = skillDirs.length
+    ? `内置 skill 已安装到 ${skillDirs.join(', ')}`
+    : '内置 skill 未安装(可用 wpops install-skill)';
+
+  console.log(`\n✓ 已写入 ${file}\n✓ ${skillNote}\n正在体检...`);
   const cfg = buildConfig(loadEnv(name));
   const client = createClient(cfg);
   return doctor(client, cfg, {});

package/lib/env.js

@@ -1,17 +1,104 @@
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { UsageError } from './errors.js';
 
 const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 
+/**
+ * 用户级配置目录(稳定、升级不丢):
+ * - Windows:%APPDATA%\wpops
+ * - 其他:$XDG_CONFIG_HOME/wpops 或 ~/.config/wpops
+ */
+export function userConfigHome() {
+  if (process.platform === 'win32' && process.env.APPDATA) {
+    return resolve(process.env.APPDATA, 'wpops');
+  }
+  const base = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+  return resolve(base, 'wpops');
+}
+
 /**
  * 配置根目录。
- * - 默认:包目录(git clone / 本地开发,配置文件就在仓库里)
- * - 可用 WPOPS_HOME 覆盖(推荐给 npm 全局安装的用户,例如 ~/.config/wpops)
+ * - 默认:用户级稳定目录(见 userConfigHome)。**不再默认用包目录**——升级会整目录替换包,配置会被清掉。
+ * - `WPOPS_HOME` 覆盖(开发时想用仓库内目录,把它设成仓库路径即可)。
  */
 export function configHome() {
-  return process.env.WPOPS_HOME ? resolve(process.env.WPOPS_HOME) : pkgRoot;
+  return process.env.WPOPS_HOME ? resolve(process.env.WPOPS_HOME) : userConfigHome();
+}
+
+function hasConfig(dir) {
+  return existsSync(join(dir, '.env')) || existsSync(join(dir, 'sites'));
+}
+
+/**
+ * 把旧版「包目录内」的配置搬到稳定的用户目录。
+ * 仅当:未显式指定 WPOPS_HOME/WPOPS_ENV、旧目录有配置、新目录还没有配置时执行;best-effort。
+ * 返回迁移的条目数(0 表示无需/未迁移)。
+ */
+export function migrateLegacyConfig() {
+  if (process.env.WPOPS_HOME || process.env.WPOPS_ENV) return 0;
+  const from = pkgRoot;
+  const to = userConfigHome();
+  if (resolve(from) === resolve(to)) return 0;
+  if (!hasConfig(from) || hasConfig(to)) return 0;
+
+  let migrated = 0;
+  try {
+    mkdirSync(join(to, 'sites'), { recursive: true });
+    const legacyRoot = join(from, '.env');
+    if (existsSync(legacyRoot)) {
+      cpSync(legacyRoot, join(to, '.env'));
+      migrated++;
+    }
+    const legacySites = join(from, 'sites');
+    if (existsSync(legacySites)) {
+      for (const file of readdirSync(legacySites)) {
+        if (!file.endsWith('.env')) continue;
+        cpSync(join(legacySites, file), join(to, 'sites', file));
+        migrated++;
+      }
+    }
+    if (migrated) hardenConfigPerms();
+  } catch {
+    return 0;
+  }
+  return migrated;
+}
+
+/** unix 下收紧配置权限(里面有应用密码)。Windows 跳过(用默认 ACL)。 */
+export function hardenConfigPerms() {
+  if (process.platform === 'win32') return;
+  const home = configHome();
+  try {
+    chmodSync(resolve(home), 0o700);
+  } catch {
+    // 目录可能刚被删/无权限,忽略
+  }
+  const sites = resolve(home, 'sites');
+  if (existsSync(sites)) {
+    try {
+      chmodSync(sites, 0o700);
+    } catch {
+      // 忽略
+    }
+    try {
+      for (const file of readdirSync(sites)) {
+        if (file.endsWith('.env')) chmodSync(join(sites, file), 0o600);
+      }
+    } catch {
+      // 忽略
+    }
+  }
+  const root = resolve(home, '.env');
+  if (existsSync(root)) {
+    try {
+      chmodSync(root, 0o600);
+    } catch {
+      // 忽略
+    }
+  }
 }
 
 function sitesDir() {

package/lib/skill.js

@@ -1,4 +1,4 @@
-import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { copyFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -18,8 +18,12 @@ export function skillTargets() {
   return targets;
 }
 
-/** 把内置 skill 复制到发现目录,返回成功写入的目录列表。best-effort。 */
-export function installSkill() {
+/**
+ * 把内置 skill 复制到发现目录,返回成功写入的目录列表。best-effort。
+ * `quiet` 目前只是语义标记(本函数不打印);保留以便调用方统一传参。
+ */
+export function installSkill({ quiet = false } = {}) {
+  void quiet;
   if (process.env.WPOPS_SKIP_SKILL) return [];
   const src = skillSource();
   const installed = [];
@@ -30,8 +34,33 @@ export function installSkill() {
       copyFileSync(src, join(dir, 'SKILL.md'));
       installed.push(dir);
     } catch {
-      // 忽略:安装脚本不应因写 skill 失败而中断
+      // 忽略:安装 skill 失败不应中断命令
     }
   }
   return installed;
 }
+
+/**
+ * 已安装的 skill 是否缺失或与内置版本不一致(用于启动时静默刷新)。
+ * 只比对 SKILL.md;任一目标缺失/内容不同即认为需要刷新。
+ */
+export function skillStale() {
+  if (process.env.WPOPS_SKIP_SKILL) return false;
+  const src = skillSource();
+  if (!existsSync(src)) return false;
+  let want;
+  try {
+    want = readFileSync(src, 'utf8');
+  } catch {
+    return false;
+  }
+  for (const dir of skillTargets()) {
+    const file = join(dir, 'SKILL.md');
+    try {
+      if (!existsSync(file) || readFileSync(file, 'utf8') !== want) return true;
+    } catch {
+      return true;
+    }
+  }
+  return false;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wpops",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "WordPress REST operations toolkit — manage posts, pages, media, menus, comments, users, custom types, revisions, blocks, templates, widgets, settings and plugins from the CLI. Multi-site, safety-first, zero dependencies.",
   "license": "MIT",
   "author": "qnnp",
@@ -11,7 +11,6 @@
   "files": [
     "bin",
     "lib",
-    "scripts",
     "skills",
     ".env.example",
     "README.md"
@@ -39,7 +38,6 @@
     "setup": "node bin/wpops.js setup",
     "doctor": "node bin/wpops.js doctor",
     "help": "node bin/wpops.js help",
-    "postinstall": "node scripts/postinstall.mjs",
     "test": "node --test"
   },
   "engines": {

package/skills/wpops/SKILL.md

@@ -11,9 +11,9 @@ license: MIT
 本 skill 自洽,不依赖其他 skill;需要精确细节时**现查现用**(见下)。
 
 ## 安装与位置
-- 全局命令 `wpops`(`npm i -g wpops` 安装;postinstall 会顺带装好本 skill)。
+- 全局命令 `wpops`(`npm i -g wpops` 安装)。内置 skill 由 `wpops setup` 安装,首次运行也会按需自动刷新。
 - 未安装时也可:`npx wpops ...`。
-- 配置目录:默认包目录下的 `sites/`;设了 `WPOPS_HOME` 则读 `$WPOPS_HOME/sites/`。
+- 配置目录:默认在用户级稳定目录(Windows `%APPDATA%\wpops`,其他 `~/.config/wpops`),升级不丢;`WPOPS_HOME` 可覆盖。旧版放在包目录的配置会在首次运行时自动迁移。
 - 凭据:`sites/<名字>.env`。**不要读取、不要打印其中的应用密码。**
 - 首次配置:`wpops setup`(交互式写入凭据并自动体检)。
 

package/scripts/postinstall.mjs

@@ -1,15 +0,0 @@
-// npm postinstall:把内置 skill 安装到 agent 的发现目录。
-// 任何失败都不应中断 npm 安装本身。
-import { installSkill } from '../lib/skill.js';
-
-try {
-  const installed = installSkill();
-  for (const dir of installed) {
-    console.log(`wpops: skill 已安装到 ${dir}`);
-  }
-  if (!installed.length) {
-    console.log('wpops: 未自动安装 skill(可用 `wpops install-skill` 手动安装)');
-  }
-} catch {
-  // 静默:postinstall 出错不影响安装
-}