内容
# 技能路由
> 一个本地优先、单二进制的路由，用于在不淹没模型上下文的情况下发现和加载大型智能体技能库。
技能路由保留一个小的接口技能在上下文中，并将完整的技能库存储在磁盘上。它只索引SQLite中的元数据，搜索该紧凑索引，并在调用者明确选择后加载完整的`SKILL.md`正文。
## 为什么存在
大型智能体安装可能包含数百或数千种专门技能。将每种技能描述和正文注入每个提示中都很慢、昂贵且嘈杂。技能路由颠覆了这种模式：
1. 本地索引技能元数据。
2. 通过自然语言意图进行搜索。
3. 返回一个小型排名候选列表。
4. 仅获取选择的技能正文。
5. 跟踪透明的使用情况遥测，以改进确定性排名。
搜索输出通过 `--top` 保持有界；它不会随着库大小的增长而增长。
## 亮点
- 一个便携的Windows x64可执行文件
- 本地优先操作，无远程服务依赖
- SQLite FTS5全文搜索，带有波特词干提取
- 精确、模糊、全文和混合排名模式
- CLI、交互式shell、环回HTTP和MCP stdio接口
- 明确的技能生命周期状态和漂移检测
- 预备的SQLite语句和有界查询/文件输入
- 确定性SHA-256发布清单
- MIT许可源
- 可复制的MSVC打包脚本
- 47个自动C++测试
## Windows发布
[下载适用于Windows x64的技能路由1.0.0](releases/skill-router-windows-x64-1.0.0.zip)
ZIP SHA-256：
```text
FBB8925A621A22BE13EDE6B09BAD9CA0B90DD968B71CC79AB30DF2849338865F
```
可执行文件目前未签名。在运行它之前，请验证ZIP摘要。
## 快速入门
将存档提取到可写入的目录，在那里打开PowerShell，并在`skill_library\`下添加技能。每个技能目录都需要一个包含`name`和`description`前置信息的`SKILL.md`。
```powershell
powershell -ExecutionPolicy Bypass -File .\index-skills.ps1
.\skillrouter.exe search "windows cpp build" --top 5 --json
.\skillrouter.exe fetch skill-router
.\skillrouter.exe stats
```
## 搜索模式
```powershell
.\skillrouter.exe search "authentication" --mode hybrid
.\skillrouter.exe search "authentication" --mode exact
.\skillrouter.exe search "authentication" --mode fts
.\skillrouter.exe search "authentcation" --mode fuzzy
```
混合模式是默认模式。精确匹配仍然占主导地位，而全文索引词干提取和有界模糊匹配则提高召回率。
## MCP集成
技能路由可以作为stdio上的换行JSON-RPC MCP服务器运行：
```powershell
.\skillrouter.exe mcp --db .\skill_index.db
```
它公开了搜索、获取、统计数据、墓地遥测和`skill://`资源。有关完整的协议参考，请参见[集成手册](skill-router/INTEGRATION_MANUAL.md)。
## HTTP接口
可选的HTTP接口仅绑定到IPv4环回：
```powershell
.\skillrouter.exe serve --db .\skill_index.db --port 8090
```
可用端点包括`/health`、`/stats`、`/graveyard`、`/search`和`/fetch`。
HTTP接口用于受信任的本地开发。它不提供身份验证，因此请勿公开或转发端口，也不要在共享机器上使用它和机密技能库。
## 从源代码构建
需求：
- Windows x64
- Visual Studio 2022 C++构建工具
- PowerShell 5.1或更高版本
> **注意：** 上述需求适用于用于生成官方Windows x64发布的MSVC构建路径。源代码本身（`main.cpp`、`skill_library.hpp`、`mcp_server.hpp`）没有Windows特定依赖，可以使用适当的C++20工具链和自己的构建脚本为其他平台（例如Linux、macOS）构建；只有`build_windows_msvc.bat`和`package-windows.ps1`是Windows特定的。
从Visual Studio x64开发命令行提示符构建和测试：
```powershell
cd .\skill-router
.\build_windows_msvc.bat
.\build\test_library.exe
```
创建干净的发布：
```powershell
.\package-windows.ps1
```
打包器初始化Visual Studio工具链，构建带有FTS5的SQLite，运行所有测试，暂存允许列出的有效载荷，写入`SHA256SUMS.txt`，并在`dist\`下创建版本化的ZIP。
## 仓库布局
```text
.
|-- README.md
|-- LICENSE
|-- releases/
| |-- SHA256SUMS.txt
| `-- skill-router-windows-x64-1.0.0.zip
`-- skill-router/
|-- main.cpp
|-- skill_library.hpp
|-- mcp_server.hpp
|-- test_library.cpp
|-- third_party/
|-- skills/skill_router/
|-- build_windows_msvc.bat
|-- package-windows.ps1
|-- index-skills.ps1
`-- INTEGRATION_MANUAL.md
```
## 安全状况
- 发布版不包含任何私有技能库、生成的数据库、备份、目标文件、调试符号、凭证或机器特定的用户路径。
- SQLite以3.53.4版本提供，并编译了FTS5。
- SQL值通过预备语句传递。
- Windows二进制文件启用了ASLR、DEP/NX和高熵虚拟地址。
- 网络服务是按需开启的，仅限环回。
- MCP使用stdio，不打开网络监听器。
- 技能主体是数据，而不是可执行代码，但下游代理仍必须将第三方技能指令视为不受信任。
- 数据库文件和索引技能目录应来自受信任的源。
- 二进制文件没有Authenticode签名；使用已发布的SHA-256摘要。
## 文档
- [技能路由README](skill-router/README.md)
- [Windows发布指南](skill-router/WINDOWS_README.md)
- [完整的集成手册](skill-router/INTEGRATION_MANUAL.md)
- [接口技能](skill-router/skills/skill_router/SKILL.md)
## 许可证
MIT许可证。版权（c）2026 Thomas Helm。
由Thomas Helm创建，作为Torafirma系统的一部分。
