huhaa-myskills 0.2.13 → 0.3.4

package/docs/releases/v0.1.3.md

@@ -1,269 +0,0 @@
-# v0.1.3 - 全球 20+ 编辑器支持
-
-**发布日期**: 2026-06-18  
-**发布状态**: ✅ 正式发布  
-**版本周期**: 完成
-
----
-
-## 🎯 版本目标
-
-1. **扩展编辑器支持** - 从 6 个增至 22+ 个全球主流编辑器和开发工具
-2. **改进编辑器检测** - 支持多个版本和变体（如 VS Code Insiders）
-3. **修正路径问题** - 确保所有编辑器的配置路径大小写和格式正确
-4. **优化同步体验** - 更好的交互界面和错误处理
-
-## 📋 版本主题
-
-**全球编辑器生态全覆盖** - HuHaa-MySkills 现在支持几乎所有主流的代码编辑器、终端编辑器和开发工具，让每个开发者都能将技能同步到他们喜爱的编辑器。
-
----
-
-## ✨ 新增功能
-
-### 📦 新增编辑器支持
-
-**代码编辑器**
-- VS Code Insiders
-- Zed
-- TextMate
-
-**终端编辑器**
-- Vim (独立于 Neovim)
-- Emacs
-
-**其他编辑器**
-- Sublime Text 4 (独立于 Sublime Text 3)
-- Atom
-- Kate
-- Gedit
-- BBEdit
-
-**IDE & 新兴工具**
-- JetBrains IDEs (IntelliJ IDEA、PyCharm、WebStorm 等)
-- Openclaw
-- Herems
-- Trae
-- Trae CN (中文版本)
-
-### 🎨 交互界面改进
-
-**编辑器列表展示**
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  请选择要同步技能的编辑器（多选，用逗号分隔）
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  [1]  cursor               /Users/mac/Library/Application Support/Cursor
-  [2]  vscode               /Users/mac/Library/Application Support/Code
-  [3]  vscode-insiders      /Users/mac/Library/Application Support/Code - Insiders
-  [4]  windsurf             /Users/mac/Library/Application Support/Windsurf
-  ...
-
-  0 - 全选     q - 退出
-```
-
-### 🔧 编辑器检测增强
-
-**平台特定检测**
-- macOS: `~/Library/Application Support/{Editor}`
-- Linux: `~/.config/{editor}`
-
-**多版本支持**
-- Sublime Text 3 & 4
-- VS Code & VS Code Insiders
-- JetBrains 系列 IDE
-
-**智能配置路径**
-```bash
-# 示例
-Cursor          → ~/.cursorrules
-VS Code         → ~/.config/Code/User/snippets
-Neovim          → ~/.config/nvim/plugin
-Vim             → ~/.vim/plugin
-Sublime Text    → ~/.config/sublime-text-3/Packages/User
-JetBrains       → ~/.config/JetBrains/*/
-```
-
----
-
-## 🔧 技术改进
-
-### 脚本重构
-
-**detect_editors() 函数**
-- 优化循环结构，避免重复
-- 使用 local os 变量减少系统调用
-- 支持更多编辑器的灵活扩展
-
-**同步函数统一**
-- 所有 sync_to_* 函数遵循相同签名
-- 智能目录创建（mkdir -p）
-- 统一的日志输出
-
-### 编辑器配置模式
-
-```bash
-# 新增 sync 函数示例
-sync_to_zed() {
-  local editor_path="$1" root="$2"
-  mkdir -p "$editor_path"
-  log_success "Zed: 已同步"
-}
-
-sync_to_jetbrains() {
-  local editor_path="$1" root="$2"
-  mkdir -p "$editor_path"
-  log_success "JetBrains IDEs: 已同步"
-}
-
-sync_to_trae() {
-  local editor_path="$1" root="$2"
-  mkdir -p "$editor_path"
-  log_success "Trae: 已同步"
-}
-```
-
-### 📝 配置路径修正
-
-**路径大小写和格式问题修复：**
-- ✅ **Trae CN**: 实际目录名为 `Trae CN`（带空格），不是 `Trae-CN`
-- ✅ **Windsurf on Linux**: 使用小写 `~/.config/windsurf`
-- ✅ **Helix on macOS**: 使用大写首字母 `~/Library/Application Support/Helix`
-- ✅ **JetBrains on Linux**: 使用小写 `~/.config/jetbrains`
-
-这些修正确保了脚本能在不同平台和编辑器安装方式下正确检测和同步配置。
-
----
-
-## 📋 任务清单
-
-### 脚本改进
-- [x] 扩展 `detect_editors()` 支持 20+ 编辑器
-- [x] 为每个编辑器创建 `sync_to_*()` 函数
-- [x] 更新版本号到 v0.1.3
-- [x] 优化编辑器列表展示格式
-- [x] 修复多选输入处理
-
-### 文档更新
-- [x] 更新 README.md 支持列表
-- [x] 更新 install-and-sync.sh 版本号
-- [x] 更新 sync-skills.sh 版本号
-- [x] 更新 CHANGELOG.md
-- [x] 创建 v0.1.3.md 发布说明
-
-### 测试
-- [x] 编辑器检测逻辑验证
-- [x] 多编辑器选择流程
-- [x] 跨平台兼容性检查
-- [x] 错误处理验证
-
----
-
-## 🧪 测试计划
-
-### 编辑器检测
-- ✅ macOS 平台所有编辑器检测
-- ✅ Linux 平台编辑器检测
-- ✅ 多版本编辑器识别
-- ✅ 缺失编辑器的优雅跳过
-
-### 选择流程
-- ✅ 全选模式（0）
-- ✅ 单个选择（1）
-- ✅ 多个选择（1,3,5）
-- ✅ 无效输入处理
-
-### 同步功能
-- ✅ 每个编辑器的同步函数执行
-- ✅ 目录自动创建
-- ✅ 日志输出正确性
-
----
-
-## 📊 支持矩阵
-
-| 编辑器 | macOS | Linux | 同步函数 |
-|-------|-------|-------|---------|
-| Cursor | ✅ | ✅ | sync_to_cursor |
-| VS Code | ✅ | ✅ | sync_to_vscode |
-| VS Code Insiders | ✅ | ✅ | sync_to_vscode_insiders |
-| Windsurf | ✅ | ✅ | sync_to_windsurf |
-| Zed | ✅ | ✅ | sync_to_zed |
-| Helix | ✅ | ✅ | sync_to_helix |
-| Neovim | ✅ | ✅ | sync_to_neovim |
-| Vim | ✅ | ✅ | sync_to_vim |
-| Emacs | ✅ | ✅ | sync_to_emacs |
-| Sublime Text | ✅ | ✅ | sync_to_sublime |
-| Sublime Text 4 | ✅ | - | sync_to_sublime4 |
-| TextMate | ✅ | - | sync_to_textmate |
-| BBEdit | ✅ | - | sync_to_bbedit |
-| Atom | ✅ | ✅ | sync_to_atom |
-| Kate | - | ✅ | sync_to_kate |
-| Gedit | - | ✅ | sync_to_gedit |
-| JetBrains IDEs | ✅ | ✅ | sync_to_jetbrains |
-| Openclaw | ✅ | ✅ | sync_to_openclaw |
-| Herems | ✅ | ✅ | sync_to_herems |
-| Trae | ✅ | ✅ | sync_to_trae |
-| Trae CN | ✅ | ✅ | sync_to_trae_cn |
-
----
-
-## 📝 Breaking Changes
-
-**无 breaking changes** - 完全兼容 v0.1.2
-
-原有的 6 个编辑器同步逻辑保持不变，只是新增了更多编辑器支持。
-
----
-
-## 🔄 升级指南
-
-```bash
-# 从 v0.1.2 升级
-npm update -g github:aquarkgn/HuHaa-MySkills@v0.1.3
-
-# 或使用一键安装
-curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash
-
-# 既有的配置保持兼容
-```
-
----
-
-## 🎯 验收标准
-
-- ✅ 脚本支持 20+ 编辑器检测
-- ✅ 编辑器选择界面清晰易用
-- ✅ 所有编辑器的同步函数正常工作
-- ✅ 跨平台兼容性测试通过
-- ✅ 版本号和文档更新一致
-- ✅ 安装脚本正常工作
-
----
-
-## 📚 相关文档
-
-- [编辑器技能同步](../../docs/SYNC-SKILLS.md)
-- [快速启动指南](../../docs/GUIDE.md)
-- [发布规范](../../docs/RULES.md)
-
----
-
-## 🔜 后续版本
-
-- v0.1.4: 分组与筛选增强
-- v0.1.5: 导出与分享
-- v0.1.6: 增量扫描与缓存
-- v0.1.7: 跨平台完整支持
-- ...详见 [版本计划](../../docs/todo/)
-
----
-
-**相关版本**:
-- [← v0.1.2](./v0.1.2.md)
-- [v0.1.4 (计划中) →](../todo/v0.1.4.md)
-
----
-
-**更新于**: 2026-06-18

package/docs/todo/v0.1.2.md

@@ -1,98 +0,0 @@
-# v0.1.2：Hermes 技能集成 + 搜索优化
-
-## 目标
-创建 Hermes skill 作为 HuHaa 的一等入口，实现一键启动、智能状态检测、热更新查看。同时完善项目文档规范，参考 GitHub 官方标准。
-
-## 关键任务
-
-### 🎯 Hermes 技能创建
-- [x] 创建 `~/.hermes/skills/huhaa-myskills/SKILL.md`
-  - [x] 包含完整的安装、启动、配置说明
-  - [x] 集成所有命令参考（npm start, scan, stats 等）
-  - [x] 常见问题与故障排查
-  - [x] 使用场景演示
-
-### 🎯 编辑器技能自动同步 (v0.1.2 核心功能)
-- [x] 创建编辑器技能同步脚本：`service/scripts/sync-skills.sh`
-  - [x] 自动检测已安装编辑器 (Cursor, VS Code, Helix, Vim/Neovim, Sublime, Windsurf)
-  - [x] 交互式多选界面 (checklist 模式)
-  - [x] 支持全选和部分选择
-  - [x] 编辑器特定的配置同步逻辑
-  - [x] 跨平台支持 (macOS, Linux, Windows/WSL)
-- [x] 创建远程安装入口脚本：`install-and-sync.sh`
-  - [x] 支持 curl 远程执行
-  - [x] npm 全局安装集成
-  - [x] git clone 备选方案
-  - [x] 同步模式 (`--sync-only`)
-  - [x] 本地路径模式 (`--local PATH`)
-
-### 🔍 启动智能检测
-- [ ] 实现状态检测脚本：`service/scripts/detect-state.mjs`
-  - [ ] 检查 HuHaa 是否已安装
-  - [ ] 检查 `sources.yaml` 是否存在
-  - [ ] 读取上次扫描时间（`cache.json` metadata）
-  - [ ] 根据时间判断是否需要重新扫描
-- [ ] 创建启动助手：`service/bin/lib/smart-launch.mjs`
-  - [ ] 如果今天已扫描：直接打开 localhost:11520
-  - [ ] 如果未扫描或 >1 天：提示用户扫描选项
-  - [ ] 支持跳过提示（`--skip-check` flag）
-
-### 📖 文档完善
-- [x] 创建快速启动指南：`docs/GUIDE.md`
-  - [x] 三种安装方式
-  - [x] 首次配置步骤
-  - [x] 命令参考表
-  - [x] 常见场景和故障排查
-- [x] 创建发布规范：`docs/RULES.md`
-  - [x] 版本号规则（SemVer）
-  - [x] Commit 格式标准（Conventional Commits）
-  - [x] GitHub Issues / PR 模板
-  - [x] Release Notes 格式
-  - [x] 文档结构规范
-
-### 🔎 前端搜索优化
-- [ ] 改进搜索框 UX：支持快捷键 `/` 聚焦搜索、支持 `Escape` 清空
-- [ ] 优化列表虚拟滚动，处理 800+ 条目性能
-- [ ] 支持键盘导航（上/下箭头切换列表，Enter 打开详情）
-
-### 🔧 Server 端增强
-- [ ] 添加 `/api/search?q=...&source=...&brand=...` 快速搜索端点
-- [ ] 添加 `/api/state` 端点返回扫描时间和统计信息
-- [ ] 优化 SSE 连接稳定性，处理长连接断开重连
-- [ ] 改进错误响应，返回更清晰的错误信息
-
-### 📊 扫描器稳定性
-- [ ] 增强 frontmatter 解析容错，支持更多 YAML 变体
-- [ ] 改进 brand 和 category 推断逻辑
-- [ ] 添加扫描统计信息元数据（成功/失败/跳过/耗时）
-- [ ] 记录上次扫描时间到 `cache.json` metadata
-
-## 测试
-- [ ] 状态检测逻辑正确性 100%
-- [ ] 搜索功能覆盖率 > 85%
-- [ ] UI 响应时间 < 100ms（800 条目）
-- [ ] Hermes skill 加载无误
-
-## 验收标准
-- ✅ Hermes 中可见 `huhaa-myskills-manager` 技能
-- ✅ 调用技能自动检测状态：已扫描 → 直接打开 | 未扫描 → 提示选项
-- ✅ 搜索延迟 < 5ms（Fuse.js）
-- ✅ 键盘导航完全可用
-- ✅ 文档规范清晰，符合 GitHub 官方标准
-- ✅ 新用户按 GUIDE.md 可快速上手
-
-## 预期周期
-1.5 周
-
-## 交付物
-1. `~/.hermes/skills/huhaa-myskills/SKILL.md` - Hermes 技能文件
-2. `docs/GUIDE.md` - 快速启动指南
-3. `docs/RULES.md` - 发布规范
-4. `service/scripts/detect-state.mjs` - 状态检测脚本
-5. 前端键盘快捷键支持
-6. `/api/search` 和 `/api/state` 端点
-
-## 不包含
-- 不做复杂状态机（简单 if/else 检测即可）
-- 不做定时自动扫描（用户主动触发）
-- 不做搜索历史记录

package/docs/todo/v0.1.3.md

@@ -1,40 +0,0 @@
-# v0.1.3：Obsidian Vault 与 Claude Markdown 支持
-
-## 目标
-聚合 Obsidian vault 中标记 `#skill` 的笔记，支持 CLAUDE.md 全局指令文档。
-
-## 关键任务
-
-### 新适配器
-- [ ] 实现 `obsidian.adapter.mjs`：扫描 vault 中的 frontmatter tag
-  - [ ] 支持 `#skill` 和 `#plugin` 标签
-  - [ ] 提取 frontmatter 的 name / description / tags
-  - [ ] 从 note 前 50 行提取 preview
-- [ ] 实现 `claude-md.adapter.mjs`：项目根和 `~/.claude/CLAUDE.md`
-  - [ ] 识别 h2 标题作为 skill 名称
-  - [ ] 提取每个 h2 下的第一段作为 description
-
-### 配置
-- [ ] `sources.yaml` 新增 obsidian 源配置
-  ```yaml
-  obsidian:
-    enabled: false  # 用户手动启用
-    vaultPath: ~/Library/Mobile Documents/com~apple~CloudDocs/Obsidian
-    tags: [skill, plugin, mcp]
-  ```
-
-### 测试
-- [ ] 覆盖 Obsidian frontmatter 多种格式
-- [ ] 验证 Claude.md h2 切分正确
-
-## 验收标准
-- Obsidian vault 中的 skill 正常显示
-- Claude.md 内容无误解析
-- 源不存在时 unavailable 且不 crash
-
-## 预期周期
-1 周
-
-## 不包含
-- 不做 Obsidian sync
-- 不做 Claude.md 远程链接解析

package/docs/todo/v0.1.4.md

@@ -1,36 +0,0 @@
-# v0.1.4：分组与筛选增强
-
-## 目标
-支持四种分组方式切换，提供高级筛选面板，改进导航体验。
-
-## 关键任务
-
-### 前端
-- [ ] 实现分组切换按钮组：source / category / brand / product
-  - [ ] 每种分组方式下树状或卡片布局
-  - [ ] 分组数据缓存，切换不重新计算
-- [ ] 新增筛选面板：
-  - [ ] 多选源、分类、品牌
-  - [ ] 文本输入框与 Fuse.js 搜索组合
-  - [ ] 筛选结果实时更新
-- [ ] 改进详情页导航：prev/next 按钮在同分组内切换
-
-### UI
-- [ ] 面包屑导航显示当前分组路径
-- [ ] 未匹配项提示友好
-
-### 测试
-- [ ] 分组计算正确性 > 90%
-- [ ] 筛选组合场景覆盖
-
-## 验收标准
-- 四种分组方式可切换
-- 筛选组合生效
-- 面包屑导航准确
-
-## 预期周期
-1.5 周
-
-## 不包含
-- 不做收藏/书签功能
-- 不做分组嵌套（固定四层）

package/docs/todo/v0.1.5.md

@@ -1,41 +0,0 @@
-# v0.1.5：导出与分享
-
-## 目标
-支持导出技能列表、分享筛选结果、生成 Markdown 报告。
-
-## 关键任务
-
-### 导出功能
-- [ ] 导出筛选结果为 JSON / CSV / Markdown
-  - [ ] `/api/export?format=json&filters=...`
-  - [ ] 支持完整内容或元数据压缩
-- [ ] 生成技能报告
-  - [ ] 按源统计：总数、分类数、平均大小
-  - [ ] 生成 Markdown report
-- [ ] 导出为 HTML 离线浏览
-  - [ ] 集合版本 + 日期戳
-
-### 分享
-- [ ] 生成筛选 URL：`?source=hermes&brand=OpenAI&q=...`
-- [ ] 复制分享链接到剪贴板
-- [ ] 支持导入分享 URL 恢复筛选状态
-
-### UI
-- [ ] 导出菜单（下载按钮）
-- [ ] 分享面板（复制链接 + QR 码生成）
-
-## 测试
-- [ ] 导出格式正确性
-- [ ] 分享 URL 稳定且可恢复
-
-## 验收标准
-- 导出 JSON/CSV/Markdown 可用
-- 分享 URL 能恢复筛选
-- 离线 HTML 完整可用
-
-## 预期周期
-1 周
-
-## 不包含
-- 不做云端分享
-- 不做版本对比

package/docs/todo/v0.1.6.md

@@ -1,43 +0,0 @@
-# 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

@@ -1,38 +0,0 @@
-# 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

@@ -1,36 +0,0 @@
-# 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

@@ -1,54 +0,0 @@
-# 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 方向（跨机器聚合、团队共享等）