npm - huhaa-myskills - Versions diffs - 0.2.13 → 0.3.4 - Mend

huhaa-myskills 0.2.13 → 0.3.4

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.

Files changed (121) hide show

package/README.md +9 -375
package/bin/huhaa-myskills.mjs +194 -12
package/{scripts → build}/verify.mjs +3 -1
package/docs/Frontend-Spec.md +1149 -0
package/docs/assets/layout-wireframe.png +0 -0
package/docs/assets/theme-reference.png +0 -0
package/docs/scan_rules.md +172 -0
package/package.json +33 -9
package/packages/scanner/src/adapters/directory-skill.mjs +239 -0
package/packages/scanner/src/adapters/skill-adapter.mjs +345 -0
package/packages/scanner/src/icon/brand-map.mjs +84 -0
package/packages/scanner/src/icon/icon-extractor.mjs +246 -0
package/packages/scanner/src/index.mjs +107 -82
package/packages/scanner/src/types.d.ts +18 -0
package/packages/scanner/test/icon.test.mjs +61 -0
package/packages/scanner/test/scanner.test.mjs +37 -41
package/packages/scanner/test/skill-adapter.test.mjs +70 -0
package/packages/scanner/tests/directory-skill.test.mjs +93 -0
package/packages/scanner/tests/scanner-integration.test.mjs +139 -0
package/packages/server/src/index.mjs +164 -12
package/packages/server/src/labels.mjs +62 -0
package/packages/server/test/server.test.mjs +1 -1
package/packages/web/README.md +33 -2
package/packages/web/dist/assets/index-BCY2cRaO.js +175 -0
package/packages/web/dist/assets/index-DALKjJPi.css +1 -0
package/packages/web/dist/favicon-16x16.png +0 -0
package/packages/web/dist/favicon-192x192.png +0 -0
package/packages/web/dist/favicon-32x32.png +0 -0
package/packages/web/dist/favicon-512x512.png +0 -0
package/packages/web/dist/favicon-source.svg +5 -0
package/packages/web/dist/index.html +23 -9
package/packages/web/index.html +22 -8
package/packages/web/package-lock.json +2989 -0
package/packages/web/package.json +21 -8
package/packages/web/postcss.config.js +6 -0
package/packages/web/public/favicon-16x16.png +0 -0
package/packages/web/public/favicon-192x192.png +0 -0
package/packages/web/public/favicon-32x32.png +0 -0
package/packages/web/public/favicon-512x512.png +0 -0
package/packages/web/public/favicon-source.svg +5 -0
package/packages/web/src/App.test.ts +40 -0
package/packages/web/src/App.tsx +177 -0
package/packages/web/src/components/ComingSoon.tsx +14 -0
package/packages/web/src/components/layout/Sidebar.test.tsx +74 -0
package/packages/web/src/components/layout/Sidebar.tsx +114 -0
package/packages/web/src/components/layout/Topbar.tsx +74 -0
package/packages/web/src/components/ui/ActionButton.tsx +48 -0
package/packages/web/src/components/ui/button.tsx +48 -0
package/packages/web/src/components/ui/card.tsx +45 -0
package/packages/web/src/components/views/DashboardView.tsx +122 -0
package/packages/web/src/components/views/OtherSkillsView.test.tsx +126 -0
package/packages/web/src/components/views/OtherSkillsView.tsx +306 -0
package/packages/web/src/components/views/SettingsView.tsx +95 -0
package/packages/web/src/components/views/SkillDetail.test.tsx +57 -0
package/packages/web/src/components/views/SkillDetail.tsx +81 -0
package/packages/web/src/components/views/SkillsView.test.ts +28 -0
package/packages/web/src/components/views/SkillsView.tsx +226 -0
package/packages/web/src/hooks/QUICK_REFERENCE.md +165 -0
package/packages/web/src/hooks/README.md +378 -0
package/packages/web/src/hooks/__tests__/useOtherSkills.test.ts +422 -0
package/packages/web/src/hooks/__tests__/useSkillIcons.test.ts +272 -0
package/packages/web/src/hooks/useLiveReload.ts +20 -0
package/packages/web/src/hooks/useOtherSkills.ts +387 -0
package/packages/web/src/hooks/useSkillIcons.ts +248 -0
package/packages/web/src/hooks/useTheme.ts +36 -0
package/packages/web/src/index.css +161 -0
package/packages/web/src/lib/api.test.ts +47 -0
package/packages/web/src/lib/api.ts +77 -0
package/packages/web/src/lib/cn.ts +7 -0
package/packages/web/src/lib/editors.test.ts +30 -0
package/packages/web/src/lib/editors.ts +70 -0
package/packages/web/src/lib/markdown.test.ts +27 -0
package/packages/web/src/lib/markdown.ts +14 -0
package/packages/web/src/main.tsx +13 -0
package/packages/web/src/types/index.ts +62 -0
package/packages/web/src/types/other-skill.ts +88 -0
package/packages/web/src/types/skill.ts +136 -0
package/packages/web/src/types.ts +47 -0
package/packages/web/src/vite-env.d.ts +1 -0
package/packages/web/tailwind.config.ts +66 -0
package/packages/web/tsconfig.json +28 -0
package/packages/web/vite.config.ts +36 -0
package/packages/web/vitest.config.ts +21 -0
package/packages/web/vitest.setup.ts +1 -0
package/scripts/activate-data-sources.sh +223 -0
package/scripts/brand-completion.py +586 -0
package/scripts/init-nextjs-project.sh +421 -0
package/scripts/install-and-sync.sh +209 -0
package/scripts/start-dev.sh +72 -0
package/docs/GUIDE.md +0 -190
package/docs/PLAN.md +0 -359
package/docs/RULES.md +0 -329
package/docs/RUNBOOK-myskills.md +0 -258
package/docs/SYNC-SKILLS.md +0 -259
package/docs/releases/README.md +0 -47
package/docs/releases/v0.1.0.md +0 -256
package/docs/releases/v0.1.1.md +0 -297
package/docs/releases/v0.1.2.md +0 -207
package/docs/releases/v0.1.3.md +0 -269
package/docs/todo/v0.1.2.md +0 -98
package/docs/todo/v0.1.3.md +0 -40
package/docs/todo/v0.1.4.md +0 -36
package/docs/todo/v0.1.5.md +0 -41
package/docs/todo/v0.1.6.md +0 -43
package/docs/todo/v0.1.7.md +0 -38
package/docs/todo/v0.1.8.md +0 -36
package/docs/todo/v0.1.9.md +0 -54
package/packages/web/dist/assets/index-BPepSb3q.js +0 -36
package/packages/web/dist/assets/index-CIGkgT5w.css +0 -1
package/packages/web/src/App.vue +0 -483
package/packages/web/src/components/AppTree.vue +0 -230
package/packages/web/src/components/DirectoryTree.vue +0 -263
package/packages/web/src/components/SkillTree.vue +0 -208
package/packages/web/src/lib/api.js +0 -43
package/packages/web/src/main.js +0 -6
package/packages/web/src/stores/i18n.js +0 -161
package/packages/web/src/stores/skills.js +0 -287
package/packages/web/src/styles.css +0 -365
package/packages/web/vite.config.js +0 -17
/package/{scripts → build}/build-web.mjs +0 -0
/package/{scripts → build}/prepare-publish.mjs +0 -0

package/docs/RULES.md DELETED Viewed

@@ -1,329 +0,0 @@
-# 版本发布规范
-本文档定义 HuHaa-MySkills 版本发布、更新日志、Issue 和 Pull Request 的标准格式。
-## 版本号规则
-遵循 Semantic Versioning：
-- `v0.1.x` - Alpha 阶段（核心功能开发）
-- `v1.0.0+` - 稳定版（计划 v0.1.9 之后）
-### 版本发布清单
-| 环节 | 检查项 |
-|------|--------|
-| 代码 | [ ] 所有测试通过 / [ ] 代码审查完成 / [ ] 无 TODO 注释 |
-| 文档 | [ ] README 更新 / [ ] CHANGELOG 更新 / [ ] API 文档更新 |
-| 发布 | [ ] git tag 创建 / [ ] GitHub Release 发布 / [ ] npm publish（如适用） |
-| 验证 | [ ] 真实环境测试 / [ ] 向后兼容性检查 |
-## CHANGELOG 格式
-参考 [Keep a Changelog](https://keepachangelog.com/)：
-```markdown
-# Changelog
-## [v0.1.2] - 2026-06-25
-### Added
-- Keyboard shortcuts support (/, Escape, arrow keys)
-- Virtual scrolling for 800+ items
-- `/api/search` endpoint with filter syntax
-### Fixed
-- Search performance optimization
-- YAML frontmatter parsing robustness
-### Changed
-- Improved error handling in adapters
-### Removed
-- Legacy cache format
-### Deprecated
-- Old search API (use `/api/search` instead)
-## [v0.1.1] - 2026-06-18
-### Added
-- npm global install support
-- Normalized bin path for cross-platform compatibility
-```
-## Git Commit 格式
-遵循 Conventional Commits：
-```
-<type>(<scope>): <subject>
-<body>
-<footer>
-```
-### 类型（type）
-- **feat** - 新功能
-- **fix** - Bug 修复
-- **docs** - 文档变更
-- **style** - 代码风格（不影响功能）
-- **refactor** - 重构（不改变外部行为）
-- **perf** - 性能优化
-- **test** - 测试相关
-- **chore** - 工具、依赖更新
-### 范围（scope）
-- `scanner` - 扫描器模块
-- `server` - HTTP 服务器
-- `web` - 前端界面
-- `adapter` - 适配器系列
-- `cli` - 命令行工具
-- `docs` - 文档
-### 示例
-```bash
-feat(web): add keyboard shortcuts support
-- Implement / key to focus search box
-- Implement Escape to clear search
-- Implement arrow keys to navigate list
-Closes #42
-```
-## GitHub Issues 模板
-### Bug Report
-```markdown
-## 描述问题
-清晰简洁的问题描述。
-## 复现步骤
-1. ...
-2. ...
-3. ...
-## 期望行为
-应该发生什么？
-## 实际行为
-实际发生了什么？
-## 环境
-- 操作系统：macOS / Linux / Windows
-- Node.js 版本：20.x
-- HuHaa-MySkills 版本：v0.1.1
-## 额外信息
-日志、截图等。
-```
-### Feature Request
-```markdown
-## 功能描述
-这个功能要解决什么问题？
-## 使用场景
-什么时候会用到？
-## 建议的实现方式
-你有什么想法吗？
-## 替代方案
-有其他可能的实现吗？
-```
-## Pull Request 模板
-```markdown
-## 变更说明
-这个 PR 做了什么？简要描述关键变更。
-## 类型
-- [ ] Bug 修复
-- [ ] 新功能
-- [ ] 文档更新
-- [ ] 性能优化
-## 相关 Issue
-Fixes #123
-## 测试
-- [ ] 本地测试通过
-- [ ] 新增单元测试
-- [ ] 回归测试通过
-## 检查清单
-- [ ] 代码风格符合项目规范
-- [ ] 无新的 linting 警告
-- [ ] CHANGELOG 已更新
-- [ ] 文档已更新
-- [ ] 提交消息格式正确
-```
-## Release Notes 模板
-```markdown
-# v0.1.2: 搜索与交互优化
-## 概览
-这个版本改进了搜索体验和 UI 交互，支持键盘快捷键和高性能虚拟滚动。
-## ✨ 新功能
-### 键盘快捷键
-- `/ ` - 聚焦搜索框
-- `Esc` - 清空搜索
-- `↑ ↓` - 导航列表
-### 快速搜索 API
-```
-GET /api/search?q=...&source=hermes&brand=OpenAI
-```
-## 🐛 Bug 修复
-- 修复 frontmatter 解析容错性 (#45)
-- 改进 SSE 连接稳定性 (#48)
-## 📊 性能
-- 列表虚拟滚动：支持 800+ 条目无卡顿
-- 搜索延迟：< 5ms（Fuse.js）
-- 内存占用：保持 ~50MB
-## 🔄 更新指南
-```bash
-# 从 npm 全局安装更新
-npm update -g github:aquarkgn/HuHaa-MySkills
-# 或从源码
-cd ~/Project/HuHaa-MySkills
-git pull origin main
-npm install
-```
-## 🙏 贡献者
-感谢 @contributor1 @contributor2 的贡献。
----
-**完整变更日志** - [CHANGELOG.md](../CHANGELOG.md)
-```
-## GitHub Actions 工作流
-### 验证工作流 (.github/workflows/verify.yml)
-```yaml
-name: Verify
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-jobs:
-  verify:
-    runs-on: macos-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm ci
-      - run: npm run verify
-      - run: npm test
-```
-### 发布工作流 (.github/workflows/release.yml)
-```yaml
-name: Release
-on:
-  push:
-    tags:
-      - 'v*'
-jobs:
-  release:
-    runs-on: macos-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm ci
-      - run: npm run verify
-      - run: npm publish  # 如果要发布到 npm
-      - name: Create Release
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-```
-## 文档结构
-```
-docs/
-├── README.md              # 项目总览
-├── GUIDE.md              # 快速启动指南（本文件）
-├── PLAN.md               # 架构和设计文档
-├── RULES.md              # 本发布规范
-├── CHANGELOG.md          # 变更日志
-├── RUNBOOK-*.md          # 操作手册
-├── ARCHITECTURE.md       # 详细架构（TODO）
-├── API.md                # API 参考（TODO）
-├── CONTRIBUTING.md       # 贡献指南（TODO）
-└── todo/
-    ├── v0.1.2.md
-    ├── v0.1.3.md
-    └── ...
-```
-## 标签（Labels）
-推荐在 GitHub Issues 中使用以下标签：
-| 标签 | 说明 |
-|------|------|
-| `bug` | 缺陷报告 |
-| `enhancement` | 功能请求 |
-| `documentation` | 文档改进 |
-| `good first issue` | 适合新贡献者 |
-| `help wanted` | 寻求帮助 |
-| `question` | 提问 |
-| `wontfix` | 无意修复 |
-| `duplicate` | 重复问题 |
-| `v0.1.x` | 版本标记 |
----
-**相关文档** → [CONTRIBUTING.md（待完善）](./CONTRIBUTING.md)

package/docs/RUNBOOK-myskills.md DELETED Viewed

@@ -1,258 +0,0 @@
-# RUNBOOK: HuHaa-MySkills
-This runbook is the production/operator note for the local HuHaa-MySkills service.
-## Service identity
-- Name: HuHaa-MySkills
-- Purpose: local browser catalog for AI-agent skills, plugins, MCP configs, and runbooks
-- Default URL: `http://127.0.0.1:11520`
-- Default data dir: `~/.config/huhaa-myskills/`
-- Override data dir: `HUHAA_HOME=/path/to/dir`
-- Default preferred port: `11520`
-- Override port: `PORT=11530`
-- Bind address: `127.0.0.1` only
-## Main commands
-```bash
-npm install
-npm run init
-npm start
-npm test
-npm run verify
-npm run purge
-```
-## Files and directories
-Runtime/user data:
-```text
-~/.config/huhaa-myskills/sources.yaml
-~/.config/huhaa-myskills/cache.json
-~/.config/huhaa-myskills/state.json
-```
-Repository layout:
-```text
-service/bin/huhaa-myskills.mjs
-service/config/sources.example.yaml
-service/packages/scanner/src/index.mjs
-service/packages/server/src/index.mjs
-service/packages/web/src/App.vue
-service/scripts/verify.mjs
-```
-## Healthy state
-```bash
-curl -s http://127.0.0.1:11520/api/health
-```
-Expected shape:
-```json
-{"ok":true,"port":11520,"items":188,"version":"0.1.0","phase":"P6"}
-```
-The exact `items` count depends on local sources.
-## Full verification
-```bash
-npm run verify
-```
-Expected final line:
-```text
-[verify] PASS build + tests + HTTP/API/static smoke checks
-```
-The verify script proves:
-1. Vue SPA builds.
-2. Scanner/server tests pass.
-3. A real Fastify server starts on loopback.
-4. `/api/health`, `/api/skills`, `/api/skills/:id`, `/api/stats`, and `/api/reload` work.
-5. Built JS/CSS assets are served with correct content types.
-6. Temporary runtime data is removed.
-## Troubleshooting
-### Page does not open
-Check service:
-```bash
-curl -s http://127.0.0.1:11520/api/health
-```
-If it fails, start manually:
-```bash
-npm start
-```
-If port is busy:
-```bash
-PORT=11530 npm start
-```
-The CLI will also try fallback ports when the preferred port is unavailable.
-### Page opens but is blank
-Build assets:
-```bash
-npm run build:web
-npm start
-```
-Check static assets from `index.html`:
-```bash
-curl -I http://127.0.0.1:11520/
-curl -I http://127.0.0.1:11520/assets/<asset>.js
-curl -I http://127.0.0.1:11520/assets/<asset>.css
-```
-Expected content types:
-```text
-text/html; charset=utf-8
-text/javascript; charset=utf-8
-text/css; charset=utf-8
-```
-### No skills or too few skills
-Check config:
-```bash
-sed -n '1,220p' ~/.config/huhaa-myskills/sources.yaml
-```
-Run scan debug:
-```bash
-HUHAA_DEBUG=1 npm run scan >/tmp/huhaa-skills.json
-```
-Common causes:
-- source root path does not exist
-- source is disabled
-- file is larger than `limits.maxFileBytes`
-- glob does not match the target file
-- project runbooks are outside configured roots
-### MCP secrets appear in UI
-They should not. Verify using tests:
-```bash
-npm test
-```
-Specific redaction behavior lives in:
-```text
-service/packages/scanner/src/adapters/mcp-config.mjs
-```
-The adapter redacts keys matching token/key/secret/password/auth/cookie-style names and common inline secret patterns before writing `raw` or `preview`.
-### Reload does not update page
-Manual reload:
-```bash
-curl -s -X POST http://127.0.0.1:11520/api/reload
-curl -s http://127.0.0.1:11520/api/reload-state
-```
-Watch events endpoint:
-```bash
-curl -N http://127.0.0.1:11520/api/events
-```
-If watcher is unreliable on a synced/cloud directory, use manual reload. The server never clears the old snapshot on reload failure; it keeps the last good data.
-### Copy buttons do not work
-On macOS, copy uses `pbcopy` on the server side.
-Check:
-```bash
-command -v pbcopy
-```
-The tests use a fake temporary `pbcopy` and do not touch the real clipboard.
-### Open in Cursor does not work
-Check Cursor CLI:
-```bash
-command -v cursor
-```
-If missing, install Cursor shell command from Cursor itself, or use the path copy/reveal buttons instead.
-### Finder reveal does not work
-Finder reveal uses:
-```bash
-open -R <path>
-```
-This is macOS-only.
-## Public release checklist
-Before pushing a public repository:
-```bash
-npm run verify
-```
-Then check ignored/generated files:
-```bash
-git status --short
-git check-ignore -v node_modules service/packages/web/dist 2>/dev/null || true
-```
-Check for obvious secrets outside ignored directories:
-```bash
-git grep -n -E '(ghp_|sk-[A-Za-z0-9_-]{12,}|Bearer [A-Za-z0-9._~+/=-]{12,}|API[_-]?KEY|SECRET|PASSWORD|TOKEN)' -- . ':!service/packages/scanner/test/scanner.test.mjs'
-```
-Expected matches should be code patterns/documentation only, not real credential values.
-## Recovery
-Reset runtime config:
-```bash
-npm run purge
-npm run init
-npm start
-```
-Remove code checkout:
-```bash
-rm -rf /path/to/HuHaa-MySkills
-```
-`purge` intentionally touches only the runtime data dir, never the repository.