harveyz-skill 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-06-09
+
+### Added
+- `url-extract`：新增 `detect_chrome_profile.py` 脚本，扫描本机 Chrome profile 并检测 X.com 登录态
+- `url-extract`：安装时 `CHROME_PROFILE` 变量改为 select 选择列表（自动列出所有 profile + 对应 Google 账号），保留手动输入兜底
+- `hskill`：安装/卸载完成后新增 "按 Enter 返回列表" 提示，避免 summary 被 fzf 立即覆盖
+
+### Changed
+- `url-extract` `vars.json`：`CHROME_PROFILE` 默认值从 `Profile 2` 更新为 `Default`
+
+## [0.11.0] - 2026-06-09
+
+### Added
+- `hskill list`：新增 Bundle 列并按 bundle 名称排序（替换旧的分组标题格式）；`hskill status` skills 列表同步增加 Bundle 列
+
+### Changed
+- `hskill` 内部重构：平台列表从 `SKILL_TARGETS` 单一来源派生，消除 `bundles.js` / `preview.mjs` 中的硬编码数组
+
+### Fixed
+- `url-extract`：移除 `SKILL_DIR` 用户配置变量
+- `preview`：安装状态侧边栏补全 openclaw、hermes 平台（USER LEVEL）
+- `npm-release`：中间步骤跳过 push 操作，最终统一给出推送 + 发布指令清单
+
 ## [0.10.0] - 2026-06-08
 
 ### Added

package/bin/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { select } from '@inquirer/prompts'
+import { select, input } from '@inquirer/prompts'
 import chalk from 'chalk'
 import { execSync, spawnSync } from 'child_process'
 import { createRequire } from 'module'
@@ -158,29 +158,31 @@ if (subcommand === 'update') {
 
 // ── List ─────────────────────────────────────────────────────────────────────
 if (subcommand === 'list') {
-  const { bundleMeta, skills, tools = [] } = require('../skills-index.json')
-  const byBundle = {}
-  for (const s of skills) {
-    if (!byBundle[s.bundle]) byBundle[s.bundle] = []
-    byBundle[s.bundle].push(s.path)
-  }
+  const { skills, tools = [] } = require('../skills-index.json')
+  const sorted = [...skills].sort((a, b) => a.bundle.localeCompare(b.bundle) || a.path.split('/').pop().localeCompare(b.path.split('/').pop()))
   if (jsonFlag) {
-    const bundles = {}
-    for (const [name, paths] of Object.entries(byBundle)) {
-      bundles[name] = { description: bundleMeta[name] ?? name, skills: paths }
-    }
-    console.log(JSON.stringify({ bundles, tools: tools.map(t => t.name) }, null, 2))
+    console.log(JSON.stringify({
+      skills: sorted.map(s => ({ name: s.path.split('/').pop(), path: s.path, bundle: s.bundle })),
+      tools: tools.map(t => t.name),
+    }, null, 2))
     process.exit(0)
   }
-  for (const [name, paths] of Object.entries(byBundle)) {
-    console.log(chalk.bold(name) + ' — ' + (bundleMeta[name] ?? name))
-    for (const p of paths) console.log('  ' + p)
+  const nw = Math.max(...sorted.map(s => s.path.split('/').pop().length), 4)
+  const bw = Math.max(...sorted.map(s => s.bundle.length), 6)
+  const sep = chalk.dim('  ' + '─'.repeat(nw + bw + 4))
+  console.log('')
+  console.log('  ' + chalk.bold('NAME'.padEnd(nw)) + '  ' + chalk.bold('BUNDLE'))
+  console.log(sep)
+  for (const s of sorted) {
+    console.log('  ' + s.path.split('/').pop().padEnd(nw) + '  ' + chalk.dim(s.bundle))
   }
   if (tools.length > 0) {
     console.log('')
-    console.log(chalk.bold('shell tools:'))
+    console.log('  ' + chalk.bold('SHELL TOOLS'))
+    console.log(sep)
     for (const t of tools) console.log('  ' + t.name)
   }
+  console.log('')
   process.exit(0)
 }
 
@@ -208,11 +210,11 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   const skillRows = skillItems.map(s => {
     const inst = checkInstalled(s.skillName, s.version ?? '—')
     return {
-      name: s.skillName, version: s.version ?? '—',
+      name: s.skillName, bundle: s.bundle ?? '—', version: s.version ?? '—',
       userStatus: scopeSummary(inst.user), projectStatus: scopeSummary(inst.project),
       userDetail: inst.user, projectDetail: inst.project,
     }
-  })
+  }).sort((a, b) => a.bundle.localeCompare(b.bundle) || a.name.localeCompare(b.name))
   const toolRows = toolItems.map(t => {
     const inst = checkToolInstalled(t.toolName, t.srcPath)
     return { name: t.toolName, version: t.version ?? '—', ...inst }
@@ -285,15 +287,16 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   const allVers  = [...skillRows, ...toolRows].map(r => r.version)
   const nw = Math.max(...allNames.map(n => n.length), 4)
   const vw = Math.max(...allVers.map(v => v.length), 7)
-  const sep = chalk.dim('  ' + '─'.repeat(nw + vw + 20))
+  const bw = Math.max(...skillRows.map(r => r.bundle.length), 6)
+  const sep = chalk.dim('  ' + '─'.repeat(nw + vw + bw + 22))
 
   console.log('')
   console.log('  ' + chalk.bold('SKILLS') + chalk.dim(`  — ${skillRows.length} available`))
   console.log(sep)
-  console.log('  ' + ''.padEnd(nw + vw + 3) + chalk.dim('user    project'))
+  console.log('  ' + ''.padEnd(nw + vw + bw + 5) + chalk.dim('user    project'))
   for (const r of skillRows) {
     const u = icon(r.userStatus), p = icon(r.projectStatus)
-    console.log('  ' + r.name.padEnd(nw) + '  ' + chalk.dim(r.version.padEnd(vw)) + '  ' + u + '       ' + p)
+    console.log('  ' + r.name.padEnd(nw) + '  ' + chalk.dim(r.version.padEnd(vw)) + '  ' + chalk.dim(r.bundle.padEnd(bw)) + '  ' + u + '       ' + p)
   }
 
   console.log('')
@@ -1066,6 +1069,8 @@ try {
       // In test mode with HSKILL_TEST_ACTION, run once and exit
       if (process.env.HSKILL_TEST_ACTION) break
 
+      if (process.stdout.isTTY) await input({ message: chalk.dim('按 Enter 返回列表…'), default: '' })
+
       // Loop back to skill selector automatically
     }
 

package/bin/preview.mjs

@@ -3,6 +3,7 @@ import fs from 'fs'
 import os from 'os'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { SKILL_TARGETS, USER_ONLY_TARGETS } from '../lib/targets.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
@@ -72,10 +73,11 @@ function statusLine(version, status) {
   return ver + '  ' + D + '— not installed' + R
 }
 
-const targets = ['claude', 'cursor', 'codex']
+const userTargets    = SKILL_TARGETS
+const projectTargets = SKILL_TARGETS.filter(t => !USER_ONLY_TARGETS.has(t))
 const home    = os.homedir()
 
-function checkScope(dirFn) {
+function checkScope(targets, dirFn) {
   return targets.map(t => {
     const ver    = readVersion(path.join(dirFn(t), skillName))
     const status = ver === '—' ? 'none'
@@ -86,10 +88,10 @@ function checkScope(dirFn) {
 }
 
 const cwd = process.cwd()
-const userDetails    = checkScope(t => path.join(home, `.${t}`, 'skills'))
+const userDetails    = checkScope(userTargets,    t => path.join(home, `.${t}`, 'skills'))
 const projectDetails = cwd === home
-  ? targets.map(t => ({ tool: t, version: '—', status: 'none' }))
-  : checkScope(t => path.join(cwd, `.${t}`, 'skills'))
+  ? projectTargets.map(t => ({ tool: t, version: '—', status: 'none' }))
+  : checkScope(projectTargets, t => path.join(cwd, `.${t}`, 'skills'))
 
 console.log(B + skillName + R)
 console.log(D + 'available: ' + R + availableVersion)

package/lib/bundles.js

@@ -3,7 +3,7 @@ import os from 'os'
 import { createRequire } from 'module'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { USER_ONLY_TARGETS } from './targets.js'
+import { SKILL_TARGETS, USER_ONLY_TARGETS } from './targets.js'
 
 const require = createRequire(import.meta.url)
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -101,13 +101,14 @@ export function buildAllChoices() {
   return choices
 }
 
-// 所有 skill 展开为 { kind:'skill', skillName, srcPath } 列表（对应 all 选项）
+// 所有 skill 展开为 { kind:'skill', skillName, bundle, srcPath } 列表（对应 all 选项）
 export function getAllSkillItems() {
   return skillDefs.map(skill => {
     const srcPath = path.join(skillsRoot, skill.path)
     return {
       kind: 'skill',
       skillName: skill.path.split('/').pop(),
+      bundle: skill.bundle,
       srcPath,
       version: readVersion(srcPath),
     }
@@ -132,7 +133,7 @@ export function getAllToolItems() {
 // 每个工具: { version: string, status: 'up-to-date'|'update'|'none' }
 export function checkInstalled(skillName, availableVersion) {
   const home = os.homedir()
-  const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+  const targets = SKILL_TARGETS
 
   function checkScope(dirFn) {
     const result = {}

package/lib/targets.js

@@ -1,7 +1,7 @@
 import os from 'os'
 import path from 'path'
 
-const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
 
 export const USER_ONLY_TARGETS = new Set(['openclaw', 'hermes'])
 

package/lib/vars.js

@@ -2,7 +2,7 @@
 import fs from 'fs-extra'
 import path from 'path'
 import os from 'os'
-import { input } from '@inquirer/prompts'
+import { input, select } from '@inquirer/prompts'
 
 export function buildAutoVars() {
   return { HOME: os.homedir() }
@@ -20,10 +20,49 @@ export function substituteVars(text, varsMap) {
   return text.replace(/\{\{(\w+)\}\}/g, (_, name) => varsMap[name] ?? `{{${name}}}`)
 }
 
+async function detectChromeProfiles() {
+  const chromeBase = path.join(os.homedir(), 'Library/Application Support/Google/Chrome')
+  if (!await fs.pathExists(chromeBase)) return []
+
+  const entries = await fs.readdir(chromeBase)
+  const profileDirs = entries.filter(e => e === 'Default' || e.startsWith('Profile '))
+  profileDirs.sort((a, b) => (a === 'Default' ? -1 : b === 'Default' ? 1 : a.localeCompare(b)))
+
+  const profiles = []
+  for (const name of profileDirs) {
+    const dir = path.join(chromeBase, name)
+    let email = ''
+    try {
+      const prefs = await fs.readJson(path.join(dir, 'Preferences'))
+      const accounts = prefs.account_info ?? []
+      email = accounts[0]?.email ?? prefs.user_name ?? ''
+    } catch { /* unreadable */ }
+    profiles.push({ name, dir, email })
+  }
+  return profiles
+}
+
 export async function resolveVars(varDefs = [], autoVars) {
   const result = { ...autoVars }
   for (const def of varDefs) {
     const defaultVal = substituteVars(def.default ?? '', autoVars)
+
+    if (def.type === 'chrome_profile_select') {
+      const profiles = await detectChromeProfiles()
+      if (profiles.length > 0) {
+        const choices = profiles.map(p => ({
+          name: p.email ? `${p.name}  (${p.email})` : p.name,
+          value: p.dir,
+        }))
+        choices.push({ name: '手动输入路径…', value: '__manual__' })
+        const selected = await select({ message: `${def.description}:`, choices })
+        if (selected !== '__manual__') {
+          result[def.name] = selected
+          continue
+        }
+      }
+    }
+
     const value = await input({
       message: `${def.description}:`,
       default: defaultVal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -27,8 +27,8 @@
     "skills/superpowers-fork/writing-plans/",
     "skills/task/pm-task-dispatch/",
     "skills/task/task-close/",
-    "skills/web-fetch/article-fetcher/",
-    "skills/web-fetch/url-extract/",
+    "skills/data-extraction/article-fetcher/",
+    "skills/data-extraction/url-extract/",
     "skills/data-extraction/vision-extract/",
     "skills/writing/mermaid-diagram/",
     "skills/design/sync-design-html/",

package/skills/{web-fetch → data-extraction}/url-extract/platforms/SKILL.claude.md

@@ -25,7 +25,6 @@ sessions_spawn \
 | 抽象变量 | 实际语法 |
 |----------|----------|
 | `VAULT_PATH` | `{{VAULT_PATH}}` |
-| `SKILL_DIR` | `{{SKILL_DIR}}` |
 | `CHROME_PROFILE` | `{{CHROME_PROFILE}}` |
 
-执行 SKILL.md 中的代码时，将所有 `VAULT_PATH`、`SKILL_DIR`、`CHROME_PROFILE` 占位替换为对应的 `{{变量名}}`，由 vars.json 注入实际值。
+`SKILL_DIR` 由平台自动提供，无需用户配置：值固定为 `$HOME/.claude/skills/url-extract`（Claude Code skill 的标准安装路径）。执行代码时直接将 `SKILL_DIR` 替换为该路径。

package/skills/{web-fetch → data-extraction}/url-extract/platforms/SKILL.codex.md

@@ -14,4 +14,6 @@
 
 ## ③ 变量注入
 
-通过环境变量或 Codex 平台的变量系统注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`SKILL_DIR`、`CHROME_PROFILE` 占位。
+通过环境变量或 Codex 平台的变量系统注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`CHROME_PROFILE` 占位。
+
+`SKILL_DIR` 由平台自动提供，无需用户配置：值为 Codex 安装本 skill 的目录（即包含 `scripts/` 的那一级目录）。

package/skills/{web-fetch → data-extraction}/url-extract/platforms/SKILL.hermes.md

@@ -14,4 +14,6 @@
 
 ## ③ 变量注入
 
-通过 Hermes vars.json 或环境变量注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`SKILL_DIR`、`CHROME_PROFILE` 占位。
+通过 Hermes vars.json 或环境变量注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`CHROME_PROFILE` 占位。
+
+`SKILL_DIR` 由平台自动提供，无需用户配置：值为 Hermes 安装本 skill 的目录（即包含 `scripts/` 的那一级目录）。

package/skills/data-extraction/url-extract/scripts/detect_chrome_profile.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+"""
+检测哪个 Chrome profile 登录了 X.com (Twitter)。
+用法: python3 detect_chrome_profile.py
+"""
+import os
+import shutil
+import sqlite3
+import tempfile
+import json
+from pathlib import Path
+
+CHROME_BASE = Path.home() / "Library/Application Support/Google/Chrome"
+XCOM_HOSTS = [".twitter.com", ".x.com"]
+AUTH_COOKIES = {"auth_token", "ct0", "twid"}
+
+
+def get_profile_email(profile_dir: Path) -> str:
+    prefs = profile_dir / "Preferences"
+    try:
+        data = json.loads(prefs.read_text(errors="ignore"))
+        accounts = data.get("account_info", [])
+        if accounts:
+            return accounts[0].get("email", "")
+        return data.get("user_name", "")
+    except Exception:
+        return ""
+
+
+def check_xcom_cookies(profile_dir: Path) -> dict:
+    """返回在 X.com 找到的 auth cookie 名称集合（不解密，只检查存在性）"""
+    cookies_db = profile_dir / "Cookies"
+    if not cookies_db.exists():
+        return {}
+
+    # 复制到 /tmp 避免 Chrome 锁文件冲突
+    with tempfile.NamedTemporaryFile(suffix=".db", delete=False) as f:
+        tmp_path = f.name
+    try:
+        shutil.copy2(cookies_db, tmp_path)
+        conn = sqlite3.connect(tmp_path)
+        conn.row_factory = sqlite3.Row
+        cur = conn.cursor()
+        cur.execute(
+            "SELECT name, host_key FROM cookies WHERE host_key IN ({})".format(
+                ",".join("?" * len(XCOM_HOSTS))
+            ),
+            XCOM_HOSTS,
+        )
+        rows = cur.fetchall()
+        conn.close()
+        found = {row["name"] for row in rows}
+        return found
+    except Exception as e:
+        return {"_error": str(e)}
+    finally:
+        os.unlink(tmp_path)
+
+
+def main():
+    if not CHROME_BASE.exists():
+        print("未找到 Chrome 目录:", CHROME_BASE)
+        return
+
+    profiles = sorted(
+        [d for d in CHROME_BASE.iterdir() if d.is_dir() and (d.name == "Default" or d.name.startswith("Profile"))],
+        key=lambda d: (d.name != "Default", d.name),
+    )
+
+    print(f"{'Profile':<12} {'账号':<38} {'X.com cookies':<30} {'推荐'}")
+    print("-" * 95)
+
+    best = None
+    for p in profiles:
+        email = get_profile_email(p) or "(未登录 Google)"
+        cookies = check_xcom_cookies(p)
+
+        if "_error" in cookies:
+            status = f"[错误: {cookies['_error'][:40]}]"
+            has_auth = False
+        else:
+            auth_found = AUTH_COOKIES & cookies
+            has_auth = bool(auth_found)
+            all_found = cookies
+            if all_found:
+                status = ", ".join(sorted(all_found))
+            else:
+                status = "(无 X.com cookie)"
+
+        recommend = "<-- 推荐" if has_auth and best is None else ""
+        if has_auth and best is None:
+            best = p
+
+        print(f"{p.name:<12} {email:<38} {status:<30} {recommend}")
+
+    print()
+    if best:
+        print(f"建议 CHROME_PROFILE 设置为：")
+        print(f"  {best}")
+    else:
+        print("未在任何 profile 中找到 X.com auth_token，请先在 Chrome 中登录 X.com。")
+
+
+if __name__ == "__main__":
+    main()

package/skills/{web-fetch → data-extraction}/url-extract/vars.json

@@ -4,14 +4,10 @@
     "description": "Obsidian Reading 目录完整路径（例如 /Users/you/Vault/Product/Reading）",
     "default": "{{HOME}}/Vault/Product/Reading"
   },
-  {
-    "name": "SKILL_DIR",
-    "description": "url-extract skill 安装后的完整路径（用于定位辅助脚本和数据库文件）",
-    "default": "{{HOME}}/.claude/skills/url-extract"
-  },
   {
     "name": "CHROME_PROFILE",
-    "description": "Chrome 用户配置目录（X.com 登录态所需）。macOS 默认：~/Library/Application Support/Google/Chrome/Profile 2",
-    "default": "{{HOME}}/Library/Application Support/Google/Chrome/Profile 2"
+    "description": "Chrome 用户配置目录（X.com 登录态所需）",
+    "type": "chrome_profile_select",
+    "default": "{{HOME}}/Library/Application Support/Google/Chrome/Default"
   }
 ]

package/skills/meta/npm-release/SKILL.md

@@ -2,12 +2,14 @@
 name: npm-release
 description: "Complete npm publish workflow for harveyz-skill: bump version, update CHANGELOG, create release branch, merge to staging then main, tag, and publish to npm. Use this skill whenever the user wants to release, publish, cut a version, bump version, ship to npm, or deploy a new package version."
 user_invocable: true
-version: "1.0.0"
+version: "1.1.0"
 ---
 
 # npm-release
 
-harveyz-skill 发布到 npm 的完整流程：版本号升级 → CHANGELOG 更新 → 分支提交 → 合并到 staging → 合并到 main → 打 tag → npm publish。
+harveyz-skill 发布到 npm 的完整流程：版本号升级 → CHANGELOG 更新 → 分支提交 → 本地合并到 staging 和 main → 打 tag → 给出推送 + 发布指令供用户执行。
+
+**说明**：所有 `git push` 和 `npm publish` 操作由用户自行执行，Claude 只做本地操作，最后统一给出指令清单。
 
 ---
 
@@ -111,44 +113,66 @@ git commit -m "chore(release): bump version to <new-version>"
 
 ---
 
-## Step 5 — 合并到 staging
+## Step 5 — 本地合并到 staging（不推送）
 
 ```bash
 git checkout staging
 git merge release/<new-version>
-git push origin staging
 ```
 
+只做本地合并，不执行 push。
+
 ---
 
-## Step 6 — 合并到 main 并打 tag
+## Step 6 — 本地合并到 main 并打 tag（不推送）
 
 ```bash
 git checkout main
-git pull origin main
+git pull origin main          # 只拉取，确保本地 main 是最新的
 git merge staging
 git tag -a v<new-version> -m "v<new-version>"
-git push origin main
-git push origin v<new-version>
 ```
 
 tag 使用 annotated tag（`-a`），符合项目 workflow-config.yml 的 `require_annotated: true` 规则。
 
+**不执行任何 push**，推送操作统一在最后由用户执行。
+
 ---
 
-## Step 7 — npm publish
+## Step 7 — 给出最终执行清单
 
-```bash
+本地准备工作已完成。向用户展示以下指令，请用户依次确认并手动执行：
+
+---
+
+```
+== 待执行：推送 + 发布 ==
+
+# 1. 推送 staging
+git push origin staging
+
+# 2. 推送 main 和 tag
+git push origin main
+git push origin v<new-version>
+
+# 3. 发布到 npm（需要已登录：npm login）
 npm publish
 ```
 
-如果报错（比如登录态过期），提示用户先运行 `npm login`，然后重试。
+---
+
+说明：
+- 如果 `npm login` 状态已过期，先运行 `npm login` 再执行 `npm publish`
+- 如果 `git push origin main` 被 pre-push hook 拒绝，检查 tag 格式是否为 `v<X>.<Y>.<Z>`，以及是否是 annotated tag
+- 以上命令需在项目根目录执行
+
+用户执行完毕后，告知 Claude，Claude 会输出最终摘要。
 
 ---
 
-## Step 8 — 收尾
+## Step 8 — 收尾（用户执行完毕后）
 
-发布成功后输出摘要：
+用户确认推送和发布成功后输出摘要：
 
 ```
 ✓ 版本 v<new-version> 已发布

package/skills-index.json

@@ -33,8 +33,8 @@
     { "path": "superpowers-fork/writing-plans", "bundle": "brainstorming" },
     { "path": "task/pm-task-dispatch", "bundle": "task" },
     { "path": "task/task-close", "bundle": "task" },
-    { "path": "web-fetch/article-fetcher", "bundle": "data-extraction" },
-    { "path": "web-fetch/url-extract", "bundle": "data-extraction" },
+    { "path": "data-extraction/article-fetcher", "bundle": "data-extraction" },
+    { "path": "data-extraction/url-extract", "bundle": "data-extraction" },
     { "path": "data-extraction/vision-extract", "bundle": "data-extraction" },
     { "path": "writing/mermaid-diagram", "bundle": "writing" },
     { "path": "design/sync-design-html", "bundle": "design" },