bfi-cli 0.1.36 → 0.1.39

package/dist/cli.mjs

@@ -905,6 +905,11 @@ function setConfigValue(key, value, isGlobal = false) {
 		saveProjectConfig(workdir, config);
 	}
 }
+var skill_ref_exports = /* @__PURE__ */ __exportAll({
+	parseSkillRef: () => parseSkillRef,
+	toCanonicalSlug: () => toCanonicalSlug,
+	toSkillRefString: () => toSkillRefString
+});
 function parseSkillRef(ref, defaultNamespace = "global") {
 	if (!ref || typeof ref !== "string") throw new Error("Skill reference is required");
 	const trimmed = ref.trim();
@@ -4909,7 +4914,17 @@ async function resolveUpdateScope(options) {
 function matchesSkillFilter(name, filter) {
 	if (!filter || filter.length === 0) return true;
 	const lower = name.toLowerCase();
-	return filter.some((f) => f.toLowerCase() === lower);
+	return filter.some((f) => {
+		const fl = f.toLowerCase();
+		if (fl === lower) return true;
+		if (fl.startsWith("@")) {
+			const slashIdx = fl.lastIndexOf("/");
+			if (slashIdx > 0 && fl.slice(slashIdx + 1) === lower) return true;
+		}
+		const dashIdx = fl.indexOf("--");
+		if (dashIdx > 0 && fl.slice(dashIdx + 2) === lower) return true;
+		return false;
+	});
 }
 function getSkipReason(entry) {
 	if (entry.sourceType === "local") return "本地路径";
@@ -5039,7 +5054,29 @@ async function updateGlobalSkills(options = {}) {
 		let tempDir = null;
 		process.stdout.write(`\r${DIM$9}Checking skills from source: ${source}${RESET$9}\x1b[K\n`);
 		if (firstEntry.sourceType === "skillhub") {
-			console.log(`  ${DIM$9}SkillHub 技能请使用 bfi skills add 重新安装来更新${RESET$9}`);
+			const skillhubRef = source.replace(/^skillhub:/, "");
+			const { parseSkillRef, toCanonicalSlug } = await Promise.resolve().then(() => skill_ref_exports);
+			const { SkillHubAPI } = await Promise.resolve().then(() => api_exports);
+			const { resolveConfig } = await Promise.resolve().then(() => config_exports);
+			const cfg = resolveConfig({});
+			new SkillHubAPI(cfg.registry, cfg.token);
+			for (const item of itemsForSource) {
+				const safeName = sanitizeMetadata(item.name);
+				console.log(`${TEXT$7}正在更新 ${safeName}...${RESET$9}`);
+				try {
+					const parts = skillhubRef.split("/");
+					const ref = parts.length === 2 ? `@${parts[0]}/${parts[1]}` : skillhubRef;
+					const { runAdd } = await Promise.resolve().then(() => add_exports);
+					await runAdd([ref], {
+						global: options.global,
+						yes: true
+					});
+					successCount++;
+				} catch (error) {
+					console.log(`  ${DIM$9}✗ ${safeName}: ${error.message}${RESET$9}`);
+					failCount++;
+				}
+			}
 			continue;
 		}
 		try {
@@ -5220,6 +5257,32 @@ async function updateProjectSkills(options = {}) {
 		const firstEntry = skillsForSource[0].entry;
 		const sourceUrl = firstEntry.sourceUrl || firstEntry.source;
 		const ref = firstEntry.ref;
+		if (firstEntry.sourceType === "skillhub") {
+			const skillhubRef = source.replace(/^skillhub:/, "");
+			const { parseSkillRef, toCanonicalSlug } = await Promise.resolve().then(() => skill_ref_exports);
+			const { SkillHubAPI } = await Promise.resolve().then(() => api_exports);
+			const { resolveConfig } = await Promise.resolve().then(() => config_exports);
+			const cfg = resolveConfig({});
+			new SkillHubAPI(cfg.registry, cfg.token);
+			for (const item of skillsForSource) {
+				const safeName = sanitizeMetadata(item.name);
+				console.log(`${TEXT$7}正在更新 ${safeName}...${RESET$9}`);
+				try {
+					const parts = skillhubRef.split("/");
+					const ref = parts.length === 2 ? `@${parts[0]}/${parts[1]}` : skillhubRef;
+					const { runAdd } = await Promise.resolve().then(() => add_exports);
+					await runAdd([ref], {
+						global: false,
+						yes: true
+					});
+					successCount++;
+				} catch (error) {
+					console.log(`  ${DIM$9}✗ ${safeName}: ${error.message}${RESET$9}`);
+					failCount++;
+				}
+			}
+			continue;
+		}
 		const allLockedForSource = Object.entries(localLock.skills).filter(([_, entry]) => (entry.sourceUrl || entry.source) === source).map(([name, _]) => name);
 		let tempDir = null;
 		let deletedSkills = [];
@@ -6578,6 +6641,7 @@ function truncate(text, maxLen) {
 	if (text.length <= maxLen) return text;
 	return text.slice(0, maxLen) + "...";
 }
+var package_exports = /* @__PURE__ */ __exportAll({ runPackage: () => runPackage });
 const RESET$3 = "\x1B[0m";
 const BOLD$1 = "\x1B[1m";
 const DIM$3 = "\x1B[38;5;102m";
@@ -6997,9 +7061,24 @@ const GREEN = "\x1B[32m";
 const YELLOW = "\x1B[33m";
 async function runInstall(args, globalOpts) {
 	const yes = args.includes("--yes") || args.includes("-y");
-	const lock = loadLockfile(globalOpts.workdir || process.cwd());
-	const skillEntries = Object.entries(lock.skills);
-	const packageEntries = Object.entries(lock.packages);
+	const workdir = globalOpts.workdir || process.cwd();
+	const lock = loadLockfile(workdir);
+	try {
+		const skillsLock = await readLocalLock(workdir);
+		for (const [name, entry] of Object.entries(skillsLock.skills)) if (!lock.skills[name]) lock.skills[name] = {
+			...entry,
+			namespace: "global",
+			slug: name
+		};
+	} catch {}
+	const filterArg = args[0];
+	let skillEntries = Object.entries(lock.skills);
+	let packageEntries = Object.entries(lock.packages);
+	if (filterArg) {
+		const slug = filterArg.replace(/^@[\w-]+\//, "").replace(/^[\w-]+--/, "");
+		skillEntries = skillEntries.filter(([name]) => name === slug || name.includes(slug));
+		packageEntries = packageEntries.filter(([ref]) => ref.includes(slug));
+	}
 	if (skillEntries.length === 0 && packageEntries.length === 0) {
 		console.log(`${DIM$1}锁文件 (.bfi/lock.json) 中未找到技能或包。${RESET$1}`);
 		console.log(`${DIM$1}请先运行 'bfi skills add <source>' 安装技能。${RESET$1}`);
@@ -7014,39 +7093,44 @@ async function runInstall(args, globalOpts) {
 	let failedCount = 0;
 	for (const [skillName, entry] of skillEntries) {
 		const skillEntry = entry;
-		const sourceType = String(skillEntry.sourceType || "");
+		const sourceType = String(skillEntry.sourceType || skillEntry.source || "");
 		const namespace = String(skillEntry.namespace || "global");
 		const slug = String(skillEntry.slug || skillName);
 		const source = String(skillEntry.source || "");
-		String(skillEntry.version || "latest");
 		let installSource;
-		if (sourceType === "skillhub" || namespace !== "global") installSource = `@${namespace}/${slug}`;
-		else if (source) installSource = source;
+		if (sourceType === "skillhub") installSource = `@${namespace}/${slug}`;
+		else if (sourceType === "github" || sourceType === "gitlab") installSource = source;
+		else if (source && (source.startsWith("http://") || source.startsWith("https://") || source.startsWith("git@"))) installSource = source;
 		else {
-			console.log(`  ${YELLOW}跳过 ${skillName}：未知源类型${RESET$1}`);
+			console.log(`  ${YELLOW}跳过 ${skillName}：未知源类型 (${sourceType})${RESET$1}`);
 			continue;
 		}
-		console.log(`  ${TEXT$1}正在从 ${installSource} 安装 ${skillName}...${RESET$1}`);
+		console.log(`  ${TEXT$1}正在安装 ${installSource}...${RESET$1}`);
 		try {
 			await runAdd([installSource], { yes });
 			installedCount++;
 			console.log(`  ${GREEN}✓ ${skillName}${RESET$1}`);
 		} catch (error) {
 			failedCount++;
-			console.error(`  ${YELLOW}失败：${error.message}${RESET$1}`);
+			console.error(`  ${YELLOW}✗ ${error.message}${RESET$1}`);
 		}
 	}
 	for (const [pkgRef, entry] of packageEntries) {
 		const pkgEntry = entry;
-		const installSource = `@${String(pkgEntry.namespace || "global")}/${String(pkgEntry.slug || pkgRef)}`;
-		console.log(`  ${TEXT$1}正在从 ${installSource} 安装包 ${pkgRef}...${RESET$1}`);
+		const namespace = String(pkgEntry.namespace || "global");
+		const slug = String(pkgEntry.slug || pkgRef);
+		console.log(`  ${TEXT$1}正在安装包 @${namespace}/${slug}...${RESET$1}`);
 		try {
-			await runAdd([installSource], { yes });
+			const { runPackage } = await Promise.resolve().then(() => package_exports);
+			await runPackage(["install", `@${namespace}/${slug}`], {
+				...globalOpts,
+				yes
+			});
 			installedCount++;
 			console.log(`  ${GREEN}✓ ${pkgRef}${RESET$1}`);
 		} catch (error) {
 			failedCount++;
-			console.error(`  ${YELLOW}失败：${error.message}${RESET$1}`);
+			console.error(`  ${YELLOW}✗ ${error.message}${RESET$1}`);
 		}
 	}
 	console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bfi-cli",
-  "version": "0.1.36",
+  "version": "0.1.39",
   "description": "用友大业财BFI统一命令行工具，支持技能，技能包，元数据，UI元数据等",
   "type": "module",
   "bin": {

package/skills/skillhub-skills/SKILL.md

@@ -7,24 +7,18 @@ description: 使用 bfi CLI 在 SkillHub 上搜索、安装、发布和管理技
 
 bfi 是 SkillHub 生态的统一命令行工具。融合了开源 agent skills 生态能力和 SkillHub 专有功能。
 
-## ⚠️ 第零步：检查 bfi CLI 是否安装（最早执行）
+## 第零步：检查 bfi CLI 是否安装
 
-**在执行任何 SkillHub 操作之前，必须先确认 bfi CLI 已安装。**
-
-静默运行 `bfi --version`。如果返回错误或未找到命令：
+静默运行 `bfi --version`。如果未找到：
 
 ```
 需要安装 bfi CLI 工具。正在安装：
-
-```bash
 npm install -g bfi-cli
 ```
 
-安装完成后，继续执行后续步骤。
+## 第一步：检查登录状态
 
-**在做任何操作之前，必须先确认用户已登录。**
-
-静默运行 `bfi whoami`。如果返回错误或未认证：
+静默运行 `bfi whoami`。如果未认证：
 
 ```
 你需要登录 SkillHub 才能继续。请提供你的 API Token。
@@ -34,154 +28,94 @@ npm install -g bfi-cli
 请直接回复你的 Token，我会自动完成登录。
 ```
 
-用户提供 Token 后，立即静默执行：
-```bash
-bfi auth login --token <用户提供的Token>
-```
+用户提供 Token 后，立即执行 `bfi auth login --token <Token>`。登录成功后继续用户原请求。
 
-登录成功后，继续执行用户原本请求的操作，无需用户再次输入。如果登录失败，告知用户 Token 无效，请重新提供。
+## ⚠️ 关键区分：使用 vs 管理
 
-## 判断场景
+- **使用**：只读取 SkillHub 数据或操作本地文件。包括：搜索、查看、安装、卸载、更新、列表、日志。
+- **管理**：会修改 SkillHub 服务端数据，需要写权限。包括：发布技能、创建包、添加/移除包内技能。
 
-根据用户意图选择对应场景：
-
-### 场景 1：使用技能（搜索、安装、使用、查看）
+---
 
-用户想找技能、安装技能、试用技能、查看已安装的技能。
+## 场景 1：使用技能
 
-**1.1 搜索技能**
+### 1.1 搜索
 ```bash
-bfi skills search <关键词>                      # 搜索 SkillHub（默认）
-bfi skills search <关键词> --marketplace        # 搜索 skills.sh 公开市场
+bfi skills search <关键词>
+bfi skills search <关键词> --marketplace        # skills.sh 公开市场
 ```
 
-**1.2 查看技能详情**
+### 1.2 查看详情
 ```bash
 bfi skills info <@namespace/slug 或 namespace--slug>
 ```
 
-**1.3 安装技能**
+### 1.3 安装
 ```bash
-# SkillHub
-bfi skills add @命名空间/技能名
-bfi skills add 命名空间--技能名
-
-# Git 仓库（默认 git.yyrd.com）
-bfi skills add owner/repo --skill <name>        # 指定仓库中的某个技能
-bfi skills add owner/repo                       # 安装全部技能
-bfi skills add owner/repo --branch <分支>        # 指定分支
-
-# GitHub
-bfi skills add github:owner/repo                # 强制走 github.com
-
-# 安装选项
-bfi skills add <来源> -y                         # 跳过交互确认
-bfi skills add <来源> --list                     # 仅列出技能，不安装
+bfi skills add @命名空间/技能名                 # SkillHub
+bfi skills add owner/repo --skill <name>        # Git 仓库（默认 git.yyrd.com）
+bfi skills add github:owner/repo                # GitHub
+bfi skills add <来源> -y                         # 跳过确认
 ```
 
-**1.4 安装技能包**
+### 1.4 安装技能包
 ```bash
-bfi skills package install @namespace/package-name
+bfi skills package install @namespace/pkg
 ```
 
-**1.5 查看已安装**
+### 1.5 查看已安装
 ```bash
 bfi skills list
-bfi skills ls -g                                # 全局安装的技能
+bfi skills ls -g                                # 全局
 ```
 
-**1.6 使用技能（不安装）**
+### 1.6 卸载
 ```bash
-bfi skills use <来源>                            # 生成 prompt 文本
+bfi skills remove <技能名> -y
 ```
 
-### 场景 2：管理技能（发布、更新、卸载、包管理）
-
-用户想发布技能、管理包、更新/卸载技能。
-
-**2.1 发布技能**
+### 1.7 更新
 ```bash
-# 从 Git 发布（推荐，自动发现所有技能）
-bfi skills publish owner/repo --from git --namespace <ns>
-
-# 从本地目录发布
-bfi skills publish <路径> --namespace <ns>
-
-# 从 ZIP 发布
-bfi skills publish <路径> --from zip --namespace <ns>
-
-# 选项
-# --visibility public   公开发布（默认）
-# --branch <分支>        指定分支（默认 main）
-# --skill <name>         只发布指定技能
-# -y                     跳过确认
+bfi skills update
+bfi skills update <技能名>
 ```
 
-**2.2 卸载技能**
+### 1.8 记录调用
 ```bash
-bfi skills remove <技能名> -y
+bfi skills log <技能名> "简要描述"
 ```
 
-**2.3 更新技能**
+---
+
+## 场景 2：管理技能
+
+### 2.1 发布
 ```bash
-bfi skills update                                # 更新全部
-bfi skills update <技能名>
-# Git 来源的技能会检查远端更新
-# SkillHub 来源的技能请用 bfi skills add 重新安装
+bfi skills publish owner/repo --from git --namespace <ns>
+bfi skills publish <路径> --namespace <ns>
+# 选项：--branch <分支>、--skill <name>、--visibility public（默认）、-y
 ```
 
-**2.4 技能包管理**
+### 2.2 技能包管理（服务端）
 ```bash
-# 创建包
 bfi skills package create <slug> --namespace <ns>
-
-# 添加技能到包
 bfi skills package add-skills @ns/pkg <skill...>
-
-# 从包移除技能
 bfi skills package remove-skills @ns/pkg <skill...>
-
-# 安装包
-bfi skills package install @ns/pkg
-
-# 卸载包
-bfi skills package uninstall @ns/pkg
-
-# 查看已安装的包
-bfi skills package list
-```
-
-### 场景 3：记录技能调用
-
-**每次使用技能时必须记录：**
-```bash
-bfi skills log <技能名> "简要描述"
 ```
 
 ## 技能引用格式
 
-| 格式 | 示例 | 说明 |
-|------|------|------|
-| `@ns/slug` | `@retail/skill-pm` | SkillHub 技能 |
-| `ns--slug` | `retail--skill-pm` | 兼容格式 |
-| `owner/repo` | `bfi/bfi-skill` | Git 仓库（默认 git.yyrd.com） |
-| `github:owner/repo` | `github:vercel-labs/agent-skills` | 强制 GitHub |
+| 格式 | 说明 |
+|------|------|
+| `@ns/slug` | SkillHub 技能 |
+| `ns--slug` | 兼容格式 |
+| `owner/repo` | Git 仓库（默认 git.yyrd.com） |
+| `github:owner/repo` | 强制 GitHub |
 
 ## 配置
 
 ```bash
-bfi config get                     # 查看全部配置
-bfi config set registry <url> --global  # 设置 API 地址
-bfi config set namespace <ns>      # 设置默认命名空间
+bfi config get
+bfi config set registry <url> --global
+bfi config set namespace <ns>
 ```
-
-## 常见问题
-
-**Q: 公司 GitLab 仓库中的技能找不到？**
-A: 默认从 git.yyrd.com 克隆。如果是 GitHub 上的技能，使用 `github:` 前缀。
-
-**Q: 如何更新 SkillHub 上的技能？**
-A: 用 `bfi skills publish` 重新发布即可，服务端自动版本管理。
-
-**Q: 发布失败？**
-A: 确保 SKILL.md 文件在发布目录或仓库中，且包含 name 和 description 字段。