@guandata/guanvis 0.1.21 → 0.1.22

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## @guandata/guanvis 0.1.22 - 2026-06-03
+
+- `install-skill` 增加 WorkBuddy skill 安装路径支持。
+- 补充发布与资源约束说明，强调发布前检查资源 ID、命名和覆盖风险。
+
 ## @guandata/guanvis 0.1.21 - 2026-05-29
 
 - 新增卡片固定钻取路径能力，可在构建时配置图表点击后的固定下钻路径。

package/README.md

@@ -42,6 +42,11 @@ guanvis publish ./my_dashboard/ --allow-overwrite
 
 ## 版本更新
 
+### @guandata/guanvis 0.1.22
+
+- `install-skill` 增加 WorkBuddy skill 安装路径支持。
+- 补充发布与资源约束说明，强调发布前检查资源 ID、命名和覆盖风险。
+
 ### 0.1.21
 
 - 新增卡片固定钻取路径能力，可在构建时配置图表点击后的固定下钻路径。

package/bin/run.js

@@ -5,6 +5,7 @@
 const { execFileSync, execSync, spawnSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
+const os = require("os");
 
 const PLATFORM_MAP = {
   "darwin-arm64": "guanvis-darwin-arm64",
@@ -35,6 +36,38 @@ function getBinaryPath() {
   return binaryPath;
 }
 
+function copyDirectory(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else if (entry.isSymbolicLink()) {
+      fs.symlinkSync(fs.readlinkSync(srcPath), destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function installCodeBuddySkill(pkgRoot, skill) {
+  try {
+    const srcDir = path.join(pkgRoot, "skills", skill);
+    if (!fs.existsSync(path.join(srcDir, "SKILL.md"))) {
+      console.warn(`Warning: skipping CodeBuddy/WorkBuddy install; skill not found: ${srcDir}`);
+      return;
+    }
+
+    const configDir = process.env.CODEBUDDY_CONFIG_DIR || path.join(os.homedir(), ".codebuddy");
+    const destDir = path.join(configDir, "skills", skill);
+    copyDirectory(srcDir, destDir);
+    console.log(`Installed ${skill} to CodeBuddy/WorkBuddy: ${destDir}`);
+  } catch (err) {
+    console.warn(`Warning: CodeBuddy/WorkBuddy install failed for ${skill}: ${err.message}`);
+  }
+}
+
 if (process.argv[2] === "version" && process.argv.length === 3) {
   const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
   console.log(pkg.version);
@@ -57,7 +90,9 @@ if (process.argv[2] === "install-skill") {
   console.log("Installing guanvis to AI coding assistants...");
   const result = spawnSync("npx", args, { stdio: "inherit", env: process.env, shell: true });
   if (result.error) throw result.error;
-  process.exit(result.status || 0);
+  const status = result.status || 0;
+  if (status === 0) installCodeBuddySkill(pkgRoot, "guanvis");
+  process.exit(status);
 }
 
 const binary = getBinaryPath();

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "@guandata/guanvis",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "观远 BI Card/Page 生成工具 - 通过 JS DSL 创建图表和仪表板",
   "bin": {
     "guanvis": "bin/run.js"
   },
+  "scripts": {
+    "build": "node scripts/build.js && node scripts/sync-skill.js",
+    "test:build-script": "node scripts/build.test.js",
+    "changelog": "node ../../scripts/generate-release-changelog.js .",
+    "check-changelog": "node ../../scripts/check-release-changelog.js .",
+    "prepublishOnly": "npm run test:build-script && npm run check-changelog && npm run build && node scripts/preflight.js"
+  },
   "files": [
     "bin/",
     "binaries/",

package/skills/guanvis/SKILL.md

@@ -290,7 +290,7 @@ guanvis pack ./project
 
 `publish` 和 `upload` 使用 BI 的 **transfer API**（`/api/manual/template/transfer`），特点：
 - `needIdMapping=false`：保持资源 ID 不变，重复导入会覆盖同 ID 资源
-- 认证方式：`X-Auth-Token` header
+- 认证方式：随底层 `guancli fetch` 使用 `Cookie: uIdToken=...`
 - 需要 `raw-backend-response: TRUE` header 绕过前端代理层
 - 不需要目标系统开启"一键迁移"开关，所有环境通用
 

package/skills/guanvis/references/publish-and-constraints.md

@@ -3,7 +3,7 @@
 `publish` 和 `upload` 命令通过 BI 的 transfer API 直接将资源包上传到目标系统：
 
 - **接口**：`POST /api/manual/template/transfer`（标准 multipart/form-data，表单字段名 `new-file`）
-- **认证**：`X-Auth-Token` header（JWT token）
+- **认证**：随底层 `guancli fetch` 使用 `Cookie: uIdToken=...`
 - **关键 header**：`raw-backend-response: TRUE`（绕过前端代理层，直达后端）
 - **ID 策略**：`needIdMapping=false`，保持资源 ID 不变。同 ID 资源会被覆盖更新。`guanvis publish/upload` 默认会先探测目标环境已有 Card/Page ID，检测到覆盖风险时拒绝上传；只有明确加 `--allow-overwrite` 才允许覆盖。
 - **通用性**：不需要目标系统开启"一键迁移"开关，所有客户环境可用