by 安全扫描
OpenClaw
安全
medium confidence该技能与其描述内部一致（一个基于 Python、从 PyPI 安装并用于构建与查询知识图谱的工具），但它会写入 steering 文件/hooks、获取远程内容，并向你的 model API 发送语义数据——安装前请审查这些副作用。
评估建议
What to 检查 before 安装ing:
- 验证 the publisher: confirm 'graphifyy' on PyPI and the GitHub repo owner match what you expect to avoid typosquatting (note 技能.md warns about 'graphify' vs 'graphifyy').
- Inspect what will be written: the 工具 can write 代理S.md and other 平台 steering files and 安装 a Git post-commit hook — open those files before allowing them to be used by your 助手.
- 保护 secrets: ensure .graphifyignore (or .Gitignore) excludes .env, 凭证s, and other sensitive files so they are not 索引ed; 运行 th...详细分析 ▾
✓ 用途与能力
名称、描述、所需二进制文件（python3、pip）、PyPI 包 'graphifyy' 以及所含脚本（query_graph.py）均与“从代码库和媒体构建并查询知识图谱”这一工具目标一致，所需内容与其宣称功能相称。
ℹ 指令范围
SKILL.md 指示 agent 与用户：索引本地项目文件；读取 graphify-out/GRAPH_REPORT.md；向 OpenClaw 注册工具（在项目根写入 AGENTS.md，并可能将文件复制到全局 skills 目录）；安装 git post-commit 钩子；获取外部内容（网页、视频）。这些操作为声明功能所需，但会修改仓库文件，并可能获取任意远程内容并转录/处理——请审查被写入和索引的内容。
✓ 安装机制
通过名为 'graphifyy' 的 PyPI 包安装（元数据中 installer kind 为 'uv'），安装后生成 'graphify' 可执行文件。规范中不含不透明下载链接或解压归档。此为标准包安装模式；安装前请验证 PyPI 包来源。
ℹ 凭证需求
该 skill 未声明任何必需的环境变量，前后一致。文档明确指出，语义提取会使用用户的 API key（由平台提供）发送至底层 model API，这是预期行为但属隐式——skill 依赖 agent/platform 已拥有模型凭证。此外，默认的 .graphifyignore 模板排除了常见密钥，但若用户未正确放置 .graphifyignore，仍可能意外索引。
ℹ 持久化与权限
always:false（非强制包含）是合适的。然而，该技能会提供将引导文件（AGENTS.md / 平台相关文件）写入项目根目录的命令，并可将技能复制到全局技能目录，同时安装 git post-commit 钩子。对于与助手工具链集成的工具而言，这些行为合理，但它们会对仓库和代理引导文件造成持久变更——请审查并批准这些写入操作。
安全有层次，运行前请审查代码。
运行时依赖
🖥️ OSLinux · macOS · Windows
版本
latestv2.0.12026/4/19
重大更新：Graphify 技能扩展了文档、功能与易用性。 - SKILL.md 已大幅重写，新增安装、使用、工作流说明，以及最佳实践与故障排查指南。 - 新增文件 templates/graphifyignore.template，提供 .graphifyignore 示例模板。 - 新增 scripts/query_graph.py，支持以编程方式查询图谱。 - 移除过时脚本 scripts/example.py 与模板 templates/example_template.txt。 - 文档现涵盖高级安装选项、平台集成、增量更新、查询方法、关系类型及团队工作流。 - 强化安全与设置说明，强调使用官方 graphifyy 包。
● 可疑
安装命令
点击复制官方npx clawhub@latest install graphify
镜像加速npx clawhub@latest install graphify --registry https://cn.longxiaskill.com
技能文档
Graphify 将代码、文档、图片、视频文件夹转为可查询知识图谱，并通过平台钩子注入每次助手交互。用于导航陌生代码库、追溯架构意图、高效共享上下文。
Token 效率： 阅读 GRAPH_REPORT.md 比读原始源码便宜约 71.5 倍，务必先读。 ---
安全提示
- PyPI 官方包名为
graphifyy（双 y）。不要安装名为graphify的包，与本项目无关。 - 代码提取本地运行，基于 tree-sitter。视频/音频转录本地运行，基于 faster-whisper。
- 文档/图片的语义提取会将内容发送至底层模型 API（Claude、GPT-4 等），使用你的 API 密钥。无遥测或云存储。
---
安装
最小安装
``bash
pip install graphifyy
`
推荐安装（含全部 extras）
`bash
pip install "graphifyy[pdf,video,watch,svg]"
`
| Extra | 新增支持 |
|-------|----------|
| pdf | PDF 论文与文档 |
| video | 视频/音频转录（faster-whisper） |
| watch | --watch 文件监控 |
| svg | --svg 导出 |
| mcp | Model Context Protocol 服务器 |
| neo4j | Neo4j 图数据库集成 |
| office | Word/Excel/PowerPoint 文档 | 注册到 OpenClaw
`bash
graphify claw install
`
将技能复制到 OpenClaw 全局技能目录，并在项目根写入 AGENTS.md，使每次工具调用都参考图谱。 注册到其他平台
`bash
graphify claude install # Claude Code（CLAUDE.md + PreToolUse 钩子）
graphify cursor install # Cursor（.cursorrules）
graphify codex install # Codex（AGENTS.md）
graphify copilot install # GitHub Copilot CLI
graphify gemini install # Gemini CLI
graphify aider install # Aider
` Git 提交钩子（提交时自动重建）
`bash
graphify hook install
` ---
构建知识图谱
首次运行
`bash
graphify .
`
Graphify 执行三阶段管道：
- AST 提取——确定性 tree-sitter 解析全部代码文件（无 LLM 调用）
- 转录——本地 Whisper 处理视频/音频
- 语义提取——并行 Claude 子代理分析文档、论文、图片
增量更新（仅变更文件）
`bash
graphify . --update
`
使用 graphify-out/cache/ 中的 SHA-256 缓存——保存后安全运行。 监听模式（文件变动自动同步）
`bash
graphify . --watch
` 深度模式（激进推断边提取）
`bash
graphify . --mode deep
`
添加置信度 0.0–1.0 的 INFERRED 边，及需复核的 AMBIGUOUS 边。 保留边方向
`bash
graphify . --directed
` 仅重聚类不复提取
`bash
graphify . --cluster-only
` 跳过 HTML 可视化（CI 更快）
`bash
graphify . --no-viz
` ---
输出产物
全部产物落入 graphify-out/：
| 文件 | 用途 |
|------|------|
| GRAPH_REPORT.md | 先读这个。 核心节点、社区结构、意外连接、推荐问题。 |
| graph.html | 交互式浏览器可视化——人工审查时打开。 |
| graph.json | 原始图谱数据，供 CLI 或脚本查询。 |
| cache/ | SHA-256 增量缓存——提交时排除此目录。 | 更多导出格式
`bash
graphify . --svg # SVG 可视化
graphify . --graphml # Gephi / yEd 兼容导出
graphify . --wiki # 每节点一篇维基式文章
` ---
查询图谱
`bash
# 自然语言语义搜索
graphify query "where is authentication handled?" # 追踪特定路径（DFS 遍历）
graphify query "how does the request reach the database?" --dfs
# 两节点最短路径
graphify path "AuthMiddleware" "PostgresAdapter"
# 用通俗语言解释节点
graphify explain "UserSessionManager"
`
---
添加外部内容
``bash
graphify add # 获取并索引论文
graphify add # 获取并索引推文
graphify add