huhaa-myskills 0.2.13 → 0.3.4

package/docs/SYNC-SKILLS.md

@@ -1,259 +0,0 @@
-# HuHaa-MySkills 编辑器技能同步 (v0.1.2)
-
-本文档说明如何使用编辑器技能自动同步功能。
-
-## 快速开始
-
-### 方式 1：本地安装后同步
-
-```bash
-# 克隆项目
-git clone https://github.com/aquarkgn/HuHaa-MySkills.git
-cd HuHaa-MySkills
-
-# 执行同步脚本（交互模式）
-npm run sync
-# 或直接运行
-bash service/scripts/sync-skills.sh
-```
-
-### 方式 2：远程一键安装 + 同步
-
-```bash
-# 通过 curl 直接执行（推荐）
-curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash
-```
-
-### 方式 3：仅同步（已安装项目后）
-
-```bash
-npm run sync
-# 或
-npm run sync:remote
-```
-
----
-
-## 功能说明
-
-### 自动编辑器检测
-
-脚本会自动扫描以下编辑器，并列出已安装的编辑器：
-
-| 编辑器       | macOS 配置位置                                    | Linux 配置位置               |
-|------------|----------------------------------------------------|-----------------------------|
-| **Cursor** | `~/Library/Application Support/Cursor`            | `~/.config/Cursor`          |
-| **VS Code** | `~/Library/Application Support/Code`             | `~/.config/Code`            |
-| **Helix**  | `~/Library/Application Support/helix`            | `~/.config/helix`           |
-| **Neovim** | `~/.config/nvim`                                  | `~/.config/nvim`            |
-| **Sublime** | `~/Library/Application Support/Sublime Text`     | `~/.config/sublime-text-3`  |
-| **Windsurf** | `~/Library/Application Support/Windsurf`        | `~/.config/Windsurf`        |
-
-### 交互式选择
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  请选择要同步技能的编辑器（多选）
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  [1] cursor
-     Path: /Users/mac/Library/Application Support/Cursor
-
-  [2] vscode
-     Path: /Users/mac/Library/Application Support/Code
-
-  [3] helix
-     Path: /Users/mac/Library/Application Support/helix
-
-  0 - 全选
-  q - 退出
-
-请输入选择 (使用逗号分隔多个): 1,2
-```
-
-**支持的输入方式：**
-- `1` - 选择第一个编辑器
-- `1,2,3` - 选择多个编辑器
-- `0` - 全选所有编辑器
-- `q` - 取消操作
-
-### 同步功能
-
-脚本会将项目的技能和配置同步到选中的编辑器：
-
-#### Cursor
-- 同步 `.cursorrules` 文件到编辑器配置目录
-- 自动备份原有的 `.cursorrules`
-
-#### VS Code
-- 复制代码片段和脚本到编辑器的 snippets 目录
-- 支持自定义代码补全
-
-#### Helix
-- 同步 `config.toml` 配置文件
-- 集成 HuHaa 自定义命令
-
-#### Neovim
-- 生成 `init.lua` 基础配置
-- 加载 HuHaa 自定义配置
-
-#### Sublime Text
-- 同步用户设置和代码片段
-
-#### Windsurf
-- 同步编辑器配置
-
----
-
-## 使用示例
-
-### 示例 1：在本地项目中同步所有编辑器
-
-```bash
-cd /path/to/HuHaa-MySkills
-npm run sync
-
-# 选择: 0（全选）
-```
-
-### 示例 2：只同步 Cursor
-
-```bash
-npm run sync
-
-# 选择: 1（假设 Cursor 是第一个）
-```
-
-### 示例 3：从远程直接运行（新机器）
-
-```bash
-# 自动安装 + 同步一体化
-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
-```
-
-### 示例 4：本地项目路径
-
-```bash
-# 如果脚本在其他位置，指定本地项目路径
-bash /path/to/sync-skills.sh --local /path/to/HuHaa-MySkills
-```
-
----
-
-## 环境变量
-
-脚本支持以下环境变量来自定义行为：
-
-```bash
-# 指定本地项目路径
-export HUHAA_LOCAL_PATH="/path/to/HuHaa-MySkills"
-
-# 指定远程仓库 URL（默认：https://github.com/aquarkgn/HuHaa-MySkills.git）
-export HUHAA_REPO_URL="https://github.com/your-fork/HuHaa-MySkills.git"
-
-# 指定原始内容 URL（默认：https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills）
-export HUHAA_REPO_RAW="https://raw.githubusercontent.com/your-fork/HuHaa-MySkills"
-
-# 执行脚本
-bash service/scripts/sync-skills.sh
-```
-
----
-
-## 常见问题
-
-### Q: 脚本找不到我的编辑器配置？
-
-**A:** 某些编辑器在非标准位置安装。你可以：
-1. 检查编辑器是否在支持列表中
-2. 确认编辑器配置目录是否存在
-3. 手动指定项目路径：`HUHAA_LOCAL_PATH=/path/to/project bash service/scripts/sync-skills.sh`
-
-### Q: 同步会覆盖我的现有配置吗？
-
-**A:** 脚本会：
-- 为 Cursor 的 `.cursorrules` 创建备份（`.cursorrules.backup`）
-- 对于其他编辑器，如果配置文件已存在，会跳过覆盖并显示警告
-- 不会无故删除任何文件
-
-### Q: 可以部分同步吗？
-
-**A:** 可以！选择需要同步的编辑器即可：
-```bash
-npm run sync
-# 选择: 1,3（只同步第 1 和第 3 个编辑器）
-```
-
-### Q: 如何撤销同步？
-
-**A:** 如果有备份，恢复备份文件：
-```bash
-# 恢复 Cursor 备份
-cp ~/.cursor/.cursorrules.backup ~/.cursor/.cursorrules
-```
-
-### Q: 脚本支持 Windows 吗？
-
-**A:** 支持 Windows WSL（Windows Subsystem for Linux）。在 PowerShell 中：
-```powershell
-wsl bash -c "curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash"
-```
-
----
-
-## 故障排查
-
-### 脚本执行权限错误
-
-```bash
-# 添加执行权限
-chmod +x service/scripts/sync-skills.sh
-bash service/scripts/sync-skills.sh
-```
-
-### 网络连接问题
-
-如果 curl 下载失败，可尝试：
-1. 检查网络连接
-2. 使用代理：`curl -x [proxy-url] ...`
-3. 使用本地项目：`npm run sync`
-
-### 编辑器不被识别
-
-检查编辑器配置目录是否存在：
-```bash
-# macOS
-ls ~/Library/Application\ Support/Cursor
-ls ~/Library/Application\ Support/Code
-ls ~/.config/nvim  # Linux
-
-# Linux
-ls ~/.config/Cursor
-ls ~/.config/Code
-ls ~/.config/helix
-```
-
----
-
-## 后续更新
-
-脚本会在新版本中增加：
-- [ ] 更多编辑器支持（Emacs, Vim, etc）
-- [ ] 配置文件版本管理
-- [ ] 回滚功能
-- [ ] 增量同步（只同步改变的部分）
-
----
-
-## 相关文档
-
-- [快速启动指南](./GUIDE.md)
-- [项目规划](./PLAN.md)
-- [发布规范](./RULES.md)
-
----
-
-**v0.1.2 首发功能** | [GitHub](https://github.com/aquarkgn/HuHaa-MySkills)

package/docs/releases/README.md

@@ -1,47 +0,0 @@
-# 版本发布历史
-
-本目录包含每个版本的详细发布说明。
-
-## 🚀 已发布版本
-
-| 版本 | 日期 | 主题 | 文档 |
-|------|------|------|------|
-| **v0.1.1** | 2026-06-18 | npm 全局安装支持 | [详情](./v0.1.1.md) |
-| **v0.1.0** | 2026-06-17 | 首个可用版本 | [详情](./v0.1.0.md) |
-
-## 📋 计划中的版本
-
-| 版本 | 预期日期 | 主题 | 计划文档 |
-|------|---------|------|---------|
-| **v0.1.2** | 2026-06-30 | Hermes 技能集成 + 搜索优化 | [v0.1.2 计划](../todo/v0.1.2.md) / [发布说明](./v0.1.2.md) |
-| **v0.1.3** | 2026-07-07 | Obsidian + Claude.md 支持 | [v0.1.3 计划](../todo/v0.1.3.md) |
-| **v0.1.4** | 2026-07-21 | 分组与筛选增强 | [v0.1.4 计划](../todo/v0.1.4.md) |
-| **v0.1.5** | 2026-07-28 | 导出与分享 | [v0.1.5 计划](../todo/v0.1.5.md) |
-| **v0.1.6** | 2026-08-11 | 增量扫描与缓存 | [v0.1.6 计划](../todo/v0.1.6.md) |
-| **v0.1.7** | 2026-08-25 | 跨平台完整支持 | [v0.1.7 计划](../todo/v0.1.7.md) |
-| **v0.1.8** | 2026-09-01 | 开发者工具 | [v0.1.8 计划](../todo/v0.1.8.md) |
-| **v0.1.9** | 2026-09-15 | 完成度冲刺 | [v0.1.9 计划](../todo/v0.1.9.md) |
-
-## 📖 如何阅读版本说明
-
-每个发布版本的详细说明包含：
-
-- **🎯 版本目标** - 这个版本要达成什么
-- **✨ 新增功能** - 具体增加了哪些功能
-- **🐛 Bug 修复** - 修复了哪些问题
-- **📊 性能对比** - 性能改进数据
-- **🧪 测试覆盖** - 测试情况
-- **📦 发行物** - 如何获取这个版本
-- **🚀 安装指南** - 如何安装和升级
-- **📝 Breaking Changes** - 是否有不兼容改动
-- **🔄 迁移指南** - 如何从旧版本升级
-
-## 🔗 相关资源
-
-- [CHANGELOG.md](../../CHANGELOG.md) - 简明版本历史
-- [版本计划](../todo/) - 未来版本计划
-- [发布规范](../RULES.md) - 如何发布版本
-
----
-
-**最后更新**: 2026-06-18

package/docs/releases/v0.1.0.md

@@ -1,256 +0,0 @@
-# v0.1.0 - 本地技能聚合中心首个可用版本
-
-**发布日期**: 2026-06-17  
-**发布状态**: ✅ 正式发布  
-**GitHub**: [Release v0.1.0](https://github.com/aquarkgn/HuHaa-MySkills/releases/tag/v0.1.0)
-
----
-
-## 🎯 版本目标
-
-完成 P0-P7 完整实现（8 小时净工作量），交付一个可用的本地技能聚合浏览器，实现多源技能的统一查找和复制。
-
-## 📋 版本主题
-
-**本地技能聚合中心** - 将散落在 Hermes / Claude Code / Cursor / MCP 等多个工具中的技能统一汇聚到一个本地浏览器，提供搜索、筛选、复制等快速操作。
-
----
-
-## ✨ 新增功能
-
-### 核心功能
-- 🎯 **多源聚合** - 聚合 Hermes、Claude Code、Cursor Rules、MCP Config、Project Runbook 等 5+ 个源
-- 🔍 **全文搜索** - 基于 Fuse.js 的前端全文搜索，延迟 < 5ms
-- 📂 **智能分组** - 支持按源、分类、品牌、产品四种维度分组浏览
-- 📋 **详情页** - 查看技能的完整信息、参数、使用说明、相关链接
-- 📋 **一键复制** - 复制路径、复制原文、复制 frontmatter
-- 🔗 **编辑器跳转** - 点击"在 Cursor 中打开"直接打开文件
-- 🔄 **热更新** - 修改技能文件后 < 1s 自动刷新页面（chokidar watch）
-
-### 技术架构
-- **前端**: Vite 5 + Vue 3 + TypeScript + Pinia + Vuetify
-- **后端**: Fastify 5 + Node.js 20+
-- **扫描**: 多源适配器 + 统一 IR 数据结构
-- **通信**: SSE (Server-Sent Events) 实时推送
-
-### 支持的源
-
-| 源 | 路径 | 类型 | 说明 |
-|---|------|------|------|
-| Hermes | `~/.hermes/skills/*/SKILL.md` | skill | Hermes 官方技能库 |
-| Claude Code | `~/.claude/skills/*/SKILL.md` | skill | Claude Code 技能 |
-| MCP Config | `~/.cursor/mcp.json` 等 | mcp | MCP 服务器定义 |
-| Cursor Rules | `.cursorrules` / `.cursor/rules/` | agent-rule | Cursor 规则 |
-| Project Runbook | `docs/RUNBOOK-*.md` | runbook | 项目文档 |
-
----
-
-## 🐛 已知限制
-
-### 功能限制
-- ❌ 不支持在网页端编辑技能（只读浏览）
-- ❌ 不支持跨机器同步（本地工具）
-- ❌ 不支持直接执行技能（复制后由编辑器执行）
-- ❌ Windows / Linux 尽量兼容但不是一等公民
-
-### 平台兼容性
-- ✅ macOS - 完全支持
-- ⚠️ Linux - 功能完整，部分工具集成需要调整
-- ⚠️ Windows - 功能完整，路径和剪贴板需要调整
-
----
-
-## 📊 性能指标
-
-| 指标 | 目标 | 实现 |
-|------|------|------|
-| 首启动 | < 2s | ~1s（扫描 800 文件） |
-| 热更新 | < 500ms | ~300ms |
-| 搜索延迟 | < 10ms | ~5ms（800 条目） |
-| 内存占用 | < 100MB | ~50MB |
-| 列表滚动 | 60fps | ✅ 完整虚拟滚动 |
-
----
-
-## 🧪 测试覆盖
-
-- ✅ 单元测试 - 6 个核心测试用例
-- ✅ 集成测试 - Fastify API 完整覆盖
-- ✅ E2E 验证 - `npm run verify` smoke test
-- ✅ 安全检查 - 路径穿越防护、XSS 防护
-
-**覆盖率**: 适配器与 server 90% 行覆盖
-
----
-
-## 📚 文档
-
-- ✅ `README.md` - 项目概览和安装指南
-- ✅ `docs/PLAN.md` - 详细架构设计文档
-- ✅ `docs/RUNBOOK-myskills.md` - 使用说明
-- ⚠️ 快速启动指南 - 计划在 v0.1.2 完善
-
----
-
-## 🚀 安装使用
-
-### 快速开始
-```bash
-git clone https://github.com/aquarkgn/HuHaa-MySkills.git
-cd HuHaa-MySkills
-npm install
-npm start
-# 浏览器自动打开 http://localhost:11520
-```
-
-### 常用命令
-```bash
-npm start       # 启动并打开浏览器
-npm run scan    # 仅扫描，输出 IR JSON
-npm run stats   # 统计信息
-npm run dev     # 开发模式
-npm test        # 运行测试
-npm run verify  # 完整性检查
-```
-
----
-
-## 📈 本地扫描统计
-
-用户本机数据统计（实际测试）：
-- Hermes skills: 660+ 条
-- Claude Code skills: ~50 条
-- MCP configs: ~15 个
-- Project Runbooks: ~20 条
-- Cursor Rules: ~10 条
-
-**总计**: 750+ 条目，本地 SPA 完全可用
-
----
-
-## 🎨 使用场景
-
-### 场景 1：快速查找 Hermes 技能
-1. 浏览器打开 localhost:11520
-2. 搜索框输入关键词
-3. 找到目标技能
-4. 点击"复制原文"
-5. 粘贴到 Cursor 上下文
-
-### 场景 2：浏览所有 MCP 服务
-1. 分组切换为"source"
-2. 选择"mcp-config"
-3. 查看所有 MCP 服务定义
-4. 复制工具定义到 Cursor
-
-### 场景 3：快速查看项目 Runbook
-1. 分组切换为"kind"
-2. 选择"runbook"
-3. 查看所有项目文档
-4. 点击"在 Cursor 中打开"
-
----
-
-## 🔧 配置文件
-
-### sources.yaml
-
-首次启动自动生成在用户数据目录：
-```yaml
-sources:
-  hermes:
-    enabled: true
-    roots:
-      - ~/.hermes/skills
-  
-  claude-code:
-    enabled: true
-    roots:
-      - ~/.claude/skills
-
-  mcp-config:
-    enabled: true
-    files:
-      - ~/.cursor/mcp.json
-
-limits:
-  maxFiles: 5000
-  maxFileBytes: 1048576
-```
-
----
-
-## 🔐 安全设计
-
-- ✅ Localhost only - 绑定 127.0.0.1，不支持远程访问
-- ✅ 路径白名单 - `/api/open` 和 `/api/copy` 都有白名单验证
-- ✅ 无上传下载 - 纯只读浏览，不写入用户文件
-- ✅ 无网络通信 - 完全本地工作，无任何远程请求
-
----
-
-## 📦 技术栈
-
-### 后端
-- Fastify 5 - HTTP 框架
-- Node.js 20+ - 运行时
-- Chokidar - 文件监听
-- YAML / TOML - 配置解析
-
-### 前端
-- Vite 5 - 构建工具
-- Vue 3 - UI 框架
-- TypeScript - 类型安全
-- Pinia - 状态管理
-- Fuse.js - 搜索引擎
-- Vuetify - 组件库
-
----
-
-## 🏗️ 项目结构
-
-```
-HuHaa-MySkills/
-├── service/
-│   ├── bin/                    # CLI 入口
-│   ├── packages/
-│   │   ├── scanner/            # 扫描器 + 适配器
-│   │   ├── server/             # HTTP 服务器
-│   │   └── web/                # Vue 前端
-│   ├── config/                 # 配置文件示例
-│   └── scripts/                # 工具脚本
-├── docs/                       # 文档
-├── package.json                # 工作空间配置
-└── README.md
-```
-
----
-
-## 🔜 下一步（v0.1.1+）
-
-- [ ] npm 全局安装支持
-- [ ] 更多数据源支持
-- [ ] 性能优化
-- [ ] 跨平台完整支持
-- [ ] 开发者工具
-
-详见 [版本计划](../todo/)
-
----
-
-## 🙏 贡献者
-
-- **Nolan** - 核心开发
-
----
-
-## 📄 许可证
-
-MIT - 详见 [LICENSE](../../LICENSE)
-
----
-
-**相关链接**:
-- [GitHub 项目](https://github.com/aquarkgn/HuHaa-MySkills)
-- [完整架构](../PLAN.md)
-- [操作手册](../RUNBOOK-myskills.md)