QMD Manager

统一的QMD知识库管理技能，集成官方qmd搜索功能和自定义项目管理/测试/内容创作知识管理。支持BM25关键词搜索、向量语义搜索、多集合管理。

Security Scan

The skill's code and instructions are coherent with its stated purpose (wrapping the local qmd CLI to manage/search knowledge bases); it does not request credentials or unusual system access.

Purpose & Capability

The name/description promise a qmd-based knowledge manager and both SKILL.md and index.js only reference qmd CLI operations (search, vsearch/query, embed, collection add, get, status). No unrelated services, credentials, or external endpoints are required.

Instruction Scope

Runtime instructions focus on installing Bun and the qmd CLI and using qmd commands against local knowledge directories, which matches the purpose. Minor inconsistency: SKILL.md documents optional env vars (QMD_PATH, KNOWLEDGE_BASE, QMD_MODEL) but the skill metadata does not declare required envs; index.js also does not read QMD_PATH (it probes common paths and PATH). Otherwise instructions do not ask to read or transmit unrelated secrets or system files.

Install Mechanism

There is no install spec and the SKILL.md recommends installing Bun and the qmd package from standard project pages/registries. The skill includes a small index.js and package.json but does not download arbitrary archives or run remote installers itself.

Credentials

No credentials or sensitive environment variables are required. The only environment references are optional (HOME used implicitly by index.js when probing paths). The skill operates on local knowledge directories and a locally installed qmd binary—this is proportionate to its function.

Persistence & Privilege

always is false and the skill does not request persistent or system-wide configuration changes. It executes local qmd CLI commands only and does not modify other skills' configs.

Assessment

This skill appears to be what it claims: a thin wrapper around the local qmd CLI. Before installing, ensure you trust the qmd binary you install (use the official repository), and confirm your knowledge base paths contain only documents you want the agent to access. Note the SKILL.md mentions optional env vars (QMD_PATH, KNOWLEDGE_BASE, QMD_MODEL) but the registry metadata doesn't mark them as required; index.js discovers qmd by probing common paths instead of reading QMD_PATH. If you need stricter control, keep the skill user-invocable only (don't enable autonomous invocation) and inspect the included index.js to verify it meets your safety expectations.

miliger-qmd-manager - 统一知识库管理

集成官方qmd搜索 + 自定义项目管理/测试/内容创作知识管理

🎯 核心功能

✅ 官方qmd功能

• BM25关键词搜索 - 快速精准匹配
• 向量语义搜索 - 理解意图，找相关内容
• 混合搜索 - 结合关键词和语义
• 多集合管理 - 支持多个知识库

✅ 自定义管理功能

• 项目管理知识库 - PMP、敏捷、瀑布等
• 软件测试知识库 - 自动化测试、性能测试等
• 内容创作知识库 - 公众号、视频号运营
• TUI交互浏览 - 终端可视化浏览

🚀 快速开始

安装依赖

# 安装Bun（如果未安装）
brew install oven-sh/bun/bun  # macOS
# 或
访问 https://bun.sh 下载安装  # Linux

# 安装qmd
bun install -g @tobi/qmd  # 或 npm install -g @tobi/qmd

配置知识库

# 添加知识库集合
qmd collection add ./knowledge/project-management --name pm
qmd collection add ./knowledge/software-testing --name testing
qmd collection add ./knowledge/content-creation --name content

# 生成向量索引（首次使用）
qmd embed

📝 使用方法

1. 关键词搜索（默认，最快）

# 搜索项目管理知识
qmd search "敏捷开发" -n 5

# 搜索测试知识
qmd search "自动化测试" -c testing

# JSON输出（AI友好）
qmd search "内容创作" --json

2. 语义搜索（理解意图）

# 当关键词搜索找不到时使用
qmd vsearch "如何提高团队效率"

# 指定集合
qmd vsearch "测试最佳实践" -c testing

3. 混合搜索（最准确，最慢）

# 需要最高质量时使用
qmd query "项目风险管理策略"

4. 获取文档内容

# 按路径获取
qmd get "knowledge/project-management/pmp-guide.md"

# 按ID获取
qmd get "#docid123"

# 批量获取
qmd multi-get "doc1.md, doc2.md"

📊 搜索模式对比

模式	速度	准确度	适用场景
search	⚡ 秒级	⭐⭐⭐	关键词明确
vsearch	🐢 1-2分钟	⭐⭐⭐⭐	需要理解意图
query	🐌 2-5分钟	⭐⭐⭐⭐⭐	最高质量要求

🎨 特色功能

1. 智能搜索建议

• 自动推荐搜索模式
• 基于查询复杂度选择算法
• 失败时自动降级

2. 多集合管理

# 查看所有集合
qmd status

# 搜索特定集合
qmd search "关键词" -c pm        # 项目管理
qmd search "关键词" -c testing   # 软件测试
qmd search "关键词" -c content   # 内容创作

3. 性能优化

• 缓存机制 - 重复查询秒级响应
• 增量更新 - 只索引变更文件
• 并行处理 - 多集合并行搜索

🔧 高级配置

自定义知识库结构

./knowledge/
├── project-management/
│   ├── pmp/
│   ├── agile/
│   └── waterfall/
├── software-testing/
│   ├── automation/
│   ├── performance/
│   └── security/
└── content-creation/
    ├── wechat/
    └── video/

环境变量

# QMD路径（如果不在PATH中）
export QMD_PATH="/path/to/qmd"

# 知识库根目录
export KNOWLEDGE_BASE="/path/to/knowledge"

# 模型路径（向量搜索）
export QMD_MODEL="/path/to/model"

📈 使用场景

场景1：快速查找PMP知识

# 关键词搜索
qmd search "风险应对策略" -c pm

# 获取完整文档
qmd get "knowledge/project-management/pmp/risk-management.md"

场景2：测试方案参考

# 语义搜索（理解意图）
qmd vsearch "如何设计性能测试方案" -c testing

# 批量获取相关文档
qmd multi-get "test1.md, test2.md, test3.md"

场景3：内容创作灵感

# 混合搜索（高质量）
qmd query "公众号运营增长策略" -c content

🛠️ 维护命令

# 查看索引状态
qmd status

# 更新索引（增量）
qmd update

# 重新生成向量
qmd embed

# 清理缓存
qmd clean

⚠️ 性能提示

1. 优先使用search - BM25通常足够快且准
2. vsearch需预热 - 首次慢（加载模型），后续快
3. query慎用 - 仅在需要最高质量时使用
4. 定期update - 保持索引最新
5. 合理分集合 - 避免单个集合过大

📊 适用场景

✅ 适合

• 个人知识库管理
• 项目文档检索
• 技术资料查找
• 学习笔记管理

⚠️ 不适合

• 代码仓库搜索（用代码搜索工具）
• 海量数据（百万级文档）
• 实时性要求高的场景

🔗 相关资源

• 官方qmd: https://github.com/tobi/qmd
• Bun: https://bun.sh
• 问题反馈: https://github.com/miliger/qmd-manager/issues

---

版本: 1.0.0 作者: 米粒儿 更新: 2026-03-06

整合了官方qmd的强大搜索能力和自定义的知识管理功能，为项目管理、软件测试、内容创作提供一站式知识检索服务 🌟