huhaa-myskills 0.1.5

package/docs/todo/v0.1.6.md

@@ -0,0 +1,43 @@
+# v0.1.6：增量扫描与缓存优化
+
+## 目标
+优化扫描性能，实现增量更新，减少首启动时间和 CPU 占用。
+
+## 关键任务
+
+### 增量扫描
+- [ ] 实现 file hash 缓存：记录每个文件的 mtime + size
+- [ ] 扫描器跳过未改动文件
+  - [ ] 启动时快速比对
+  - [ ] watch 事件中已处理
+- [ ] 单源增量刷新
+  - [ ] 某源文件变化 → 只重扫该源
+  - [ ] SSE 通知前端只更新该源
+
+### 缓存
+- [ ] 改进 `cache.json` 结构：
+  - [ ] 记录 IR 版本、生成时间、文件哈希
+- [ ] 源级别缓存：
+  - [ ] 每个源单独缓存文件
+  - [ ] 允许源级别的失效时间设置
+
+### 性能指标
+- [ ] 启动无变化 < 100ms
+- [ ] 单文件改动响应 < 300ms
+- [ ] 内存占用保持 < 50MB
+
+## 测试
+- [ ] 增量扫描正确性（无遗漏/无误更新）
+- [ ] 缓存一致性
+
+## 验收标准
+- 热启动 < 100ms
+- 改动响应 < 300ms
+- 无缓存遗漏
+
+## 预期周期
+1.5 周
+
+## 不包含
+- 不做分布式缓存
+- 不做 CDN 策略

package/docs/todo/v0.1.7.md

@@ -0,0 +1,38 @@
+# v0.1.7：跨平台完整支持
+
+## 目标
+确保 Windows 和 Linux 一等公民支持，改进平台特定工具集成。
+
+## 关键任务
+
+### Windows 支持
+- [ ] 剪贴板：用 powershell / `clip.exe` 替代 `pbcopy`
+- [ ] 文件打开：支持 `explorer.exe` / `start`
+- [ ] 编辑器启动：支持 VSCode / Cursor (Windows)
+- [ ] 路径规范化：统一处理 `\` 和 `/`
+
+### Linux 支持
+- [ ] 剪贴板：支持 `xclip` / `xsel` / `wl-copy`
+- [ ] 文件打开：支持 `xdg-open`
+- [ ] 编辑器启动：支持 code / cursor / vim
+- [ ] Wayland 兼容性
+
+### 测试
+- [ ] Windows / Linux 上运行 `npm test` 全绿
+- [ ] 路径穿越防护在各平台有效
+
+### 文档
+- [ ] 更新 README 平台支持说明
+- [ ] 添加 Windows / Linux 快速启动指南
+
+## 验收标准
+- Windows 上 `npm start` 完全可用
+- Linux 上 `npm start` 完全可用
+- 三个平台功能等价
+
+## 预期周期
+1.5 周
+
+## 不包含
+- 不做移动端
+- 不做容器内环境（Docker）

package/docs/todo/v0.1.8.md

@@ -0,0 +1,36 @@
+# v0.1.8：开发者工具与调试
+
+## 目标
+增强 CLI 和调试能力，方便用户自定义和二次开发。
+
+## 关键任务
+
+### CLI 增强
+- [ ] `huhaa-myskills` 新命令：
+  - [ ] `huhaa-myskills doctor` — 诊断配置和数据问题
+  - [ ] `huhaa-myskills validate-config` — 验证 sources.yaml
+  - [ ] `huhaa-myskills export <format>` — 导出 IR
+- [ ] 支持配置文件路径覆盖：`HUHAA_CONFIG` env
+- [ ] 支持日志级别：`LOG_LEVEL=debug npm start`
+
+### 调试工具
+- [ ] 前端 DevTools：集成 Pinia inspector 快捷启用
+- [ ] API 响应时间统计：`/api/stats?verbose=1`
+- [ ] 扫描性能分析：按适配器统计耗时
+
+### 文档
+- [ ] 编写适配器开发指南（如何新增源类型）
+- [ ] 配置参考文档
+- [ ] 常见问题排查指南
+
+## 验收标准
+- `doctor` 命令能检测常见问题
+- 调试日志清晰可读
+- 开发指南可用于第三方扩展
+
+## 预期周期
+1 周
+
+## 不包含
+- 不做 GUI 配置工具
+- 不做 web 端配置修改

package/docs/todo/v0.1.9.md

@@ -0,0 +1,54 @@
+# v0.1.9：完成度冲刺与稳定性
+
+## 目标
+完善文档、加固安全、建立性能基准，为 v1.0 做准备。
+
+## 关键任务
+
+### 文档完善
+- [ ] 写完整的 README（多语言支持）
+- [ ] 贡献者指南（CONTRIBUTING.md）
+- [ ] 架构文档（ARCHITECTURE.md）
+- [ ] API 文档（OpenAPI spec）
+- [ ] 中文用户指南
+
+### 安全加固
+- [ ] 安全审计：路径穿越、命令注入、XSS 等
+- [ ] 更新依赖安全补丁
+- [ ] 添加依赖审计工作流（GitHub Actions）
+- [ ] OWASP 检查清单
+
+### 性能基准
+- [ ] 建立性能基准测试套件
+  - [ ] 首启动时间
+  - [ ] 搜索延迟分布
+  - [ ] 内存峰值
+  - [ ] 网络传输大小
+- [ ] 性能衰退告警
+
+### 打包与发布
+- [ ] 验证 npm 全局安装流程（真实测试）
+- [ ] 生成 CHANGELOG
+- [ ] 标记 v0.1.9 release
+
+### 用户反馈收集
+- [ ] 添加反馈渠道（GitHub Issues）
+- [ ] 收集 3+ 个真实用户场景
+- [ ] 修复高优反馈
+
+## 测试
+- [ ] 集成测试覆盖率 > 90%
+- [ ] 性能基准记录
+- [ ] 安全检查通过
+
+## 验收标准
+- 文档完整可用
+- 安全漏洞 0
+- 性能满足预期
+
+## 预期周期
+2 周
+
+## 后续
+- 计划 v1.0（稳定版）
+- 考虑 v2.0 方向（跨机器聚合、团队共享等）

package/install-and-sync.sh

@@ -0,0 +1,209 @@
+#!/bin/bash
+
+###############################################################################
+# HuHaa-MySkills 远程安装与技能同步入口 (v0.1.5)
+#
+# 用法：
+#   curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash
+#   或
+#   curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash -s -- --sync-only
+#
+# 参数：
+#   --sync-only    只执行同步，不安装
+#   --local PATH   使用本地项目路径
+#   --branch NAME  指定分支（默认 main）
+#
+###############################################################################
+
+set -euo pipefail
+
+# 配置
+REPO_URL="https://github.com/aquarkgn/HuHaa-MySkills.git"
+REPO_RAW="https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills"
+BRANCH="main"
+SYNC_ONLY=false
+LOCAL_PATH=""
+
+# 颜色定义
+readonly BLUE='\033[0;34m'
+readonly GREEN='\033[0;32m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly CYAN='\033[0;36m'
+readonly NC='\033[0m'
+
+# 日志函数
+log_info() { echo -e "${BLUE}ℹ${NC} $*"; }
+log_success() { echo -e "${GREEN}✓${NC} $*"; }
+log_warn() { echo -e "${YELLOW}⚠${NC} $*"; }
+log_error() { echo -e "${RED}✗${NC} $*" >&2; }
+
+# 解析命令行参数
+parse_args() {
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --sync-only)
+        SYNC_ONLY=true
+        shift
+        ;;
+      --local)
+        LOCAL_PATH="$2"
+        SYNC_ONLY=true
+        shift 2
+        ;;
+      --branch)
+        BRANCH="$2"
+        shift 2
+        ;;
+      *)
+        log_error "未知参数: $1"
+        exit 1
+        ;;
+    esac
+  done
+}
+
+# 获取临时目录
+get_temp_dir() {
+  if command -v mktemp &>/dev/null; then
+    mktemp -d
+  else
+    local tmpdir="/tmp/huhaa-myskills-$$"
+    mkdir -p "$tmpdir"
+    echo "$tmpdir"
+  fi
+}
+
+# 检查依赖
+check_deps() {
+  if ! command -v curl &>/dev/null; then
+    log_error "需要 curl，请先安装"
+    exit 1
+  fi
+
+  if ! $SYNC_ONLY && ! command -v git &>/dev/null; then
+    log_error "需要 git，请先安装"
+    exit 1
+  fi
+}
+
+# 下载并执行同步脚本
+download_and_sync() {
+  local sync_script_url="$REPO_RAW/$BRANCH/service/scripts/sync-skills.sh"
+
+  log_info "下载同步脚本..."
+
+  local temp_script
+  temp_script=$(mktemp)
+  trap "rm -f '$temp_script'" EXIT
+
+  if ! curl -fsSL "$sync_script_url" -o "$temp_script"; then
+    log_error "下载失败: $sync_script_url"
+    return 1
+  fi
+
+  if [[ -n "$LOCAL_PATH" ]]; then
+    export HUHAA_LOCAL_PATH="$LOCAL_PATH"
+  fi
+
+  log_success "同步脚本已下载"
+
+  # 执行同步脚本
+  bash "$temp_script"
+}
+
+# 本地安装（git clone）
+local_install() {
+  local temp_dir
+  temp_dir=$(get_temp_dir)
+  trap "rm -rf '$temp_dir'" EXIT
+
+  log_info "克隆项目仓库..."
+
+  if ! git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$temp_dir"; then
+    log_error "克隆失败"
+    return 1
+  fi
+
+  local_path="$temp_dir"
+  log_success "项目已克隆到临时目录"
+
+  # 执行同步
+  export HUHAA_LOCAL_PATH="$local_path"
+  download_and_sync
+}
+
+# 检查 npm 全局安装
+npm_install() {
+  if ! command -v npm &>/dev/null; then
+    log_warn "未安装 npm，跳过全局安装"
+    return 0
+  fi
+
+  log_info "正在进行 npm 全局安装..."
+
+  if npm install -g "github:aquarkgn/HuHaa-MySkills#$BRANCH"; then
+    log_success "npm 全局安装完成"
+
+    # 获取安装位置
+    local npm_prefix
+    npm_prefix=$(npm prefix -g)
+    export HUHAA_LOCAL_PATH="$npm_prefix/node_modules/huhaa-myskills"
+
+    return 0
+  else
+    log_warn "npm 全局安装失败，将使用远程脚本"
+    return 1
+  fi
+}
+
+# 主函数
+main() {
+  echo -e "\n${CYAN}╔════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${CYAN}║     HuHaa-MySkills v0.1.5 - 编辑器技能自动同步        ║${NC}"
+  echo -e "${CYAN}╚════════════════════════════════════════════════════════╝${NC}\n"
+
+  parse_args "$@"
+  check_deps
+
+  if $SYNC_ONLY; then
+    log_info "执行同步模式"
+    if [[ -z "$LOCAL_PATH" ]]; then
+      # 只下载并执行远程脚本
+      download_and_sync
+    else
+      # 使用本地路径
+      if [[ ! -d "$LOCAL_PATH" ]]; then
+        log_error "本地路径不存在: $LOCAL_PATH"
+        exit 1
+      fi
+      export HUHAA_LOCAL_PATH="$LOCAL_PATH"
+      download_and_sync
+    fi
+  else
+    log_info "执行完整安装 + 同步流程"
+
+    # 尝试 npm 全局安装
+    if ! npm_install; then
+      # 如果 npm 安装失败，使用 git clone
+      log_info "使用 git clone 方式安装"
+      local_install
+    else
+      # npm 安装成功，执行同步
+      download_and_sync
+    fi
+  fi
+
+  echo -e "\n${GREEN}╔════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${GREEN}║                   ✨ 同步完成！ ✨                    ║${NC}"
+  echo -e "${GREEN}╚════════════════════════════════════════════════════════╝${NC}\n"
+
+  log_info "后续步骤："
+  echo "  1. 启动 HuHaa: npm start"
+  echo "  2. 查看技能中心: http://localhost:11520"
+  echo "  3. 在编辑器中使用你的技能"
+  echo -e "\n更多信息: https://github.com/aquarkgn/HuHaa-MySkills\n"
+}
+
+# 执行主程序
+main "$@"

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "huhaa-myskills",
+  "version": "0.1.5",
+  "private": false,
+  "description": "Local skill / plugin / MCP aggregation hub. Browse all your AI agent skills at http://localhost:11520.",
+  "license": "MIT",
+  "homepage": "https://github.com/aquarkgn/HuHaa-MySkills#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aquarkgn/HuHaa-MySkills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aquarkgn/HuHaa-MySkills/issues"
+  },
+  "type": "module",
+  "workspaces": [
+    "service/packages/*"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "huhaa-myskills": "service/bin/huhaa-myskills.mjs"
+  },
+  "files": [
+    "service/bin/",
+    "service/config/",
+    "service/packages/scanner/src/",
+    "service/packages/server/src/",
+    "service/packages/web/dist/",
+    "service/scripts/",
+    "docs/",
+    "README.md",
+    "LICENSE",
+    "install-and-sync.sh"
+  ],
+  "scripts": {
+    "start": "node service/bin/huhaa-myskills.mjs start",
+    "scan": "node service/bin/huhaa-myskills.mjs scan",
+    "stats": "node service/bin/huhaa-myskills.mjs stats",
+    "duplicates": "node service/bin/huhaa-myskills.mjs duplicates",
+    "init": "node service/bin/huhaa-myskills.mjs init",
+    "purge": "node service/bin/huhaa-myskills.mjs purge",
+    "dev": "node service/bin/huhaa-myskills.mjs dev",
+    "sync": "bash service/scripts/sync-skills.sh",
+    "sync:remote": "curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash -s -- --sync-only",
+    "build:web": "node service/scripts/build-web.mjs",
+    "test": "node --test service/packages/scanner/test/*.test.mjs service/packages/server/test/*.test.mjs",
+    "verify": "node service/scripts/verify.mjs"
+  },
+  "dependencies": {
+    "@huhaa/scanner": "file:service/packages/scanner",
+    "@huhaa/server": "file:service/packages/server",
+    "chokidar": "^4.0.3",
+    "fast-glob": "^3.3.2",
+    "fastify": "^5.0.0",
+    "yaml": "^2.6.0"
+  },
+  "devDependencies": {
+    "@huhaa/web": "file:service/packages/web",
+    "@vitejs/plugin-vue": "^5.2.1",
+    "fuse.js": "^7.0.0",
+    "markdown-it": "^14.1.0",
+    "pinia": "^2.3.0",
+    "vite": "^6.0.0",
+    "vue": "^3.5.13"
+  }
+}