@lark-people/cli 0.0.5 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-people/cli",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "The official CLI for People open platform",
   "bin": {
     "people-cli": "scripts/run.js"

package/scripts/install-wizard.js

@@ -309,6 +309,29 @@ function sameResolvedPath(a, b) {
   }
 }
 
+function resolveExistingPath(targetPath) {
+  if (!targetPath) {
+    return null;
+  }
+  try {
+    return fs.realpathSync(targetPath);
+  } catch (_) {
+    return targetPath;
+  }
+}
+
+function isNpxCachePath(packageDir) {
+  if (!packageDir) {
+    return false;
+  }
+  const normalized = String(packageDir).replace(/\\/g, "/");
+  return normalized.includes("/_npx/") && normalized.includes("/node_modules/");
+}
+
+function packageInstallTarget(packageName, version) {
+  return version ? `${packageName}@${version}` : packageName;
+}
+
 function parseVersion(version) {
   if (!version) {
     return null;
@@ -355,10 +378,19 @@ function planGlobalInstall({
   currentPackageDir = CURRENT_PACKAGE_DIR,
   globalPackageDir = resolveGlobalPackageDir(currentPackageName),
 } = {}) {
+  const resolvedCurrentPackageDir = resolveExistingPath(currentPackageDir);
+  const resolvedGlobalPackageDir = resolveExistingPath(globalPackageDir);
+  const currentPackageFromNpxCache = isNpxCachePath(currentPackageDir) || isNpxCachePath(resolvedCurrentPackageDir);
+  const globalPackageLinkedToNpxCache = isNpxCachePath(globalPackageDir) || isNpxCachePath(resolvedGlobalPackageDir);
+  const missingGlobalInstallFromNpxCache = currentPackageFromNpxCache && !installedVersion;
+  const registryInstallVersion = currentVersion || latestVersion || installedVersion || null;
+  const registryInstallTarget = packageInstallTarget(currentPackageName, registryInstallVersion);
   const useCurrentPackage = Boolean(
     currentPackageDir &&
     globalPackageDir &&
-    !sameResolvedPath(currentPackageDir, globalPackageDir),
+    !sameResolvedPath(currentPackageDir, globalPackageDir) &&
+    !currentPackageFromNpxCache &&
+    !globalPackageLinkedToNpxCache,
   );
 
   if (useCurrentPackage) {
@@ -377,11 +409,12 @@ function planGlobalInstall({
     installVersion &&
     compareVersions(installedVersion, installVersion) < 0,
   );
+  const needsRepair = Boolean(globalPackageLinkedToNpxCache || missingGlobalInstallFromNpxCache);
 
   return {
-    skip: Boolean(installedVersion && !needsUpgrade),
+    skip: Boolean(installedVersion && !needsUpgrade && !needsRepair),
     needsUpgrade,
-    installTarget: currentPackageName,
+    installTarget: needsRepair ? registryInstallTarget : currentPackageName,
     installVersion,
     useCurrentPackage: false,
   };

package/skills/people-cli/SKILL.md

@@ -43,19 +43,36 @@ npx @lark-people/cli install
 
 ### Step 2: 检查版本并处理更新
 
-检查是否有更新：
+必须先执行结构化检查：
+
+```bash
+people-cli update --check --json
+```
+
+判断规则：
+
+- `update_available=true`：必须立即执行 `people-cli update`，不能继续 Step 3 或任何业务命令。
+- `skills_status.in_sync=false`：即使 CLI 已是最新版，也必须立即执行 `people-cli update` 同步 Skills，不能继续 Step 3 或任何业务命令。
+- 只有 `update_available=false`，且 `skills_status.in_sync` 不为 `false` 时，才能继续 Step 3。
+- 命令失败、输出不是合法 JSON、或缺少 `update_available` 字段：改用文本检查兜底。
+
+文本检查兜底：
 
 ```bash
 people-cli update --check
 ```
 
-如果提示有新版本，或后续任意 `people-cli` 输出中提示需要更新 CLI / Skills，执行：
+如果输出包含 `Update available:` 或提示运行 `people-cli update`，即使命令退出码是 0，也代表存在可更新版本；必须立即执行：
 
 ```bash
 people-cli update
 ```
 
-更新完成后重新执行 `people-cli --version`。如果更新同步了 Skills，提醒用户退出并重新打开 AI Agent，让新 Skills 生效。
+更新完成后必须重新执行 `people-cli --version` 和 `people-cli update --check --json`。只有确认 `update_available=false`，且 `skills_status.in_sync` 不为 `false` 后，才能继续 Step 3 或业务命令。
+
+如果 `people-cli update` 失败、更新后版本仍不是最新，或检查结果仍显示 `update_available=true` / `skills_status.in_sync=false`，停止业务操作，并把错误信息和 CLI 返回的 hint 告知用户。
+
+例外：如果 `people-cli update` 返回 `update_error`，且 `hint` 是明确的 `npm install -g @lark-people/cli@...` 或 `pnpm add -g @lark-people/cli@...` 安装命令，可以按该 hint 执行一次手动安装兜底。兜底完成后仍必须重新执行 `people-cli --version` 和 `people-cli update --check --json`；复查不通过时停止业务操作。
 
 ### Step 3: 检查用户身份和授权