# 存档分析

Canonical page: https://phishdestroy.github.io/TgWitness/zh/docs/reference/analysis/

搜索已保存的消息、审查 AI 输入内容，并保存附有来源参考信息的分析报告。

**当前主要版本：**请使用源代码检出；0.7.0 便携版预览版尚未包含此功能。

[工作流指南](https://phishdestroy.github.io/TgWitness/docs/archive/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md)

使用**日志**可在本地进行搜索，无需 AI。如需使用**查询存档**，请先在**集成**中启用并配置服务提供商。 通过工作区选择器选择账户；通过表单选择会话和观察时间段。检索在本地进行。 输入精确短语或域名可缩小检索范围；输入消息 ID 可查询已保存的版本。 请查看摘录内容，并打开其日志记录或上下文。 本工具不包含向量数据库，也不会自动执行任何 Telegram 操作。

## 服务提供商与同意条款

AI 功能在每个工作区中默认处于禁用状态。仅主管理员可配置 模型、端点、加密 API 密钥、上下文/输出限制、超时及每日 请求配额。密钥绝不会返回至浏览器。若要保留当前密钥，请将密钥字段 留空；如需移除，请明确将其删除。

Ollama 使用其文档中记载的 [`/api/chat` 端点](https://docs.ollama.com/api/chat)， 该端点输出非流式 JSON 数据。其默认地址为 TgWitness 服务器上的 `http://127.0.0.1:11434`。操作员可通过 `TGWITNESS_AI_LOCAL_ENDPOINT` 更改该地址；此地址不受模型控制。请自行安装 所选模型。TgWitness 不会自动下载该模型。

兼容的服务提供商应具备以 `/v1` 结尾的基础 URL，并支持 [聊天内容补全协议](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)： `messages`、JSON 响应模式、`max_completion_tokens` 以及 `choices[0].message.content`。缺少这些字段的服务不予支持。 连接测试会发送合成文本，并计入请求配额。

每次请求均使用工作区中配置的外部路由。 若路由被封锁或 仅限 Telegram 的 MTProxy 出现错误，则不会直接重试。通过刻意 配置的本地 Ollama 地址，可在继续使用 所选路由的同时，实现私有目标地址。对于其他私有服务，则适用现有的服务器级私有 目标地址选择加入机制。面板上会显示实际配置的端点。

生成前，**发送至模型的数据**包含以下请求信息：问题、 已选中的摘录、事件类型、观察时间及覆盖标记。Telegram 会话、原始字段、提供商密钥、附件字节以及完整的日志 均不属于该上下文范围。请取消勾选不需要的来源，然后明确批准 处理。 外部提供商可能会根据其自身的 政策保留提交的内容。本地执行意味着端点位于本地；这并不保证 独立配置的服务会遵循特定行为。

全球范围内最多同时存在两个服务提供商请求，每个 工作区限一个。预览有效期为十分钟，且仅可生成一个响应。 页面会显示提供商报告的令牌数量；只有 在输入和输出费率均已配置的情况下，才会显示成本估算。失败的尝试也会 消耗每日请求配额。自动重试不会消耗额外配额。

## 来源与局限性

检索功能通过有限词汇搜索分析已保存的消息文本。它最多返回 24 个来源，并会标注被截断的摘录或不完整的结果集。该 时间段指**观察时间**，并非声称 Telegram 历史记录 完整。工作区范围内的事件不包含在聊天范围的访问权限中。 缺失数据被描述为“在可用存档中未找到”。

该模型不接收任何工具。其源 ID 需与所选 记录进行比对验证，哈希值需重新核查，且引用的字符串必须出现在这些记录中。 未知 ID、被修改的引文以及未被引用的主张将导致答案被拒绝。该应用程序 会生成链接；模型生成的 URL 不能用作引用来源。这些检查 旨在验证来源的存在性和引文的准确性，而非推论的真实性。 在依赖推论结果之前，请对照记录进行核查。

## 报告

将经过审核的回答保存为一份独立的分析报告。该报告包含模型 摘要、观察到的时间线、提取的链接和标识符、编辑/删除记录、 覆盖范围限制以及源事件哈希值。同时附有提供商、模型、端点、时间以及 提示词模板版本信息。不会自动合并任何身份信息。

分析师的修订和注释与模型摘要分开存储。报告 保存在加密的衍生文件中，索引位于签名事件流之外； 原始事件和媒体内容不会发生改变。只有所有者或管理员才能 打开报告，且会再次验证源访问权限。 下载同样需要导出 权限。第 1 版不会对报告进行签名，也不暗示模型结论是 经过验证的证据。限制：每个工作区 100 份报告，每份报告 100 次分析师修订 。

有关手动 OCR 和文字转录，请参阅[“媒体处理”](https://phishdestroy.github.io/TgWitness/zh/docs/reference/media-analysis/)。 有关客户端访问，请参阅 [MCP](https://phishdestroy.github.io/TgWitness/zh/docs/reference/mcp/)。