# zhixun

**Repository Path**: vee7z/zhixun

## Basic Information

- **Project Name**: zhixun
- **Description**: 一款本地AI+语义文件搜索工具，支持Office文件、普通文本文件、开发文件、多媒体文件搜索。你是否曾苦于找某个印象中的文件翻遍文件夹？那么这款软件你值得尝试。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-16
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 智寻 Zhixun

**本地智能语义搜索 · Local Semantic File Search**

搜索你电脑里的所有文件——用自然语言，而不是文件名。
Search every file on your computer with natural language, not filenames.

**100% 本地运行 · 数据永不上传 · 中文优先 · 安装即用（内置模型）**
**100% local · zero upload · Chinese-first · bundled model, ready out of the box**

</div>

---

## 官网与文档 / Website & Docs

- 官网：<https://zhixun-app.github.io/zhixun/> （介绍、亮点、下载）
- 文档：<https://zhixun-app.github.io/zhixun/guide/> （VitePress，含快速开始/设置详解/发布指南）
- 本地文档源码在 `website/` 目录，`npm run docs:build` 构建

---

## 为什么做这个？ / Why?

- 微软 Recall 因隐私问题翻车且国内不可用 —— 但「搜到我记得内容、记不得名字的文件」是每个人的需求。
- Everything 只搜文件名；Windows 自带搜索搜内容但体验糟糕。
- **「100% 本地 + 中文语义 + 普通用户可用」这个组合目前没人做透。**

## 功能 / Features

- 🔍 **全局热键呼出**（`Ctrl+Alt+Space`），即输即搜；窗口可拖动
- 🧠 **语义搜索**：本地中文向量模型（bge-small-zh，随安装包附带），文件内容里没有你搜的词也能凭意思找到；关键词精确命中永远优先，语义只做补充
- 📄 **格式全覆盖**：文本/代码、Word（docx/doc）、Excel（xlsx/xls）、PPT（pptx）、PDF、邮件（eml），图片走 **Windows 内置 OCR**（零下载，中文系统自带中文识别）
- 🎙️ **音视频转写（ASR）**：mp3/mp4/wav/flac/m4a/mov 等后台自动转写（whisper，中文优化），转写文字直接可搜；右键可手动触发单个文件
- 🧭 **中文搜代码**：标识符拆分（userLogin → user/login）+ 内置 400+ 中英词典——搜「登录」能命中 login/user_login；可选 LLM 代码摘要让代码可被「功能」搜索
- 🖼️ **图片理解（可选）**：OCR 之外可接任意 OpenAI 兼容视觉模型（自配 BaseURL/API Key/模型名/请求间隔限流），为图片生成中文内容描述
- ✨ **启动欢迎动画**：安装后启动有品牌动画提示，随后自动驻留托盘
- ⚡ **实时索引**：文件系统 watcher——新建/修改/删除秒级同步进索引
- 🎚️ **高度可自定义**：语义灵敏度预设（严格/平衡/宽松）+ 自定义阈值 + 高级参数；**模型可换**（内置 or 你自己的 ONNX 模型目录）
- 🗂️ **筛选与浏览**：类型（文档/图片/代码/音视频）× 时间（今天/本周/本月/今年）快捷筛选；空输入显示最近文件；右侧内容预览面板
- 🖱️ **完整交互**：右键菜单（打开/在文件夹中显示/复制路径/复制文件名）、`Ctrl+C` 复制路径、结果高亮与片段预览
- 🚀 **自动更新**：启动自动检查 + 手动检查，发现新版本一键下载覆盖安装（配置/索引保留）
- 🔒 **隐私第一**：索引全部在本地；一键清空/重建索引；**可选索引加密**（XChaCha20 口令加密，启动自动解密、退出自动封存）；LLM 功能默认关闭，仅在你自己配置 API 后才会联网

## 安装 / Install

从发布页下载 `智寻_x.y.z_x64-setup.exe` 安装即可（内置语义模型，无需联网下载）。
后续版本会自动更新提示。

## 开发 / Development

需要 Rust (≥1.88) 与 Node.js 18+。

```bash
npm install
npm run tauri dev
```

测试：`cargo test`（索引管线/解析器/OCR/筛选等 12+ 项端到端测试）

打包发布：见 [docs/DEPLOY.md](docs/DEPLOY.md)（含自动更新服务器配置指南）。

## 隐私承诺 / Privacy

- 所有索引与搜索都在本机完成，程序不包含任何网络上传逻辑（唯一联网场景：检查更新）
- 语义模型内置在安装包中，加载不联网
- 设置中可一键清空索引

## License

MIT