用途：为项目文档、代码库或研究资料建立本地文档记忆，支持即时语义检索与问答，服务于 AI 辅助工作流。
主要能力：可导入 PDF、DOCX、PPTX、XLSX、Markdown、代码及 URL；提供语义搜索（免费、无需 LLM）、LLM 问答、交互式对话、文档列表与统计、删除文档、切换嵌入模型时重索引、监听文件变化自动导入，以及导出 JSONL 供训练数据整理。支持集合、项目、标签等元数据过滤，并自动解析 YAML frontmatter。
使用方式：常用命令包括 vstash add paper.pdf notes.md https://example.com/article、vstash add ./docs --collection research --project ml-survey、vstash search "..."、vstash ask "..."、vstash chat、vstash list、vstash stats、vstash forget paper.pdf、vstash reindex、vstash watch ./docs、vstash export --project ml-survey --format jsonl、vstash config。可在当前目录或 ~/.vstash/vstash.toml 配置推理后端（ollama、cerebras、openai）、Ollama 主机与模型、嵌入模型、分块大小与重叠、code_aware 以及打分重排。
适用场景：管理大量项目文档、代码库或研究论文并需要快速语义查找与问答时使用。
限制：vstash ask 需要推理后端；使用 Cerebras/OpenAI 时文本块会发送到 API，如需完全隐私应使用 ollama 后端或仅用 vstash search。其余组件（FastEmbed ONNX 嵌入、sqlite-vec 向量库、语义搜索、Ollama 推理）均为本地。搜索采用向量与关键词检索的 RRF 融合、内存打分、去重与相关性信号，并附带相邻分块扩展上下文。更多选项细节请参见 references/cli-reference.md。