简体中文 | 繁體中文（中國台灣） | 繁體中文（中國香港） | 繁體中文（中國澳門） | English

TChat

開源的安卓端AI聊天軟體

TChat的作者是大陸人，交流最好用簡體中文，如果不會使用那就用翻譯，謝謝

TChat By wanxiaoT

QQ 群：819083916

功能特色

多服務商支援（OpenAI、Anthropic Claude、Google Gemini）
自訂 API Key 和端點設定
模型選擇和從 API 拉取模型列表
手動輸入模型支援
側邊欄聊天記錄導航
串流式聊天回應
Material 3 UI 搭配 Jetpack Compose
知識庫（RAG）功能
MCP（Model Context Protocol）工具伺服器支援
深度研究（Deep Research）功能
設定匯出/匯入（檔案、二維碼、加密）
聊天資料夾管理（巢狀、智慧分組）
助手群聊（多助手協作對話）

自願贊助

v1.8

新增功能

語音朗讀（TTS）功能
- 支援將 AI 回覆內容朗讀出來
- 支援選擇不同的 TTS 引擎
- TTS 引擎選項採用卡片式設計
- 使用 synthesizeToFile() 實現更穩定的語音合成
Cloudflare R2 雲端備份
- 支援將資料備份到 Cloudflare R2 雲端儲存
- 大檔案採用串流上傳，優化記憶體佔用
- 完整的備份/還原功能
API Key 輪詢功能
- 支援設定多個 API Key 輪詢使用
- 原子操作實現，解決多對話時的競態問題
- 自動切換失效的 API Key
Skills 功能
- 新增 Skills 系統支援
側邊欄優化
- 搜尋框美化並實現真正的搜尋功能
- 聊天記錄顯示樣式優化（更圓潤的設計）
- 設定頁面圖示統一使用 Lucide 圖示庫

技術改進詳情

1. TTS 語音朗讀服務

功能：將文字內容轉換為語音朗讀

實現：

TtsService 語音合成服務
使用 synthesizeToFile() 替代 speak() 提高穩定性
支援多種 TTS 引擎選擇
卡片式引擎選擇 UI

2. Cloudflare R2 雲端備份

功能：雲端資料備份與還原

實現：

R2 雲端儲存 API 整合
串流上傳支援大檔案
完整的備份/還原流程

3. API Key 輪詢機制

功能：多 API Key 負載平衡

實現：

原子操作保證執行緒安全
解決多對話並行時的競態條件
自動故障轉移

4. 側邊欄搜尋功能

功能：快速搜尋聊天記錄

實現：

搜尋框 UI 美化
即時搜尋過濾
聊天記錄卡片圓角優化

涉及檔案

模組	檔案	說明
app	TtsService.kt	TTS 語音合成服務
app	TtsSettingsScreen.kt	TTS 設定頁面
app	R2BackupService.kt	R2 雲端備份服務
app	R2BackupScreen.kt	雲端備份設定頁面
app	ApiKeyRotationManager.kt	API Key 輪詢管理
app	ChatDrawer.kt	側邊欄搜尋功能
app	SettingsScreen.kt	設定頁面圖示更新

v1.7

新增功能

Token 統計增強
- 按提供商分別統計 Token 使用量
- 顯示每個提供商的輸入/輸出 Token 和呼叫次數
- Token 記錄控制功能：
  - 開始：啟用 Token 記錄
  - 暫停：暫停記錄（保留已有資料）
  - 關閉：完全關閉記錄功能
  - 清空：清空所有統計資料（帶確認對話框）
設定匯出/匯入系統
- 供應商設定批次匯出/匯入（支援多選、檔案、二維碼）
- 單個供應商模型列表匯出/匯入
- API設定匯出/匯入（包含金鑰，強制加密）
- 知識庫完整匯出（原始檔案+向量資料+設定）
- AES-256-CBC 加密保護
- 二維碼分享支援（可選加密）
- 批次檔案匯入（自動防止ID衝突）
聊天資料夾系統
- 無限層級巢狀資料夾
- 資料夾圖示和顏色自訂
- 拖曳排序支援
- 智慧自動分組：
  - 按時間分組（今天/昨天/本週/本月/更早）
  - 按模型分組（根據使用的AI模型）
  - 按助手分組（根據關聯的助手）
- 資料夾樹狀展示（支援展開/摺疊）
- 聊天快速分配到資料夾
助手群聊功能
- 多個助手在同一聊天中協作對話
- 4種訊息路由策略：
  - 自然模式：基於話語權智慧選擇
  - 輪流模式：按成員優先順序發言
  - 隨機模式：隨機選擇助手回覆
  - 手動模式：使用者手動選擇發言者
- 成員設定（優先順序、話語權、啟用/停用）
- 自動模式支援（助手自動連續對話）
- 群聊統計資訊

技術改進詳情

1. 匯出/匯入系統

功能：完整的設定備份和遷移方案

實現：

ExportDataModels.kt 定義匯出資料結構
EncryptionUtils.kt AES-256-CBC加密
QRCodeUtils.kt 二維碼生成/解析
ExportImportManager.kt 統一管理器
ExportImportScreen.kt Material 3 UI介面

安全特性：

PBKDF2 金鑰派生（10000次迭代）
API金鑰強制加密匯出
二維碼支援加密/非加密模式

2. 聊天資料夾系統

功能：組織和管理聊天記錄

實現：

ChatFolder.kt 資料夾資料模型
ChatFolderEntity.kt 資料庫實體
ChatFolderDao.kt 資料存取層
ChatFolderRepository.kt 業務邏輯層
ChatFolderManagementScreen.kt 資料夾管理UI

核心演算法：

資料夾樹建構演算法（遞迴）
循環參照偵測（移動資料夾時）
智慧分組演算法（時間/模型/助手）

3. 助手群聊系統

功能：多助手協作對話

實現：

GroupChat.kt 群聊資料模型
GroupChatEntity.kt + GroupMemberEntity.kt 資料庫實體
GroupChatDao.kt 資料存取層
GroupChatRepository.kt 業務邏輯層
GroupChatScreen.kt 群聊UI介面

訊息路由策略：

LIST模式：按優先順序輪流發言
POOLED模式：隨機選擇成員
NATURAL模式：基於話語權加權隨機選擇
MANUAL模式：使用者手動選擇發言者

4. 資料庫升級

修改：

資料庫版本 14 → 15
新增4個實體表：
- chat_folders 聊天資料夾
- chat_folder_relations 聊天-資料夾關聯
- group_chats 群聊
- group_members 群聊成員
完整的外鍵約束和索引最佳化

涉及檔案

模組	檔案	說明
app/util	ExportDataModels.kt	匯出資料模型定義
app/util	EncryptionUtils.kt	AES-256-CBC加密工具
app/util	QRCodeUtils.kt	二維碼生成/解析工具
app/util	ExportImportManager.kt	匯出匯入統一管理器
app/ui/settings	ExportImportScreen.kt	匯出匯入UI介面
app/ui/folder	ChatFolderManagementScreen.kt	資料夾管理UI
app/ui/groupchat	GroupChatScreen.kt	群聊UI介面
data/model	ChatFolder.kt	資料夾資料模型
data/model	GroupChat.kt	群聊資料模型
data/database/entity	ChatFolderEntity.kt	資料夾資料庫實體
data/database/entity	GroupChatEntity.kt	群聊資料庫實體
data/database/dao	ChatFolderDao.kt	資料夾DAO
data/database/dao	GroupChatDao.kt	群聊DAO
data/repository	ChatFolderRepository.kt	資料夾Repository介面
data/repository	GroupChatRepository.kt	群聊Repository介面
data/repository/impl	ChatFolderRepositoryImpl.kt	資料夾Repository實現
data/repository/impl	GroupChatRepositoryImpl.kt	群聊Repository實現
data/database	AppDatabase.kt	資料庫版本15遷移

同步平板和手機模式的設定圖示同步平板模式和手機模式的設定圖示

修改內容

在 SettingsScreen.kt 的平板模式 SettingsListContent 函式中，添加了兩個缺失的圖示定義：

助手群聊 (group_chat): - 使用 Lucide.Users 圖示 - 與手機模式保持一致
正規表示式 (regex_rules): - 使用 Icons.Default.BugReport 圖示 - 與手機模式保持一致

當前圖示對應

設定項	圖示	類型
助手	Icons.Default.Person	Material
助手群聊	Lucide.Users	Lucide ✨
服務商	Icons.Default.Settings	Material
知識庫	Lucide.BookOpen	Lucide ✨
MCP 伺服器	Icons.Default.Cloud	Material
深度研究	Icons.Default.Search	Material
正規表示式	Icons.Default.BugReport	Material ✨
使用統計	Icons.Default.BarChart	Material
日誌檢視	Lucide.ScrollText	Lucide ✨
網路日誌	Icons.Default.Cloud	Material
關於	Icons.Default.Info	Material

現在平板模式和手機模式在設定頁面中顯示的圖示完全一致了！

v1.6

新增功能

軟體內更新支援
- 應用程式內檢查更新、下載和安裝
- 橫向平板模式下選單列正常使用
正規表示式功能
- 根據社群建議新增正規表示式支援
服務商頁面列佈局選擇
- 支援一列、二列、三列顯示模式切換
網路請求檢視功能
- 新增網路請求除錯/檢視入口
本地工具 - Sleep 工具
- AI 可呼叫 sleep 工具暫停一段時間後傳送通知

Bug 修復

修復 thinking 標籤解析問題
- 解決部分模型（如 Kimi-K2-Thinking）回傳的 <thinking> 標籤無法正常解析的問題
修復工具呼叫問題
- 解決工具呼叫過程中的若干問題
優化本地檔案系統工具描述
- 修復 LLM 不知道系統是 Android 導致檔案儲存路徑錯誤的問題
- 改進本地工具-檔案系統對於 LLM 的描述

v1.5

新增功能

深度研究（Deep Research）功能
- 透過多輪搜尋和 AI 分析，自動生成詳細的研究報告
- 迭代式深度研究，支援設定搜尋廣度（1-10）和深度（1-5）
- 即時顯示研究進度，包括查詢生成、搜尋、結果處理等步驟
- 自動提取關鍵資訊（Learnings）並生成引用來源
- 研究報告支援 Markdown 格式，包含編號引用
搜尋 API 支援
- 支援 Tavily 搜尋 API（推薦，支援進階搜尋模式）
- 支援 Firecrawl 搜尋 API
- 可設定自訂 API Base URL
深度研究 AI 設定
- 支援使用獨立的 AI 設定進行研究
- 可選擇不同的 AI 提供商（OpenAI、Anthropic、Gemini）
- 支援自訂 API Key、Base URL 和模型名稱
- 關閉獨立設定時使用預設服務商
深度研究參數設定
- 搜尋廣度：每層生成的搜尋查詢數量
- 搜尋深度：遞迴研究的層數
- 輸出語言：支援中文和英文
- 搜尋語言：可與輸出語言不同
歷史記錄管理
- 自動儲存研究歷史
- 檢視歷史研究報告和來源
- 支援刪除單條或清空全部歷史
研究進度視覺化
- 樹狀結構展示研究節點
- 即時顯示每個節點的狀態（生成查詢/搜尋中/處理中/完成/錯誤）
- 顯示每個節點發現的資訊數量
助手參數增強
- 新增 Top-p 參數調節，支援開關控制和滑桿調節（0.0~1.0）
- 上下文訊息數量改為 RadioButton 選擇：
  - 不限制（預設）：保留所有歷史訊息
  - 限制數量：滑桿快速調節（1~200）+ 輸入框手動填寫任意值
UI/UX 改進
- RadioButton 選項支援點擊整行文字選擇，使用 Material You selectable 互動
- 訊息數量輸入框從邊框樣式改為下劃線樣式（Material You TextField）
- 輸入框文字置中顯示，視覺更和諧
- 修復設定頁面多級導航動畫方向：從詳情頁返回列表頁時正確使用返回動畫（從左滑入）
平板適配
- 設定頁面支援平板 List-Detail 雙欄佈局
- 螢幕寬度 ≥ 840dp 時自動切換為左右分欄模式
- 左側顯示設定列表，右側顯示詳情內容
- 選中項高亮顯示，支援快速切換
- 新增搜尋功能，可快速過濾設定項

技術改進詳情

1. 深度研究服務

功能：實現迭代式深度研究演算法

實現：

DeepResearchService 核心研究服務
遞迴深度優先搜尋策略
並發控制（Semaphore）限制同時請求數
串流返回研究進度（ResearchStep）

2. 網路搜尋服務

功能：封裝搜尋 API 呼叫

實現：

WebSearchService 搜尋服務介面
TavilySearchService Tavily API 實現
FirecrawlSearchService Firecrawl API 實現
支援搜尋結果內容提取

3. 深度研究資料層

功能：研究歷史持久化

實現：

DeepResearchHistoryEntity 資料庫實體
DeepResearchHistoryDao 資料存取物件
DeepResearchHistoryRepository 儲存庫實現
支援按時間排序、搜尋、刪除

4. 深度研究狀態管理

功能：管理研究過程狀態

實現：

DeepResearchManager 狀態管理器
ResearchState 研究狀態（空閒/研究中/生成報告/完成/錯誤）
ResearchNode 研究節點（查詢、狀態、結果）
NodeStatus 節點狀態列舉

5. 深度研究資料模型

新增：

SearchQuery 搜尋查詢（關鍵字、研究目標、節點ID）
WebSearchResult 網路搜尋結果
Learning 學習成果（URL、標題、關鍵資訊）
ProcessedSearchResult 處理後的結果（學習成果、後續問題）
DeepResearchConfig 研究設定
DeepResearchResult 研究結果
ResearchStep 研究進度步驟（sealed class）

涉及檔案

模組	檔案	修改
data	DeepResearchModels.kt	深度研究資料模型定義
data	DeepResearchService.kt	深度研究核心服務
data	WebSearchService.kt	網路搜尋服務介面和實現
data	DeepResearchManager.kt	研究狀態管理器
data	DeepResearchRepository.kt	研究設定 Repository
data	DeepResearchHistoryEntity.kt	歷史記錄資料庫實體
data	DeepResearchHistoryDao.kt	歷史記錄 DAO
data	DeepResearchHistoryRepository.kt	歷史記錄 Repository
data	AppDatabase.kt	添加深度研究歷史表
data	build.gradle.kts	添加 Gson 依賴
app	DeepResearchViewModel.kt	深度研究 ViewModel
app	DeepResearchScreen.kt	深度研究頁面
app	SettingsManager.kt	添加深度研究設定
app	AppSettings.kt	添加 DeepResearchSettings

v1.4

新增功能

聊天介面優化
- 停用 Markdown 連結自動解析，[名字](連結) 格式顯示為純文字
- 頂部標題列顯示當前助手名稱，副標題顯示 服務商 > 模型
- AI 頭像移至訊息上方，頭像旁顯示模型名稱
- 工具選擇彈窗優化：已授權時隱藏權限狀態，只在未授權時顯示
使用統計功能
- 設定頁面新增「使用統計」入口
- 顯示上行 Token（輸入）總計
- 顯示下行 Token（輸出）總計
- 顯示總呼叫次數
- 按模型分類顯示呼叫次數
MCP（Model Context Protocol）工具伺服器支援
- 支援連接外部 MCP 伺服器，擴展 AI 工具能力
- 支援 SSE 和 Streamable HTTP 兩種傳輸協定
- 伺服器管理：新增/編輯/刪除/啟用/停用
- 連接測試功能，顯示可用工具數量
- 自訂請求標頭和逾時設定
MCP 伺服器管理頁面
- 設定頁面新增「MCP 伺服器」入口
- 卡片式伺服器列表，顯示名稱、描述、URL
- 一鍵測試連接狀態
- 支援批次管理多個 MCP 伺服器
助手 MCP 工具設定
- 助手詳情頁新增「MCP工具」標籤頁
- 為每個助手獨立選擇啟用的 MCP 伺服器
- MCP 工具與本地工具、知識庫工具協同運作
聊天整合
- AI 可自動呼叫已啟用的 MCP 伺服器工具
- 工具呼叫結果即時顯示
- 支援多輪工具呼叫

技術改進詳情

1. 聊天介面優化

功能：改進聊天訊息顯示佈局

實現：

移除 LinkifyPlugin，停用連結自動解析
TopAppBar 添加副標題顯示 服務商 > 模型
AI 訊息佈局改為垂直結構：頭像+模型名稱在上，內容在下

2. 使用統計功能

功能：統計 Token 使用量和模型呼叫次數

實現：

MessageEntity 添加 modelName 欄位
MessageDao 添加統計查詢方法
UsageStatsScreen 使用統計頁面
資料庫版本 9 → 10 遷移

3. MCP 用戶端實現

功能：支援 MCP 協議的 SSE 用戶端

實現：

McpClient 介面定義連接、工具列表、工具呼叫操作
McpSseClient 實現 SSE 傳輸協議
JSON-RPC 2.0 訊息格式
支援 session 管理

4. MCP 資料層

功能：MCP 伺服器設定持久化

實現：

McpServerEntity 資料庫實體
McpServerDao 資料存取物件
McpServerRepository 儲存庫介面和實現
資料庫版本 8 → 9 遷移

5. MCP 工具服務

功能：將 MCP 工具轉換為本地 Tool 物件

實現：

McpToolService 工具轉換服務
工具快取機制，避免重複請求
自動處理工具呼叫和結果返回

6. 助手模型擴展

修改：

Assistant 添加 mcpServerIds 欄位
AssistantEntity 添加 mcpServerIds 欄位
支援為每個助手設定不同的 MCP 伺服器

涉及檔案

模組	檔案	修改
feature-chat	MarkdownText.kt	移除 LinkifyPlugin
feature-chat	MessageItem.kt	AI 頭像移至上方，顯示模型名稱
feature-chat	MessageList.kt	傳遞 modelName 參數
feature-chat	ChatScreen.kt	傳遞 modelName 到 ViewModel
feature-chat	ChatViewModel.kt	setTools 支援 modelName
data	MessageEntity.kt	添加 modelName 欄位
data	MessageDao.kt	添加統計查詢方法
data	Message.kt	添加 modelName 欄位
data	ChatRepository.kt	ChatConfig 添加 modelName
data	ChatRepositoryImpl.kt	儲存訊息時記錄模型名稱
data	AppDatabase.kt	版本 10，modelName 遷移
data	McpServer.kt	MCP 伺服器模型定義
data	McpServerEntity.kt	MCP 伺服器資料庫實體
data	McpServerDao.kt	MCP 伺服器 DAO
data	McpClient.kt	MCP 用戶端介面
data	McpSseClient.kt	SSE 用戶端實現
data	McpClientFactory.kt	用戶端工廠
data	McpServerRepository.kt	Repository 介面
data	McpServerRepositoryImpl.kt	Repository 實現
data	McpToolService.kt	MCP 工具服務
data	Assistant.kt	添加 mcpServerIds 欄位
data	AssistantEntity.kt	添加 mcpServerIds 欄位
data	AssistantRepositoryImpl.kt	更新轉換邏輯
data	AppDatabase.kt	版本 9，MCP 表遷移
data	build.gradle.kts	添加 OkHttp SSE 依賴
app	McpViewModel.kt	MCP 管理 ViewModel
app	McpScreen.kt	MCP 伺服器管理頁面
app	SettingsScreen.kt	添加 MCP 設定入口
app	AssistantDetailScreen.kt	添加 MCP 工具標籤頁
app	AssistantDetailViewModel.kt	添加 MCP 伺服器支援
app	MainActivity.kt	整合 MCP 工具到聊天，添加副標題
app	UsageStatsScreen.kt	使用統計頁面（新增）
app	SettingsScreen.kt	添加使用統計入口
feature-chat	ToolSelectorSheet.kt	已授權時隱藏權限狀態顯示

v1.3

新增功能

知識庫（RAG）功能
- 支援建立和管理多個知識庫
- 內容匯入支援：文字筆記、URL網頁抓取、檔案上傳（TXT/MD）
- 向量嵌入生成與相似度檢索
- 支援 OpenAI 和 Gemini 的 Embedding API
知識庫管理
- 建立/編輯/刪除知識庫
- 選擇 Embedding 服務商和模型
- 批次處理待處理條目
- 處理狀態顯示（待處理/處理中/已完成/失敗）
知識條目管理
- Tab 切換檢視（全部/檔案/筆記/URL）
- 新增/編輯/刪除條目
- 單獨處理或批次處理
- 語意搜尋功能
設定入口
- 設定頁面新增「知識庫」入口
- 位於「一般」分組下
工具呼叫參數儲存
- 儲存完整的工具呼叫參數（JSON 格式）
- 記錄工具執行耗時（毫秒級）
- 持久化儲存到資料庫，重新載入對話可檢視歷史呼叫
工具呼叫 UI 改進
- 全新的工具呼叫卡片設計
- 顯示工具名稱、參數摘要、執行時間
- 點擊展開檢視完整的輸入參數和執行結果
- 格式化 JSON 顯示，更易讀
- 成功/失敗狀態圖示區分
錯誤處理優化
- 安全處理無參數工具呼叫
- 相容舊版本損壞資料，提供友善提示
- JSON 解析失敗時顯示友善錯誤訊息

技術改進詳情

1. Embedding API 支援

功能：支援 OpenAI 和 Gemini 的向量嵌入 API

實現：

EmbeddingProvider 介面定義嵌入操作
OpenAIEmbeddingProvider 呼叫 /embeddings 端點
GeminiEmbeddingProvider 呼叫 embedContent 端點
支援批次嵌入處理

2. 知識庫資料層

功能：完整的知識庫資料管理

實現：

KnowledgeRepository 介面和實現
KnowledgeService 處理內容載入、分塊、向量化
文件載入器：TextLoader、UrlLoader、FileLoader
資料庫版本 6 → 7 遷移，添加 status/errorMessage 欄位

3. 向量檢索

功能：基於餘弦相似度的語意搜尋

實現：

文字分塊（按段落，支援重疊）
向量儲存為 JSON 格式
餘弦相似度計算
Top-K 結果返回，支援閾值過濾

4. ToolResultData 模型擴展

修改：

新增 arguments 欄位儲存工具呼叫參數
新增 executionTimeMs 欄位記錄執行耗時
JSON 序列化/反序列化支援新欄位

5. 無參數工具呼叫修復

問題：Gemini 等 API 返回無參數工具呼叫時，arguments 為空字串導致解析失敗

修復：

執行前檢查 toolCall.arguments.ifBlank { "{}" }
確保空參數被轉換為有效的空 JSON 物件

6. 舊資料相容處理

功能：偵測並處理之前儲存的損壞資料

實現：

載入時偵測 "End of input at character 0" 錯誤
對損壞資料顯示友善提示
自動修正空參數欄位

涉及檔案

模組	檔案	修改
network	EmbeddingProvider.kt	Embedding 介面定義
network	OpenAIEmbeddingProvider.kt	OpenAI Embedding 實現
network	GeminiEmbeddingProvider.kt	Gemini Embedding 實現
network	EmbeddingProviderFactory.kt	Embedding 工廠類別
data	KnowledgeItemEntity.kt	添加 status/errorMessage 欄位
data	KnowledgeRepository.kt	知識庫 Repository 介面
data	KnowledgeRepositoryImpl.kt	Repository 實現
data	KnowledgeService.kt	知識庫核心服務
data	DocumentLoader.kt	文件載入器介面
data	TextLoader.kt	文字載入器
data	UrlLoader.kt	URL 網頁載入器
data	FileLoader.kt	檔案載入器
data	AppDatabase.kt	版本 7，status 欄位遷移
data	Message.kt	ToolResultData 添加 arguments、executionTimeMs 欄位
data	ChatRepositoryImpl.kt	工具執行記錄參數和耗時，舊資料相容處理
app	KnowledgeViewModel.kt	知識庫 ViewModel
app	KnowledgeScreen.kt	知識庫列表頁面
app	KnowledgeDetailScreen.kt	知識庫詳情頁面
app	SettingsScreen.kt	添加知識庫入口
feature-chat	MessageItem.kt	新工具卡片 UI，安全 JSON 解析

v1.2

新增功能

服務商多模型管理
- 服務商設定支援從 API 拉取模型列表
- 拉取後彈窗選擇要儲存的模型（支援多選）
- 已儲存模型可單獨刪除
- 支援手動添加自訂模型
聊天頁面模型選擇
- 在聊天頁面輸入框上方工具欄選擇模型
- 使用 Lucide Icon 顯示模型類型圖示
  - OpenAI → ✨ Sparkles
  - Claude → 🤖 Bot
  - Gemini → 🧠 BrainCircuit
二維碼分享優化
- 使用 ModalBottomSheet 樣式替代彈窗
- 支援選擇是否包含模型列表
- 顯示預計資料大小
- 二維碼卡片顯示服務商名稱和端點
Material You 介面重構
- 服務商列表頁使用 ElevatedCard 卡片設計
- 服務商編輯頁使用卡片分組佈局
- 使用 FAB 浮動按鈕替代底部固定按鈕
- 刪除「設為當前使用」按鈕（簡化操作）
本地工具調用功能
- 支援 AI 調用本地工具完成任務
- 三大提供商全支援：OpenAI、Anthropic Claude、Google Gemini 均可使用工具
- 聊天工具欄添加工具開關按鈕
- 工具執行結果可展開查看詳情
- 支援的工具：
  - read_file - 讀取檔案內容
  - write_file - 寫入檔案內容
  - list_directory - 列出目錄檔案
  - delete_file - 刪除檔案
  - create_directory - 建立目錄
  - web_fetch - 網頁內容抓取
  - get_system_info - 取得裝置資訊

技術改進詳情

1. 工具呼叫循環機制

功能：AI 可以連續呼叫多個工具完成複雜任務

實現：

傳送訊息時攜帶工具定義給 AI
AI 返回工具呼叫請求時自動執行
執行結果傳送回 AI 繼續對話
最多支援 10 輪工具呼叫，避免無限循環

2. 工具結果視覺化

功能：在聊天介面顯示工具執行詳情

實現：

每個工具呼叫顯示為獨立的可點擊卡片
顯示「呼叫 xxx」，點擊可展開查看詳細執行結果
成功使用主題色，失敗使用錯誤色

3. 資料庫支援工具資料

修改：

MessageEntity 添加 toolCallId、toolName、toolCallsJson、toolResultsJson 欄位
資料庫版本 5 → 6 遷移

4. 無參數工具相容性修復

問題：get_system_info 等無參數工具在某些 API（如 Anthropic）中無法被呼叫

原因：無參數工具的 parameters 返回 null，但 Anthropic 等 API 要求必須有有效的 input_schema

修復：無參數工具改為返回空物件 InputSchema.Obj(emptyMap(), emptyList())

涉及檔案

模組	檔案	修改
network	AIProvider.kt	添加工具呼叫相關資料類別
network	OpenAIProvider.kt	支援 Function Calling
network	AnthropicProvider.kt	支援 Tool Use（工具呼叫）
network	GeminiProvider.kt	支援 Function Calling
data	Tool.kt	工具定義和執行介面
data	LocalTools.kt	本地工具實現
data	Message.kt	添加 ToolCallData、ToolResultData
data	MessageEntity.kt	添加工具相關欄位
data	ChatRepository.kt	添加 ChatConfig 設定
data	ChatRepositoryImpl.kt	工具呼叫循環實現
data	AppDatabase.kt	版本 6，工具欄位遷移
feature-chat	ChatScreen.kt	工具開關按鈕
feature-chat	MessageItem.kt	工具結果展示 UI
app	MainActivity.kt	LocalTools 整合

v1.1

新增功能

串流式訊息輸出
輸出內容 Token 上行/下行/TPS（每秒 Token 數）/首字延時顯示
持久化資料儲存（支援 API 提供商設定和本地對話的持久化儲存）
多對話資料接收優化
優化對話頁面顯示，支援在對話頁面直接選擇模型
支援單個提供商設定多個模型

技術改進詳情

1. 切換聊天時繼續接收 AI 訊息

問題：之前切換聊天會取消正在進行的 AI 串流回應

解決方案：Application 級別 Scope + MessageSender 單例

MessageSender 單例管理所有聊天的傳送任務
使用 Map<chatId, Job> 獨立管理每個聊天
切換聊天只取消資料庫訂閱，不取消傳送任務

2. Token 統計資訊持久化

問題：資料庫沒有儲存 Token 統計資訊

修復：

MessageEntity 添加 inputTokens、outputTokens、tokensPerSecond、firstTokenLatency
資料庫版本 1 → 2 遷移

3. AI 回覆重新生成功能

功能：使用者可以讓 AI 重新生成回覆，新舊回覆作為變體共存

實現：

使用者訊息下方顯示 🔄 重新整理按鈕
點擊後 AI 重新生成回覆
新回覆作為變體添加，不覆蓋舊回覆

4. 多變體切換功能

功能：當 AI 訊息有多個變體時，可以切換查看

實現：

AI 訊息下方顯示 < 1/3 > 變體選擇器
點擊 < > 循環切換不同版本
變體以 JSON 格式儲存在資料庫

5. OpenAI 串流回應修復

問題：某些 API 返回 usage 時提前退出導致內容為空

修復：

先處理內容（choices），再儲存 usage
等待 [DONE] 標記再傳送 Done
避免 usage 導致提前退出

涉及檔案

模組	檔案	修改
data	Message.kt	添加 MessageVariant、變體欄位
data	MessageEntity.kt	添加統計和變體欄位
data	AppDatabase.kt	版本 3，兩次遷移
data	MessageDao.kt	變體更新方法
data	ChatRepository.kt	regenerateMessage、selectVariant 介面
data	ChatRepositoryImpl.kt	重新生成、變體選擇實現
data	MessageSender.kt	Application Scope 單例
feature-chat	ChatViewModel.kt	重新生成、變體選擇方法
feature-chat	MessageItem.kt	重新整理按鈕、變體選擇器 UI
feature-chat	MessageList.kt	傳遞回呼
feature-chat	ChatScreen.kt	連接回呼
network	OpenAIProvider.kt	修復串流回應
app	MainActivity.kt	MessageSender 初始化

v1.0

首個正式版本發布！

核心功能

多服務商支援
- OpenAI
- Anthropic Claude
- Gemini 靈活的服務商設定
- 自訂 API Key
- 自訂 API 端點（支援第三方代理）
- 從 API 自動拉取可用模型列表
- 手動輸入自訂模型名稱
- 多服務商設定管理，一鍵切換
聊天功能
- 非串流式回應，即時顯示 AI 回應
- 多會話管理
- 側邊欄聊天記錄導航
- 新建/刪除/切換對話

Uh oh!

FilesExpand file tree

README_ZH_TW.md

Latest commit

History

README_ZH_TW.md

File metadata and controls

TChat

開源的安卓端AI聊天軟體

功能特色

v1.8

新增功能

技術改進詳情

1. TTS 語音朗讀服務

2. Cloudflare R2 雲端備份

3. API Key 輪詢機制

4. 側邊欄搜尋功能

涉及檔案

v1.7

新增功能

技術改進詳情

1. 匯出/匯入系統

2. 聊天資料夾系統

3. 助手群聊系統

4. 資料庫升級

涉及檔案

v1.6

新增功能

Bug 修復

v1.5

新增功能

技術改進詳情

1. 深度研究服務

2. 網路搜尋服務

3. 深度研究資料層

4. 深度研究狀態管理

5. 深度研究資料模型

涉及檔案

v1.4

新增功能

技術改進詳情

1. 聊天介面優化

2. 使用統計功能

3. MCP 用戶端實現

4. MCP 資料層

5. MCP 工具服務

6. 助手模型擴展

涉及檔案

v1.3

新增功能

技術改進詳情

1. Embedding API 支援

2. 知識庫資料層

3. 向量檢索

4. ToolResultData 模型擴展

5. 無參數工具呼叫修復

6. 舊資料相容處理

涉及檔案

v1.2

新增功能

技術改進詳情

1. 工具呼叫循環機制

2. 工具結果視覺化

3. 資料庫支援工具資料

4. 無參數工具相容性修復

涉及檔案

v1.1

新增功能

技術改進詳情

1. 切換聊天時繼續接收 AI 訊息

2. Token 統計資訊持久化

3. AI 回覆重新生成功能

4. 多變體切換功能

5. OpenAI 串流回應修復

涉及檔案

v1.0

首個正式版本發布！

核心功能

還沒實現的功能：

鳴謝：