AI 助手（BYOK）

Mindwtr 提供可选的 AI 助手，用于明确任务、拆解任务和检查长期未更新的事项。该功能默认关闭，并采用**自备密钥（BYOK）**模式。

隐私模式

• 本地优先：数据保留在你的设备上。
• 按需请求：只有在你点按 AI 操作或启用 Copilot 建议时才会发送请求。在配置了密钥的情况下打开 AI 设置时，还会向你的服务商查询最新模型列表，让模型选择器保持最新——该请求不包含任何任务数据。
• 范围受限：助手只会接收完成操作所需的任务数据。

支持的服务提供方

• OpenAI
• Google Gemini
• Anthropic (Claude)

在桌面端的设置 → AI 助手或移动端的菜单 → 设置 → 高级 → AI 助手中配置：

• 启用/禁用 AI
• 服务提供方
• 模型
• 可选的自定义 OpenAI 兼容基础 URL
• API 密钥（仅存储在本地）
• 推理强度/思考预算（取决于服务提供方）
• Claude/Gemini 可选的**“启用思考”**开关（增加扩展推理）

OpenAI 兼容端点（本地或托管）

Mindwtr 可以连接任何提供 OpenAI 兼容 Chat Completions API 的服务，包括本地服务器和部分托管服务提供方。

以下情况可使用此设置：

• 官方 OpenAI：将自定义基础 URL留空，并使用你的 OpenAI API 密钥。
• 本地服务器：llama.cpp、Ollama、LM Studio、LocalAI、vLLM 等。
• 托管的 OpenAI 兼容服务：例如 GLM，或其他提供 OpenAI 兼容端点的厂商。

1. 如有需要，启动 OpenAI 兼容端点或取得其访问权限。
2. 在桌面端的设置 → AI 助手或移动端的菜单 → 设置 → 高级 → AI 助手中：
   • 将服务提供方设为 OpenAI
   • 将模型设为该服务公开的模型名称
   • 将自定义基础 URL设为服务的基础 URL
   • 如果服务要求 bearer auth，请输入 API 密钥
3. 只有使用官方 OpenAI 时，才将自定义基础 URL留空。
4. 只有自定义端点允许未认证请求时，才将 API 密钥留空。

Mindwtr 会自动附加 /chat/completions，因此应使用服务提供方的基础 URL，而不是完整的 chat-completions 路径，除非该服务明确要求完整路径。

常用基础 URL：

• llama.cpp：http://localhost:8080/v1
• Ollama：http://localhost:11434/v1
• LM Studio：http://localhost:1234/v1
• LocalAI / vLLM：http://localhost:8080/v1

GLM 类托管端点示例：

• 服务提供方：OpenAI
• 模型：服务提供方公开的 GLM 模型 ID，例如 GLM-4.7
• 自定义基础 URL：服务提供方的 OpenAI 兼容基础 URL
• API 密钥：服务提供方要求时填写其密钥

功能

明确

把含糊的任务转化为具体的下一步行动，并建议情境/标签。

拆解

为大型任务生成简短的后续步骤检查清单，由你选择要应用的内容。

回顾分析

每周回顾期间，助手可以标出长期未更新的任务，并建议如下操作：

• 移至将来/也许
• 归档
• 拆解
• 保留

Copilot 建议

（可在任务编辑器、桌面列表的快速添加行以及移动端快速收集中使用）

输入时，Mindwtr 可以建议：

• 情境
• 标签
• 时间预估

Copilot 未经你批准绝不会应用更改。

语音转文字

将语音笔记转录为任务。

• 离线（Whisper）：下载模型（Tiny 约 75MB，Base 约 150MB），完全离线转录。
• 云端（OpenAI/Gemini）：使用你的 API 密钥获得高准确度转录。
• 自托管（兼容 OpenAI）：在 OpenAI 语音提供方下设置自定义基础 URL，即可在你自己的服务器上转录，而不经过 api.openai.com。任何提供 OpenAI /v1/audio/transcriptions 接口的服务器都可以（whisper.cpp、Speaches、LocalAI、vLLM）；此时 API 密钥为可选，模型字段也接受你服务器自己的模型名称。
• 模式：
  • 智能解析：从自然语音中提取截止日期、项目和优先级（例如“明天买牛奶，优先级高”）。
  • 仅转录：只生成文字。

自托管转录

将语音提供方设为 OpenAI，然后填写基础 URL：你服务器的根地址，以 /v1 结尾（例如 http://localhost:8000/v1）。Mindwtr 会像发送给 OpenAI 一样，将录音发送到该地址下的 /v1/audio/transcriptions。

• 如果你的服务器不需要密钥，可将 API 密钥留空。
• 模型选择器会显示你的服务器在 /v1/models 报告的模型（如果它有响应）；否则回退到建议列表。你随时可以输入任意模型名称——列表并非固定选项。
• 语音服务器只负责转录。智能解析需要语言模型，因此若未配置 AI 助手，捕获内容会变成以转录文字为标题的任务，不会从中提取日期、项目和优先级。如果需要这些功能，请单独配置助手。

说明

• AI 是可选功能。Mindwtr 无需 AI 也能完整工作。
• 响应会按结构化 JSON 解析；如果解析失败，不会应用任何更改。

Whisper 语言代码

使用 Whisper 离线模型时，可在桌面端的设置 → AI 助手 → 音频语言或移动端的菜单 → 设置 → 高级 → AI 助手 → 音频语言中明确设置语言代码。 语言列表请参阅 Whisper language list。