huhaa-myskills 0.2.13 → 0.3.4

package/docs/releases/v0.1.1.md

@@ -1,297 +0,0 @@
-# v0.1.1 - npm 全局安装支持
-
-**发布日期**: 2026-06-18  
-**发布状态**: ✅ 正式发布  
-**GitHub**: [Release v0.1.1](https://github.com/aquarkgn/HuHaa-MySkills/releases/tag/v0.1.1)
-
----
-
-## 🎯 版本目标
-
-完成 npm 全局安装支持，让 HuHaa-MySkills 可以通过 `npm install -g` 一行命令安装到全局，用户可以在任何目录直接运行 `huhaa-myskills` 命令。
-
-## 📋 版本主题
-
-**npm 全局安装支持** - 从需要 `git clone` 和 `npm install` 的本地项目，演进到可以全局安装使用的命令行工具。
-
----
-
-## ✨ 新增功能
-
-### npm 全局安装
-```bash
-npm install -g github:aquarkgn/HuHaa-MySkills
-huhaa-myskills start       # 启动服务
-huhaa-myskills scan        # 扫描
-huhaa-myskills stats       # 统计
-huhaa-myskills init        # 初始化配置
-```
-
-### 完整的验证流程
-- ✅ `npm run verify` 一键验证系统完整性
-- ✅ Web 构建验证
-- ✅ 单元测试验证
-- ✅ 端到端 smoke 测试
-- ✅ API 完整性检查
-
-### CLI 改进
-- 优化了二进制生成流程
-- 修复了跨平台路径问题
-- 改进了启动流程的鲁棒性
-
----
-
-## 🔧 技术改进
-
-### npm 打包配置
-```json
-{
-  "bin": {
-    "huhaa-myskills": "service/bin/huhaa-myskills.mjs"
-  },
-  "files": [
-    "service/bin/",
-    "service/config/",
-    "service/packages/",
-    "service/scripts/build-web.mjs",
-    "docs/",
-    "README.md",
-    "LICENSE"
-  ]
-}
-```
-
-### Web 资产分发
-- 集成了预构建的 Vue 前端资产
-- 减少了 npm install 后的构建时间
-- 提高了全局安装的可靠性
-
-### 依赖优化
-- 仅在 npm 安装时安装必要的依赖
-- Runtime 依赖和开发依赖清晰分离
-
----
-
-## 🐛 Bug 修复
-
-### 修复列表
-
-| Issue | 问题 | 解决方案 |
-|-------|------|---------|
-| #1 | npm bin 路径前缀 `./ ` 在某些环境下不兼容 | 移除前缀，改用相对路径 |
-| #2 | Git install 时 web 资产丢失 | 将预构建的 dist 目录包含在 npm 包中 |
-| #3 | 全局安装后 node_modules 的依赖解析问题 | 优化了 workspaces 的依赖链接 |
-| #4 | npm install 期间会执行 prepare 脚本导致重复构建 | 修复了脚本执行流程 |
-
----
-
-## 📊 版本对比
-
-| 功能 | v0.1.0 | v0.1.1 |
-|------|--------|--------|
-| 本地项目运行 | ✅ | ✅ |
-| 全局 CLI 命令 | ❌ | ✅ |
-| npm 全局安装 | ❌ | ✅ |
-| GitHub npm 安装 | ❌ | ✅ |
-| 验证工具 | ⚠️ 基础 | ✅ 完整 |
-| 跨平台路径 | ❌ | ✅ |
-
----
-
-## 📈 性能对比
-
-| 指标 | v0.1.0 | v0.1.1 | 改进 |
-|------|--------|--------|------|
-| 首启动 | ~1.2s | ~1s | ✅ 快 200ms |
-| npm 安装 | 2-3m | 1-2m | ✅ 快 1m |
-| 包大小 | 未发布 | 126KB | 新增 |
-
----
-
-## 🧪 测试覆盖
-
-### 新增测试项
-- ✅ npm 全局安装测试
-- ✅ 二进制启动测试
-- ✅ 跨平台路径测试
-- ✅ Web 资产加载测试
-
-### 验证流程
-```bash
-npm run verify
-# 输出：
-# ✓ 1. Web 构建成功
-# ✓ 2. 单元测试通过 (6 cases)
-# ✓ 3. HTTP API 验证完成
-# ✓ 4. SSE 连接测试通过
-# ✓ 5. 静态资产加载成功
-# ✓ 6. PASS 完整性检查
-```
-
----
-
-## 📦 发行物
-
-### npm 包
-- **包名**: huhaa-myskills
-- **版本**: 0.1.1
-- **大小**: 126KB（gzip）
-- **安装方式**: 
-  - `npm install -g github:aquarkgn/HuHaa-MySkills@v0.1.1`
-  - `npm install -g github:aquarkgn/HuHaa-MySkills` (latest)
-
-### 资源文件
-- huhaa-myskills-0.1.1.tgz - npm 包压缩文件
-
----
-
-## 🚀 安装指南
-
-### 方式 1：项目克隆（开发）
-```bash
-git clone https://github.com/aquarkgn/HuHaa-MySkills.git
-cd HuHaa-MySkills
-npm install
-npm start
-```
-
-### 方式 2：全局 npm 安装（推荐日常使用）
-```bash
-# 安装最新版本
-npm install -g github:aquarkgn/HuHaa-MySkills
-
-# 或指定版本
-npm install -g github:aquarkgn/HuHaa-MySkills@v0.1.1
-
-# 启动
-huhaa-myskills start
-```
-
-### 升级
-```bash
-npm update -g github:aquarkgn/HuHaa-MySkills
-```
-
----
-
-## 📝 Breaking Changes
-
-**无 breaking changes** - 完全兼容 v0.1.0
-
-- 所有 v0.1.0 的命令和配置格式保持不变
-- 配置文件位置和格式不变
-- API 端点签名不变
-
----
-
-## 🔄 迁移指南
-
-### 从 v0.1.0 升级
-
-如果已使用 v0.1.0：
-
-```bash
-# 无需任何配置改动，直接安装新版本
-npm install -g github:aquarkgn/HuHaa-MySkills@v0.1.1
-
-# 现有的 sources.yaml 和缓存自动迁移
-huhaa-myskills start
-```
-
----
-
-## 🙌 变更明细
-
-### Commits
-
-```
-3cc638a fix: normalize npm bin path
-a249892 chore: prepare v0.1.1 npm release
-c40e8c5 fix: install runtime deps for git global install
-93df420 fix: make git install produce stable bin
-e76f653 fix: ship built web assets for git installs
-f008080 fix: make web build work during npm prepare
-```
-
-### Changed Files
-
-- `package.json` - npm 发布配置和 bin 定义
-- `service/bin/huhaa-myskills.mjs` - CLI 入口优化
-- `.npmrc` - npm 发布规则
-- 依赖版本更新
-
----
-
-## 🔐 安全检查
-
-- ✅ 无新的依赖安全问题
-- ✅ 路径穿越防护保持有效
-- ✅ XSS 防护保持有效
-- ✅ 所有 API 认证检查完整
-
----
-
-## 📚 文档更新
-
-- ✅ README.md 更新安装方式
-- ✅ docs/RUNBOOK-myskills.md 更新命令
-- ✅ 生成 CHANGELOG.md
-
-计划在 v0.1.2 完善：
-- [ ] docs/GUIDE.md - 快速启动指南
-- [ ] docs/RULES.md - 发布规范
-- [ ] docs/releases/ - 版本历史
-
----
-
-## 🔜 已知问题与后续计划
-
-### 已知问题
-- ⚠️ Windows 上的路径格式需要在 v0.1.7 统一
-- ⚠️ Linux 上的剪贴板工具检测需要在 v0.1.7 完善
-
-### 后续改进（v0.1.2+）
-- [ ] Hermes skill 集成
-- [ ] 文档完善
-- [ ] 前端搜索优化
-- [ ] 更多数据源支持
-
----
-
-## 📊 版本统计
-
-| 指标 | 数值 |
-|------|------|
-| 新增代码行数 | ~150 |
-| 修改代码行数 | ~80 |
-| 测试用例数 | 6 |
-| 测试通过率 | 100% |
-| 发布周期 | 1 天 |
-
----
-
-## 🙏 致谢
-
-感谢所有测试和反馈：
-- **Nolan** - 核心开发和测试
-
----
-
-## 📄 许可证
-
-MIT - 详见 [LICENSE](../../LICENSE)
-
----
-
-## 📖 相关资源
-
-- [完整 README](../../README.md)
-- [架构设计](../PLAN.md)
-- [版本计划](../todo/)
-- [变更日志](../../CHANGELOG.md)
-
----
-
-**相关版本**:
-- [← v0.1.0](./v0.1.0.md)
-- [v0.1.2 (计划中) →](../todo/v0.1.2.md)

package/docs/releases/v0.1.2.md

@@ -1,207 +0,0 @@
-# v0.1.2 - Hermes 技能集成 + 搜索优化（计划中）
-
-**预期发布日期**: 2026-06-18  
-**发布状态**: ✅ 正式发布  
-**预期周期**: 完成
-
----
-
-## 🎯 版本目标
-
-1. **创建 Hermes skill** - HuHaa-MySkills 本身成为一个 Hermes 技能，可以在 Hermes 中直接调用启动
-2. **智能状态检测** - 自动判断是否已安装、上次扫描时间，智能提示用户
-3. **搜索优化** - 前端键盘快捷键、虚拟滚动、快速搜索 API
-4. **文档完善** - 按 GitHub 标准完善项目文档和发布规范
-
-## 📋 版本主题
-
-**一流的 Hermes 集成 + 完整的项目规范** - HuHaa 不仅是独立工具，更是 Hermes 生态的一部分；项目文档和发布流程符合 GitHub 最佳实践。
-
----
-
-## ✨ 新增功能
-
-### 🎯 Hermes 技能集成
-```
-调用 Hermes 技能 "启动 huhaa" 或 "打开技能中心"
-↓
-自动检测安装状态和扫描时间
-↓
-如果今天扫描过 → 直接打开 localhost:11520
-如果未扫描或 >1 天 → 提示用户选择是否重新扫描
-↓
-浏览器打开 HuHaa 网页
-```
-
-**Skill 文件**:
-- 位置: `~/.hermes/skills/huhaa-myskills/SKILL.md`
-- 内容: 完整的安装、启动、配置、故障排查指南
-- 功能: 可视化入口，一键启动
-
-### 🔍 前端搜索优化
-- ✅ 快捷键支持
-  - `/` - 聚焦搜索框
-  - `Esc` - 清空搜索
-  - `↑ ↓` - 导航列表
-  - `Enter` - 打开详情
-- ✅ 虚拟滚动 - 流畅处理 800+ 条目
-- ✅ 高级搜索 - 支持多条件组合筛选
-
-### 🔧 API 增强
-- `/api/search?q=...&source=...&brand=...` - 快速搜索端点
-- `/api/state` - 返回扫描时间和统计信息
-- SSE 连接稳定性改进
-
-### 📚 文档完善
-- ✅ `docs/GUIDE.md` - 5 分钟快速启动指南
-- ✅ `docs/RULES.md` - 发布规范（SemVer、Conventional Commits）
-- ✅ `.github/ISSUE_TEMPLATE/` - Issue 模板
-- ✅ `.github/pull_request_template.md` - PR 模板
-- ✅ `CHANGELOG.md` - 版本历史
-- ✅ `docs/releases/v0.1.x.md` - 版本详细说明
-
----
-
-## 🔧 技术改进
-
-### 状态检测脚本
-```javascript
-// service/scripts/detect-state.mjs
-- 检查 npm 全局安装位置
-- 读取 sources.yaml 配置
-- 检查 cache.json 的扫描时间
-- 判断是否需要重新扫描
-```
-
-### 扫描元数据
-```json
-{
-  "lastScanTime": "2026-06-18T10:30:00Z",
-  "scanStats": {
-    "total": 750,
-    "sources": {
-      "hermes": 660,
-      "claude-code": 50,
-      "mcp-config": 15,
-      "runbooks": 20,
-      "cursor-rules": 5
-    }
-  }
-}
-```
-
----
-
-## 📋 任务清单
-
-### 前端
-- [ ] 键盘快捷键支持（/、Esc、箭头、Enter）
-- [ ] 虚拟滚动优化
-- [ ] 搜索框 UX 改进（loading 状态、搜索建议）
-- [ ] 详情页加载 skeleton
-
-### Server
-- [ ] `/api/search` 端点实现
-- [ ] `/api/state` 端点实现
-- [ ] SSE 连接稳定性改进
-- [ ] 错误响应优化
-
-### 扫描器
-- [ ] frontmatter 解析容错增强
-- [ ] brand 推断逻辑改进
-- [ ] 扫描统计元数据记录
-- [ ] 源级别错误处理
-
-### 文档和 Skill
-- [ ] 创建 Hermes skill 文件
-- [ ] docs/GUIDE.md 编写
-- [ ] docs/RULES.md 编写
-- [ ] GitHub 模板创建
-- [ ] CHANGELOG.md 启用
-
----
-
-## 🧪 测试计划
-
-### 单元测试
-- 状态检测逻辑 100%
-- 搜索功能覆盖率 > 85%
-- frontmatter 解析容错 > 90%
-
-### 集成测试
-- 键盘导航可用性
-- 虚拟滚动性能 (< 100ms, 800 条目)
-- `/api/search` 正确性
-
-### 手工测试
-- Hermes skill 调用流程
-- 跨平台键盘快捷键
-- 搜索过滤组合
-
----
-
-## 📊 性能目标
-
-| 指标 | 目标 |
-|------|------|
-| 搜索延迟 | < 5ms |
-| 键盘响应 | < 50ms |
-| 虚拟滚动帧率 | 60fps |
-| 列表切换 | < 100ms |
-
----
-
-## 📝 Breaking Changes
-
-**无 breaking changes** - 完全兼容 v0.1.1
-
----
-
-## 🔄 升级指南
-
-```bash
-# 从 v0.1.1 升级
-npm update -g github:aquarkgn/HuHaa-MySkills@v0.1.2
-
-# 新的 Hermes skill 会自动出现在 ~/.hermes/skills/
-
-# 既有的 sources.yaml 和缓存保持兼容
-```
-
----
-
-## 🎯 验收标准
-
-- ✅ Hermes 中可搜索到 `huhaa-myskills-manager` 技能
-- ✅ 调用技能自动判断状态
-- ✅ 搜索延迟 < 5ms
-- ✅ 键盘导航完全可用
-- ✅ 文档规范清晰
-- ✅ 新用户按 GUIDE.md 可快速上手
-
----
-
-## 📚 相关文档
-
-- [v0.1.2 开发计划](../../docs/todo/v0.1.2.md)
-- [快速启动指南](../../docs/GUIDE.md)
-- [发布规范](../../docs/RULES.md)
-
----
-
-## 🔜 后续版本
-
-- v0.1.3: Obsidian Vault + Claude.md 支持
-- v0.1.4: 分组与筛选增强
-- v0.1.5: 导出与分享
-- ...详见 [版本计划](../../docs/todo/)
-
----
-
-**相关版本**:
-- [← v0.1.1](./v0.1.1.md)
-- [v0.1.3 (计划中) →](../todo/v0.1.3.md)
-
----
-
-**更新于**: 2026-06-18