简体中文 | English

Honcho 嵌入向量维度配置技能

一个 Hermes Skill，让 Honcho 的嵌入向量维度完全可配置，支持无缝切换不同维度的嵌入模型。

功能

• 通过 VECTOR_STORE_DIMENSIONS 环境变量配置任意嵌入维度
• 支持 OpenAI 1536d、BGE-m3 1024d、Nomic 768d 等任意模型
• CLI 迁移工具，一键迁移数据库维度
• 运行时维度不匹配自动检测
• Alembic 迁移模板，支持 schema 版本管理

快速开始

# 1. 设置目标维度
echo "VECTOR_STORE_DIMENSIONS=1024" >> .env

# 2. 查看当前维度
python scripts/honcho_dim.py status

# 3. 检测配置不匹配
python scripts/honcho_dim.py detect

# 4. 执行迁移
python scripts/honcho_dim.py migrate --target 1024

# 5. 重启服务
docker compose up -d --build

文件结构

honcho-embedding-dimensions/
├── SKILL.md                    # 技能元数据和技术指南
├── README.md                   # 中文说明（本文件）
├── README_en.md                # 英文说明
├── LICENSE                     # MIT 许可证
├── requirements.txt            # Python 依赖
├── scripts/
│   ├── honcho_dim.py                  # 统一 CLI 入口 (status/detect/migrate/selftest)
│   ├── dimension_check.py             # 维度检测与迁移模块
│   └── migrate_embedding_dimensions.py # 旧版 CLI（向后兼容）
├── templates/
│   └── alembic_migration_configurable_dimensions.py  # Alembic 迁移模板
└── references/
    └── open_source_contribution.md  # 开源贡献指南

已知限制

• 迁移会销毁所有现有嵌入向量，由 reconciler 重新生成
• 切换维度期间向量搜索可能返回过期或空结果
• 需要 pgvector >= 0.5.0

作者

Jarvis-Drawf

许可证

MIT License