skill-author-card 1.6.2 → 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.6.2
+# 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.2"
+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,37 +1,41 @@
 # skill-author-card
 
-给 skill 或项目源码注入一个本地作者卡片。
+给 skill 或项目源码注入一个本地作者卡片。  
+Inject a local author card into a skill or project source tree.
 
-它会在目标项目里生成 `.author-card/show-card.sh`，并把一条调用命令追加到目标 `SKILL.md` 或 `skill.md` 末尾。作者信息保存在本机，不会写入远端服务。
+它会在目标项目里生成 `.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.
 
-## 功能
+## 功能 | Features
 
-- 初始化本地作者信息
-- 给 skill 或项目源码注入作者卡片
-- 自动读取 git remote 或项目元数据中的 GitHub 仓库地址
-- 支持 `Claude Code`、`Cursor`、`Windsurf`、`Codex` 和 generic shell 环境
+- 初始化本地作者信息 / 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
 
 ```bash
 npm install -g skill-author-card
 ```
 
-安装后会暴露 `skill-author-card` CLI，并包含以下脚本：
+安装后会暴露 `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. 初始化作者信息
+### 1. 初始化作者信息 | Initialize the author profile
 
 ```bash
 init-profile.sh
 ```
 
-会在本地配置目录写入作者资料。常见位置：
+会在本地配置目录写入作者资料。常见位置如下。  
+This writes author data to a local config directory. Common locations:
 
 - Claude Code: `~/.claude/skills/.author-profile.json`
 - Cursor: `~/.cursor/.author-profile.json`
@@ -39,41 +43,61 @@ init-profile.sh
 - Codex: `~/.codex/.author-profile.json`
 - Generic: `~/.config/author-card/profile.json`
 
-### 2. 注入到目标项目
+### 2. 注入到目标项目 | Inject into a target project
 
 ```bash
 inject-to-skill.sh /absolute/path/to/your-project
 ```
 
-注入器会：
+注入器会执行以下操作。  
+The injector will:
 
-- 创建 `.author-card/show-card.sh`
-- 在目标 `SKILL.md` 或 `skill.md` 末尾添加 `Author Card` 段落
-- 向目标 `.gitignore` 追加 `.author-card/.shown`
+- 创建 `.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`
 
-它不会再修改目标项目的 `package.json`。
+它不会再修改目标项目的 `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. 预览卡片
+### 3. 预览卡片 | Preview the card
 
 ```bash
 /absolute/path/to/your-project/.author-card/show-card.sh --no-prompt --frequency always
 ```
 
-`--frequency always` 适合预览；默认注入命令使用 `--frequency once`，避免重复打扰用户。
+`--frequency always` 适合预览；默认注入命令使用 `--frequency once`，避免重复打扰用户。  
+Use `--frequency always` for previews. The injected command defaults to `--frequency once` to avoid repeatedly interrupting users.
 
-## 生成后的调用
+## 生成后的调用 | Injected Command
 
-注入后的目标 skill 文件末尾会追加：
+注入后的目标 skill 文件末尾会追加以下命令。  
+The target skill file will receive this command near the end:
 
 ```bash
 .author-card/show-card.sh --frequency once
 ```
 
-这条命令应该保留在主任务逻辑之后，让作者卡片只在任务成功完成后展示。
+这条命令应该保留在主任务逻辑之后，让作者卡片只在任务成功完成后展示。  
+Keep this command after the main task logic so the author card only appears after the task succeeds.
 
-## 仓库检测
+## 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`
+
+这意味着你可以先在本机预览卡片，再把源码推到远端；其他用户下载、安装或打包后，仍然会在他们自己的机器上看到第一次展示。  
+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.
+
+## 仓库检测 | Repository Detection
+
+作者卡片会优先从下面几种来源提取仓库地址。  
+The author card tries these sources in order:
 
 1. `git remote get-url origin`
 2. `package.json.repository`
@@ -81,9 +105,10 @@ inject-to-skill.sh /absolute/path/to/your-project
 4. `Cargo.toml`
 5. `go.mod`
 
-如果没有检测到 GitHub 仓库，卡片仍然会生成，只是不会显示仓库链接。
+如果没有检测到 GitHub 仓库，卡片仍然会生成，只是不会显示仓库链接。  
+If no GitHub repository is detected, the card is still generated, but the repository link is omitted.
 
-## 示例输出
+## 示例输出 | Example Output
 
 ```text
 ┌─────────────────────────────────────────────────────────┐
@@ -99,23 +124,28 @@ inject-to-skill.sh /absolute/path/to/your-project
 └─────────────────────────────────────────────────────────┘
 ```
 
-## 开发
+## 开发 | Development
 
-运行测试：
+运行测试：  
+Run the test suite:
 
 ```bash
 npm test
 ```
 
-当前测试覆盖：
+当前测试覆盖以下内容。  
+The current test suite covers:
 
-- 注入命令是否正确写入目标 `SKILL.md`
-- 平台与配置路径检测
-- `show-card.sh` 对对象格式 `package.json.repository` 的解析
+- 注入命令是否正确写入目标 `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
 
-发布前建议：
+发布前建议执行：  
+Recommended steps before publishing:
 
 ```bash
 npm test
@@ -124,7 +154,8 @@ git push origin main
 npm publish --access public
 ```
 
-如果旧版本不再推荐使用，优先用 `npm deprecate` 标记，不要随意 `unpublish` 已存在的稳定版本。
+如果旧版本不再推荐使用，优先用 `npm deprecate` 标记，不要随意 `unpublish` 已存在的稳定版本。  
+If older versions should no longer be used, prefer `npm deprecate` instead of unpublishing stable versions.
 
 ## License
 

package/inject-to-skill.sh

@@ -272,28 +272,31 @@ fi
 echo ""
 
 # Update .gitignore
-if [ ! -f ".gitignore" ]; then
-    touch .gitignore
-fi
-
-# Remove old config.json ignore rule if it exists
-if grep -q ".author-card/config.json" .gitignore 2>/dev/null; then
-    if sed --version >/dev/null 2>&1; then
-        sed -i '/.author-card\/config.json/d; /# Author card local config/d' .gitignore
-    else
-        sed -i '' -e '/.author-card\/config.json/d' -e '/# Author card local config/d' .gitignore
+if [ -f ".gitignore" ]; then
+    # Remove legacy rules from older versions. Once-state now lives in a
+    # user-level config/state directory rather than in the project tree.
+    if grep -q ".author-card/config.json" .gitignore 2>/dev/null || grep -q ".author-card/.shown" .gitignore 2>/dev/null; then
+        if sed --version >/dev/null 2>&1; then
+            sed -i \
+                -e '/.author-card\/config.json/d' \
+                -e '/.author-card\/.shown/d' \
+                -e '/# Author card local config/d' \
+                -e '/# Author card shown state (user-specific)/d' \
+                .gitignore
+        else
+            sed -i '' \
+                -e '/.author-card\/config.json/d' \
+                -e '/.author-card\/.shown/d' \
+                -e '/# Author card local config/d' \
+                -e '/# Author card shown state (user-specific)/d' \
+                .gitignore
+        fi
     fi
 fi
 
-# Add .shown file to gitignore (user-specific state)
-if ! grep -q ".author-card/.shown" .gitignore 2>/dev/null; then
-    echo "" >> .gitignore
-    echo "# Author card shown state (user-specific)" >> .gitignore
-    echo ".author-card/.shown" >> .gitignore
-fi
-
 echo ""
 success "完成! Author card 已添加到 $SKILL_NAME"
 echo ""
+info "once 状态会写入当前用户的配置目录，不会污染项目仓库或打包产物"
 info "下一步: git add . && git commit -m 'feat: add author card' && git push"
 echo ""

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "skill-author-card",
-  "version": "1.6.2",
-  "description": "把每个 Skill 变成你的个人 IP 入口。展示小红书/抖音/Twitter/B站等全平台信息，精准流量转化 30%+。内容创作者和独立开发者的个人品牌增长引擎。",
+  "version": "1.6.3",
+  "description": "给 skill 或项目源码注入本地作者卡片 / Inject a local author card into a skill or project source tree.",
   "main": "skill.md",
   "scripts": {
     "postinstall": "node postinstall.js",
@@ -38,7 +38,7 @@
   "files": [
     "SKILL.md",
     "skill.md",
-    ".author-card",
+    ".author-card/show-card.sh",
     "bin",
     "postinstall.js",
     "preuninstall.js",

package/skill.md

@@ -1,73 +1,83 @@
 ---
 name: skill-author-card
-description: Add an author card to a skill or project source tree. Use when the user wants to inject an author card, initialize author profile data, or preview the generated card.
+description: Add an author card to a skill or project source tree. Use when the user wants to inject an author card, initialize author profile data, or preview the generated card. 支持中文和英文场景。
 ---
 
 # Skill Author Card
 
-Use this skill when the user wants to:
+Use this skill when the user wants to add an author card to a skill or project source tree.  
+当用户想给 skill 或项目源码添加作者卡片时，使用这个 skill。
 
-- initialize local author profile data
-- inject an author card into a skill or project source directory
-- preview the generated card before committing changes
+- initialize local author profile data / 初始化本地作者资料
+- inject an author card into a skill or project source directory / 向 skill 或项目源码目录注入作者卡片
+- preview the generated card before committing changes / 在提交前预览生成的卡片
 
-This skill edits source trees. Work on the user's checked-out project, not on already-installed skills unless they explicitly ask for that.
+This skill edits source trees. Work on the user's checked-out project, not on already-installed skills unless they explicitly ask for that.  
+这个 skill 作用于源码目录。除非用户明确要求，否则不要修改已经安装好的 skill。
 
 ## Workflow
 
-### 1. Resolve the target
+### 1. Resolve the target | 确定目标目录
 
-- If the user gave an absolute or relative path, use it.
-- If they only gave a project name, inspect the current workspace for a matching directory first.
-- If multiple matches remain or the target is still ambiguous, ask one concise question before editing.
+- If the user gave an absolute or relative path, use it. / 如果用户给了绝对路径或相对路径，直接使用。
+- If they only gave a project name, inspect the current workspace for a matching directory first. / 如果只给了项目名，先在当前工作区查找匹配目录。
+- If multiple matches remain or the target is still ambiguous, ask one concise question before editing. / 如果仍然有多个候选或目标不明确，编辑前只问一个简短问题。
 
-### 2. Initialize author profile when missing
+### 2. Initialize author profile when missing | 缺失时初始化作者资料
 
-Run the bundled initializer from this skill directory:
+Run the bundled initializer from this skill directory.  
+从当前 skill 目录运行内置初始化脚本：
 
 ```bash
 ./init-profile.sh
 ```
 
-Only do this when the author profile file does not already exist or the user explicitly asks to reset it.
+Only do this when the author profile file does not already exist or the user explicitly asks to reset it.  
+仅在作者资料文件不存在，或用户明确要求重置时执行。
 
-### 3. Inject the author card
+### 3. Inject the author card | 注入作者卡片
 
-Run the injector against the target source directory:
+Run the injector against the target source directory.  
+对目标源码目录执行注入脚本：
 
 ```bash
 ./inject-to-skill.sh /absolute/path/to/target
 ```
 
-The injector will:
+The injector will:  
+注入器会：
 
-- create `.author-card/show-card.sh` inside the target project
-- append an `Author Card` section to the target `SKILL.md` or `skill.md`
-- add `.author-card/.shown` to the target `.gitignore`
+- create `.author-card/show-card.sh` inside the target project / 在目标项目内创建 `.author-card/show-card.sh`
+- append an `Author Card` section to the target `SKILL.md` or `skill.md` / 在目标 `SKILL.md` 或 `skill.md` 末尾追加 `Author Card` 段落
 
-It should not modify unrelated files such as `package.json`.
+It should not modify unrelated files such as `package.json`, and it should not store once-state inside the target project.  
+不要修改 `package.json` 之类的无关文件，也不要把 once 状态写进目标项目目录。
 
-### 4. Preview the result
+### 4. Preview the result | 预览结果
 
-After injection, preview the generated card directly from the target project:
+After injection, preview the generated card directly from the target project.  
+注入完成后，直接在目标项目内预览生成的卡片：
 
 ```bash
 /absolute/path/to/target/.author-card/show-card.sh --no-prompt --frequency always
 ```
 
-Use `--frequency always` for previews so the card still renders after a previous run.
+Use `--frequency always` for previews so the card still renders after a previous run.  
+预览时使用 `--frequency always`，这样即使之前展示过也还能再次渲染。
 
-### 5. Report the exact outcome
+### 5. Report the exact outcome | 明确反馈结果
 
-Tell the user:
+Tell the user:  
+向用户说明：
 
-- which directory was modified
-- which files were created or changed
-- whether repository metadata was detected automatically
-- any follow-up they may want, such as reviewing the diff or committing the change
+- which directory was modified / 修改了哪个目录
+- which files were created or changed / 创建或修改了哪些文件
+- whether repository metadata was detected automatically / 是否自动识别到了仓库元数据
+- any follow-up they may want, such as reviewing the diff or committing the change / 用户接下来可能要做的事，比如看 diff 或提交改动
 
 ## Notes
 
-- Keep the author card call at the end of the target skill file so it runs only after the main task succeeds.
-- Prefer the bundled scripts in this skill directory. Do not rewrite the injection logic manually unless the scripts fail and need patching.
-- If repository detection fails, still inject the card and tell the user the GitHub link will be omitted until the target project has git or package metadata.
+- Keep the author card call at the end of the target skill file so it runs only after the main task succeeds. / 把作者卡片调用保留在目标 skill 文件末尾，确保主任务成功后再展示。
+- Prefer the bundled scripts in this skill directory. Do not rewrite the injection logic manually unless the scripts fail and need patching. / 优先使用当前 skill 自带脚本；除非脚本失效需要修补，否则不要手写重做注入逻辑。
+- If repository detection fails, still inject the card and tell the user the GitHub link will be omitted until the target project has git or package metadata. / 如果仓库检测失败，仍然要完成注入，并告知用户在目标项目补齐 git 或包元数据前不会显示 GitHub 链接。
+- The once-state must live in a user-level config or state directory so packaged downstream skills remain safe for other users. / once 状态必须保存在用户级配置或状态目录里，这样被注入后的其他 skill 再打包分发时也不会影响别的用户。

package/templates/show-card-standalone.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Standalone Author Card - Bundled with your skill, no external dependencies
-# Version: 1.6.2
+# 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
@@ -51,9 +89,10 @@ SHOW_PROMOTION="__SHOW_PROMOTION__"
 # 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
@@ -137,5 +176,6 @@ fi
 # ============================================================================
 
 if [ "$FREQUENCY" = "once" ]; then
-    touch "$SCRIPT_DIR/.shown"
+    mkdir -p "$(dirname "$SHOWN_FILE")"
+    touch "$SHOWN_FILE"
 fi