@aswless_854771076/ai_short_studio_cli 0.1.0 → 0.1.2

package/README.md

@@ -3,7 +3,7 @@
 VVICAT 新链路无限画布的官方命令行客户端。要求 Node.js 22 或更高版本。
 
 ```bash
-npm install --global @vvicat/ai_short_studio_cli
+npm install --global @aswless_854771076/ai_short_studio_cli
 ai-short-studio auth login --google \
   --base-url https://vvicat.example.com \
   --supabase-url https://your-project.supabase.co \
@@ -42,7 +42,7 @@ CLI 直接使用现有 `/api/projects`、`/api/canvas/node-types`、项目画布
 
 退出码：`0` 成功，`3` 未认证，`4` 不存在，`5` 禁止或冲突，`6` 参数错误，`7` 其他错误。
 
-配套 Agent Skill 位于 `skills/using-vvicat-cli`，随 npm 包发布。
+配套 Agent Skill 位于 `skills/using-vvicat-cli`，随 npm 包发布。安装或更新 CLI 时会自动安装到 Codex Skill 目录；已被用户修改或非 CLI 托管的目录不会被覆盖。
 
 ```bash
 ai-short-studio skill install --target codex
@@ -50,7 +50,7 @@ ai-short-studio skill status --target codex
 ai-short-studio skill update --target codex
 ```
 
-也可使用 `--target agents` 或 `--directory <path>`。CLI 会记录版本和 SHA-256；已安装 Skill 被用户修改后，更新默认停止，只有显式 `--force` 才覆盖。
+手动恢复或安装到其他 Agent 时，可使用 `--target agents` 或 `--directory <path>`。CLI 会记录版本和 SHA-256；已安装 Skill 被用户修改后，更新默认停止，只有显式 `--force` 才覆盖。自动安装可通过 `VVICAT_SKIP_SKILL_INSTALL=1` 跳过。
 
 ## 发布
 
@@ -66,6 +66,8 @@ npm run release
 
 Token 只从环境变量读取，不要放入参数、Git 或日志。
 
+未显式传入 `--version` 时，发布脚本会从包清单版本开始查询 npm，并自动选择第一个未占用的 patch 版本；例如 `0.1.1` 已存在时发布 `0.1.2`。显式传入 `--version` 时严格使用指定版本，版本已存在则幂等跳过。
+
 Docker 自动发布使用 `.env` 中的 `NPM_PUBLISH_PACKAGE_NAME` 选择目标；当前默认个人包为 `@aswless_854771076/ai_short_studio_cli`，获得组织权限后可改为 `@vvicat/ai_short_studio_cli`。`latest` 不会自动升级已安装的全局 CLI，手动更新使用：
 
 ```bash

package/dist/skill/skill-manager.d.ts

@@ -22,3 +22,31 @@ export declare function installSkill(input: {
     installedVersion: string | null;
     modified: boolean;
 }>;
+export declare function autoInstallSkill(target: string): Promise<{
+    target: string;
+    installed: boolean;
+    managed: boolean;
+    current: boolean;
+    packageVersion: string;
+    installedVersion: string | null;
+    modified: boolean;
+    action: "unchanged";
+} | {
+    target: string;
+    installed: boolean;
+    managed: boolean;
+    current: boolean;
+    packageVersion: string;
+    installedVersion: string | null;
+    modified: boolean;
+    action: "skipped";
+} | {
+    target: string;
+    installed: boolean;
+    managed: boolean;
+    current: boolean;
+    packageVersion: string;
+    installedVersion: string | null;
+    modified: boolean;
+    action: "updated" | "installed";
+}>;

package/dist/skill/skill-manager.js

@@ -60,6 +60,14 @@ export async function installSkill(input) {
     }
     return skillStatus(input.target);
 }
+export async function autoInstallSkill(target) {
+    const current = await skillStatus(target);
+    if (current.current)
+        return { action: 'unchanged', ...current };
+    if (current.installed && (!current.managed || current.modified))
+        return { action: 'skipped', ...current };
+    return { action: current.installed ? 'updated' : 'installed', ...await installSkill({ target }) };
+}
 async function directoryChecksum(root) {
     const files = await filesBelow(root);
     const hash = createHash('sha256');

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "@aswless_854771076/ai_short_studio_cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "VVICAT 无限画布项目命令行工具",
   "license": "MIT",
   "private": false,
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/854771076/waoowaoo.git",
+    "url": "git+https://codeup.aliyun.com/685a53a7323b2da0bd60070e/vvicat-ai-short-studio.git",
     "directory": "packages/ai_short_studio_cli"
   },
-  "homepage": "https://github.com/854771076/waoowaoo#readme",
-  "bugs": "https://github.com/854771076/waoowaoo/issues",
+  "homepage": "https://codeup.aliyun.com/685a53a7323b2da0bd60070e/vvicat-ai-short-studio",
   "publishConfig": {
     "access": "public"
   },
@@ -22,6 +21,7 @@
     "bin",
     "dist",
     "skills",
+    "scripts/postinstall.mjs",
     "README.md"
   ],
   "engines": {
@@ -29,6 +29,7 @@
   },
   "scripts": {
     "build": "node scripts/clean.mjs && tsc -p tsconfig.json",
+    "postinstall": "node scripts/postinstall.mjs",
     "prepack": "npm run build",
     "release:dry-run": "node scripts/publish.mjs --dry-run",
     "release:test": "node scripts/publish.mjs --name @aswless_854771076/ai_short_studio_cli --tag beta",

package/scripts/postinstall.mjs

@@ -0,0 +1,22 @@
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const packageRoot = fileURLToPath(new URL('../', import.meta.url))
+
+export function shouldAutoInstallSkill(environment = process.env) {
+  if (environment.VVICAT_SKIP_SKILL_INSTALL === '1') return false
+  return !environment.INIT_CWD || resolve(environment.INIT_CWD) !== resolve(packageRoot)
+}
+
+export async function main(environment = process.env) {
+  if (!shouldAutoInstallSkill(environment)) return
+  try {
+    const { autoInstallSkill, defaultSkillTarget } = await import('../dist/skill/skill-manager.js')
+    const result = await autoInstallSkill(environment.VVICAT_SKILL_DIRECTORY || defaultSkillTarget('codex'))
+    process.stdout.write(`VVICAT Skill ${result.action}: ${result.target}\n`)
+  } catch (error) {
+    process.stderr.write(`VVICAT CLI 已安装，Skill 自动安装已跳过：${error instanceof Error ? error.message : String(error)}\n`)
+  }
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])) await main()

package/skills/using-vvicat-cli/SKILL.md

@@ -21,7 +21,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 ## 工作流
 
 1. 运行 `ai-short-studio auth status --json`。首次登录通过参数或 `VVICAT_BASE_URL`、`VVICAT_SUPABASE_URL`、`VVICAT_SUPABASE_PUBLISHABLE_KEY` 提供服务和 Supabase 公共配置，再运行 `ai-short-studio auth login --google`；非交互环境才通过 stdin 传密码。
-   若 Skill 来自 CLI 安装，先运行 `ai-short-studio skill status --json`；`current` 为 false 时提示用户运行 `ai-short-studio skill update`。
+   npm 安装或更新 CLI 时会自动同步 Codex Skill。先运行 `ai-short-studio skill status --json`；`current` 为 false 时，说明自动同步可能因用户修改或非托管目录被跳过，再询问是否执行 `ai-short-studio skill update`。
 2. 完成上述初始化检查。确认目标项目是 `INFINITE_CANVAS`；创建测试项目时使用唯一前缀，并记录项目 ID。
 3. 严格按节点目录返回的 schema 和默认配置构造数据。
 4. 写入前运行 `ai-short-studio canvas get --project <id> --json` 获取当前结构；优先使用专用 node/edge 命令，批量变更才用 `canvas apply`。