Teams 零安装依赖 CLI（Python 3.12）¶

此版本随包附带所需的 Python 解析源码，解压后直接运行。需要预先安装 Python 3.12，无需 pip、Brotli、zstd 或 MCP SDK。

开始使用¶

解压 ZIP，在包含 teams_cli.py 的 teams-zero-cli 目录打开 PowerShell：

py -3.12 -S teams_cli.py --help
py -3.12 -S teams_cli.py diagnose
py -3.12 -S teams_cli.py accounts
py -3.12 -S teams_cli.py conversations --limit 20
py -3.12 -S teams_cli.py search "关键词" --limit 20

-S 禁用 site-packages 加载，用于确保不依赖已安装的第三方包。请保留 ZIP 内的完整目录结构。diagnose 显示 Python 环境和候选缓存路径规则，不读取消息，也不保证已发现缓存。

指定缓存目录¶

如果自动发现失败，手动指定实际 IndexedDB LevelDB 目录：

py -3.12 -S teams_cli.py accounts --leveldb "D:\path\to\cache.indexeddb.leveldb"
py -3.12 -S teams_cli.py search "关键词" --leveldb "D:\path\to\cache.indexeddb.leveldb" --limit 20

路径只是示例，需要替换。可以使用 --account "tenantId:userId" 限定账号，使用 --debug 查看错误堆栈。--limit 必须大于零。

输出与范围¶

查询结果通过标准输出返回 JSON；诊断信息与跳过记录数量写入标准错误。程序在临时副本上解析缓存，完成后释放文件并清理副本。Teams 正在写入时，副本不一定一致；复制失败可关闭 Teams 后重试。

本版只提供 CLI，不提供 MCP 服务；只读取本机已有的近期缓存，不通过 Graph 获取历史消息。请在有权读取和运行工具的环境使用。

兼容性与来源¶

目标为 Python 3.12，验收使用 Windows x64 / Python 3.12.13。包含标准库之外的第三方源码，但不需要安装外部依赖。包内 PROVENANCE.json 记录固定上游提交，LICENSES/ 保留许可证。

实际 Windows Teams 缓存与 Python 3.12.10 尚未在部署机上验证；Teams 内部缓存结构变化可能影响解析结果。遇到零条结果时，不能据此认定账号没有消息。合成测试不能替代真实缓存验证。