TgWitness参考 / 存档与集成
存档分析
搜索已保存的消息、审查 AI 输入内容，并保存附有来源参考信息的分析报告。
当前主要版本：请使用源代码检出；0.7.0 便携版预览版尚未包含此功能。
使用日志可在本地进行搜索，无需 AI。如需使用查询存档，请先在集成中启用并配置服务提供商。 通过工作区选择器选择账户；通过表单选择会话和观察时间段。检索在本地进行。 输入精确短语或域名可缩小检索范围；输入消息 ID 可查询已保存的版本。 请查看摘录内容，并打开其日志记录或上下文。 本工具不包含向量数据库，也不会自动执行任何 Telegram 操作。
服务提供商与同意条款#
AI 功能在每个工作区中默认处于禁用状态。仅主管理员可配置 模型、端点、加密 API 密钥、上下文/输出限制、超时及每日 请求配额。密钥绝不会返回至浏览器。若要保留当前密钥，请将密钥字段 留空；如需移除，请明确将其删除。
Ollama 使用其文档中记载的 /api/chat 端点，
该端点输出非流式 JSON 数据。其默认地址为 TgWitness 服务器上的
http://127.0.0.1:11434。操作员可通过
TGWITNESS_AI_LOCAL_ENDPOINT 更改该地址；此地址不受模型控制。请自行安装
所选模型。TgWitness 不会自动下载该模型。
兼容的服务提供商应具备以 /v1 结尾的基础 URL，并支持
聊天内容补全协议：
messages、JSON 响应模式、max_completion_tokens 以及
choices[0].message.content。缺少这些字段的服务不予支持。
连接测试会发送合成文本，并计入请求配额。
每次请求均使用工作区中配置的外部路由。 若路由被封锁或 仅限 Telegram 的 MTProxy 出现错误，则不会直接重试。通过刻意 配置的本地 Ollama 地址，可在继续使用 所选路由的同时，实现私有目标地址。对于其他私有服务，则适用现有的服务器级私有 目标地址选择加入机制。面板上会显示实际配置的端点。
生成前，发送至模型的数据包含以下请求信息：问题、 已选中的摘录、事件类型、观察时间及覆盖标记。Telegram 会话、原始字段、提供商密钥、附件字节以及完整的日志 均不属于该上下文范围。请取消勾选不需要的来源，然后明确批准 处理。 外部提供商可能会根据其自身的 政策保留提交的内容。本地执行意味着端点位于本地；这并不保证 独立配置的服务会遵循特定行为。
全球范围内最多同时存在两个服务提供商请求，每个 工作区限一个。预览有效期为十分钟，且仅可生成一个响应。 页面会显示提供商报告的令牌数量；只有 在输入和输出费率均已配置的情况下，才会显示成本估算。失败的尝试也会 消耗每日请求配额。自动重试不会消耗额外配额。
来源与局限性#
检索功能通过有限词汇搜索分析已保存的消息文本。它最多返回 24 个来源，并会标注被截断的摘录或不完整的结果集。该 时间段指观察时间，并非声称 Telegram 历史记录 完整。工作区范围内的事件不包含在聊天范围的访问权限中。 缺失数据被描述为“在可用存档中未找到”。
该模型不接收任何工具。其源 ID 需与所选 记录进行比对验证，哈希值需重新核查，且引用的字符串必须出现在这些记录中。 未知 ID、被修改的引文以及未被引用的主张将导致答案被拒绝。该应用程序 会生成链接；模型生成的 URL 不能用作引用来源。这些检查 旨在验证来源的存在性和引文的准确性，而非推论的真实性。 在依赖推论结果之前，请对照记录进行核查。
报告#
将经过审核的回答保存为一份独立的分析报告。该报告包含模型 摘要、观察到的时间线、提取的链接和标识符、编辑/删除记录、 覆盖范围限制以及源事件哈希值。同时附有提供商、模型、端点、时间以及 提示词模板版本信息。不会自动合并任何身份信息。
分析师的修订和注释与模型摘要分开存储。报告 保存在加密的衍生文件中，索引位于签名事件流之外； 原始事件和媒体内容不会发生改变。只有所有者或管理员才能 打开报告，且会再次验证源访问权限。 下载同样需要导出 权限。第 1 版不会对报告进行签名，也不暗示模型结论是 经过验证的证据。限制：每个工作区 100 份报告，每份报告 100 次分析师修订 。