← 返回 Skills 市场
deki18

Pinecone Search

作者 deki18 · GitHub ↗ · v0.1.3 · MIT-0
cross-platform ⚠ suspicious
394
总下载
1
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install pinecone-search
功能描述
Pinecone vector search and document upload tool for knowledge base management
安全使用建议
This skill appears to implement Pinecone uploads and search as described, but take these precautions before installing or using it: - The runtime requires PINECONE_API_KEY, EMBEDDING_API_KEY and EMBEDDING_BASE_URL (the registry metadata omitted these) — set and protect these keys carefully. - The tool records and returns absolute file paths (the 'source' field) and other metadata in JSON and stores them in Pinecone metadata; review whether you want full paths and file-level metadata indexed or returned to callers. - Ensure EMBEDDING_BASE_URL points to a trusted embedding provider (e.g., OpenAI). If you set this to an untrusted endpoint it will receive file contents and your EMBEDDING_API_KEY. - Use the provided --dry-run option first to preview which files and how many chunks will be processed before uploading anything. - Consider running the tool in an isolated environment (or with least-privilege keys) and inspect the code (pinecone_tool.py, upload.py, search.py) yourself if you have sensitive documents. - If you need the skill listed in a registry, ask the publisher to correct the registry metadata so required environment variables and secrets are clearly declared. If you want, I can point out the exact lines that send file paths/metadata to Pinecone and where the embedding base URL and keys are used so you can audit or modify them.
功能分析
Type: OpenClaw Skill Name: pinecone-search Version: 0.1.3 The `pinecone-search` skill bundle is a legitimate tool for managing vector databases. It provides functionality for loading, splitting, and uploading Markdown and TXT documents to Pinecone, as well as performing hybrid (vector + BM25) searches. The implementation in `pinecone_tool.py`, `upload.py`, and `search.py` is well-structured, uses standard libraries like `openai` and `pinecone`, and adheres to its stated purpose without any indicators of data exfiltration, malicious execution, or prompt injection.
能力评估
Purpose & Capability
The skill's name/description (Pinecone vector search & upload) matches the code and SKILL.md: it reads local TXT/Markdown files, splits them, requests embeddings, and uploads vectors to Pinecone. However the registry metadata (top-level 'Required env vars: none' and 'Primary credential: none') contradicts the SKILL.md and code which require PINECONE_API_KEY, EMBEDDING_API_KEY and EMBEDDING_BASE_URL — this mismatch is unexpected and could cause confusion or misconfiguration.
Instruction Scope
SKILL.md and the code direct the skill to read arbitrary local files and directories (the files you ask it to upload). The code attaches metadata including absolute file system paths ('source') and token counts and returns them in JSON and stores them as Pinecone metadata. That behavior is coherent with indexing but can leak full paths and document metadata back to any consumer of the skill's JSON output (or into Pinecone). The instructions do not attempt to read unrelated system files, but the inclusion of absolute paths in metadata is a privacy concern and should be reviewed.
Install Mechanism
No binary downloads or remote install scripts are used; installation is the typical 'pip install -r requirements.txt' plus copying a .env. Requirements are standard libraries for this use case (openai, pinecone, tiktoken, etc.).
Credentials
The SKILL.md and code require PINECONE_API_KEY, EMBEDDING_API_KEY, and EMBEDDING_BASE_URL (plus optional EMBEDDING_MODEL, INDEX_NAME, NAMESPACE). These are appropriate for embedding+Pinecone operations. The concern is the manifest/registry metadata claiming 'no required env vars' while the runtime clearly needs secrets — an inconsistency that could mislead users. Also note EMBEDDING_BASE_URL is user-controlled; pointing it to an untrusted endpoint would send text/metadata (and keys) there.
Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills or global agent settings. It behaves like a normal local CLI/tool invoked by the user. It will, however, upload data to external services (embedding provider and Pinecone) when used.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install pinecone-search
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /pinecone-search 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.3
- Updated optional environment variable documentation: clarified that NAMESPACE is optional and defaults to "default". - Added "pineone" to the list of trigger keywords. - fix bugs.
v0.1.2
添加了上传文件到Pineone的功能,提高搜索返回结果质量 Major update: Adds document upload support and advanced search/filter options. - Introduced document upload tool (upload.py) supporting TXT and Markdown files with semantic chunking and embedding. - Enhanced search functionality (search.py) with options for namespace, file type, filename, similarity threshold, and hybrid search (vector + BM25). - Added environment variable configuration for flexible deployment and project isolation. - Updated documentation with detailed usage examples and technical detail. - search_tool.py removed; new files added: pinecone_tool.py, upload.py, search.py, requirements.txt.
v0.1.1
- Updated the recommended embedding API base URL in configuration from https://api.vectorengine.ai/v1 to https://api.openai.com/v1. - No other changes made.
v0.1.0
Initial release of Pinecone Search: a vector search tool for local knowledge bases. - Enables searching of regulations, standards, and construction documentation using Pinecone vector search. - Supports keyword-based queries in both English and Chinese. - Simple configuration via `.env` file for API keys and model settings. - Command-line interface with adjustable result count (`--top-k` option). - Example queries and output format provided in documentation.
元数据
Slug pinecone-search
版本 0.1.3
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 4
常见问题

Pinecone Search 是什么?

Pinecone vector search and document upload tool for knowledge base management. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 394 次。

如何安装 Pinecone Search?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install pinecone-search」即可一键安装,无需额外配置。

Pinecone Search 是免费的吗?

是的,Pinecone Search 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Pinecone Search 支持哪些平台?

Pinecone Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Pinecone Search?

由 deki18(@deki18)开发并维护,当前版本 v0.1.3。

💬 留言讨论