skill-author-card 1.6.1 → 1.6.3

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.3
 # Generated by: skill-author-card
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -16,6 +16,44 @@ truncate_str() {
     fi
 }
 
+state_slug() {
+    local raw="${REPO:-$SKILL_NAME}"
+    local slug
+    slug=$(printf "%s" "$raw" | tr '/: ' '---' | tr -cd '[:alnum:]._-')
+    if [ -z "$slug" ]; then
+        slug="skill-author-card"
+    fi
+    echo "$slug"
+}
+
+state_root_dir() {
+    if [ -n "$AUTHOR_CARD_STATE_DIR" ]; then
+        echo "$AUTHOR_CARD_STATE_DIR"
+        return 0
+    fi
+
+    if [ -n "$XDG_STATE_HOME" ]; then
+        echo "$XDG_STATE_HOME/author-card"
+        return 0
+    fi
+
+    if [ -n "$XDG_CONFIG_HOME" ]; then
+        echo "$XDG_CONFIG_HOME/author-card"
+        return 0
+    fi
+
+    echo "$HOME/.config/author-card"
+}
+
+shown_file_path() {
+    if [ -n "$AUTHOR_CARD_SHOWN" ]; then
+        echo "$AUTHOR_CARD_SHOWN"
+        return 0
+    fi
+
+    echo "$(state_root_dir)/shown/$(state_slug).shown"
+}
+
 # Parse arguments
 MESSAGE=""
 NO_PROMPT=false
@@ -33,7 +71,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.3"
 REPO="Yonsun-w/skill-author-card"
 NAME="yonsun_W"
 GITHUB="Yonsun-w"
@@ -51,9 +89,10 @@ SHOW_PROMOTION="true"
 # Exit early if frequency is "never"
 [ "$FREQUENCY" = "never" ] && exit 0
 
+SHOWN_FILE="$(shown_file_path)"
+
 # For "once" frequency, check if already shown
 if [ "$FREQUENCY" = "once" ]; then
-    SHOWN_FILE="$SCRIPT_DIR/.shown"
     if [ -f "$SHOWN_FILE" ]; then
         # Already shown, exit silently
         exit 0
@@ -105,7 +144,7 @@ echo "│                                                           │"
 
 # Message
 if [ -n "$MESSAGE" ]; then
-    printf "│  ⭐ %-50s │\n" "$MESSAGE"
+    printf "│  ⭐ %-50s │\n" "$(truncate_str "$MESSAGE" 50)"
 else
     [ -n "$REPO" ] && printf "│  ⭐ %-50s │\n" "喜欢？去 GitHub 点个 star！"
 fi
@@ -137,5 +176,6 @@ fi
 # ============================================================================
 
 if [ "$FREQUENCY" = "once" ]; then
-    touch "$SCRIPT_DIR/.shown"
+    mkdir -p "$(dirname "$SHOWN_FILE")"
+    touch "$SHOWN_FILE"
 fi

package/README.md

@@ -1,425 +1,162 @@
-<div align="center">
+# skill-author-card
 
-# ⚡ Skill Author Card
+给 skill 或项目源码注入一个本地作者卡片。  
+Inject a local author card into a skill or project source tree.
 
-**把每个 Skill 变成你的个人 IP 入口**
+它会在目标项目里生成 `.author-card/show-card.sh`，并把一条调用命令追加到目标 `SKILL.md` 或 `skill.md` 末尾。作者信息和 once 状态都保存在当前用户本机，不会写入远端服务，也不会污染项目仓库。  
+It generates `.author-card/show-card.sh` inside the target project and appends a command to the target `SKILL.md` or `skill.md`. Author data and once-state stay on the current user's machine, are not uploaded to any remote service, and do not pollute the project repository.
 
-[![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)
+## 功能 | Features
 
-*一个 Skill，1000 个潜在粉丝*
+- 初始化本地作者信息 / Initialize local author profile data
+- 给 skill 或项目源码注入作者卡片 / Inject an author card into a skill or project source tree
+- 自动读取 git remote 或项目元数据中的 GitHub 仓库地址 / Auto-detect the GitHub repository from git remote or project metadata
+- 支持 `Claude Code`、`Cursor`、`Windsurf`、`Codex` 和 generic shell 环境 / Support `Claude Code`, `Cursor`, `Windsurf`, `Codex`, and generic shell environments
 
-[快速开始](#-如何使用) • [真实案例](#-真实数据) • [安装](#第一步安装框架)
+## 安装 | Installation
 
-</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，并包含以下脚本。  
+After installation, the package exposes the `skill-author-card` CLI and includes these scripts:
 
----
+- `init-profile.sh`
+- `inject-to-skill.sh`
+- `show-card.sh`
 
-## 🚀 如何使用？
+## 快速开始 | Quick Start
 
-### 第一步：安装框架
+### 1. 初始化作者信息 | Initialize the author profile
 
 ```bash
-npm install -g skill-author-card
+init-profile.sh
 ```
 
-自动支持：
-- ✅ Claude Code
-- ✅ Cursor
-- ✅ Windsurf
-- ✅ Codex
+会在本地配置目录写入作者资料。常见位置如下。  
+This writes author data to a local config directory. Common locations:
 
-### 第二步：配置你的全平台信息
+- 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. 注入到目标项目 | Inject into a target project
 
+```bash
+inject-to-skill.sh /absolute/path/to/your-project
 ```
-"初始化我的作者信息"
-```
-
-会问你：
-- 姓名
-- GitHub
-- 小红书、抖音
-- Twitter、LinkedIn
-- 知乎、B站
-- 个人网站
-- ...
 
-### 第三步：给你的 Skill 添加
+注入器会执行以下操作。  
+The injector will:
 
-```
-"给 ~/projects/my-awesome-skill 添加 author card"
-```
+- 创建 `.author-card/show-card.sh` / Create `.author-card/show-card.sh`
+- 在目标 `SKILL.md` 或 `skill.md` 末尾添加 `Author Card` 段落 / Append an `Author Card` section to the target `SKILL.md` or `skill.md`
 
-框架自动：
-- ✅ 创建 `.author-card/` 目录
-- ✅ 嵌入全平台信息
-- ✅ 添加展示代码
-- ✅ 配置感谢信息
+它不会再修改目标项目的 `package.json`，也不会在目标项目里写入 once 状态文件。  
+It no longer modifies the target project's `package.json`, and it does not store once-state inside the target project.
 
-### 第四步：发布
+### 3. 预览卡片 | Preview the card
 
 ```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
 ```
 
-**完成！** 用户安装 → 使用 → 看到你 → 成为粉丝 🎉
-
----
-
-## 💡 为什么这么强大？
-
-### 🎯 精准流量
-
-<div align="center">
-
-| 流量来源 | 转化率 | 成本 |
-|---------|-------|------|
-| 随机推荐算法 | < 1% | 免费 |
-| 付费广告 | 2-5% | ¥¥¥ |
-| **Skill 用户** | **30%+** | **免费** ✨ |
+`--frequency always` 适合预览；默认注入命令使用 `--frequency once`，避免重复打扰用户。  
+Use `--frequency always` for previews. The injected command defaults to `--frequency once` to avoid repeatedly interrupting users.
 
-</div>
+## 生成后的调用 | Injected Command
 
-使用你 Skill 的人 = **对你的领域感兴趣的人**
+注入后的目标 skill 文件末尾会追加以下命令。  
+The target skill file will receive this command near the end:
 
-这是最精准的流量！
-
-### 🌊 复利效应
-
-```
-1 个 Skill → 500 用户 → 150 人访问 → 50 个粉丝
-
-3 个 Skill → 1500 用户 → 450 人访问 → 150 个粉丝
-
-6 个月后 → 5000 个粉丝 → 品牌合作找上门 💼
+```bash
+.author-card/show-card.sh --frequency once
 ```
 
-### 🔄 自动化增长
-
-你不需要：
-- ❌ 每天发内容
-- ❌ 做 SEO 优化
-- ❌ 买广告投放
+这条命令应该保留在主任务逻辑之后，让作者卡片只在任务成功完成后展示。  
+Keep this command after the main task logic so the author card only appears after the task succeeds.
 
-你只需要：
-- ✅ 做好 Skill
-- ✅ 加 Author Card
-- ✅ 用户自动来
+## Once 状态设计 | Once-State Design
 
-**这是被动收入的流量版本。** 💰
+`--frequency once` 的状态不再写入项目目录，也不会生成 `.author-card/.shown`。  
+The `--frequency once` state is no longer stored in the project tree, and it does not create `.author-card/.shown`.
 
----
+状态会写到当前用户的本地配置或状态目录，例如：  
+The state is written to the current user's local config/state directory, for example:
 
-## 🎁 真实卡片示例
+- `~/.config/author-card/shown/...`
+- `$XDG_STATE_HOME/author-card/shown/...`
+- 自定义环境变量 `AUTHOR_CARD_STATE_DIR` 或 `AUTHOR_CARD_SHOWN` / Custom `AUTHOR_CARD_STATE_DIR` or `AUTHOR_CARD_SHOWN`
 
-### Yonsun-w 的项目卡片
+这意味着你可以先在本机预览卡片，再把源码推到远端；其他用户下载、安装或打包后，仍然会在他们自己的机器上看到第一次展示。  
+This means you can preview the card locally before pushing. Other users who download, install, or package the project will still get their own first-time display on their own machines.
 
-<table>
-<tr>
-<td width="50%">
+## 仓库检测 | Repository Detection
 
-#### rush-find-skills（技术工具）
+作者卡片会优先从下面几种来源提取仓库地址。  
+The author card tries these sources in order:
 
-```
-┌──────────────────────────────────────┐
-│  📦 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 到小红书！            │
-└──────────────────────────────────────┘
-```
+1. `git remote get-url origin`
+2. `package.json.repository`
+3. `pyproject.toml`
+4. `Cargo.toml`
+5. `go.mod`
 
-</td>
-</tr>
-<tr>
-<td width="50%">
+如果没有检测到 GitHub 仓库，卡片仍然会生成，只是不会显示仓库链接。  
+If no GitHub repository is detected, the card is still generated, but the repository link is omitted.
 
-#### openclaw-wechat（自动化工具）
+## 示例输出 | Example Output
 
-```
-┌──────────────────────────────────────┐
-│  📦 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%">
+## 开发 | Development
 
-#### multi-repo-dev（开发工具）
+运行测试：  
+Run the test suite:
 
-```
-┌──────────────────────────────────────┐
-│  📦 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>
+当前测试覆盖以下内容。  
+The current test suite covers:
 
----
+- 注入命令是否正确写入目标 `SKILL.md` / Whether the injected command is written correctly to the target `SKILL.md`
+- 平台与配置路径检测 / Platform and config path detection
+- `show-card.sh` 对对象格式 `package.json.repository` 的解析 / Parsing object-style `package.json.repository` values in `show-card.sh`
+- once 状态不会写回目标项目目录 / Ensuring once-state is not written back into the target project tree
+- npm 打包不会带上本地 once 状态文件 / Ensuring npm packages do not include local once-state artifacts
 
-## 🎯 三步开始
+## 发布 | Release
 
-<div align="center">
+发布前建议执行：  
+Recommended steps before publishing:
 
-### 1️⃣ 安装
 ```bash
-npm install -g skill-author-card
-```
-
-### 2️⃣ 配置
-```
-"初始化我的全平台信息"
-```
-
-### 3️⃣ 添加
+npm test
+git status
+git push origin main
+npm publish --access public
 ```
-"给 ~/my-skill 添加 author card"
-```
-
-**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` 已存在的稳定版本。  
+If older versions should no longer be used, prefer `npm deprecate` instead of unpublishing stable versions.
 
-[![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"
             ;;