用户手册 — 意动 MindFlow

意动智能协作平台软件 V1.0 用户手册

软件全称：意动智能协作平台软件
版本号：V1.0
著作权人：陕西易扬智创信息科技有限公司
编制日期：2026-06-18

第一章  软件概述
  1.1 产品简介
  1.2 适用场景
  1.3 运行环境
  1.4 技术特性
  1.5 主界面布局

第二章  安装与卸载
  2.1 获取安装程序
  2.2 安装前准备
  2.3 安装步骤
  2.4 首次启动与引导
  2.5 卸载方法
  2.6 覆盖安装（版本更新）

第三章  首次使用
  3.1 许可协议与 API 配置
  3.2 身份选择
  3.3 创建知识库
  3.4 导入与同步文件
  3.5 快速演示引导
  3.6 能力面板
  3.7 「帮帮我」指令

第四章  核心功能——学生向
  4.1 作业拆解
  4.2 知识盘点
  4.3 项目复盘

第五章  核心功能——职场向
  5.1 方案辅助
  5.2 能力盘点
  5.3 新手上路

第六章  基础功能（通用）
  6.1 语义查找
  6.2 随手笔记
  6.3 进度查询
  6.4 内容带读

第七章  知识库管理
  7.1 多知识库创建与切换
  7.2 目录映射与文件同步
  7.3 目录树与文档预览
  7.4 AI 产出文件的存放规则

第八章  设置与配置
  8.1 API Key 模式切换
  8.2 许可协议与遥测开关
  8.3 公测反馈
  8.4 版本更新
  8.5 退出应用

第九章  数据安全与隐私
  9.1 本地数据存储位置
  9.2 AI 调用与云端传输
  9.3 隐私保护与用户权利

第十章  常见问题

附录 A  支持的文档格式
附录 B  快捷键与输入操作
附录 C  功能与技能对照表

第一章软件概述

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

1.1 产品简介

MindFlow（意动智能协作平台软件）是一款面向大学生与职场新人的桌面智能工作软件。软件通过本地知识库与 AI 对话相结合的方式，帮助用户完成以下典型任务：

将模糊的作业或需求拆解为可执行步骤；
对学期或项目文档进行知识盘点与能力评估；
对已完成项目进行复盘并整理为可写入简历的表述；
在本地文件夹中语义查找资料、随手笔记、查询执行进度；
对长文档进行内容带读与要点摘要。

核心理念：用户无需学习复杂菜单，用自然语言说明需求即可；AI 结合本地知识库内容给出结构化成果，并将报告写入用户指定的文件夹。

产品定位：为面临学业/工作压力、但缺少系统化方法论的用户，提供「AI 辅助的个人知识工作台」。

当前版本：V1.0（正式登记版本）。V1.0 支持 Windows 10/11（64 位）；macOS、Linux 版本在后续规划中。

1.2 适用场景

用户类型	典型场景	推荐功能	示例说法
大学生	大作业要求模糊，不知从何下手	作业拆解	「帮我拆解一下这个作业要求」
大学生	学期末回顾学了什么	知识盘点	「帮我看看这学期学了什么」
大学生	课程项目结束后整理经历	项目复盘	「帮我把这个项目复盘一下」
大学生	在笔记里找某知识点	语义查找	「二叉树相关内容在哪个文件？」
职场新人	面对大量业务文档无从下手	新手上路	「帮我梳理这些业务文档，生成上手指南」
职场新人	领导布置需求但不会写方案	方案辅助	「帮我拆解这个需求：给系统加权限管理」
职场新人	述职前梳理技术积累	能力盘点	「帮我看看这一年积累了哪些技术点」
通用	临时记录想法	随手笔记	「帮我记一条：下周评审支付模块方案」

1.3 运行环境

项目	最低要求	推荐配置
操作系统	Windows 10 22H2 及以上（64 位）	Windows 11 64 位
CPU	x86_64，双核 2.0GHz	四核及以上
内存	4 GB	8 GB 及以上
磁盘	安装包约 500 MB；运行需额外 ≥1 GB 可用空间	SSD，预留 5 GB 以上
网络	AI 功能需连接互联网	宽带稳定接入
其他	需安装 Microsoft VC++ 2015–2022 运行库（安装包会提示）	—

不支持的环境：32 位 Windows、Windows 7/8、虚拟机中未启用 GPU/网络隔离导致 API 不可达的环境。

1.4 技术特性

特性	说明
本地优先	知识库文件、对话记录、配置、数据库默认保存在本机 `%APPDATA%\MindFlow\`
文件夹映射	知识库直接映射用户本地目录，增删改文件后自动增量同步
语义检索	内嵌向量模型（all-MiniLM-L6-v2），支持离线检索；模型随安装包内置
AI 推理	默认调用 DeepSeek 大语言模型；支持平台共享额度或用户自有 API Key
身份适配	「学生 / 职场人」两种身份，能力面板文案与引导语自动切换
桌面壳	基于 Electron 的独立窗口应用，系统托盘/单实例运行

系统架构示意：

┌──────────────────────────────────────────┐
│     用户界面层（Electron + Web 前端）      │
│  知识库树 │ 对话区 │ 能力面板 │ 设置侧栏   │
├──────────────────────────────────────────┤
│     业务逻辑层（Python 后端服务）          │
│  对话编排 │ 技能引擎 │ 知识库服务 │ 检索   │
├──────────────────────────────────────────┤
│     数据层（SQLite + 本地文件系统）        │
│  %APPDATA%\MindFlow\data\mindflow.db     │
│  用户映射的知识库目录（任意本地路径）       │
├──────────────────────────────────────────┤
│     外部服务（可选）                       │
│  DeepSeek API │ 匿名遥测端点（可关闭）     │
└──────────────────────────────────────────┘

典型数据流：用户在对话区输入需求 → 系统从当前知识库检索相关文档片段 → 组装提示词 → 调用 DeepSeek API → 将回复展示在对话区；若技能需要落盘，则将 Markdown 报告写入知识库映射目录。原始项目文件始终保留在用户指定的本地路径，不会被上传至 MindFlow 自有服务器。

系统架构简图：

+------------------------------------------+
|            用户界面（Electron）             |
+------------------------------------------+
|   知识库管理   |   AI对话   |   文件同步     |
+------------------------------------------+
|            本地SQLite数据库                 |
+------------------------------------------+
|            DeepSeek API（云端）             |
+------------------------------------------+

数据流说明：用户通过界面发起请求，本地知识库检索相关文档，构建提示词，调用DeepSeek API，返回结果写入本地数据库和知识库文件。所有用户文件始终保留在本地，仅必要上下文发送给云端AI。

1.5 主界面布局

安装并完成首次引导后，进入知识中心工作台。主要区域如下：

区域	位置	功能
顶栏	窗口最上方	当前知识库名称、运行状态、退出按钮（桌面版）
能力面板	顶栏下方或对话区上方	4 个常用能力快捷卡片 +「查看全部能力」
知识库列表	左侧	已创建的知识库；支持新建、切换、删除
目录树	中部	当前知识库的文件树；点击文件可预览
对话区	右侧	与「知识助手」的多轮对话；支持思考过程展示（若模型返回）
输入框	对话区底部	输入自然语言指令；Enter 发送，Shift+Enter 换行
侧栏底部	左侧最下	公测反馈、许可协议、发送匿名使用统计开关

状态指示：顶栏「运行正常」表示后端服务与数据库可用；若显示异常，请重启应用或查看 %APPDATA%\MindFlow\logs\ 下日志。

第二章安装与卸载

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

2.1 获取安装程序

打开官方网站：https://mindflowtools.cn
点击首页 「免费下载」 按钮。
浏览器将下载 Windows 安装程序（文件名形如 MindFlow_Beta_0.9.1_Setup.exe，约 450～500 MB）。
建议将安装包保存到本地磁盘（如 D:\Downloads\），勿在网络驱动器上直接运行。

2.2 安装前准备

检查项	说明
管理员权限	安装程序需管理员权限（per-machine 安装）
关闭旧版本	若已安装旧版，请先完全退出（含托盘），必要时在任务管理器中结束 `mindflow-backend.exe`
SmartScreen	未签名公测包可能弹出「Windows 已保护你的电脑」→ 点「更多信息」→「仍要运行」
运行库	若启动报缺 `VCRUNTIME140.dll`，请安装 Microsoft VC++ Redistributable 2015–2022 x64
磁盘空间	确保系统盘与目标安装盘各有足够空间（见 §1.3）

2.3 安装步骤

步骤	用户操作	系统行为
1	双击 `MindFlow_Beta_0.9.1_Setup.exe`	启动 NSIS 安装向导
2	阅读软件许可协议，勾选同意	许可协议为 UTF-8 中文全文
3	选择安装目录（默认 `C:\Program Files\意动 MindFlow` 或类似路径）	可更改到其他盘符
4	确认安装	释放 Electron 壳、Python 后端、内嵌模型与前端资源
5	勾选「运行 MindFlow」（可选）→ 完成	创建开始菜单与桌面快捷方式

安装过程中不会要求输入 API Key；Key 在首次启动时配置（见 §2.4）。

2.4 首次启动与引导

首次启动时，软件按以下顺序初始化：

顺序	界面/动作	说明
1	启动画面（Splash）	后端子进程启动，扫描可用端口（默认 18000 起）
2	API 配置页	二选一：免费体验（平台共享 DeepSeek 额度，每日约 3 万词元）或填写自有 DeepSeek API Key（`sk-` 开头，仅保存在本机）
3	身份选择	选择「学生」或「职场人」（见第三章）
4	知识库引导	若无知识库，引导创建第一个知识库
5	进入工作台	显示能力面板与知识助手欢迎语

后台自动完成（用户无感）：在 %APPDATA%\MindFlow\ 创建 .env（含 JWT 密钥）、从模板复制空数据库、写入 .onboarding_done 标记。

若启动超过 30 秒仍停留在启动画面，请检查防火墙是否拦截本地端口，或查看日志文件。

2.5 卸载方法

方式一：Windows 设置

设置 → 应用 → 已安装的应用 → 找到 「意动 MindFlow (Beta)」 或 MindFlow → 卸载。

方式二：控制面板

控制面板 → 程序和功能 → 选中 MindFlow → 卸载。

方式三：开始菜单

开始菜单 → MindFlow → 卸载。

卸载时的数据选项（重要）：

安装程序会弹出对话框：「是否保留应用数据？」

选择	效果
是（保留）	保留 `%APPDATA%\MindFlow\` 与 `%APPDATA%\mindflow-desktop\`；重装后可恢复对话与配置
否（不保留）	删除上述两个目录内的应用数据（聊天记录、知识库配置、Electron 缓存等）

说明：

知识库映射的本地文件夹（如 D:\学习资料\）中的原始文件不会被删除。
若选「不保留」后仍看到旧聊天或知识库列表，请确认已完全退出应用后再卸载，或手动删除 %APPDATA%\MindFlow。

2.6 覆盖安装（版本更新）

从官网下载新版本安装包。
完全退出 MindFlow（菜单退出或关闭窗口并确认；检查任务管理器无 mindflow-backend.exe）。
双击新安装包，按向导覆盖安装。
无需卸载。用户数据在 %APPDATA%\MindFlow\，与安装目录无关，覆盖安装默认保留数据。
若新版本提示更新，也可在应用内点击「前往下载」获取安装包后重复上述步骤。

第三章首次使用

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

3.1 许可协议与 API 配置

许可协议：首次使用及后续可在侧栏打开「许可协议」查看全文。协议说明公测/正式版的使用范围、免责声明、知识产权归属等。

API 配置页提供两种模式：

模式	适用人群	说明
免费体验	希望零配置试用的用户	使用平台配置的 DeepSeek Key，受每日词元配额限制；高峰可能排队
自有 API Key	希望稳定、大量使用的用户	在 DeepSeek 开放平台申请 Key，填入后仅保存在本机 `%APPDATA%\MindFlow\.env`，不上传至 MindFlow 服务器

后续可在工作台随时切换模式（见 §8.1）。

3.2 身份选择

首次进入时展示身份选择页，标题大意：「你好，我是你的知识助手」。

身份	适用	能力侧重
学生 🎓	在校大学生	拆作业、查资料、做盘点、记笔记、项目复盘
职场人 💼	职场新人（约 1～3 年）	做方案、查文档、新手上路、做盘点、记笔记

操作：点击对应卡片即完成选择。之后可在对话中说 「切换身份」 重新选择（无需重启软件）。

3.3 创建知识库

知识库是 MindFlow 的核心概念：一个知识库 = 本地一个文件夹的映射。

创建步骤：

在左侧点击 「新建知识库」（或按引导提示操作）。
填写 知识库名称（必填，最多 50 字），如「我的学习资料库」。
填写 知识库说明（选填，最多 500 字）。
点击 「选择目录」，在系统文件夹选择器中指定本地路径（如 D:\MindFlowData\学习）。
点击 「创建」。

注意：

目录创建后不可修改；若需换路径，请新建知识库并迁移文件。
所选目录下的文件会被索引；请勿选择系统目录或含大量无关文件的根目录。

3.4 导入与同步文件

知识库创建后，添加文件的方式：

方式	操作
资源管理器	直接将 PDF、Word、Markdown 等复制/保存到映射目录
对话写入	使用「随手笔记」「作业拆解」等技能，AI 将产出写入该目录下子文件夹
自动同步	软件监视目录变化，增量更新索引（无需手动「刷新」按钮，极端情况可切换知识库触发重载）

默认不同步的目录名（减少噪音）：.git、.venv、node_modules、__pycache__ 等。

3.5 快速演示引导

首次进入工作台且知识库为空时，知识助手会提示先放入文件或选择演示场景。

若知识库已有文件，助手会扫描并主动建议，例如：

学生：「看到有 12 篇 Markdown 和 8 份 PDF，需要帮你拆解作业或做知识盘点吗？」
职场人：「看到需求文档和会议纪要，需要帮你梳理业务或做方案吗？」

场景引导卡片（三选一）：

学生	职场人
拆解作业	制定方案
盘点知识库	盘点知识库
自由问答	自由问答

3.6 能力面板

能力面板展示当前身份可用的 9 项业务能力（顶部默认显示 4 个最常用的，其余通过「查看全部能力」展开）。

学生 — 全部能力：

图标	名称	示例指令
📖	查资料	「快速排序的 Python 实现在哪个文件里？」
🔍	拆作业	「帮我拆解一下这个作业要求」
📊	做盘点	「帮我看看我这学期学了什么」
📝	记笔记	「帮我记一条关于微服务的思考」
📈	进度查询	「我做到哪了」
🚀	新手上路	「帮我生成一份新手上路指南」
📋	项目复盘	「帮我复盘一下这个项目」

职场人 — 全部能力（名称略有不同）：

图标	名称	示例指令
📖	查文档	「用户登录模块的接口文档在哪？」
🔧	做方案	「帮我拆解这个需求：给系统加权限管理」
📊	做盘点	「帮我看看这一年积累了哪些技术点」
📝	记笔记	「帮我记一下：支付模块方案通过评审」
🚀	新手上路	「帮我梳理这些业务文档，生成上手指南」
📈	进度查询	「帮我查一下方案执行进度」
📋	项目复盘	「帮我复盘一下这个项目」

使用方式：点击能力卡片 → 系统自动将「使用方法 + 示例」填入输入框 → 用户可编辑后发送。

3.7 「帮帮我」指令

在对话中输入 「帮帮我」 或 「你能做什么」，知识助手会：

列出当前身份下全部能力说明；
结合当前知识库文件情况给出上下文建议（如优先推荐拆解或盘点）；
提示可说「切换身份」更换面板。

第四章核心功能——学生向

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

4.1 作业拆解

功能说明：将课程作业要求拆解为分阶段、可执行的《作业执行路线图》。

适用：编程大作业、课程设计、实验报告类任务等。

操作步骤：

将作业要求文档（PDF/Word/Markdown）放入知识库目录。
在目录树中选中该文档（可选，便于 AI 定位）。
点击能力面板 「拆作业」，或输入「帮我拆解一下这个作业要求」。
按 AI 追问回答关键信息（语言/框架、数据来源、截止日期、硬件条件等；最多 3 轮，每轮最多 3 问）。
等待 AI 生成路线图；确认后写入知识库。

处理阶段：

阶段	名称	说明
1	追问澄清	收集约束条件；用户可说「跳过」提前进入分析
2	分析	结合文档与用户回答分析关键路径
3	生成路线图	输出分阶段计划、预估时间、产出物、质量标准
4	写入知识库	保存为 Markdown，通常位于 `docs/作业拆解/`

产出物示例结构：

# 作业执行路线图
## 阶段一：信息收集（预计 2 天）
- 任务：……
- 产出物：……
## 阶段二：……

4.2 知识盘点

功能说明：扫描知识库，按主题聚类，评估掌握程度，生成《个人知识资产报告》。

操作步骤：

确保知识库中已有本学期/本阶段的笔记与资料。
输入「帮我看看这学期学了什么」或点击 「做盘点」。
AI 扫描文件 → 聚类 → 评估 → 生成报告并写入知识库。

产出物要点：

主题聚类列表（如「算法」「数据库」「网络」）；
各主题能力等级（入门 / 熟悉 / 精通）；
薄弱点提示；
统计信息（文件数、主题数等）。

默认保存路径：docs/盘点报告/ 或类似归类目录。

4.3 项目复盘

功能说明：对课程项目按 STAR 法则（情境 / 任务 / 行动 / 结果）生成复盘报告，便于写入简历或答辩材料。

操作步骤：

将项目相关代码、文档、报告放入知识库（可单独子目录）。
输入「帮我把这个项目复盘一下」或点击 「项目复盘」。
AI 扫描项目文件 → 提取技术栈与难点 → 生成 STAR 结构化报告 → 写入 docs/复盘/。

第五章核心功能——职场向

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

5.1 方案辅助

功能说明：将产品/开发需求拆解为《技术方案初稿》，含模块划分、接口思路、测试要点等。

与作业拆解的关系：共用「追问 → 分析 → 生成 → 写入」流程，但追问维度与产出模板不同。

对比项	作业拆解（学生）	方案辅助（职场）
典型追问	语言、数据集、截止日期	用户角色、权限粒度、技术栈、数据库
产出物	《作业执行路线图》	《技术方案初稿》
内容侧重	学习步骤与时间安排	模块、接口、库表变更、测试

操作步骤：映射含 PRD/需求/会议纪要的知识库 → 输入「帮我拆解这个需求：……」→ 回答追问 → 获取方案初稿。

5.2 能力盘点

功能说明：按技术栈方向聚类项目与文档，生成《个人技术能力报告》，适用于述职与自我评估。

操作：输入「帮我看看这一年积累了哪些技术点」或点击 「做盘点」（职场身份下文案为技术向）。

产出物：《个人技术能力报告》——技术栈分布、各方向积累量、能力等级、薄弱点。

5.3 新手上路

功能说明：面对大量陌生业务文档，自动生成《新人上手指南》，含业务简介、术语表、建议阅读顺序。

操作步骤：

将团队文档目录映射为知识库（或复制到专用文件夹）。
输入「帮我梳理这些业务文档，生成上手指南」或点击 「新手上路」。
AI 扫描 → 提取术语与依赖 → 生成指南 → 写入 docs/指南/ 等目录。

产出物结构：业务简介、术语表（通常 ≥20 条）、分阶段学习路径（≥3 阶段）、上下游依赖说明。

第六章基础功能（通用）

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

6.1 语义查找

功能说明：用自然语言在知识库中查找相关内容，返回原文片段与文件路径引用。

触发：

直接提问且未匹配到其他专用技能时自动走语义检索；
或点击 「查资料 / 查文档」 能力卡片。

操作示例：

「用户登录的接口文档在哪？」
「我之前写的快速排序实现在哪个文件？」

返回格式：回答正文 + 来源标记（如 📄 docs/课程/算法/笔记.md），点击可定位目录树节点。

性能：知识库文件数 ≤10,000 时，检索响应通常 <3 秒（视硬件与文件大小而定）。

6.2 随手笔记

功能说明：通过对话快速记录备忘，自动归类并保存为 Markdown。

操作：输入「帮我记一条：……」或点击 「记笔记」。

规则：

默认写入当日备忘录，如 备忘录/备忘_2026-06-18.md；
同一天多条记录追加到同一文件；
AI 回复中会告知具体保存路径。

6.3 进度查询

功能说明：根据已生成的路线图/方案，结合当前日期告知所处阶段与下一步建议。

前提：知识库中已有此前「作业拆解」或「方案辅助」产出的路线图文件。

操作：在新对话中问「我做到哪了？」「现在该做第几步了？」或点击 「进度查询」。

示例回复：「按路线图，你应在第 3 阶段：模型训练。建议本周完成训练与初步评估。」

6.4 内容带读

功能说明：对指定文档生成结构化带读摘要（核心论点、关键概念、适合人群、阅读建议）。

操作：

在目录树选中目标文档（或对话中说明文件名）；
输入「帮我读一下这篇文档」或「这篇文章讲了什么」；
在对话区阅读摘要；可选要求「保存到知识库」。

与语义查找的区别：语义查找回答「在哪/哪段相关」；内容带读回答「全文讲了什么」。

第七章知识库管理

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

7.1 多知识库创建与切换

支持多个知识库，分别对应不同本地目录，适用于「课程资料 / 实习项目 / 工作文档」分离管理。

操作	步骤
新建	左侧列表 →「新建知识库」→ 填写名称与目录 → 创建
切换	点击列表中另一知识库名称；对话上下文与目录树随之切换
编辑	可修改名称与说明；不可修改已绑定的本地目录
删除	在知识库项上选择删除 → 确认；仅删除 MindFlow 内索引与配置，不删除磁盘原文件

默认行为：下次启动进入上次使用的知识库。

7.2 目录映射与文件同步

映射关系：每个知识库在数据库中记录 local_path（绝对路径）。MindFlow 对该路径做只读索引与约定目录写入（AI 产出）。

同步机制：

监视文件系统变更，增量更新 SQLite 中的文档索引与目录树；
保留用户原有文件夹层级；
大目录首次扫描可能需要数分钟，请耐心等待状态变为可用。

建议：

单个知识库映射路径下文件量建议控制在 1 万文件以内；
避免映射整个用户主目录或含大量二进制/临时文件的目录。

7.3 目录树与文档预览

目录树（中部区域）：

展示文件夹与文档节点；
支持展开/折叠；
点击文档可在预览区查看提取后的文本内容（PDF/Word 等经解析后展示）。

若显示「目录未加载」：检查后端是否运行正常、网络/本地服务是否可达，点击刷新或切换知识库重试。

7.4 AI 产出文件的存放规则

产出类型	建议/默认子目录
作业路线图	`docs/作业拆解/`
技术方案初稿	`docs/方案/` 或技能约定路径
知识/能力盘点报告	`docs/盘点报告/`
项目复盘	`docs/复盘/`
新手上路指南	`docs/指南/`
随手笔记	`备忘录/备忘_日期.md`
未分类	`docs/未分类/`（兜底）

用户可在资源管理器中直接打开上述文件进行编辑；MindFlow 会在下次同步时更新索引。

第八章设置与配置

截图说明：本章界面截图来自 V0.9 公测构建，功能与登记版本 V1.0 一致。界面中「意动 MindFlow」为产品简称，与软件全称「意动智能协作平台软件」指同一产品。

8.1 API Key 模式切换

入口：工作台顶栏或额度相关区域 → 切换 API Key 模式（对话框）。

模式	说明
平台共享 Key	免费体验，每日配额；适合轻度使用
自有 Key	填写 DeepSeek API Key（`sk-` 开头）；保存在 `%APPDATA%\MindFlow\.env`

切换后：立即生效，无需重启；对话继续使用新 Key 调用模型。

8.2 许可协议与遥测开关

许可协议：侧栏或关于区域 → 打开《意动 MindFlow 软件许可协议》全文。

发送匿名使用统计（侧栏开关，默认开启）：

项目	说明
目的	改进产品稳定性与功能优先级
上报字段	`install_id`（匿名 UUID）、`event`（如 startup）、`version`、`platform`、`timestamp`；技能使用时可能含 `skill_id` / `skill_name`
不上报	对话正文、文件路径与内容、用户名、API Key
关闭方式	侧栏关闭「发送匿名使用统计」；关闭后不再发送新事件
存储	未配置外发端点时可能仅落本机库；配置 `TELEMETRY_ENDPOINT` 时发送至指定统计服务

8.3 公测反馈

入口：左侧侧栏 「公测反馈」。

操作：

填写 反馈标题（必填）；
填写 详细描述（必填）；
点击提交。

处理：反馈通过应用内接口发送至产品团队（飞书群机器人）；不会自动附带知识库文件或对话全文。请用户在描述中自行说明版本号与复现步骤。

其他渠道：用户群（微信/QQ）、邮箱 contact@mindflowtools.cn（见官网隐私政策）。

8.4 版本更新

检查机制：启动时连接 health 接口，比对 latest_version 与当前安装版本。

若有新版本：

弹出 版本更新 对话框，展示更新说明；
点击 「前往下载」 打开浏览器下载新安装包；
关闭 MindFlow → 运行新安装包覆盖安装 → 数据保留。

注意：下载链接仅允许官方域名 mindflowtools.cn；安装包内嵌的 DOWNLOAD_URL 与官网 health 配置需一致。

8.5 退出应用

方式一：顶栏 「退出」 按钮 → 确认对话框 → 退出（关闭后端进程与窗口）。

方式二：点击窗口 × 关闭按钮 → 同样弹出确认（防止误关）。

退出后托盘不应残留进程；若异常残留，可在任务管理器中结束 mindflow-backend.exe 与 意动 MindFlow.exe。

第九章数据安全与隐私

9.1 本地数据存储位置

数据类型	存储位置
应用数据库、配置、日志	`%APPDATA%\MindFlow\`
主数据库文件	`%APPDATA%\MindFlow\data\mindflow.db`
用户环境配置（含 API Key、JWT）	`%APPDATA%\MindFlow\.env`
运行日志	`%APPDATA%\MindFlow\logs\`
Electron 缓存	`%APPDATA%\mindflow-desktop\`
知识库原始文件	用户创建知识库时选择的任意本地目录

卸载选「不保留」时，会删除 MindFlow 与 mindflow-desktop 两个目录（见 §2.5）。

9.2 AI 调用与云端传输

AI 功能调用 DeepSeek API（默认 api.deepseek.com）。
请求中发送的是与当前问题相关的文档片段与对话上下文，不是整个硬盘数据。
DeepSeek 按其隐私政策处理 API 数据；用户可选用自有 API Key 自行控制账户与账单。
MindFlow 不提供默认云端备份用户知识库的服务。

9.3 隐私保护与用户权利

遥测：见 §8.2；可关闭。
反馈：仅发送用户主动填写内容。
删除操作：删除知识库、清空对话等需用户确认，不静默删除映射目录内用户文件。
咨询与删除请求：通过公测反馈或 contact@mindflowtools.cn 联系，可提供 install_id 以便处理匿名统计删除请求（若有外发）。

完整说明见官网 《隐私政策》：https://mindflowtools.cn/privacy.html

第十章常见问题

10.1 安装与启动

Q：安装包有多大？
A：约 450～500 MB，含 Python 运行时、向量模型与前端资源。

Q：安装时 Windows 提示「已保护你的电脑」？
A：点击「更多信息」→「仍要运行」。公测安装包可能暂无商业代码签名。

Q：启动提示缺少 VCRUNTIME140.dll？
A：安装 Microsoft VC++ Redistributable 2015–2022（x64）。

Q：启动一直停在启动画面？
A：检查 18000–18099 端口是否被占用；查看 %APPDATA%\MindFlow\logs\；结束残留 mindflow-backend.exe 后重试。

Q：能否安装到 D 盘？
A：可以，安装向导中选择自定义路径即可。

Q：支持 Mac 吗？
A：V1.0 仅 Windows；Mac 版规划中。

10.2 使用与知识库

Q：如何切换学生/职场身份？
A：在对话中输入「切换身份」。

Q：知识库文件实际在哪？
A：在您创建知识库时选择的本地文件夹；MindFlow 只做映射与索引。

Q：AI 写的报告存在哪？
A：写在当前知识库映射目录下的 docs/、备忘录/ 等子目录（见 §7.4）。

Q：追问最多几轮？
A：拆解/方案类技能最多 3 轮追问，每轮最多 3 个问题；可说「跳过」提前进入生成。

Q：删除知识库会删我电脑上的文件吗？
A：不会删除映射目录中的原始文件，仅删除 MindFlow 内的库记录与索引。

Q：目录树显示「目录未加载」？
A：确认后端正常、完全退出后重启；检查映射路径是否存在且可读。

10.3 API 与额度

Q：提示「当前使用人数较多」或 429？
A：稍等重试，或切换到自有 API Key。

Q：如何获取 DeepSeek API Key？
A：注册 DeepSeek 开放平台，创建 Key（sk- 开头），在 MindFlow 配置页或设置中填入。

Q：自有 Key 存在哪？
A：仅 %APPDATA%\MindFlow\.env，不上传 MindFlow 服务器。

Q：免费额度有多少？
A：公测期约每日 3 万词元（以实际配置为准）；用尽后可等待次日或改用自有 Key。

10.4 卸载与数据

Q：卸载选「不保留」为什么还有旧数据？
A：请完全退出应用后再卸载；若仍残留，手动删除 %APPDATA%\MindFlow 与 %APPDATA%\mindflow-desktop。映射目录中的文档不会被卸载删除。

Q：覆盖安装会丢数据吗？
A：不会。数据在 %APPDATA%\MindFlow\，与安装路径无关。

附录 A 支持的文档格式

格式	扩展名	解析方式	限制说明
PDF	`.pdf`	文本提取	扫描版 PDF 若无文字层，提取效果差
Word	`.doc` / `.docx`	结构化解析	复杂排版可能丢失部分格式
Excel	`.xls` / `.xlsx`	表格读取	以单元格文本为主
Markdown	`.md`	原生	推荐格式
纯文本	`.txt`	原生	UTF-8 优先

暂不支持：PPT（.pptx）格式计划在V1.1版本支持；图片 OCR；音频/视频。

附录 B 快捷键与输入操作

操作	按键/方式	说明
发送消息	Enter	在对话输入框中
换行	Shift + Enter	不发送，仅换行
切换知识库	鼠标点击左侧列表	—
选中文件再提问	目录树点击文件	便于拆解/带读类技能定位文档

附录 C 功能与技能对照表

序号	用户可见名称	学生/职场差异	主要产出
1	查资料 / 查文档	名称不同	对话回答 + 路径引用
2	拆作业 / 做方案	学生/职场	路线图 / 方案初稿
3	做盘点	学生：知识资产；职场：技术能力	盘点报告
4	记笔记	相同	当日备忘 Markdown
5	进度查询	相同	对话进度说明
6	新手上路	相同	上手指南
7	项目复盘	相同	STAR 复盘报告
8	内容带读	相同	结构化摘要
9	帮帮我	相同	能力清单与建议

意动 MindFlow

意动智能协作平台软件 V1.0 用户手册

目录

第一章 软件概述

1.1 产品简介

1.2 适用场景

1.3 运行环境

1.4 技术特性

1.5 主界面布局

第二章 安装与卸载

2.1 获取安装程序

2.2 安装前准备

2.3 安装步骤

2.4 首次启动与引导

2.5 卸载方法

2.6 覆盖安装（版本更新）

第三章 首次使用

3.1 许可协议与 API 配置

3.2 身份选择

3.3 创建知识库

3.4 导入与同步文件

3.5 快速演示引导

3.6 能力面板

3.7 「帮帮我」指令

第四章 核心功能——学生向

4.1 作业拆解

4.2 知识盘点

4.3 项目复盘

第五章 核心功能——职场向

5.1 方案辅助

5.2 能力盘点

5.3 新手上路

第六章 基础功能（通用）

6.1 语义查找

6.2 随手笔记

6.3 进度查询

6.4 内容带读

第七章 知识库管理

7.1 多知识库创建与切换

7.2 目录映射与文件同步

7.3 目录树与文档预览

7.4 AI 产出文件的存放规则

第八章 设置与配置

8.1 API Key 模式切换

8.2 许可协议与遥测开关

8.3 公测反馈

8.4 版本更新

8.5 退出应用

第九章 数据安全与隐私

9.1 本地数据存储位置

9.2 AI 调用与云端传输

9.3 隐私保护与用户权利

第十章 常见问题

10.1 安装与启动

10.2 使用与知识库

10.3 API 与额度

10.4 卸载与数据

附录 A 支持的文档格式

附录 B 快捷键与输入操作

附录 C 功能与技能对照表

第一章软件概述

第二章安装与卸载

第三章首次使用

第四章核心功能——学生向

第五章核心功能——职场向

第六章基础功能（通用）

第七章知识库管理

第八章设置与配置

第九章数据安全与隐私

第十章常见问题