用途：ktx 是自改进的上下文层，教 AI 智能体准确查询数据仓库。它从公司知识（wiki 内容，去重、标记矛盾）、数据栈（采样表、采集元数据、识别可连接列）和语义层（通过 join 图组合原始表与指标，解决 chasm 与 fan 陷阱）中学习，并在执行时通过 CLI 与 MCP 工具向智能体提供服务，支持全文与语义组合搜索。
主要能力：支持 PostgreSQL、Snowflake、BigQuery、ClickHouse、MySQL、SQL Server、SQLite；集成 dbt、MetricFlow、LookML、Looker、Metabase、Notion。提供 MCP 工具：search_semantic_layer、search_wiki、get_metric_definition、list_connections、get_table_schema、get_join_paths。
使用方式：安装 npm install -g @kaelio/ktx 或 npm install @kaelio/ktx；运行 ktx setup 交互式配置项目、LLM 与嵌入提供方、数据库连接、上下文源并构建初始上下文。常用命令：ktx status 查看状态，ktx ingest 构建上下文，ktx sl "revenue" 搜索语义层，ktx wiki "refund policy" 搜索 wiki，ktx mcp start 启动 MCP 服务器。Codex 可执行 npx skills add Kaelio/ktx --skill ktx；Cursor/OpenCode 在编辑器 MCP 设置中配置 ktx 命令。
项目结构：ktx.yaml 配置、semantic-layer/ 语义源、wiki/global 与 wiki/user 笔记、raw-sources/ 原始产物、.ktx/ 本地状态与密钥。建议提交 ktx.yaml、semantic-layer/、wiki/，保持 .ktx/ 本地并加入 gitignore。
配置：ktx.yaml 定义 LLM（anthropic、vertex、claude-agent-sdk）、embeddings、connections 与 sources；密钥通过环境变量如 ANTHROPIC_API_KEY、OPENAI_API_KEY、DB_PASSWORD 提供；支持通过 semantic_layer.joins 自定义 join 逻辑与基数，可配置多数据库连接。
适用场景：需要让 AI 智能体基于公司数据仓库进行准确查询、指标定义与文档检索的分析团队。
限制：资料未提供价格、性能数据、扩展上限或官方支持渠道；实际行为取决于所配数据库、LLM 与嵌入服务的可用性与权限。遥测可通过 KTX_TELEMETRY_DISABLED=1 关闭。