Pixeltable 是一个 Python 多模态数据库，同时提供 pxt 目录命令行工具，用于构建或操作以表、视图和计算列为组织方式的应用。它并非知识图谱或本体目录工具，使用前应先确认目标确实是 Pixeltable，并核对已安装版本与项目检出内容。
用途方面，可处理本地目录、表与查询，媒体或计算列工作流，模式核对与调整，本地守护进程与配置，以及托管的 Cloud 数据库、服务与组织操作。
主要能力包括：通过 pxt 的帮助、健康检查、状态、目录列出、描述、列查看和配置等命令进行检查；支持表、视图与计算列；pxt 在首个目录命令时会启动本地守护进程（依照所附文档说明），未经用户批准不应自行启动。
使用方式上建议先做只读检查，再考虑变更。目录操作可能包含破坏性的删除、目录删除、重算、模式更新与清理；云端命令可管理数据库、服务、组织、密钥与机密。支持时应使用试运行，先查看目标与影响，并在应用前另行取得批准。凭据通过环境、配置或登录设置解析，提供方密钥应放在密钥或配置中，不得在对话中打印机密值；托管 Cloud 登录、凭据、数据库操作、媒体上传与提供方调用均需单独批准。pxt init 会写入项目配置并可能修改 pyproject.toml，且会拒绝部分嵌套根目录情形，建议前先确认工作目录与现有项目根目录。
适用场景包括排查计算列失败原因、在仓库中初始化 Pixeltable、检查表模式与历史等。注意：本地的配置或 CLI 成功并不能证明云端部署、远程持久化、计算正确性或媒体可用性；来源预检只检查选定哈希，不验证运行时行为。Ontology 或目录建模需求应转向本体与目录设计，Pixeltable 不是其替代品。