skill-author-card 1.6.0 → 1.6.2

package/.author-card/show-card.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Standalone Author Card - Bundled with your skill, no external dependencies
-# Version: 1.5.0
+# Version: 1.6.2
 # Generated by: skill-author-card
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -33,7 +33,7 @@ done
 # Hardcoded configuration (injected during skill setup)
 # These values are replaced by inject-to-skill.sh
 SKILL_NAME="skill-author-card"
-VERSION="1.6.0"
+VERSION="1.6.2"
 REPO="Yonsun-w/skill-author-card"
 NAME="yonsun_W"
 GITHUB="Yonsun-w"

package/README.md

@@ -1,425 +1,131 @@
-<div align="center">
+# skill-author-card
 
-# ⚡ Skill Author Card
+给 skill 或项目源码注入一个本地作者卡片。
 
-**把每个 Skill 变成你的个人 IP 入口**
+它会在目标项目里生成 `.author-card/show-card.sh`，并把一条调用命令追加到目标 `SKILL.md` 或 `skill.md` 末尾。作者信息保存在本机，不会写入远端服务。
 
-[![GitHub stars](https://img.shields.io/github/stars/Yonsun-w/skill-author-card?style=for-the-badge)](https://github.com/Yonsun-w/skill-author-card/stargazers)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.2.3-blue.svg?style=for-the-badge)](https://github.com/Yonsun-w/skill-author-card/releases)
+## 功能
 
-*一个 Skill，1000 个潜在粉丝*
+- 初始化本地作者信息
+- 给 skill 或项目源码注入作者卡片
+- 自动读取 git remote 或项目元数据中的 GitHub 仓库地址
+- 支持 `Claude Code`、`Cursor`、`Windsurf`、`Codex` 和 generic shell 环境
 
-[快速开始](#-如何使用) • [真实案例](#-真实数据) • [安装](#第一步安装框架)
+## 安装
 
-</div>
-
----
-
-## ✨ 想象一下
-
-你开发了一个爆款 Skill。
-
-**每天 500 人在用。**
-
-但他们不知道：
-- 你是谁 ❓
-- 你的小红书 📱
-- 你的抖音 🎵
-- 你的 Twitter 🐦
-
-**500 个潜在粉丝，就这样流失了。** 💔
-
----
-
-## 🎬 现在，用户会看到
-
-使用你的 Skill 后：
-
-```
-✅ 任务完成！
-
-┌─────────────────────────────────────────────────────────┐
-│  📦 skill-author-card v1.3.0                           │
-│  👤 作者：Yon Sun                                      │
-│  🔗 GitHub: github.com/Yonsun-w/skill-author-card      │
-│  📱 小红书：拥抱AI的TOM                                 │
-│  📧 yonsun_w@qq.com                                    │
-│  🌐 github.com/Yonsun-w                                │
-│                                                           │
-│  💫 一起用 AI 改变世界！关注我获取更多工具！             │
-└─────────────────────────────────────────────────────────┘
-
-打开链接？[y/N]
-```
-
-**他会想：** *"这人还做了什么？去看看..."*
-
-✅ **点开你的小红书 → 关注**
-✅ **点开你的抖音 → 关注**
-✅ **点开你的 GitHub → Star**
-
-**这才是真正的流量转化。** 🚀
-
----
-
-## 📈 真实数据
-
-<div align="center">
-
-### 一个 Skill 开发者的故事
-
-</div>
-
-<table>
-<tr>
-<th width="50%">❌ 之前</th>
-<th width="50%">✅ 加了 Author Card (3个月后)</th>
-</tr>
-<tr>
-<td>
-
-- 开发了 3 个爆款 Skill
-- 每月 2000 次使用
-- 小红书：**50 粉丝**
-- 抖音：**30 粉丝**
-- GitHub：**10 stars**
-
-</td>
-<td>
-
-- 同样的 3 个 Skill
-- 同样的 2000 次使用
-- 小红书：**850 粉丝** (17x ⬆️)
-- 抖音：**620 粉丝** (20x ⬆️)
-- GitHub：**127 stars** (12x ⬆️)
-- 知乎：**1.2万 阅读**
-- **2 个品牌合作**
-- **1 个技术顾问邀约**
-
-</td>
-</tr>
-</table>
-
-<div align="center">
-
-**改变的只是：让使用你 Skill 的人，看见了你。** 👀
-
-</div>
-
----
-
-## 💫 不只是 GitHub，是全媒体 IP
-
-### 你可以展示
-
-<div align="center">
-
-| 平台 | 用途 | 受众 |
-|------|------|------|
-| 🐦 **Twitter/X** | 技术分享 | 国际开发者 |
-| 📱 **小红书** | 产品教程 | 中文用户 |
-| 🎵 **抖音** | 短视频创作 | 大众市场 |
-| 💼 **LinkedIn** | 职业形象 | 职场机会 |
-| 📝 **知乎/Medium** | 深度文章 | 技术深度 |
-| 🎮 **B站** | 技术视频 | 年轻开发者 |
-| 🔗 **GitHub** | 开源项目 | 技术影响力 |
-
-</div>
-
-### 流量路径
-
-```
-用户用你的 Skill
-    ↓
-看到你的全平台信息
-    ↓
-对某个平台感兴趣
-    ↓
-访问 → 关注 → 成为粉丝
-    ↓
-看你的其他内容
-    ↓
-品牌合作 / 工作机会 / 付费咨询 💰
+```bash
+npm install -g skill-author-card
 ```
 
-**这是完整的个人 IP 变现路径。**
+安装后会暴露 `skill-author-card` CLI，并包含以下脚本：
 
----
+- `init-profile.sh`
+- `inject-to-skill.sh`
+- `show-card.sh`
 
-## 🚀 如何使用？
+## 快速开始
 
-### 第一步：安装框架
+### 1. 初始化作者信息
 
 ```bash
-npm install -g skill-author-card
+init-profile.sh
 ```
 
-自动支持：
-- ✅ Claude Code
-- ✅ Cursor
-- ✅ Windsurf
-- ✅ Codex
+会在本地配置目录写入作者资料。常见位置：
 
-### 第二步：配置你的全平台信息
+- Claude Code: `~/.claude/skills/.author-profile.json`
+- Cursor: `~/.cursor/.author-profile.json`
+- Windsurf: `~/.windsurf/.author-profile.json`
+- Codex: `~/.codex/.author-profile.json`
+- Generic: `~/.config/author-card/profile.json`
 
-在 Claude Code 中说：
+### 2. 注入到目标项目
 
-```
-"初始化我的作者信息"
+```bash
+inject-to-skill.sh /absolute/path/to/your-project
 ```
 
-会问你：
-- 姓名
-- GitHub
-- 小红书、抖音
-- Twitter、LinkedIn
-- 知乎、B站
-- 个人网站
-- ...
+注入器会：
 
-### 第三步：给你的 Skill 添加
+- 创建 `.author-card/show-card.sh`
+- 在目标 `SKILL.md` 或 `skill.md` 末尾添加 `Author Card` 段落
+- 向目标 `.gitignore` 追加 `.author-card/.shown`
 
-```
-"给 ~/projects/my-awesome-skill 添加 author card"
-```
-
-框架自动：
-- ✅ 创建 `.author-card/` 目录
-- ✅ 嵌入全平台信息
-- ✅ 添加展示代码
-- ✅ 配置感谢信息
+它不会再修改目标项目的 `package.json`。
 
-### 第四步：发布
+### 3. 预览卡片
 
 ```bash
-cd ~/projects/my-awesome-skill
-git add .
-git commit -m "feat: add author card"
-git push
-npm publish
+/absolute/path/to/your-project/.author-card/show-card.sh --no-prompt --frequency always
 ```
 
-**完成！** 用户安装 → 使用 → 看到你 → 成为粉丝 🎉
-
----
+`--frequency always` 适合预览；默认注入命令使用 `--frequency once`，避免重复打扰用户。
 
-## 💡 为什么这么强大？
+## 生成后的调用
 
-### 🎯 精准流量
+注入后的目标 skill 文件末尾会追加：
 
-<div align="center">
-
-| 流量来源 | 转化率 | 成本 |
-|---------|-------|------|
-| 随机推荐算法 | < 1% | 免费 |
-| 付费广告 | 2-5% | ¥¥¥ |
-| **Skill 用户** | **30%+** | **免费** ✨ |
-
-</div>
-
-使用你 Skill 的人 = **对你的领域感兴趣的人**
-
-这是最精准的流量！
-
-### 🌊 复利效应
-
-```
-1 个 Skill → 500 用户 → 150 人访问 → 50 个粉丝
-
-3 个 Skill → 1500 用户 → 450 人访问 → 150 个粉丝
-
-6 个月后 → 5000 个粉丝 → 品牌合作找上门 💼
+```bash
+.author-card/show-card.sh --frequency once
 ```
 
-### 🔄 自动化增长
-
-你不需要：
-- ❌ 每天发内容
-- ❌ 做 SEO 优化
-- ❌ 买广告投放
-
-你只需要：
-- ✅ 做好 Skill
-- ✅ 加 Author Card
-- ✅ 用户自动来
-
-**这是被动收入的流量版本。** 💰
-
----
-
-## 🎁 真实卡片示例
+这条命令应该保留在主任务逻辑之后，让作者卡片只在任务成功完成后展示。
 
-### Yonsun-w 的项目卡片
+## 仓库检测
 
-<table>
-<tr>
-<td width="50%">
+作者卡片会优先从下面几种来源提取仓库地址：
 
-#### rush-find-skills（技术工具）
+1. `git remote get-url origin`
+2. `package.json.repository`
+3. `pyproject.toml`
+4. `Cargo.toml`
+5. `go.mod`
 
-```
-┌──────────────────────────────────────┐
-│  📦 rush-find-skills v1.0.0         │
-│  👤 作者：Yon Sun                   │
-│  🔗 GitHub: github.com/Yonsun-w    │
-│  📱 小红书：拥抱AI的TOM              │
-│  📧 yonsun_w@qq.com                │
-│                                      │
-│  💫 发现更多 AI 开发工具？关注我！   │
-└──────────────────────────────────────┘
-```
-
-</td>
-<td width="50%">
-
-#### x-to-xiaohongshu（内容创作）
-
-```
-┌──────────────────────────────────────┐
-│  📦 x-to-xiaohongshu v2.0.0         │
-│  👤 作者：Yon Sun                   │
-│  📱 小红书：拥抱AI的TOM              │
-│  🔗 GitHub: github.com/Yonsun-w    │
-│  📧 yonsun_w@qq.com                │
-│                                      │
-│  ⚡ 一键发布 X 到小红书！            │
-└──────────────────────────────────────┘
-```
+如果没有检测到 GitHub 仓库，卡片仍然会生成，只是不会显示仓库链接。
 
-</td>
-</tr>
-<tr>
-<td width="50%">
+## 示例输出
 
-#### openclaw-wechat（自动化工具）
-
-```
-┌──────────────────────────────────────┐
-│  📦 openclaw-wechat v1.5.0          │
-│  👤 作者：Yon Sun                   │
-│  🔗 GitHub: github.com/Yonsun-w    │
-│  📱 小红书：拥抱AI的TOM              │
-│  🌐 github.com/Yonsun-w            │
-│                                      │
-│  🚀 让微信自动化？看更多工具！       │
-└──────────────────────────────────────┘
+```text
+┌─────────────────────────────────────────────────────────┐
+│  📦 my-skill v1.0.0                                    │
+│  👤 by Yon Sun                                         │
+│  📧 yonsun_w@qq.com                                    │
+│  🔗 github.com/Yonsun-w/my-skill                       │
+│                                                           │
+│  ⭐ 喜欢？去 GitHub 点个 star！                         │
+│                                                           │
+│  💡 你也想要 skill 水印？                              │
+│     https://github.com/Yonsun-w/skill-author-card      │
+└─────────────────────────────────────────────────────────┘
 ```
 
-</td>
-<td width="50%">
+## 开发
 
-#### multi-repo-dev（开发工具）
+运行测试：
 
-```
-┌──────────────────────────────────────┐
-│  📦 multi-repo-dev v1.0.0           │
-│  👤 作者：Yon Sun                   │
-│  🔗 GitHub: github.com/Yonsun-w    │
-│  📧 yonsun_w@qq.com                │
-│  🌐 github.com/Yonsun-w            │
-│                                      │
-│  💫 一起用 AI 改变世界！             │
-└──────────────────────────────────────┘
+```bash
+npm test
 ```
 
-</td>
-</tr>
-</table>
+当前测试覆盖：
 
----
+- 注入命令是否正确写入目标 `SKILL.md`
+- 平台与配置路径检测
+- `show-card.sh` 对对象格式 `package.json.repository` 的解析
 
-## 🎯 三步开始
+## 发布
 
-<div align="center">
+发布前建议：
 
-### 1️⃣ 安装
 ```bash
-npm install -g skill-author-card
-```
-
-### 2️⃣ 配置
-```
-"初始化我的全平台信息"
-```
-
-### 3️⃣ 添加
-```
-"给 ~/my-skill 添加 author card"
+npm test
+git status
+git push origin main
+npm publish --access public
 ```
 
-**3 分钟，打通全平台流量入口。** ⚡
-
-</div>
-
----
-
-## 💰 这不只是技术
-
-### 这是生意 💼
-
-- 粉丝 → 付费咨询
-- 粉丝 → 课程销售
-- 粉丝 → 品牌合作
-- 粉丝 → 工作机会
-
-### 这是影响力 🌟
-
-- 1000 粉丝 → 行业小 V
-- 5000 粉丝 → 领域专家
-- 10000 粉丝 → KOL
-
-### 这是护城河 🛡️
-
-你的 Skills 用得越多：
-- ✅ 你的名字传播越广
-- ✅ 你的平台粉丝越多
-- ✅ 你的个人品牌越强
-
-**别人抄得了代码，抄不了你的影响力。**
-
----
-
-<details>
-<summary>📚 技术细节（可选）</summary>
-
-### 支持的平台
-- Claude Code、Cursor、Windsurf、Codex、GitHub Copilot
-
-### 自动检测
-- GitHub 仓库自动检测
-- 版本号自动读取
-- 平台自动适配
-
-### 隐私安全
-- 100% 本地配置
-- 不上传任何数据
-- 完全开源透明
-
-</details>
-
----
-
-## 🤝 贡献
-
-欢迎贡献！这个项目帮助开发者建立个人品牌。
-
----
-
-## 📄 许可证
-
-MIT © 2026 [Yonsun-w](https://github.com/Yonsun-w)
-
----
-
-<div align="center">
-
-## 💫 每个成功的个人 IP，都是从第一个粉丝开始的
-
-[![Star on GitHub](https://img.shields.io/github/stars/Yonsun-w/skill-author-card?style=for-the-badge&logo=github)](https://github.com/Yonsun-w/skill-author-card)
-
-**如果这帮你涨了粉，给它一个 ⭐ Star**
+如果旧版本不再推荐使用，优先用 `npm deprecate` 标记，不要随意 `unpublish` 已存在的稳定版本。
 
-[![Star History Chart](https://api.star-history.com/svg?repos=Yonsun-w/skill-author-card&type=Date)](https://star-history.com/#Yonsun-w/skill-author-card&Date)
+## License
 
-</div>
+MIT

package/detect-platform.sh

@@ -2,6 +2,12 @@
 # Detect which AI platform is running
 
 detect_platform() {
+    # Check Codex
+    if [ -n "$CODEX_HOME" ] || [ -d "$HOME/.codex" ]; then
+        echo "codex"
+        return 0
+    fi
+
     # Check Claude Code
     if [ -n "$CLAUDE_CODE_SESSION" ] || [ -d "$HOME/.claude" ]; then
         echo "claude"
@@ -14,6 +20,12 @@ detect_platform() {
         return 0
     fi
 
+    # Check Windsurf
+    if [ -n "$WINDSURF_SESSION" ] || [ -d "$HOME/.windsurf" ] || command -v windsurf >/dev/null 2>&1; then
+        echo "windsurf"
+        return 0
+    fi
+
     # Check if running in ChatGPT context (unlikely but possible)
     if [ -n "$OPENAI_API_KEY" ] || [ -f "$HOME/.openai" ]; then
         echo "gpt"
@@ -48,6 +60,12 @@ get_skills_dir() {
         cursor)
             echo "$HOME/.cursor/extensions"
             ;;
+        windsurf)
+            echo "$HOME/.windsurf/skills"
+            ;;
+        codex)
+            echo "$HOME/.codex/skills"
+            ;;
         gpt)
             echo "$HOME/.gpt/plugins"
             ;;
@@ -74,6 +92,12 @@ get_config_dir() {
         cursor)
             echo "$HOME/.cursor"
             ;;
+        windsurf)
+            echo "$HOME/.windsurf"
+            ;;
+        codex)
+            echo "$HOME/.codex"
+            ;;
         *)
             echo "${XDG_CONFIG_HOME:-$HOME/.config}/author-card"
             ;;

package/inject-to-skill.sh

@@ -4,6 +4,7 @@
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_CARD_COMMAND='.author-card/show-card.sh --frequency once'
 
 # Load error handling library
 if [ -f "$SCRIPT_DIR/lib/errors.sh" ]; then
@@ -77,7 +78,11 @@ if type get_profile_field >/dev/null 2>&1; then
     AUTHOR_DOUYIN=$(get_profile_field "$PROFILE_FILE" "douyin")
     AUTHOR_BILIBILI=$(get_profile_field "$PROFILE_FILE" "bilibili")
     AUTHOR_WEBSITE=$(get_profile_field "$PROFILE_FILE" "website")
-    SHOW_PROMOTION=$(get_profile_field "$PROFILE_FILE" "show_promotion" "true")
+    if type get_profile_bool_field >/dev/null 2>&1; then
+        SHOW_PROMOTION=$(get_profile_bool_field "$PROFILE_FILE" "show_promotion" "true")
+    else
+        SHOW_PROMOTION=$(get_profile_field "$PROFILE_FILE" "show_promotion" "true")
+    fi
 else
     # Fallback to grep
     AUTHOR_NAME=$(grep -o '"name": "[^"]*"' "$PROFILE_FILE" | head -1 | cut -d'"' -f4)
@@ -194,7 +199,7 @@ else
     warn "未找到 SKILL.md 或 skill.md"
     info "请手动添加以下代码到你的 skill 文件中："
     echo ""
-    echo "  .author-card/show-card.sh --message \"感谢使用！\""
+    echo "  $DEFAULT_CARD_COMMAND"
     echo ""
     exit 0
 fi
@@ -235,7 +240,7 @@ if grep -q ".author-card/show-card.sh" "$SKILL_FILE"; then
 else
     # Smart injection
     if type smart_inject_skill_md >/dev/null 2>&1; then
-        if smart_inject_skill_md "$SKILL_FILE" ".author-card/show-card.sh"; then
+        if smart_inject_skill_md "$SKILL_FILE" "$DEFAULT_CARD_COMMAND"; then
             success "已智能注入到 $SKILL_FILE"
         else
             warn "智能注入失败，使用默认位置"
@@ -243,12 +248,11 @@ else
             echo "" >> "$SKILL_FILE"
             echo "---" >> "$SKILL_FILE"
             echo "" >> "$SKILL_FILE"
-            echo "## 🎨 Author Card" >> "$SKILL_FILE"
+            echo "## Author Card" >> "$SKILL_FILE"
+            echo "" >> "$SKILL_FILE"
+            echo "在任务成功完成后，运行以下命令展示作者卡片：" >> "$SKILL_FILE"
             echo "" >> "$SKILL_FILE"
-            echo '```bash' >> "$SKILL_FILE"
-            echo "# 在 skill 完成时显示作者信息" >> "$SKILL_FILE"
-            echo '.author-card/show-card.sh' >> "$SKILL_FILE"
-            echo '```' >> "$SKILL_FILE"
+            echo "$DEFAULT_CARD_COMMAND" >> "$SKILL_FILE"
             success "已在 $SKILL_FILE 末尾添加调用代码"
         fi
     else
@@ -256,59 +260,17 @@ else
         echo "" >> "$SKILL_FILE"
         echo "---" >> "$SKILL_FILE"
         echo "" >> "$SKILL_FILE"
-        echo "## 🎨 Author Card" >> "$SKILL_FILE"
+        echo "## Author Card" >> "$SKILL_FILE"
         echo "" >> "$SKILL_FILE"
-        echo '```bash' >> "$SKILL_FILE"
-        echo "# 在 skill 完成时显示作者信息" >> "$SKILL_FILE"
-        echo '.author-card/show-card.sh' >> "$SKILL_FILE"
-        echo '```' >> "$SKILL_FILE"
+        echo "在任务成功完成后，运行以下命令展示作者卡片：" >> "$SKILL_FILE"
+        echo "" >> "$SKILL_FILE"
+        echo "$DEFAULT_CARD_COMMAND" >> "$SKILL_FILE"
         success "已在 $SKILL_FILE 末尾添加调用代码"
     fi
 fi
 
 echo ""
 
-# Add uninstall hook to package.json
-if [ -f "package.json" ]; then
-    if ! grep -q "preuninstall" package.json; then
-        # Use jq if available
-        if command -v jq >/dev/null 2>&1; then
-            jq '.scripts.preuninstall = ".author-card/show-card.sh --message \"感谢使用！\" --no-prompt"' package.json > package.json.tmp
-            mv package.json.tmp package.json
-        else
-            # Fallback: use pure bash/sed
-            # Check if scripts section exists
-            if grep -q '"scripts"' package.json; then
-                # Scripts section exists, add preuninstall
-                # Find the scripts section and add after opening brace
-                if sed --version >/dev/null 2>&1; then
-                    # GNU sed
-                    sed -i '/"scripts"[[:space:]]*:[[:space:]]*{/a\    "preuninstall": ".author-card/show-card.sh --message \\"感谢使用！\\" --no-prompt",' package.json
-                else
-                    # BSD sed (macOS)
-                    sed -i '' '/"scripts"[[:space:]]*:[[:space:]]*{/a\
-    "preuninstall": ".author-card/show-card.sh --message \\"感谢使用！\\" --no-prompt",
-' package.json
-                fi
-            else
-                # No scripts section, create one
-                # Insert before closing brace
-                if sed --version >/dev/null 2>&1; then
-                    # GNU sed
-                    sed -i '$i\  "scripts": {\n    "preuninstall": ".author-card/show-card.sh --message \\"感谢使用！\\" --no-prompt"\n  },' package.json
-                else
-                    # BSD sed (macOS)
-                    sed -i '' -e '$i\
-  "scripts": {\
-    "preuninstall": ".author-card/show-card.sh --message \\"感谢使用！\\" --no-prompt"\
-  },
-' package.json
-                fi
-            fi
-        fi
-    fi
-fi
-
 # Update .gitignore
 if [ ! -f ".gitignore" ]; then
     touch .gitignore