@boses/skillink 1.0.5 → 1.1.0

package/README.md

@@ -1,51 +1,50 @@
 # Skillink 🚀
 
-**Skillink** 是一个为 AI 时代打造的技能管理工具。它允许你在一个统一的目录（`.agents/skills`）中编写 AI 技能（Skills），并利用符号链接（Symlink/Junction）技术，即时同步到各种 AI 工具（如 Cursor、Windsurf、VSCode、Gemini）的配置目录中。
+[English](./README.md) | [简体中文](./README.zh-CN.md)
 
-> **核心理念：一次编写，处处生效。**
+**Skillink** is a skill linker for AI tools.  
+Write skills in one place (`.agents/skills`) and sync to multiple tool directories with symlinks/junctions.
 
-## ✨ 特性
+> Core idea: **Write once, use everywhere.**
 
--   **🎯 极简架构**：基于 Node.js 20+ 和 TypeScript 5.x，性能卓越。
--   **🔗 零克隆开销**：采用符号链接技术，目标目录的文件只是源文件的引用。修改源文件，AI 工具立即感知，无需等待同步。
--   **🛠️ 极致 DX**：
-    -   **交互式初始化**：一键引导配置。
-    -   **自动探测与创建**：自动管理 AI 工具的配置目录。
-    -   **实时监视**：支持 `--watch` 模式，动态响应技能的增删。
--   **🛡️ 安全可靠**：仅操作符号链接，不轻易改动或删除用户的原始文件。
+## Features
 
-## 📦 安装
+- Minimal architecture with Node.js 20+ and TypeScript
+- Symlink-based sync (no copy, instant effect)
+- Interactive `init` flow
+- `sync --watch` for real-time skill folder changes
+- Safe clean behavior (only removes links under source boundary)
+- CLI localization via config (`en` / `zh-CN`)
 
-推荐作为开发依赖安装到项目中：
+## Install
+
+Install as a dev dependency:
 
 ```bash
-# 使用 pnpm
+# pnpm
 pnpm add -D @boses/skillink
 
-# 使用 npm
+# npm
 npm install -D @boses/skillink
 
-# 使用 yarn
+# yarn
 yarn add -D @boses/skillink
 ```
 
-## 🚀 快速开始
-
-### 1. 初始化项目
+## Quick Start
 
-在项目根目录下运行：
+### 1) Initialize
 
 ```bash
 npx skillink init
 ```
 
-按照交互提示选择你正在使用的 AI 工具。该命令会自动：
-- 创建 `.agents/skills` 目录并添加一个示例技能。
-- 生成 `skillink.config.ts` 配置文件。
+The first step in `init` asks language (`English / 简体中文`), then it creates:
 
-### 2. 编写技能
+- `.agents/skills` (with an example skill)
+- `skillink.config.ts`
 
-在 `.agents/skills` 目录下创建子文件夹，并在其中编写 `SKILL.md`：
+### 2) Write skills
 
 ```text
 .agents/skills/
@@ -53,54 +52,60 @@ npx skillink init
     └── SKILL.md
 ```
 
-### 3. 同步到工具
+### 3) Sync
 
 ```bash
 npx skillink sync
 ```
 
-想要在开发时自动同步新增的技能？运行：
+Watch mode:
 
 ```bash
 npx skillink sync --watch
 ```
 
-## 🛠️ 命令详解
+## Commands
 
-| 命令 | 描述 |
-| :--- | :--- |
-| `init` | 初始化项目环境，生成 `.agents/skills` 和配置文件。 |
-| `sync` | 将技能同步到所有配置的目标工具中。支持 `-w, --watch` 模式。 |
-| `status` | 检查并显示当前所有技能与目标工具的同步状态。 |
-| `clean` | 移除所有由 Skillink 创建的符号链接，恢复环境。 |
-| `check` | 检查是否有新版本可用。 |
+| Command  | Description                                                                          |
+| :------- | :----------------------------------------------------------------------------------- |
+| `init`   | Initialize project and create config.                                                |
+| `sync`   | Sync skills to all enabled targets (`--watch` supported).                            |
+| `status` | Show detailed sync status.                                                           |
+| `clean`  | Remove generated symlinks from configured targets.                                   |
+| `check`  | Check updates by semantic versions from npm `versions` (no `latest` tag dependency). |
 
-## ⚙️ 配置说明 (`skillink.config.ts`)
+## Configuration (`skillink.config.ts`)
 
 ```typescript
 import { defineConfig } from '@boses/skillink';
 
 export default defineConfig({
-  // 技能源目录
+  // CLI locale: 'en' | 'zh-CN' (default: 'en')
+  locale: 'en',
+  // Skills source directory
   source: '.agents/skills',
-  // 同步目标列表
+  // Sync targets
   targets: [
     {
       name: 'cursor',
       path: '.cursor/rules',
-      // 是否启用该目标（默认为 true）
-      // 设置为 false 后，sync 和 status 命令将忽略此目标
       enabled: true,
     },
     {
       name: 'gemini',
-      path: '.gemini/modules',
+      path: '.gemini/skills',
       enabled: true,
-    }
+    },
   ],
 });
 ```
 
-## 📄 许可证
+## Git Recommendation
+
+- Commit: `skillink.config.ts`, `.agents/skills/**`
+- Avoid committing generated link targets (for example: `.cursor/rules`, `.gemini/skills`)
+- `init` will remind you to add target directories to `.gitignore`
+
+## License
 
-MIT
+MIT

package/README.zh-CN.md

@@ -0,0 +1,111 @@
+# Skillink 🚀
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+**Skillink** 是一个 AI Skills 链接工具。  
+你可以在统一目录（`.agents/skills`）编写技能，并通过符号链接（Symlink/Junction）同步到多个 AI 工具目录。
+
+> 核心理念：**一次编写，处处生效。**
+
+## 特性
+
+- Node.js 20+ + TypeScript 的简洁架构
+- 基于符号链接同步，零拷贝、即时生效
+- 交互式 `init` 初始化流程
+- `sync --watch` 支持实时监听技能目录变化
+- 安全清理策略（仅清理位于 source 边界内的链接）
+- 支持 CLI 国际化输出（`en` / `zh-CN`）
+
+## 安装
+
+推荐安装为开发依赖：
+
+```bash
+# pnpm
+pnpm add -D @boses/skillink
+
+# npm
+npm install -D @boses/skillink
+
+# yarn
+yarn add -D @boses/skillink
+```
+
+## 快速开始
+
+### 1）初始化
+
+```bash
+npx skillink init
+```
+
+`init` 第一步会先询问语言（`English / 简体中文`），然后自动创建：
+
+- `.agents/skills`（包含示例技能）
+- `skillink.config.ts`
+
+### 2）编写技能
+
+```text
+.agents/skills/
+└── react-expert/
+    └── SKILL.md
+```
+
+### 3）同步
+
+```bash
+npx skillink sync
+```
+
+监听模式：
+
+```bash
+npx skillink sync --watch
+```
+
+## 命令
+
+| 命令     | 说明                                                               |
+| :------- | :----------------------------------------------------------------- |
+| `init`   | 初始化项目并生成配置。                                             |
+| `sync`   | 同步技能到所有启用目标（支持 `--watch`）。                         |
+| `status` | 显示详细同步状态。                                                 |
+| `clean`  | 清理配置目标中的已生成符号链接。                                   |
+| `check`  | 基于 npm `versions` 的语义化版本检查更新（不依赖 `latest` 标签）。 |
+
+## 配置说明（`skillink.config.ts`）
+
+```typescript
+import { defineConfig } from '@boses/skillink';
+
+export default defineConfig({
+  // CLI 语言: 'en' | 'zh-CN'（默认: 'en'）
+  locale: 'en',
+  // 技能源目录
+  source: '.agents/skills',
+  // 同步目标
+  targets: [
+    {
+      name: 'cursor',
+      path: '.cursor/rules',
+      enabled: true,
+    },
+    {
+      name: 'gemini',
+      path: '.gemini/skills',
+      enabled: true,
+    },
+  ],
+});
+```
+
+## Git 建议
+
+- 推荐提交：`skillink.config.ts`、`.agents/skills/**`
+- 不建议提交：链接产物目录（如 `.cursor/rules`、`.gemini/skills`）
+- `init` 完成后会提示将目标目录加入 `.gitignore`
+
+## 许可证
+
+MIT

package/dist/bin/skillink.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
 import { createRequire } from 'module';const require = createRequire(import.meta.url);
-import "../chunk-WG3NDRGG.js";
+import "../chunk-2UL2JQ4R.js";
 import "../chunk-AGAXTALJ.js";

package/dist/{chunk-WG3NDRGG.js → chunk-2UL2JQ4R.js}

@@ -9,7 +9,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@boses/skillink",
-      version: "1.0.5",
+      version: "1.1.0",
       description: "\u7EDF\u4E00 AI Skills \u7BA1\u7406\u5DE5\u5177 - \u50CF pnpm \u4E00\u6837\u94FE\u63A5\u5230\u5404 AI \u5DE5\u5177\u76EE\u5F55",
       type: "module",
       main: "dist/index.js",
@@ -35,7 +35,8 @@ var require_package = __commonJS({
         start: "node dist/bin/skillink.js",
         lint: "tsc --noEmit",
         check: "eslint",
-        format: "prettier --write src"
+        test: "vitest run",
+        format: "prettier --write ."
       },
       keywords: [
         "ai",
@@ -71,7 +72,8 @@ var require_package = __commonJS({
         prettier: "^3.8.1",
         tsup: "^8.5.1",
         typescript: "^5.9.3",
-        "typescript-eslint": "^8.54.0"
+        "typescript-eslint": "^8.54.0",
+        vitest: "^4.0.18"
       },
       engines: {
         node: ">=20.0.0"
@@ -87,7 +89,7 @@ import { cac } from "cac";
 import path from "path";
 import fs2 from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-import { checkbox, confirm } from "@inquirer/prompts";
+import { checkbox, confirm, select } from "@inquirer/prompts";
 
 // src/utils/fs.ts
 import fs from "fs/promises";
@@ -105,18 +107,40 @@ function isSymlink(p) {
 }
 async function createSymlink(target, path5) {
   const type = process.platform === "win32" ? "junction" : "dir";
-  if (existsSync(path5)) {
-    if (isSymlink(path5)) {
+  try {
+    const stats = await fs.lstat(path5);
+    if (stats.isSymbolicLink()) {
       await fs.unlink(path5);
     } else {
       throw new Error(`\u8DEF\u5F84 ${path5} \u5DF2\u5B58\u5728\u4E14\u4E0D\u662F\u7B26\u53F7\u94FE\u63A5\uFF0C\u8BF7\u624B\u52A8\u6E05\u7406\u3002`);
     }
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
   }
   await fs.symlink(target, path5, type);
 }
 
+// src/utils/locale.ts
+function resolveLocale(locale) {
+  return locale === "zh-CN" ? "zh-CN" : "en";
+}
+function isChineseLocale(locale) {
+  return locale === "zh-CN";
+}
+
 // src/commands/init.ts
-var TEMPLATE_SKILL = `---
+var TEMPLATE_SKILL_EN = `---
+name: Example Skill
+description: This is an example skill generated by Skillink.
+---
+
+# Usage
+
+Enable this skill to use it.
+`;
+var TEMPLATE_SKILL_ZH = `---
 name: \u793A\u4F8B\u6280\u80FD
 description: \u8FD9\u662F\u4E00\u4E2A\u7531 Skillink \u751F\u6210\u7684\u6F14\u793A\u6280\u80FD\u3002
 ---
@@ -129,47 +153,88 @@ var DEFAULT_TARGETS = [
   { name: "Cursor", value: "cursor", path: ".cursor/rules" },
   { name: "Windsurf", value: "windsurf", path: ".windsurf/rules" },
   { name: "VSCode", value: "vscode", path: ".vscode/skills" },
-  { name: "Gemini", value: "gemini", path: ".gemini/modules" }
+  { name: "Gemini", value: "gemini", path: ".gemini/skills" }
 ];
+function getInitText(locale) {
+  if (isChineseLocale(locale)) {
+    return {
+      title: "\u2728 Skillink \u521D\u59CB\u5316",
+      createSkillsDir: (skillsDir) => `\u662F\u5426\u5728 ${skillsDir} \u521B\u5EFA\u6280\u80FD\u76EE\u5F55\uFF1F`,
+      exampleSkillCreated: "\u2705 \u5DF2\u521B\u5EFA\u793A\u4F8B\u6280\u80FD\u3002",
+      skillsDirExists: "\u2139\uFE0F  \u6280\u80FD\u76EE\u5F55\u5DF2\u5B58\u5728\u3002",
+      selectTargets: "\u9009\u62E9\u8981\u540C\u6B65\u7684 AI \u5DE5\u5177\uFF1A",
+      noTargets: "\u26A0\uFE0F \u672A\u9009\u62E9\u4EFB\u4F55\u76EE\u6807\u3002\u914D\u7F6E\u6587\u4EF6\u4E2D\u7684\u76EE\u6807\u5217\u8868\u5C06\u4E3A\u7A7A\u3002",
+      overwriteConfig: "\u914D\u7F6E\u6587\u4EF6\u5DF2\u5B58\u5728\u3002\u662F\u5426\u8986\u76D6\uFF1F",
+      initCancelled: "\u274C \u521D\u59CB\u5316\u5DF2\u53D6\u6D88\u3002",
+      configCreated: "\u2705 \u5DF2\u521B\u5EFA skillink.config.ts",
+      gitAdvice: (paths) => `\u{1F4A1} Git \u5EFA\u8BAE\uFF1A\u8BF7\u5C06\u76EE\u6807\u76EE\u5F55\uFF08${paths}\uFF09\u52A0\u5165 .gitignore\uFF0C\u53EA\u63D0\u4EA4 .agents/skills \u4E0E\u914D\u7F6E\u6587\u4EF6\u3002`,
+      nextStep: '\n\u{1F449} \u8FD0\u884C "npx skillink sync" \u5F00\u59CB\u540C\u6B65\uFF01'
+    };
+  }
+  return {
+    title: "\u2728 Skillink Initialization",
+    createSkillsDir: (skillsDir) => `Create skills directory at ${skillsDir}?`,
+    exampleSkillCreated: "\u2705 Example skill created.",
+    skillsDirExists: "\u2139\uFE0F  Skills directory already exists.",
+    selectTargets: "Select AI tools to sync:",
+    noTargets: "\u26A0\uFE0F No targets selected. The config will contain an empty targets list.",
+    overwriteConfig: "Configuration file already exists. Overwrite?",
+    initCancelled: "\u274C Initialization cancelled.",
+    configCreated: "\u2705 Created skillink.config.ts",
+    gitAdvice: (paths) => `\u{1F4A1} Git tip: Add target directories (${paths}) to .gitignore. Commit only .agents/skills and config files.`,
+    nextStep: '\n\u{1F449} Run "npx skillink sync" to start syncing!'
+  };
+}
 async function initCommand(cwd = process.cwd()) {
-  console.log("\u2728 Skillink \u521D\u59CB\u5316");
+  const locale = await select({
+    message: "Select language / \u9009\u62E9\u8BED\u8A00",
+    choices: [
+      { name: "English", value: "en" },
+      { name: "\u7B80\u4F53\u4E2D\u6587", value: "zh-CN" }
+    ],
+    default: "en"
+  });
+  const text = getInitText(locale);
+  const templateSkill = isChineseLocale(locale) ? TEMPLATE_SKILL_ZH : TEMPLATE_SKILL_EN;
+  console.log(text.title);
   const skillsDir = path.join(cwd, ".agents", "skills");
   const configFile = path.join(cwd, "skillink.config.ts");
   if (!existsSync2(skillsDir)) {
     const create = await confirm({
-      message: `\u662F\u5426\u5728 ${skillsDir} \u521B\u5EFA\u6280\u80FD\u76EE\u5F55\uFF1F`,
+      message: text.createSkillsDir(skillsDir),
       default: true
     });
     if (create) {
       await ensureDir(skillsDir);
       const exampleDir = path.join(skillsDir, "example-skill");
       await ensureDir(exampleDir);
-      await fs2.writeFile(path.join(exampleDir, "SKILL.md"), TEMPLATE_SKILL);
-      console.log("\u2705 \u5DF2\u521B\u5EFA\u793A\u4F8B\u6280\u80FD\u3002");
+      await fs2.writeFile(path.join(exampleDir, "SKILL.md"), templateSkill);
+      console.log(text.exampleSkillCreated);
     }
   } else {
-    console.log("\u2139\uFE0F  \u6280\u80FD\u76EE\u5F55\u5DF2\u5B58\u5728\u3002");
+    console.log(text.skillsDirExists);
   }
   const selectedTargets = await checkbox({
-    message: "\u9009\u62E9\u8981\u540C\u6B65\u7684 AI \u5DE5\u5177\uFF1A",
+    message: text.selectTargets,
     choices: DEFAULT_TARGETS.map((t) => ({ name: t.name, value: t }))
   });
   if (selectedTargets.length === 0) {
-    console.log("\u26A0\uFE0F \u672A\u9009\u62E9\u4EFB\u4F55\u76EE\u6807\u3002\u914D\u7F6E\u6587\u4EF6\u4E2D\u7684\u76EE\u6807\u5217\u8868\u5C06\u4E3A\u7A7A\u3002");
+    console.log(text.noTargets);
   }
   if (existsSync2(configFile)) {
     const overwrite = await confirm({
-      message: "\u914D\u7F6E\u6587\u4EF6\u5DF2\u5B58\u5728\u3002\u662F\u5426\u8986\u76D6\uFF1F",
+      message: text.overwriteConfig,
       default: false
     });
     if (!overwrite) {
-      console.log("\u274C \u521D\u59CB\u5316\u5DF2\u53D6\u6D88\u3002");
+      console.log(text.initCancelled);
       return;
     }
   }
   const configContent = `import { defineConfig } from '@boses/skillink';
 
 export default defineConfig({
+  locale: '${locale}',
   source: '.agents/skills',
   targets: [
 ${selectedTargets.map(
@@ -183,8 +248,12 @@ ${selectedTargets.map(
 });
 `;
   await fs2.writeFile(configFile, configContent);
-  console.log("\u2705 \u5DF2\u521B\u5EFA skillink.config.ts");
-  console.log('\n\u{1F449} \u8FD0\u884C "npx skillink sync" \u5F00\u59CB\u540C\u6B65\uFF01');
+  console.log(text.configCreated);
+  if (selectedTargets.length > 0) {
+    const targetPaths = selectedTargets.map((t) => t.path).join(", ");
+    console.log(text.gitAdvice(targetPaths));
+  }
+  console.log(text.nextStep);
 }
 
 // src/commands/sync.ts
@@ -334,7 +403,11 @@ var Linker = class {
    * 清理所有由 Skillink 创建的符号链接
    */
   async cleanAll() {
-    const targets = this.config.targets.filter((t) => t.enabled !== false);
+    const targets = this.config.targets;
+    const absSourceDir = path2.resolve(
+      this.root,
+      this.config.source || ".agents/skills"
+    );
     for (const target of targets) {
       const targetDir = path2.resolve(this.root, target.path);
       if (!existsSync3(targetDir)) continue;
@@ -345,11 +418,8 @@ var Linker = class {
           try {
             const linkTarget = await fs3.readlink(itemPath);
             const absLinkTarget = path2.resolve(targetDir, linkTarget);
-            const absSourceDir = path2.resolve(
-              this.root,
-              this.config.source || ".agents/skills"
-            );
-            if (absLinkTarget.startsWith(absSourceDir)) {
+            const relative = path2.relative(absSourceDir, absLinkTarget);
+            if (relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative)) {
               await fs3.unlink(itemPath);
               console.log(`\u5DF2\u4ECE ${target.name} \u79FB\u9664 ${item.name}`);
             }
@@ -372,13 +442,23 @@ var Linker = class {
 import pc from "picocolors";
 async function syncCommand(options) {
   const cwd = options.cwd || process.cwd();
+  const fallbackLocale = resolveLocale();
+  const fallbackChinese = isChineseLocale(fallbackLocale);
   const config = await loadConfig(cwd);
   if (!config) {
-    console.error(pc.red('\u274C \u672A\u627E\u5230\u914D\u7F6E\u3002\u8BF7\u5148\u8FD0\u884C "skillink init"\u3002'));
+    console.error(
+      pc.red(
+        fallbackChinese ? '\u274C \u672A\u627E\u5230\u914D\u7F6E\u3002\u8BF7\u5148\u8FD0\u884C "skillink init"\u3002' : '\u274C Configuration not found. Run "skillink init" first.'
+      )
+    );
     process.exit(1);
   }
+  const locale = resolveLocale(config.locale);
+  const isChinese = isChineseLocale(locale);
   const linker = new Linker(cwd, config);
-  console.log(pc.cyan("\u{1F504} \u6B63\u5728\u540C\u6B65\u6280\u80FD..."));
+  console.log(
+    pc.cyan(isChinese ? "\u{1F504} \u6B63\u5728\u540C\u6B65\u6280\u80FD..." : "\u{1F504} Syncing skills...")
+  );
   const results = await linker.sync();
   let changes = 0;
   results.forEach((r) => {
@@ -388,33 +468,67 @@ async function syncCommand(options) {
       );
       changes++;
     } else if (r.status === "failed") {
-      console.error(pc.red(`\u274C ${r.skill} -> ${r.target}: ${r.message}`));
+      console.error(
+        pc.red(
+          isChinese ? `\u274C ${r.skill} -> ${r.target}: ${r.message}` : `\u274C ${r.skill} -> ${r.target}: ${r.message}`
+        )
+      );
     }
   });
   if (changes === 0) {
-    console.log(pc.gray("\u65E0\u9700\u66F4\u6539\u3002\u6240\u6709\u6280\u80FD\u5DF2\u540C\u6B65\u3002"));
+    console.log(
+      pc.gray(
+        isChinese ? "\u65E0\u9700\u66F4\u6539\u3002\u6240\u6709\u6280\u80FD\u5DF2\u540C\u6B65\u3002" : "No changes needed. All skills are already synced."
+      )
+    );
   } else {
-    console.log(pc.green(`\u2705 \u5DF2\u540C\u6B65 ${changes} \u5904\u53D8\u66F4\u3002`));
+    console.log(
+      pc.green(
+        isChinese ? `\u2705 \u5DF2\u540C\u6B65 ${changes} \u5904\u53D8\u66F4\u3002` : `\u2705 Synced ${changes} change(s).`
+      )
+    );
   }
   if (options.watch) {
-    console.log(pc.cyan("\n\u{1F440} \u6B63\u5728\u76D1\u89C6\u53D8\u66F4... \u6309 Ctrl+C \u505C\u6B62\u3002"));
+    console.log(
+      pc.cyan(
+        isChinese ? "\n\u{1F440} \u6B63\u5728\u76D1\u89C6\u53D8\u66F4... \u6309 Ctrl+C \u505C\u6B62\u3002" : "\n\u{1F440} Watching for changes... Press Ctrl+C to stop."
+      )
+    );
     const sourceDir = path3.resolve(cwd, config.source || ".agents/skills");
     const watcher = chokidar.watch(sourceDir, {
       ignoreInitial: true,
-      depth: 0,
+      depth: 1,
       awaitWriteFinish: {
         stabilityThreshold: 100,
         pollInterval: 100
       }
     });
     watcher.on("all", async (event, filePath) => {
+      if (path3.dirname(filePath) !== sourceDir) return;
       const fileName = path3.basename(filePath);
-      if (event === "addDir") {
-        console.log(pc.green(`+ \u68C0\u6D4B\u5230\u65B0\u6280\u80FD: ${fileName}`));
-        await linker.syncSkillToAll(fileName);
-      } else if (event === "unlinkDir") {
-        console.log(pc.red(`- \u6280\u80FD\u5DF2\u79FB\u9664: ${fileName}`));
-        await linker.removeSkillFromAll(fileName);
+      if (!fileName || fileName.startsWith(".")) return;
+      try {
+        if (event === "addDir") {
+          console.log(
+            pc.green(
+              isChinese ? `+ \u68C0\u6D4B\u5230\u65B0\u6280\u80FD: ${fileName}` : `+ New skill detected: ${fileName}`
+            )
+          );
+          await linker.syncSkillToAll(fileName);
+        } else if (event === "unlinkDir") {
+          console.log(
+            pc.red(
+              isChinese ? `- \u6280\u80FD\u5DF2\u79FB\u9664: ${fileName}` : `- Skill removed: ${fileName}`
+            )
+          );
+          await linker.removeSkillFromAll(fileName);
+        }
+      } catch (error) {
+        console.error(
+          pc.red(
+            isChinese ? `\u274C \u5904\u7406\u76D1\u89C6\u4E8B\u4EF6\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}` : `\u274C Failed to process watch event: ${error instanceof Error ? error.message : String(error)}`
+          )
+        );
       }
     });
   }
@@ -440,56 +554,110 @@ import { existsSync as existsSync4 } from "fs";
 async function statusCommand(options) {
   const cwd = options.cwd || process.cwd();
   const config = await loadConfig(cwd);
+  const locale = resolveLocale(config?.locale);
+  const isChinese = isChineseLocale(locale);
   if (!config) {
-    logger.error('\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\u3002\u8BF7\u5148\u8FD0\u884C "skillink init"\u3002');
+    logger.error(
+      isChinese ? '\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\u3002\u8BF7\u5148\u8FD0\u884C "skillink init"\u3002' : 'Configuration file not found. Run "skillink init" first.'
+    );
     return;
   }
-  logger.title("Skillink \u540C\u6B65\u72B6\u6001");
+  logger.title(isChinese ? "Skillink \u540C\u6B65\u72B6\u6001" : "Skillink Sync Status");
   logger.newline();
   const sourcePath = path4.resolve(cwd, config.source || ".agents/skills");
-  logger.info(`\u6E90\u76EE\u5F55: ${sourcePath}`);
+  logger.info(
+    isChinese ? `\u6E90\u76EE\u5F55: ${sourcePath}` : `Source directory: ${sourcePath}`
+  );
   if (!existsSync4(sourcePath)) {
-    logger.error("\u6E90\u76EE\u5F55\u4E0D\u5B58\u5728\uFF01");
+    logger.error(
+      isChinese ? "\u6E90\u76EE\u5F55\u4E0D\u5B58\u5728\uFF01" : "Source directory does not exist!"
+    );
     return;
   }
   const skills = await fs4.readdir(sourcePath, { withFileTypes: true });
   const validSkills = skills.filter((s) => s.isDirectory() && !s.name.startsWith(".")).map((s) => s.name);
-  logger.gray(`\u627E\u5230 ${validSkills.length} \u4E2A\u6280\u80FD\u3002`);
+  logger.gray(
+    isChinese ? `\u627E\u5230 ${validSkills.length} \u4E2A\u6280\u80FD\u3002` : `Found ${validSkills.length} skill(s).`
+  );
   logger.newline();
-  logger.info("\u76EE\u6807\u5DE5\u5177:");
+  logger.info(isChinese ? "\u76EE\u6807\u5DE5\u5177:" : "Targets:");
   for (const target of config.targets) {
     if (target.enabled === false) continue;
     const targetDir = path4.resolve(cwd, target.path);
     console.log(`${pc3.bold(target.name)} [${targetDir}]`);
     if (!existsSync4(targetDir)) {
-      console.log(pc3.red("  - \u76EE\u5F55\u7F3A\u5931\uFF08\u8FD0\u884C sync \u547D\u4EE4\u4EE5\u521B\u5EFA\uFF09"));
+      console.log(
+        pc3.red(
+          isChinese ? "  - \u76EE\u5F55\u7F3A\u5931\uFF08\u8FD0\u884C sync \u547D\u4EE4\u4EE5\u521B\u5EFA\uFF09" : "  - Missing directory (run sync to create it)"
+        )
+      );
       continue;
     }
     let syncedCount = 0;
     let missingCount = 0;
     let brokenCount = 0;
+    let mismatchedCount = 0;
+    let occupiedCount = 0;
     for (const skill of validSkills) {
       const linkPath = path4.join(targetDir, skill);
-      if (!existsSync4(linkPath)) {
+      const sourceSkillPath = path4.resolve(sourcePath, skill);
+      try {
+        const stats = await fs4.lstat(linkPath);
+        if (!stats.isSymbolicLink()) {
+          occupiedCount++;
+          continue;
+        }
         try {
-          const stats = await fs4.lstat(linkPath);
-          if (stats.isSymbolicLink()) {
-            brokenCount++;
+          const currentTarget = await fs4.readlink(linkPath);
+          const absCurrentTarget = path4.resolve(targetDir, currentTarget);
+          if (absCurrentTarget === sourceSkillPath) {
+            syncedCount++;
           } else {
-            missingCount++;
+            mismatchedCount++;
           }
         } catch {
+          brokenCount++;
+        }
+      } catch (error) {
+        if (error.code === "ENOENT") {
           missingCount++;
+          continue;
         }
-      } else {
-        syncedCount++;
+        missingCount++;
       }
     }
-    if (missingCount > 0) console.log(pc3.yellow(`  - ${missingCount} \u4E2A\u7F3A\u5931`));
-    if (brokenCount > 0) console.log(pc3.red(`  - ${brokenCount} \u4E2A\u5931\u6548\u94FE\u63A5`));
-    if (syncedCount > 0) console.log(pc3.green(`  - ${syncedCount} \u4E2A\u5DF2\u540C\u6B65`));
-    if (missingCount === 0 && brokenCount === 0)
-      console.log(pc3.green("  \u72B6\u6001\u826F\u597D\uFF01"));
+    if (missingCount > 0)
+      console.log(
+        pc3.yellow(
+          isChinese ? `  - ${missingCount} \u4E2A\u7F3A\u5931` : `  - ${missingCount} missing`
+        )
+      );
+    if (brokenCount > 0)
+      console.log(
+        pc3.red(
+          isChinese ? `  - ${brokenCount} \u4E2A\u5931\u6548\u94FE\u63A5` : `  - ${brokenCount} broken link(s)`
+        )
+      );
+    if (mismatchedCount > 0)
+      console.log(
+        pc3.red(
+          isChinese ? `  - ${mismatchedCount} \u4E2A\u9519\u8BEF\u6307\u5411\u94FE\u63A5` : `  - ${mismatchedCount} mismatched link(s)`
+        )
+      );
+    if (occupiedCount > 0)
+      console.log(
+        pc3.yellow(
+          isChinese ? `  - ${occupiedCount} \u4E2A\u540C\u540D\u5360\u4F4D\uFF08\u975E\u94FE\u63A5\uFF09` : `  - ${occupiedCount} occupied by non-link`
+        )
+      );
+    if (syncedCount > 0)
+      console.log(
+        pc3.green(
+          isChinese ? `  - ${syncedCount} \u4E2A\u5DF2\u540C\u6B65` : `  - ${syncedCount} synced`
+        )
+      );
+    if (missingCount === 0 && brokenCount === 0 && mismatchedCount === 0 && occupiedCount === 0)
+      console.log(pc3.green(isChinese ? "  \u72B6\u6001\u826F\u597D\uFF01" : "  Healthy!"));
     console.log("");
   }
 }
@@ -499,19 +667,21 @@ import { confirm as confirm2 } from "@inquirer/prompts";
 async function cleanCommand(options = {}) {
   const cwd = options.cwd || process.cwd();
   const config = await loadConfig(cwd);
+  const locale = resolveLocale(config?.locale);
+  const isChinese = isChineseLocale(locale);
   if (!config) {
-    logger.error("\u672A\u627E\u5230\u914D\u7F6E\u3002");
+    logger.error(isChinese ? "\u672A\u627E\u5230\u914D\u7F6E\u3002" : "Configuration not found.");
     return;
   }
   const answer = await confirm2({
-    message: "\u786E\u5B9A\u8981\u79FB\u9664\u6240\u6709\u5DF2\u540C\u6B65\u7684\u6280\u80FD\u94FE\u63A5\u5417\uFF1F",
+    message: isChinese ? "\u786E\u5B9A\u8981\u79FB\u9664\u6240\u6709\u5DF2\u540C\u6B65\u7684\u6280\u80FD\u94FE\u63A5\u5417\uFF1F" : "Remove all synced skill links?",
     default: false
   });
   if (!answer) return;
   const linker = new Linker(cwd, config);
-  logger.info("\u6B63\u5728\u6E05\u7406\u94FE\u63A5...");
+  logger.info(isChinese ? "\u6B63\u5728\u6E05\u7406\u94FE\u63A5..." : "Cleaning links...");
   await linker.cleanAll();
-  logger.success("\u6E05\u7406\u5B8C\u6210\u3002");
+  logger.success(isChinese ? "\u6E05\u7406\u5B8C\u6210\u3002" : "Clean completed.");
 }
 
 // src/commands/check.ts
@@ -522,11 +692,21 @@ import semver from "semver";
 var pkg = require_package();
 var currentVersion = pkg.version;
 var pkgName = pkg.name;
+function resolveLatestSemverVersion(versions) {
+  const validStableVersions = versions.filter(
+    (version) => semver.valid(version) && semver.prerelease(version) === null
+  );
+  const sorted = semver.rsort(validStableVersions);
+  if (sorted.length === 0) {
+    throw new Error("\u672A\u627E\u5230\u53EF\u7528\u7684\u7A33\u5B9A\u8BED\u4E49\u5316\u7248\u672C");
+  }
+  return sorted[0];
+}
 async function checkUpdate() {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), 3e3);
   try {
-    const res = await fetch(`https://registry.npmjs.org/${pkg.name}/latest`, {
+    const res = await fetch(`https://registry.npmjs.org/${pkg.name}`, {
       signal: controller.signal
     });
     clearTimeout(timeoutId);
@@ -534,12 +714,14 @@ async function checkUpdate() {
       throw new Error(`\u8BF7\u6C42\u5931\u8D25: ${res.status} ${res.statusText}`);
     }
     const data = await res.json();
-    const latestVersion = data.version;
+    const latestVersion = resolveLatestSemverVersion(
+      Object.keys(data.versions ?? {})
+    );
     return {
       latest: latestVersion,
       current: currentVersion,
       hasUpdate: semver.gt(latestVersion, currentVersion),
-      name: pkg.name
+      name: pkgName
     };
   } catch (error) {
     clearTimeout(timeoutId);
@@ -549,7 +731,12 @@ async function checkUpdate() {
 
 // src/commands/check.ts
 async function checkCommand() {
-  logger.info("\u6B63\u5728\u68C0\u67E5\u66F4\u65B0...");
+  const config = await loadConfig();
+  const locale = resolveLocale(config?.locale);
+  const isChinese = isChineseLocale(locale);
+  logger.info(
+    isChinese ? "\u6B63\u5728\u68C0\u67E5\u66F4\u65B0\uFF08\u8BED\u4E49\u5316\u7248\u672C\u6BD4\u8F83\uFF09..." : "Checking updates (semantic version comparison)..."
+  );
   try {
     const info = await checkUpdate();
     if (info.hasUpdate) {
@@ -562,7 +749,7 @@ async function checkCommand() {
       );
       console.log(
         pc4.yellow(
-          `   \u2502      \u53D1\u73B0\u65B0\u7248\u672C ${pc4.green(info.latest)} (\u5F53\u524D ${pc4.gray(info.current)})      \u2502`
+          isChinese ? `   \u2502      \u53D1\u73B0\u65B0\u7248\u672C ${pc4.green(info.latest)} (\u5F53\u524D ${pc4.gray(info.current)})      \u2502` : `   \u2502    New version ${pc4.green(info.latest)} (current ${pc4.gray(info.current)})    \u2502`
         )
       );
       console.log(
@@ -570,7 +757,7 @@ async function checkCommand() {
       );
       console.log(
         pc4.yellow(
-          `   \u2502    \u8BF7\u8FD0\u884C ${pc4.cyan(`npm i -g ${info.name}`)} \u66F4\u65B0    \u2502`
+          isChinese ? `   \u2502  \u8BF7\u8FD0\u884C ${pc4.cyan(`npm install -D ${info.name}@${info.latest}`)} \u66F4\u65B0  \u2502` : `   \u2502  Run ${pc4.cyan(`npm install -D ${info.name}@${info.latest}`)} to update  \u2502`
         )
       );
       console.log(
@@ -581,11 +768,13 @@ async function checkCommand() {
       );
       console.log();
     } else {
-      logger.success(`\u5F53\u524D\u5DF2\u662F\u6700\u65B0\u7248\u672C (${pc4.green(info.current)})`);
+      logger.success(
+        isChinese ? `\u5F53\u524D\u5DF2\u662F\u6700\u65B0\u7A33\u5B9A\u7248\u672C (${pc4.green(info.current)})` : `You are on the latest stable version (${pc4.green(info.current)})`
+      );
     }
   } catch (error) {
     logger.error(
-      `\u68C0\u67E5\u66F4\u65B0\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}`
+      isChinese ? `\u68C0\u67E5\u66F4\u65B0\u5931\u8D25: ${error instanceof Error ? error.message : String(error)}` : `Update check failed: ${error instanceof Error ? error.message : String(error)}`
     );
   }
 }
@@ -593,11 +782,14 @@ async function checkCommand() {
 // src/cli.ts
 var cli = cac("skillink");
 cli.version(currentVersion);
-cli.command("init", "\u521D\u59CB\u5316 Skillink \u914D\u7F6E").action(() => initCommand());
-cli.command("sync", "\u5C06\u6280\u80FD\u540C\u6B65\u5230\u76EE\u6807\u5DE5\u5177").option("-w, --watch", "\u76D1\u89C6\u6587\u4EF6\u53D8\u66F4").action((options) => syncCommand(options));
-cli.command("status", "\u663E\u793A\u540C\u6B65\u72B6\u6001").action(() => statusCommand({}));
-cli.command("clean", "\u79FB\u9664\u6240\u6709\u751F\u6210\u7684\u7B26\u53F7\u94FE\u63A5").action(() => cleanCommand());
-cli.command("check", "\u68C0\u67E5\u7248\u672C\u66F4\u65B0").action(() => checkCommand());
+cli.command(
+  "init",
+  "Initialize Skillink configuration / \u521D\u59CB\u5316 Skillink \u914D\u7F6E"
+).action(() => initCommand());
+cli.command("sync", "Sync skills to configured targets / \u540C\u6B65\u6280\u80FD\u5230\u76EE\u6807\u5DE5\u5177").option("-w, --watch", "Watch file changes / \u76D1\u89C6\u6587\u4EF6\u53D8\u66F4").action((options) => syncCommand(options));
+cli.command("status", "Show sync status / \u663E\u793A\u540C\u6B65\u72B6\u6001").action(() => statusCommand({}));
+cli.command("clean", "Remove generated symlinks / \u79FB\u9664\u751F\u6210\u7684\u7B26\u53F7\u94FE\u63A5").action(() => cleanCommand());
+cli.command("check", "Check package updates / \u68C0\u67E5\u7248\u672C\u66F4\u65B0").action(() => checkCommand());
 cli.help();
 try {
   cli.parse();

package/dist/cli.js

@@ -1,3 +1,3 @@
 import { createRequire } from 'module';const require = createRequire(import.meta.url);
-import "./chunk-WG3NDRGG.js";
+import "./chunk-2UL2JQ4R.js";
 import "./chunk-AGAXTALJ.js";

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+type Locale = 'en' | 'zh-CN';
 interface SyncTarget {
     /** 目标名称（如 'Cursor', 'VSCode'） */
     name: string;
@@ -9,10 +10,10 @@ interface SyncTarget {
 interface SkillinkConfig {
     /** 技能源目录（默认为 .agents/skills） */
     source?: string;
+    /** CLI 输出语言（默认 en） */
+    locale?: Locale;
     /** 同步目标列表 */
     targets: SyncTarget[];
-    /** 忽略的文件模式（暂未使用） */
-    ignore?: string[];
 }
 interface Skill {
     /** 技能名称（文件夹名） */
@@ -43,4 +44,4 @@ declare function loadConfig(cwd?: string): Promise<SkillinkConfig | null>;
  */
 declare function defineConfig(config: SkillinkConfig): SkillinkConfig;
 
-export { type Skill, type SkillinkConfig, type SyncResult, type SyncTarget, defineConfig, loadConfig };
+export { type Locale, type Skill, type SkillinkConfig, type SyncResult, type SyncTarget, defineConfig, loadConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boses/skillink",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "统一 AI Skills 管理工具 - 像 pnpm 一样链接到各 AI 工具目录",
   "type": "module",
   "main": "dist/index.js",
@@ -53,7 +53,8 @@
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.54.0"
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -64,6 +65,7 @@
     "start": "node dist/bin/skillink.js",
     "lint": "tsc --noEmit",
     "check": "eslint",
-    "format": "prettier --write src"
+    "test": "vitest run",
+    "format": "prettier --write ."
   }
 }