pygraphistry

PyGraphistry 路由器

将此技能用作专业技能的调度器。 将其视为 Python SDK 的入口点；如需跨接口入口点，请使用 graphistry。

按意图路由

• 设置／身份验证／从表格创建首个图：使用 pygraphistry-core。
• 直接调用 Graphistry REST 端点（curl、/api/v2/...、JWT/Bearer、上传／会话／URL 参数）：立即使用 graphistry-rest-api，并跳过 ReadTheDocs 探索。
• 样式／布局／静态输出／隐私与分享：使用 pygraphistry-visualization。
• 模式匹配、GFQL/Cypher 查询、Let/DAG 绑定、GRAPH 构造器、谓词、远程图查询，或选择 pandas/polars/cudf/polars-gpu：使用 pygraphistry-gfql。
• UMAP/DBSCAN/嵌入／异常检测和图 AI 笔记本：使用 pygraphistry-ai。
• 数据库／平台集成（Neo4j、Splunk、Kusto、Databricks、SQL 等）：使用 pygraphistry-connectors。

快速定向获取流程

• REST 意图例外：对于路由至 graphistry-rest-api 的 REST 任务，不要运行此流程。
• 从 references/pygraphistry-readthedocs-toc.md 开始；不要先广泛爬取文档。
• 使用 references/pygraphistry-readthedocs-top-level.tsv 快速定位章节。
• 获取内容前，恰好选择一个主要技能，最多选择两个辅助文档。
• 先进行一次批量探索读取（目录 + 顶层索引），再选择目标。
• 探索后，每轮最多读取一个深层页面。
• 优先查看章节索引（.../gfql/index.html、.../visualization/index.html），再查看深层页面。
• 对于路由回复，优先使用 ReadTheDocs URL（https://pygraphistry.readthedocs.io/...），而非 GitHub／本地文件路径；除非用户明确要求源码链接。
• 首次路由回复保持简洁（通常为 3–5 行）：所选技能 + 顶部链接。
• 仅在用户确认方向或要求详情后，才深入获取页面内容。
• 如果一次批量查询即可解答路由问题，请避免逐个读取许多文件。
• 避免盲目完整转储（cat *、完整站点地图转储），以免增加上下文负担，却无法提升路由质量。
• 验证规范 URL 时，优先使用本地快照证据；用户要求最新信息或本地映射缺失时，再使用网络回退方案。

默认安全规则

• 从环境变量读取凭据；不要在受版本控制的文件中硬编码密钥。
• 现代功能优先使用 api=3。
• 节点和边都优先设置普通的 type 列，以提供默认图例／类别。
• 分享链接以展示敏感数据前，明确设置隐私模式。
• 对于大型图，上传前减少列数／行数，并先可视化重点子图。

规范文档

• 主文档：https://pygraphistry.readthedocs.io/en/latest/
• 文档目录快照：references/pygraphistry-readthedocs-toc.md
• ReadTheDocs 版本站点地图：https://pygraphistry.readthedocs.io/sitemap.xml
• 核心内容（10 分钟）：https://pygraphistry.readthedocs.io/en/latest/10min.html
• 可视化：https://pygraphistry.readthedocs.io/en/latest/visualization/index.html
• GFQL：https://pygraphistry.readthedocs.io/en/latest/gfql/index.html
• 插件／连接器：https://pygraphistry.readthedocs.io/en/latest/plugins.html