内容
能力中心
[](LICENSE)
[](https://nodejs.org/)
[](https://pnpm.io/)
> **俄语版本：** [README.ru.md](README.ru.md)
Cursor 和兼容的 AI 代理的本地优先 **技能**、**MCP 服务器** 和 **规则** 目录。
了解已安装的内容、其存在的原因、使用时机，并导出 **项目路由器技能**，以便代理停止在数十种全局能力中猜测。
---
## 为什么
| 痛点 | Hub 的作用 |
|------|----------------|
| 技能分散在 `~/.cursor`、`~/.claude`、`~/.agents` | 统一的目录，去除重复，附带源路径 |
| 代理忽略有用的技能 | 编辑英文描述，构建项目路由器 |
| 没有俄语说明供人类阅读 | 叠加俄语描述 + AI 翻译 |
| 大型目录难以管理 | AI 组织、标签、配置文件、审计 |
**重要：** Hub 不会自行更改 Cursor。只有编写 `SKILL.md`（英文描述 / 路由器导出）才会影响代理。MCP 的启用/禁用仍在 Cursor 设置中。
---
## 功能
- **目录** — 搜索、类别筛选、标签、重复项和冲突
- **叠加层** — 俄语描述、`whenToUse`、提示模板（本地、面向人类）
- **AI 翻译** — 英文 → 俄文，通过 OpenAI、OpenRouter、Kie.ai、Anthropic、Cursor SDK 或 Ollama
- **组织** — AI 分组、标签建议、路由器/清理候选项（SSE 进度）
- **路由器向导** — 导出 `{workspace}/.cursor/skills/<name>-router/SKILL.md`
- **配置文件** — 保存组织选择以供重用
- **审计** — 冲突、缺少俄文/英文、未使用的标记、组织提示
- **帮助** — 应用内指南（俄文/英文），解释概念和工作流程
- **CLI** — 扫描、组织、导出路由器、审计、翻译
---
## 快速开始
```bash
pnpm install
pnpm build
pnpm test
# Web UI — http://127.0.0.1:47200
pnpm ui
# Dev UI (Vite :47201; 在另一个终端运行 `pnpm ui` 以启动 API)
pnpm dev:ui
```
### 有用的命令
```bash
pnpm scan:duplicates
pnpm scan:fixtures
pnpm translate:dry
pnpm translate
pnpm organize:dry
pnpm organize
pnpm export-router:dry
pnpm export-router
# 不是 `pnpm audit`（pnpm 安全检查）— 使用：
pnpm run audit
pnpm audit:json
```
---
## 配置
在 UI 中打开 **设置**，或编辑 `%USERPROFILE%\.capabilities-hub\config.json`（macOS/Linux 上为 `~/.capabilities-hub/config.json`）：
```json
{
"version": 1,
"locale": "zh",
"workspace": "/path/to/your/project",
"ai": {
"provider": "openrouter",
"providers": {
"openrouter": {
"apiKey": "sk-or-...",
"model": "openai/gpt-4o-mini"
}
}
}
}
```
提供商：**OpenAI**、**OpenRouter**、**Kie.ai**、**Cursor SDK**、**Anthropic**、**Ollama**（本地，无需密钥）。
用户数据目录：
```text
~/.capabilities-hub/
config.json
overlay.json
index.cache.json
.cache.json
profiles.json
backups/
```
---
## UI 地图
| 区域 | 目的 |
|------|---------|
| **目录** | 浏览/编辑能力 |
| **组织** | AI 摘要、应用标签、路由器候选项 |
| **审计** | 目录健康检查 |
| **帮助** | 概念和操作方法（应用内指南） |
| 页头 **俄文 \| 英文** | UI 语言 |
| **设置** | 工作区 + AI 提供商 |
“打开文件”的编辑器CAPABILITIES_HUB_EDITOR`（默认为 `cursor`）。
---
## 单体仓库布局
```text
packages/
scanner/ # 文件系统扫描、解析、去重、机密掩蔽
store/ # 叠加层、缓存、翻译、组织、路由器、配置文件、审计
server/ # 本地 Fastify API
web/ # Vite + React 仪表板
cli/ # capabilities-hub CLI
fixtures/
docs/
```
---
## 文档
| 文档 | 内容 |
|-----|----------|
| [docs/PROJECT.md](docs/PROJECT.md) | 架构、MVP 范围、决策 |
| [docs/V2-AI-ORGANIZE.md](docs/V2-AI-ORGANIZE.md) | 组织和路由器（v2.0） |
| [fixtures/README.md](fixtures/README.md) | 测试用例目录 |
| [README.ru.md](README.ru.md) | 俄语 README |
---
## 故障排除
**端口 47200 已被占用**
```bash
# Windows
netstat -ano | findstr :47200
# 或选择另一个端口
capabilities-hub ui --port 47201
```
**UI 显示旧版本**
```bash
pnpm build && pnpm ui
```
首先停止之前的进程（`:47200`）。
**重启后标签丢失**
标签存储在 `overlay.json` 在启动时将叠加层重新合并到扫描缓存中。如果您在修复之前使用了较旧的版本，请重新应用一次。
---
## 许可证
[MIT](LICENSE)
