@ziniao-open/cli 0.1.0-beta.100 → 0.1.0-beta.103

package/README.md

@@ -28,7 +28,7 @@ Windows PowerShell 执行：
 ziniao-cli doctor fix-path
 ```
 
-遍历当前 PATH 并清理正式目录之外的 `ziniao.exe` 文件（默认只预览）：
+遍历当前 PATH 清理旧的 `ziniao` shim，并清理 Unix 端的 `ziniaobrowser/cli` 缓存目录（默认只预览）：
 
 ```powershell
 & "$(npm root -g)\@ziniao-open\cli\scripts\remove-ziniao-cli-shims.ps1"
@@ -45,6 +45,7 @@ macOS/Linux：
 脚本只探测 `ziniao.app` / `ziniao` 的安装目录；Windows 会优先查询卸载注册表中 `DisplayIcon` 包含 `ziniao.exe` 的条目，再从本体目录的 `resources/app.asar.unpacked/envkit/cli` 查找 CLI。Windows 使用 `%APPDATA%\ziniaobrowser\cli`，macOS 使用 `~/Library/Application Support/ziniaobrowser/cli`，Linux 使用 `${XDG_CONFIG_HOME:-~/.config}/ziniaobrowser/cli`，在目标目录缺少 CLI 或文件内容发生变化时同步最新文件，并注册当前用户 PATH。找不到源文件时只提示并继续，不阻断 PATH 配置。若安装目录无法自动探测，可设置 `ZINIAO_INSTALL_DIR`；若目标位置不同，可设置 `ZINIAO_APP_CACHE_DIR`。
 Windows 同时会把找到的紫鸟本体绝对路径写入 `%APPDATA%\ziniaobrowser\gui-path`，供 CLI 定位桌面客户端。
 macOS/Linux 也会在找到桌面本体时写入对应的 `gui-path`（macOS 为 `~/Library/Application Support/ziniaobrowser/gui-path`，Linux 为 `${XDG_CONFIG_HOME:-~/.config}/ziniaobrowser/gui-path`）。
+macOS/Linux 还会在 `~/.local/bin/ziniao` 创建固定 shim，避免向随机 PATH 目录写入文件。
 
 安装时会自动下载当前平台对应的预编译二进制（支持 macOS / Linux / Windows × amd64 / arm64），并做 SHA-256 校验。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziniao-open/cli",
-  "version": "0.1.0-beta.100",
+  "version": "0.1.0-beta.103",
   "description": "紫鸟开放平台命令行工具，为开发者和 AI Agent 提供统一的接口调用入口。",
   "license": "UNLICENSED",
   "bin": {

package/scripts/remove-ziniao-cli-shims.sh

@@ -45,7 +45,37 @@ for path_entry in ${PATH:-}; do
 done
 IFS="$old_ifs"
 
-if [ "$found" -eq 0 ]; then
+stable_shim="$home_dir/.local/bin/ziniao"
+if [ -e "$stable_shim" ] || [ -L "$stable_shim" ]; then
+  if [ "$stable_shim" != "$target_dir/ziniao" ]; then
+    found=1
+    if [ "$apply" -eq 1 ]; then
+      rm -f -- "$stable_shim"
+      log "Removed: $stable_shim"
+    else
+      log "Would remove: $stable_shim"
+    fi
+  fi
+fi
+
+cache_found=0
+if [ -d "$target_dir" ]; then
+  cache_found=1
+  if [ "$apply" -eq 1 ]; then
+    if [ -f "$target_dir/ziniao" ] || [ -L "$target_dir/ziniao" ]; then
+      rm -f -- "$target_dir/ziniao"
+    fi
+    if rmdir "$target_dir" 2>/dev/null; then
+      log "Removed CLI cache directory: $target_dir"
+    else
+      log "WARN: CLI cache directory is not empty; keeping it: $target_dir"
+    fi
+  else
+    log "Would remove CLI cache directory: $target_dir"
+  fi
+fi
+
+if [ "$found" -eq 0 ] && [ "$cache_found" -eq 0 ]; then
   log "No ziniao shims found in PATH directories."
 elif [ "$apply" -eq 0 ]; then
   log "Preview only. Re-run with --apply to remove these files."

package/scripts/setup-ziniao-cli.sh

@@ -164,11 +164,30 @@ fi
 shim_installed=0
 install_path_shim() {
   [ -f "$target_path" ] || return 0
+  shim_dir="$home_dir/.local/bin"
+  shim_path="$shim_dir/$source_name"
+  mkdir -p "$shim_dir"
+  if [ -L "$shim_path" ] && [ "$(readlink "$shim_path" 2>/dev/null || true)" = "$target_path" ]; then
+    shim_installed=1
+    log "The CLI shim already points to the AppCache CLI: $shim_path"
+  elif [ ! -e "$shim_path" ]; then
+    if ln -s "$target_path" "$shim_path" 2>/dev/null; then
+      shim_installed=1
+      log "Created the CLI shim: $shim_path"
+    else
+      log "WARN: Could not create the CLI shim: $shim_path"
+    fi
+  else
+    log "A file already exists at the CLI shim path; leaving it unchanged: $shim_path"
+  fi
   case ":${PATH:-}:" in
     *:"$target_dir":*)
       shim_installed=1
       log "The current PATH already contains the AppCache CLI directory: $target_dir"
       ;;
+    *:"$shim_dir":*)
+      [ "$shim_installed" -eq 1 ] && log "The current PATH contains the CLI shim directory: $shim_dir"
+      ;;
     *)
       log "The AppCache CLI directory is not on the current PATH; no shim will be created elsewhere: $target_dir"
       ;;
@@ -177,7 +196,8 @@ install_path_shim() {
 
 install_path_shim
 
-export PATH="$target_dir${PATH:+:$PATH}"
+shim_dir="$home_dir/.local/bin"
+export PATH="$target_dir:$shim_dir${PATH:+:$PATH}"
 
 profile=""
 case "${SHELL:-}" in
@@ -192,7 +212,7 @@ if [ -z "$profile" ]; then
 fi
 
 marker="# ziniao-cli: AppCache CLI PATH"
-path_line="export PATH=\"$target_dir:\$PATH\""
+path_line="export PATH=\"$target_dir:$shim_dir:\$PATH\""
 if ! grep -Fqx "$marker" "$profile" 2>/dev/null; then
   mkdir -p "$(dirname "$profile")"
   printf '\n%s\n' "$marker" >> "$profile"