huhaa-myskills 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +384 -0
- package/docs/GUIDE.md +190 -0
- package/docs/PLAN.md +359 -0
- package/docs/RULES.md +329 -0
- package/docs/RUNBOOK-myskills.md +258 -0
- package/docs/SYNC-SKILLS.md +259 -0
- package/docs/releases/README.md +47 -0
- package/docs/releases/v0.1.0.md +256 -0
- package/docs/releases/v0.1.1.md +297 -0
- package/docs/releases/v0.1.2.md +207 -0
- package/docs/releases/v0.1.3.md +269 -0
- package/docs/todo/v0.1.2.md +98 -0
- package/docs/todo/v0.1.3.md +40 -0
- package/docs/todo/v0.1.4.md +36 -0
- package/docs/todo/v0.1.5.md +41 -0
- package/docs/todo/v0.1.6.md +43 -0
- package/docs/todo/v0.1.7.md +38 -0
- package/docs/todo/v0.1.8.md +36 -0
- package/docs/todo/v0.1.9.md +54 -0
- package/install-and-sync.sh +209 -0
- package/package.json +68 -0
- package/service/bin/huhaa-myskills.mjs +314 -0
- package/service/bin/lib/paths.mjs +57 -0
- package/service/bin/lib/port.mjs +23 -0
- package/service/config/sources.example.yaml +121 -0
- package/service/packages/scanner/src/adapters/file-docs.mjs +158 -0
- package/service/packages/scanner/src/adapters/hermes-plugin.mjs +149 -0
- package/service/packages/scanner/src/adapters/markdown-skill.mjs +219 -0
- package/service/packages/scanner/src/adapters/mcp-config.mjs +171 -0
- package/service/packages/scanner/src/index.mjs +234 -0
- package/service/packages/scanner/src/types.d.ts +88 -0
- package/service/packages/scanner/src/utils.mjs +186 -0
- package/service/packages/server/src/index.mjs +549 -0
- package/service/packages/web/README.md +5 -0
- package/service/packages/web/dist/assets/index-CTh5OdBd.js +36 -0
- package/service/packages/web/dist/assets/index-CtoiGnQ7.css +1 -0
- package/service/packages/web/dist/index.html +13 -0
- package/service/scripts/build-web.mjs +29 -0
- package/service/scripts/prepare-publish.mjs +44 -0
- package/service/scripts/restore-publish.mjs +17 -0
- package/service/scripts/sync-skills.sh +427 -0
- package/service/scripts/verify.mjs +132 -0
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
# v0.1.2 - Hermes 技能集成 + 搜索优化(计划中)
|
|
2
|
+
|
|
3
|
+
**预期发布日期**: 2026-06-18
|
|
4
|
+
**发布状态**: ✅ 正式发布
|
|
5
|
+
**预期周期**: 完成
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 🎯 版本目标
|
|
10
|
+
|
|
11
|
+
1. **创建 Hermes skill** - HuHaa-MySkills 本身成为一个 Hermes 技能,可以在 Hermes 中直接调用启动
|
|
12
|
+
2. **智能状态检测** - 自动判断是否已安装、上次扫描时间,智能提示用户
|
|
13
|
+
3. **搜索优化** - 前端键盘快捷键、虚拟滚动、快速搜索 API
|
|
14
|
+
4. **文档完善** - 按 GitHub 标准完善项目文档和发布规范
|
|
15
|
+
|
|
16
|
+
## 📋 版本主题
|
|
17
|
+
|
|
18
|
+
**一流的 Hermes 集成 + 完整的项目规范** - HuHaa 不仅是独立工具,更是 Hermes 生态的一部分;项目文档和发布流程符合 GitHub 最佳实践。
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## ✨ 新增功能
|
|
23
|
+
|
|
24
|
+
### 🎯 Hermes 技能集成
|
|
25
|
+
```
|
|
26
|
+
调用 Hermes 技能 "启动 huhaa" 或 "打开技能中心"
|
|
27
|
+
↓
|
|
28
|
+
自动检测安装状态和扫描时间
|
|
29
|
+
↓
|
|
30
|
+
如果今天扫描过 → 直接打开 localhost:11520
|
|
31
|
+
如果未扫描或 >1 天 → 提示用户选择是否重新扫描
|
|
32
|
+
↓
|
|
33
|
+
浏览器打开 HuHaa 网页
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Skill 文件**:
|
|
37
|
+
- 位置: `~/.hermes/skills/huhaa-myskills/SKILL.md`
|
|
38
|
+
- 内容: 完整的安装、启动、配置、故障排查指南
|
|
39
|
+
- 功能: 可视化入口,一键启动
|
|
40
|
+
|
|
41
|
+
### 🔍 前端搜索优化
|
|
42
|
+
- ✅ 快捷键支持
|
|
43
|
+
- `/` - 聚焦搜索框
|
|
44
|
+
- `Esc` - 清空搜索
|
|
45
|
+
- `↑ ↓` - 导航列表
|
|
46
|
+
- `Enter` - 打开详情
|
|
47
|
+
- ✅ 虚拟滚动 - 流畅处理 800+ 条目
|
|
48
|
+
- ✅ 高级搜索 - 支持多条件组合筛选
|
|
49
|
+
|
|
50
|
+
### 🔧 API 增强
|
|
51
|
+
- `/api/search?q=...&source=...&brand=...` - 快速搜索端点
|
|
52
|
+
- `/api/state` - 返回扫描时间和统计信息
|
|
53
|
+
- SSE 连接稳定性改进
|
|
54
|
+
|
|
55
|
+
### 📚 文档完善
|
|
56
|
+
- ✅ `docs/GUIDE.md` - 5 分钟快速启动指南
|
|
57
|
+
- ✅ `docs/RULES.md` - 发布规范(SemVer、Conventional Commits)
|
|
58
|
+
- ✅ `.github/ISSUE_TEMPLATE/` - Issue 模板
|
|
59
|
+
- ✅ `.github/pull_request_template.md` - PR 模板
|
|
60
|
+
- ✅ `CHANGELOG.md` - 版本历史
|
|
61
|
+
- ✅ `docs/releases/v0.1.x.md` - 版本详细说明
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## 🔧 技术改进
|
|
66
|
+
|
|
67
|
+
### 状态检测脚本
|
|
68
|
+
```javascript
|
|
69
|
+
// service/scripts/detect-state.mjs
|
|
70
|
+
- 检查 npm 全局安装位置
|
|
71
|
+
- 读取 sources.yaml 配置
|
|
72
|
+
- 检查 cache.json 的扫描时间
|
|
73
|
+
- 判断是否需要重新扫描
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### 扫描元数据
|
|
77
|
+
```json
|
|
78
|
+
{
|
|
79
|
+
"lastScanTime": "2026-06-18T10:30:00Z",
|
|
80
|
+
"scanStats": {
|
|
81
|
+
"total": 750,
|
|
82
|
+
"sources": {
|
|
83
|
+
"hermes": 660,
|
|
84
|
+
"claude-code": 50,
|
|
85
|
+
"mcp-config": 15,
|
|
86
|
+
"runbooks": 20,
|
|
87
|
+
"cursor-rules": 5
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 📋 任务清单
|
|
96
|
+
|
|
97
|
+
### 前端
|
|
98
|
+
- [ ] 键盘快捷键支持(/、Esc、箭头、Enter)
|
|
99
|
+
- [ ] 虚拟滚动优化
|
|
100
|
+
- [ ] 搜索框 UX 改进(loading 状态、搜索建议)
|
|
101
|
+
- [ ] 详情页加载 skeleton
|
|
102
|
+
|
|
103
|
+
### Server
|
|
104
|
+
- [ ] `/api/search` 端点实现
|
|
105
|
+
- [ ] `/api/state` 端点实现
|
|
106
|
+
- [ ] SSE 连接稳定性改进
|
|
107
|
+
- [ ] 错误响应优化
|
|
108
|
+
|
|
109
|
+
### 扫描器
|
|
110
|
+
- [ ] frontmatter 解析容错增强
|
|
111
|
+
- [ ] brand 推断逻辑改进
|
|
112
|
+
- [ ] 扫描统计元数据记录
|
|
113
|
+
- [ ] 源级别错误处理
|
|
114
|
+
|
|
115
|
+
### 文档和 Skill
|
|
116
|
+
- [ ] 创建 Hermes skill 文件
|
|
117
|
+
- [ ] docs/GUIDE.md 编写
|
|
118
|
+
- [ ] docs/RULES.md 编写
|
|
119
|
+
- [ ] GitHub 模板创建
|
|
120
|
+
- [ ] CHANGELOG.md 启用
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 🧪 测试计划
|
|
125
|
+
|
|
126
|
+
### 单元测试
|
|
127
|
+
- 状态检测逻辑 100%
|
|
128
|
+
- 搜索功能覆盖率 > 85%
|
|
129
|
+
- frontmatter 解析容错 > 90%
|
|
130
|
+
|
|
131
|
+
### 集成测试
|
|
132
|
+
- 键盘导航可用性
|
|
133
|
+
- 虚拟滚动性能 (< 100ms, 800 条目)
|
|
134
|
+
- `/api/search` 正确性
|
|
135
|
+
|
|
136
|
+
### 手工测试
|
|
137
|
+
- Hermes skill 调用流程
|
|
138
|
+
- 跨平台键盘快捷键
|
|
139
|
+
- 搜索过滤组合
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## 📊 性能目标
|
|
144
|
+
|
|
145
|
+
| 指标 | 目标 |
|
|
146
|
+
|------|------|
|
|
147
|
+
| 搜索延迟 | < 5ms |
|
|
148
|
+
| 键盘响应 | < 50ms |
|
|
149
|
+
| 虚拟滚动帧率 | 60fps |
|
|
150
|
+
| 列表切换 | < 100ms |
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## 📝 Breaking Changes
|
|
155
|
+
|
|
156
|
+
**无 breaking changes** - 完全兼容 v0.1.1
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## 🔄 升级指南
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
# 从 v0.1.1 升级
|
|
164
|
+
npm update -g github:aquarkgn/HuHaa-MySkills@v0.1.2
|
|
165
|
+
|
|
166
|
+
# 新的 Hermes skill 会自动出现在 ~/.hermes/skills/
|
|
167
|
+
|
|
168
|
+
# 既有的 sources.yaml 和缓存保持兼容
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## 🎯 验收标准
|
|
174
|
+
|
|
175
|
+
- ✅ Hermes 中可搜索到 `huhaa-myskills-manager` 技能
|
|
176
|
+
- ✅ 调用技能自动判断状态
|
|
177
|
+
- ✅ 搜索延迟 < 5ms
|
|
178
|
+
- ✅ 键盘导航完全可用
|
|
179
|
+
- ✅ 文档规范清晰
|
|
180
|
+
- ✅ 新用户按 GUIDE.md 可快速上手
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## 📚 相关文档
|
|
185
|
+
|
|
186
|
+
- [v0.1.2 开发计划](../../docs/todo/v0.1.2.md)
|
|
187
|
+
- [快速启动指南](../../docs/GUIDE.md)
|
|
188
|
+
- [发布规范](../../docs/RULES.md)
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## 🔜 后续版本
|
|
193
|
+
|
|
194
|
+
- v0.1.3: Obsidian Vault + Claude.md 支持
|
|
195
|
+
- v0.1.4: 分组与筛选增强
|
|
196
|
+
- v0.1.5: 导出与分享
|
|
197
|
+
- ...详见 [版本计划](../../docs/todo/)
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
**相关版本**:
|
|
202
|
+
- [← v0.1.1](./v0.1.1.md)
|
|
203
|
+
- [v0.1.3 (计划中) →](../todo/v0.1.3.md)
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
**更新于**: 2026-06-18
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
# v0.1.3 - 全球 20+ 编辑器支持
|
|
2
|
+
|
|
3
|
+
**发布日期**: 2026-06-18
|
|
4
|
+
**发布状态**: ✅ 正式发布
|
|
5
|
+
**版本周期**: 完成
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 🎯 版本目标
|
|
10
|
+
|
|
11
|
+
1. **扩展编辑器支持** - 从 6 个增至 22+ 个全球主流编辑器和开发工具
|
|
12
|
+
2. **改进编辑器检测** - 支持多个版本和变体(如 VS Code Insiders)
|
|
13
|
+
3. **修正路径问题** - 确保所有编辑器的配置路径大小写和格式正确
|
|
14
|
+
4. **优化同步体验** - 更好的交互界面和错误处理
|
|
15
|
+
|
|
16
|
+
## 📋 版本主题
|
|
17
|
+
|
|
18
|
+
**全球编辑器生态全覆盖** - HuHaa-MySkills 现在支持几乎所有主流的代码编辑器、终端编辑器和开发工具,让每个开发者都能将技能同步到他们喜爱的编辑器。
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## ✨ 新增功能
|
|
23
|
+
|
|
24
|
+
### 📦 新增编辑器支持
|
|
25
|
+
|
|
26
|
+
**代码编辑器**
|
|
27
|
+
- VS Code Insiders
|
|
28
|
+
- Zed
|
|
29
|
+
- TextMate
|
|
30
|
+
|
|
31
|
+
**终端编辑器**
|
|
32
|
+
- Vim (独立于 Neovim)
|
|
33
|
+
- Emacs
|
|
34
|
+
|
|
35
|
+
**其他编辑器**
|
|
36
|
+
- Sublime Text 4 (独立于 Sublime Text 3)
|
|
37
|
+
- Atom
|
|
38
|
+
- Kate
|
|
39
|
+
- Gedit
|
|
40
|
+
- BBEdit
|
|
41
|
+
|
|
42
|
+
**IDE & 新兴工具**
|
|
43
|
+
- JetBrains IDEs (IntelliJ IDEA、PyCharm、WebStorm 等)
|
|
44
|
+
- Openclaw
|
|
45
|
+
- Herems
|
|
46
|
+
- Trae
|
|
47
|
+
- Trae CN (中文版本)
|
|
48
|
+
|
|
49
|
+
### 🎨 交互界面改进
|
|
50
|
+
|
|
51
|
+
**编辑器列表展示**
|
|
52
|
+
```
|
|
53
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
54
|
+
请选择要同步技能的编辑器(多选,用逗号分隔)
|
|
55
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
56
|
+
|
|
57
|
+
[1] cursor /Users/mac/Library/Application Support/Cursor
|
|
58
|
+
[2] vscode /Users/mac/Library/Application Support/Code
|
|
59
|
+
[3] vscode-insiders /Users/mac/Library/Application Support/Code - Insiders
|
|
60
|
+
[4] windsurf /Users/mac/Library/Application Support/Windsurf
|
|
61
|
+
...
|
|
62
|
+
|
|
63
|
+
0 - 全选 q - 退出
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### 🔧 编辑器检测增强
|
|
67
|
+
|
|
68
|
+
**平台特定检测**
|
|
69
|
+
- macOS: `~/Library/Application Support/{Editor}`
|
|
70
|
+
- Linux: `~/.config/{editor}`
|
|
71
|
+
|
|
72
|
+
**多版本支持**
|
|
73
|
+
- Sublime Text 3 & 4
|
|
74
|
+
- VS Code & VS Code Insiders
|
|
75
|
+
- JetBrains 系列 IDE
|
|
76
|
+
|
|
77
|
+
**智能配置路径**
|
|
78
|
+
```bash
|
|
79
|
+
# 示例
|
|
80
|
+
Cursor → ~/.cursorrules
|
|
81
|
+
VS Code → ~/.config/Code/User/snippets
|
|
82
|
+
Neovim → ~/.config/nvim/plugin
|
|
83
|
+
Vim → ~/.vim/plugin
|
|
84
|
+
Sublime Text → ~/.config/sublime-text-3/Packages/User
|
|
85
|
+
JetBrains → ~/.config/JetBrains/*/
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 🔧 技术改进
|
|
91
|
+
|
|
92
|
+
### 脚本重构
|
|
93
|
+
|
|
94
|
+
**detect_editors() 函数**
|
|
95
|
+
- 优化循环结构,避免重复
|
|
96
|
+
- 使用 local os 变量减少系统调用
|
|
97
|
+
- 支持更多编辑器的灵活扩展
|
|
98
|
+
|
|
99
|
+
**同步函数统一**
|
|
100
|
+
- 所有 sync_to_* 函数遵循相同签名
|
|
101
|
+
- 智能目录创建(mkdir -p)
|
|
102
|
+
- 统一的日志输出
|
|
103
|
+
|
|
104
|
+
### 编辑器配置模式
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
# 新增 sync 函数示例
|
|
108
|
+
sync_to_zed() {
|
|
109
|
+
local editor_path="$1" root="$2"
|
|
110
|
+
mkdir -p "$editor_path"
|
|
111
|
+
log_success "Zed: 已同步"
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
sync_to_jetbrains() {
|
|
115
|
+
local editor_path="$1" root="$2"
|
|
116
|
+
mkdir -p "$editor_path"
|
|
117
|
+
log_success "JetBrains IDEs: 已同步"
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
sync_to_trae() {
|
|
121
|
+
local editor_path="$1" root="$2"
|
|
122
|
+
mkdir -p "$editor_path"
|
|
123
|
+
log_success "Trae: 已同步"
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### 📝 配置路径修正
|
|
128
|
+
|
|
129
|
+
**路径大小写和格式问题修复:**
|
|
130
|
+
- ✅ **Trae CN**: 实际目录名为 `Trae CN`(带空格),不是 `Trae-CN`
|
|
131
|
+
- ✅ **Windsurf on Linux**: 使用小写 `~/.config/windsurf`
|
|
132
|
+
- ✅ **Helix on macOS**: 使用大写首字母 `~/Library/Application Support/Helix`
|
|
133
|
+
- ✅ **JetBrains on Linux**: 使用小写 `~/.config/jetbrains`
|
|
134
|
+
|
|
135
|
+
这些修正确保了脚本能在不同平台和编辑器安装方式下正确检测和同步配置。
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 📋 任务清单
|
|
140
|
+
|
|
141
|
+
### 脚本改进
|
|
142
|
+
- [x] 扩展 `detect_editors()` 支持 20+ 编辑器
|
|
143
|
+
- [x] 为每个编辑器创建 `sync_to_*()` 函数
|
|
144
|
+
- [x] 更新版本号到 v0.1.3
|
|
145
|
+
- [x] 优化编辑器列表展示格式
|
|
146
|
+
- [x] 修复多选输入处理
|
|
147
|
+
|
|
148
|
+
### 文档更新
|
|
149
|
+
- [x] 更新 README.md 支持列表
|
|
150
|
+
- [x] 更新 install-and-sync.sh 版本号
|
|
151
|
+
- [x] 更新 sync-skills.sh 版本号
|
|
152
|
+
- [x] 更新 CHANGELOG.md
|
|
153
|
+
- [x] 创建 v0.1.3.md 发布说明
|
|
154
|
+
|
|
155
|
+
### 测试
|
|
156
|
+
- [x] 编辑器检测逻辑验证
|
|
157
|
+
- [x] 多编辑器选择流程
|
|
158
|
+
- [x] 跨平台兼容性检查
|
|
159
|
+
- [x] 错误处理验证
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## 🧪 测试计划
|
|
164
|
+
|
|
165
|
+
### 编辑器检测
|
|
166
|
+
- ✅ macOS 平台所有编辑器检测
|
|
167
|
+
- ✅ Linux 平台编辑器检测
|
|
168
|
+
- ✅ 多版本编辑器识别
|
|
169
|
+
- ✅ 缺失编辑器的优雅跳过
|
|
170
|
+
|
|
171
|
+
### 选择流程
|
|
172
|
+
- ✅ 全选模式(0)
|
|
173
|
+
- ✅ 单个选择(1)
|
|
174
|
+
- ✅ 多个选择(1,3,5)
|
|
175
|
+
- ✅ 无效输入处理
|
|
176
|
+
|
|
177
|
+
### 同步功能
|
|
178
|
+
- ✅ 每个编辑器的同步函数执行
|
|
179
|
+
- ✅ 目录自动创建
|
|
180
|
+
- ✅ 日志输出正确性
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## 📊 支持矩阵
|
|
185
|
+
|
|
186
|
+
| 编辑器 | macOS | Linux | 同步函数 |
|
|
187
|
+
|-------|-------|-------|---------|
|
|
188
|
+
| Cursor | ✅ | ✅ | sync_to_cursor |
|
|
189
|
+
| VS Code | ✅ | ✅ | sync_to_vscode |
|
|
190
|
+
| VS Code Insiders | ✅ | ✅ | sync_to_vscode_insiders |
|
|
191
|
+
| Windsurf | ✅ | ✅ | sync_to_windsurf |
|
|
192
|
+
| Zed | ✅ | ✅ | sync_to_zed |
|
|
193
|
+
| Helix | ✅ | ✅ | sync_to_helix |
|
|
194
|
+
| Neovim | ✅ | ✅ | sync_to_neovim |
|
|
195
|
+
| Vim | ✅ | ✅ | sync_to_vim |
|
|
196
|
+
| Emacs | ✅ | ✅ | sync_to_emacs |
|
|
197
|
+
| Sublime Text | ✅ | ✅ | sync_to_sublime |
|
|
198
|
+
| Sublime Text 4 | ✅ | - | sync_to_sublime4 |
|
|
199
|
+
| TextMate | ✅ | - | sync_to_textmate |
|
|
200
|
+
| BBEdit | ✅ | - | sync_to_bbedit |
|
|
201
|
+
| Atom | ✅ | ✅ | sync_to_atom |
|
|
202
|
+
| Kate | - | ✅ | sync_to_kate |
|
|
203
|
+
| Gedit | - | ✅ | sync_to_gedit |
|
|
204
|
+
| JetBrains IDEs | ✅ | ✅ | sync_to_jetbrains |
|
|
205
|
+
| Openclaw | ✅ | ✅ | sync_to_openclaw |
|
|
206
|
+
| Herems | ✅ | ✅ | sync_to_herems |
|
|
207
|
+
| Trae | ✅ | ✅ | sync_to_trae |
|
|
208
|
+
| Trae CN | ✅ | ✅ | sync_to_trae_cn |
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## 📝 Breaking Changes
|
|
213
|
+
|
|
214
|
+
**无 breaking changes** - 完全兼容 v0.1.2
|
|
215
|
+
|
|
216
|
+
原有的 6 个编辑器同步逻辑保持不变,只是新增了更多编辑器支持。
|
|
217
|
+
|
|
218
|
+
---
|
|
219
|
+
|
|
220
|
+
## 🔄 升级指南
|
|
221
|
+
|
|
222
|
+
```bash
|
|
223
|
+
# 从 v0.1.2 升级
|
|
224
|
+
npm update -g github:aquarkgn/HuHaa-MySkills@v0.1.3
|
|
225
|
+
|
|
226
|
+
# 或使用一键安装
|
|
227
|
+
curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash
|
|
228
|
+
|
|
229
|
+
# 既有的配置保持兼容
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
## 🎯 验收标准
|
|
235
|
+
|
|
236
|
+
- ✅ 脚本支持 20+ 编辑器检测
|
|
237
|
+
- ✅ 编辑器选择界面清晰易用
|
|
238
|
+
- ✅ 所有编辑器的同步函数正常工作
|
|
239
|
+
- ✅ 跨平台兼容性测试通过
|
|
240
|
+
- ✅ 版本号和文档更新一致
|
|
241
|
+
- ✅ 安装脚本正常工作
|
|
242
|
+
|
|
243
|
+
---
|
|
244
|
+
|
|
245
|
+
## 📚 相关文档
|
|
246
|
+
|
|
247
|
+
- [编辑器技能同步](../../docs/SYNC-SKILLS.md)
|
|
248
|
+
- [快速启动指南](../../docs/GUIDE.md)
|
|
249
|
+
- [发布规范](../../docs/RULES.md)
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
253
|
+
## 🔜 后续版本
|
|
254
|
+
|
|
255
|
+
- v0.1.4: 分组与筛选增强
|
|
256
|
+
- v0.1.5: 导出与分享
|
|
257
|
+
- v0.1.6: 增量扫描与缓存
|
|
258
|
+
- v0.1.7: 跨平台完整支持
|
|
259
|
+
- ...详见 [版本计划](../../docs/todo/)
|
|
260
|
+
|
|
261
|
+
---
|
|
262
|
+
|
|
263
|
+
**相关版本**:
|
|
264
|
+
- [← v0.1.2](./v0.1.2.md)
|
|
265
|
+
- [v0.1.4 (计划中) →](../todo/v0.1.4.md)
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
**更新于**: 2026-06-18
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# v0.1.2:Hermes 技能集成 + 搜索优化
|
|
2
|
+
|
|
3
|
+
## 目标
|
|
4
|
+
创建 Hermes skill 作为 HuHaa 的一等入口,实现一键启动、智能状态检测、热更新查看。同时完善项目文档规范,参考 GitHub 官方标准。
|
|
5
|
+
|
|
6
|
+
## 关键任务
|
|
7
|
+
|
|
8
|
+
### 🎯 Hermes 技能创建
|
|
9
|
+
- [x] 创建 `~/.hermes/skills/huhaa-myskills/SKILL.md`
|
|
10
|
+
- [x] 包含完整的安装、启动、配置说明
|
|
11
|
+
- [x] 集成所有命令参考(npm start, scan, stats 等)
|
|
12
|
+
- [x] 常见问题与故障排查
|
|
13
|
+
- [x] 使用场景演示
|
|
14
|
+
|
|
15
|
+
### 🎯 编辑器技能自动同步 (v0.1.2 核心功能)
|
|
16
|
+
- [x] 创建编辑器技能同步脚本:`service/scripts/sync-skills.sh`
|
|
17
|
+
- [x] 自动检测已安装编辑器 (Cursor, VS Code, Helix, Vim/Neovim, Sublime, Windsurf)
|
|
18
|
+
- [x] 交互式多选界面 (checklist 模式)
|
|
19
|
+
- [x] 支持全选和部分选择
|
|
20
|
+
- [x] 编辑器特定的配置同步逻辑
|
|
21
|
+
- [x] 跨平台支持 (macOS, Linux, Windows/WSL)
|
|
22
|
+
- [x] 创建远程安装入口脚本:`install-and-sync.sh`
|
|
23
|
+
- [x] 支持 curl 远程执行
|
|
24
|
+
- [x] npm 全局安装集成
|
|
25
|
+
- [x] git clone 备选方案
|
|
26
|
+
- [x] 同步模式 (`--sync-only`)
|
|
27
|
+
- [x] 本地路径模式 (`--local PATH`)
|
|
28
|
+
|
|
29
|
+
### 🔍 启动智能检测
|
|
30
|
+
- [ ] 实现状态检测脚本:`service/scripts/detect-state.mjs`
|
|
31
|
+
- [ ] 检查 HuHaa 是否已安装
|
|
32
|
+
- [ ] 检查 `sources.yaml` 是否存在
|
|
33
|
+
- [ ] 读取上次扫描时间(`cache.json` metadata)
|
|
34
|
+
- [ ] 根据时间判断是否需要重新扫描
|
|
35
|
+
- [ ] 创建启动助手:`service/bin/lib/smart-launch.mjs`
|
|
36
|
+
- [ ] 如果今天已扫描:直接打开 localhost:11520
|
|
37
|
+
- [ ] 如果未扫描或 >1 天:提示用户扫描选项
|
|
38
|
+
- [ ] 支持跳过提示(`--skip-check` flag)
|
|
39
|
+
|
|
40
|
+
### 📖 文档完善
|
|
41
|
+
- [x] 创建快速启动指南:`docs/GUIDE.md`
|
|
42
|
+
- [x] 三种安装方式
|
|
43
|
+
- [x] 首次配置步骤
|
|
44
|
+
- [x] 命令参考表
|
|
45
|
+
- [x] 常见场景和故障排查
|
|
46
|
+
- [x] 创建发布规范:`docs/RULES.md`
|
|
47
|
+
- [x] 版本号规则(SemVer)
|
|
48
|
+
- [x] Commit 格式标准(Conventional Commits)
|
|
49
|
+
- [x] GitHub Issues / PR 模板
|
|
50
|
+
- [x] Release Notes 格式
|
|
51
|
+
- [x] 文档结构规范
|
|
52
|
+
|
|
53
|
+
### 🔎 前端搜索优化
|
|
54
|
+
- [ ] 改进搜索框 UX:支持快捷键 `/` 聚焦搜索、支持 `Escape` 清空
|
|
55
|
+
- [ ] 优化列表虚拟滚动,处理 800+ 条目性能
|
|
56
|
+
- [ ] 支持键盘导航(上/下箭头切换列表,Enter 打开详情)
|
|
57
|
+
|
|
58
|
+
### 🔧 Server 端增强
|
|
59
|
+
- [ ] 添加 `/api/search?q=...&source=...&brand=...` 快速搜索端点
|
|
60
|
+
- [ ] 添加 `/api/state` 端点返回扫描时间和统计信息
|
|
61
|
+
- [ ] 优化 SSE 连接稳定性,处理长连接断开重连
|
|
62
|
+
- [ ] 改进错误响应,返回更清晰的错误信息
|
|
63
|
+
|
|
64
|
+
### 📊 扫描器稳定性
|
|
65
|
+
- [ ] 增强 frontmatter 解析容错,支持更多 YAML 变体
|
|
66
|
+
- [ ] 改进 brand 和 category 推断逻辑
|
|
67
|
+
- [ ] 添加扫描统计信息元数据(成功/失败/跳过/耗时)
|
|
68
|
+
- [ ] 记录上次扫描时间到 `cache.json` metadata
|
|
69
|
+
|
|
70
|
+
## 测试
|
|
71
|
+
- [ ] 状态检测逻辑正确性 100%
|
|
72
|
+
- [ ] 搜索功能覆盖率 > 85%
|
|
73
|
+
- [ ] UI 响应时间 < 100ms(800 条目)
|
|
74
|
+
- [ ] Hermes skill 加载无误
|
|
75
|
+
|
|
76
|
+
## 验收标准
|
|
77
|
+
- ✅ Hermes 中可见 `huhaa-myskills-manager` 技能
|
|
78
|
+
- ✅ 调用技能自动检测状态:已扫描 → 直接打开 | 未扫描 → 提示选项
|
|
79
|
+
- ✅ 搜索延迟 < 5ms(Fuse.js)
|
|
80
|
+
- ✅ 键盘导航完全可用
|
|
81
|
+
- ✅ 文档规范清晰,符合 GitHub 官方标准
|
|
82
|
+
- ✅ 新用户按 GUIDE.md 可快速上手
|
|
83
|
+
|
|
84
|
+
## 预期周期
|
|
85
|
+
1.5 周
|
|
86
|
+
|
|
87
|
+
## 交付物
|
|
88
|
+
1. `~/.hermes/skills/huhaa-myskills/SKILL.md` - Hermes 技能文件
|
|
89
|
+
2. `docs/GUIDE.md` - 快速启动指南
|
|
90
|
+
3. `docs/RULES.md` - 发布规范
|
|
91
|
+
4. `service/scripts/detect-state.mjs` - 状态检测脚本
|
|
92
|
+
5. 前端键盘快捷键支持
|
|
93
|
+
6. `/api/search` 和 `/api/state` 端点
|
|
94
|
+
|
|
95
|
+
## 不包含
|
|
96
|
+
- 不做复杂状态机(简单 if/else 检测即可)
|
|
97
|
+
- 不做定时自动扫描(用户主动触发)
|
|
98
|
+
- 不做搜索历史记录
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# v0.1.3:Obsidian Vault 与 Claude Markdown 支持
|
|
2
|
+
|
|
3
|
+
## 目标
|
|
4
|
+
聚合 Obsidian vault 中标记 `#skill` 的笔记,支持 CLAUDE.md 全局指令文档。
|
|
5
|
+
|
|
6
|
+
## 关键任务
|
|
7
|
+
|
|
8
|
+
### 新适配器
|
|
9
|
+
- [ ] 实现 `obsidian.adapter.mjs`:扫描 vault 中的 frontmatter tag
|
|
10
|
+
- [ ] 支持 `#skill` 和 `#plugin` 标签
|
|
11
|
+
- [ ] 提取 frontmatter 的 name / description / tags
|
|
12
|
+
- [ ] 从 note 前 50 行提取 preview
|
|
13
|
+
- [ ] 实现 `claude-md.adapter.mjs`:项目根和 `~/.claude/CLAUDE.md`
|
|
14
|
+
- [ ] 识别 h2 标题作为 skill 名称
|
|
15
|
+
- [ ] 提取每个 h2 下的第一段作为 description
|
|
16
|
+
|
|
17
|
+
### 配置
|
|
18
|
+
- [ ] `sources.yaml` 新增 obsidian 源配置
|
|
19
|
+
```yaml
|
|
20
|
+
obsidian:
|
|
21
|
+
enabled: false # 用户手动启用
|
|
22
|
+
vaultPath: ~/Library/Mobile Documents/com~apple~CloudDocs/Obsidian
|
|
23
|
+
tags: [skill, plugin, mcp]
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### 测试
|
|
27
|
+
- [ ] 覆盖 Obsidian frontmatter 多种格式
|
|
28
|
+
- [ ] 验证 Claude.md h2 切分正确
|
|
29
|
+
|
|
30
|
+
## 验收标准
|
|
31
|
+
- Obsidian vault 中的 skill 正常显示
|
|
32
|
+
- Claude.md 内容无误解析
|
|
33
|
+
- 源不存在时 unavailable 且不 crash
|
|
34
|
+
|
|
35
|
+
## 预期周期
|
|
36
|
+
1 周
|
|
37
|
+
|
|
38
|
+
## 不包含
|
|
39
|
+
- 不做 Obsidian sync
|
|
40
|
+
- 不做 Claude.md 远程链接解析
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# v0.1.4:分组与筛选增强
|
|
2
|
+
|
|
3
|
+
## 目标
|
|
4
|
+
支持四种分组方式切换,提供高级筛选面板,改进导航体验。
|
|
5
|
+
|
|
6
|
+
## 关键任务
|
|
7
|
+
|
|
8
|
+
### 前端
|
|
9
|
+
- [ ] 实现分组切换按钮组:source / category / brand / product
|
|
10
|
+
- [ ] 每种分组方式下树状或卡片布局
|
|
11
|
+
- [ ] 分组数据缓存,切换不重新计算
|
|
12
|
+
- [ ] 新增筛选面板:
|
|
13
|
+
- [ ] 多选源、分类、品牌
|
|
14
|
+
- [ ] 文本输入框与 Fuse.js 搜索组合
|
|
15
|
+
- [ ] 筛选结果实时更新
|
|
16
|
+
- [ ] 改进详情页导航:prev/next 按钮在同分组内切换
|
|
17
|
+
|
|
18
|
+
### UI
|
|
19
|
+
- [ ] 面包屑导航显示当前分组路径
|
|
20
|
+
- [ ] 未匹配项提示友好
|
|
21
|
+
|
|
22
|
+
### 测试
|
|
23
|
+
- [ ] 分组计算正确性 > 90%
|
|
24
|
+
- [ ] 筛选组合场景覆盖
|
|
25
|
+
|
|
26
|
+
## 验收标准
|
|
27
|
+
- 四种分组方式可切换
|
|
28
|
+
- 筛选组合生效
|
|
29
|
+
- 面包屑导航准确
|
|
30
|
+
|
|
31
|
+
## 预期周期
|
|
32
|
+
1.5 周
|
|
33
|
+
|
|
34
|
+
## 不包含
|
|
35
|
+
- 不做收藏/书签功能
|
|
36
|
+
- 不做分组嵌套(固定四层)
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# v0.1.5:导出与分享
|
|
2
|
+
|
|
3
|
+
## 目标
|
|
4
|
+
支持导出技能列表、分享筛选结果、生成 Markdown 报告。
|
|
5
|
+
|
|
6
|
+
## 关键任务
|
|
7
|
+
|
|
8
|
+
### 导出功能
|
|
9
|
+
- [ ] 导出筛选结果为 JSON / CSV / Markdown
|
|
10
|
+
- [ ] `/api/export?format=json&filters=...`
|
|
11
|
+
- [ ] 支持完整内容或元数据压缩
|
|
12
|
+
- [ ] 生成技能报告
|
|
13
|
+
- [ ] 按源统计:总数、分类数、平均大小
|
|
14
|
+
- [ ] 生成 Markdown report
|
|
15
|
+
- [ ] 导出为 HTML 离线浏览
|
|
16
|
+
- [ ] 集合版本 + 日期戳
|
|
17
|
+
|
|
18
|
+
### 分享
|
|
19
|
+
- [ ] 生成筛选 URL:`?source=hermes&brand=OpenAI&q=...`
|
|
20
|
+
- [ ] 复制分享链接到剪贴板
|
|
21
|
+
- [ ] 支持导入分享 URL 恢复筛选状态
|
|
22
|
+
|
|
23
|
+
### UI
|
|
24
|
+
- [ ] 导出菜单(下载按钮)
|
|
25
|
+
- [ ] 分享面板(复制链接 + QR 码生成)
|
|
26
|
+
|
|
27
|
+
## 测试
|
|
28
|
+
- [ ] 导出格式正确性
|
|
29
|
+
- [ ] 分享 URL 稳定且可恢复
|
|
30
|
+
|
|
31
|
+
## 验收标准
|
|
32
|
+
- 导出 JSON/CSV/Markdown 可用
|
|
33
|
+
- 分享 URL 能恢复筛选
|
|
34
|
+
- 离线 HTML 完整可用
|
|
35
|
+
|
|
36
|
+
## 预期周期
|
|
37
|
+
1 周
|
|
38
|
+
|
|
39
|
+
## 不包含
|
|
40
|
+
- 不做云端分享
|
|
41
|
+
- 不做版本对比
|