← Back to Skills Marketplace
221
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install weiqi-db
Description
weiqi-db 围棋棋谱数据库 - 本地棋谱管理工具，支持SGF导入、元数据编辑、标签管理、全文搜索。数据存储于单个JSON文件，AI友好的JSON接口设计。
Usage Guidance
This appears to be a local-only SGF database tool and is coherent with its instructions and code. Before installing, note: (1) the tool will create and manage ~/.weiqi-db/database.json (back it up if you have similarly named data), (2) it requires pip3 install tinydb, so ensure you trust that package source and your Python environment, (3) the skill will write/read temporary JSON files (e.g., /tmp/*.json) when invoked — avoid running the tool on sensitive system directories, and (4) SKILL.md contains an odd prohibition about not reading the DB file directly; that is a documentation inconsistency but not a security signal. If you need higher assurance, review the complete scripts (db.py and sgf_parser.py) yourself or run them in a sandboxed account/environment.
Capability Analysis
Type: OpenClaw Skill
Name: weiqi-db
Version: 1.0.5
The weiqi-db skill bundle is a legitimate local utility for managing Go (Weiqi) game records (SGF files). The code in scripts/db.py and scripts/sgf_parser.py implements database operations using TinyDB, SGF parsing, and data compression (gzip/base64) without any network activity, obfuscation, or unauthorized file access. The instructions in SKILL.md are well-aligned with the tool's purpose and provide helpful workarounds for AI agents operating in restricted shell environments.
Capability Assessment
Purpose & Capability
Name/description (local SGF DB and search) align with included code and CLI. The skill only reads/writes a JSON DB under the user's home (~/.weiqi-db/database.json), parses SGF, compresses content, and exposes query/add/update/tag/delete operations. No unrelated services or credentials are requested.
Instruction Scope
SKILL.md focuses on running the included Python CLI and using temporary JSON files for complex parameters, which matches the code. One oddity: the doc's '禁止行为' (forbidden actions) says '禁止直接读取 ~/.weiqi-db/database.json' and '禁止使用 JSON 输出后再用 Python 解析提取 SGF' despite the tool itself storing DB there and offering JSON output—this is an inconsistency in guidance but not evidence of malicious behavior. The instructions do permit writing temp files (/tmp/where.json, /tmp/set.json) and reading them, which is expected for the CLI but means the agent will create and read local files as part of normal operation.
Install Mechanism
No installer is embedded; code files are included and SKILL.md instructs 'pip3 install tinydb'. Pulling a small, well-known Python dependency (tinydb) is proportionate. There is no external download URL or extraction of arbitrary archives.
Credentials
The skill requires no environment variables, no credentials, and no special config paths beyond creating/using ~/.weiqi-db/database.json. That matches its functionality and is appropriately scoped.
Persistence & Privilege
always is false and the skill does not request permanent platform-wide privileges. It writes/reads only its own data file under the user's home directory and does not modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install weiqi-db - After installation, invoke the skill by name or use
/weiqi-db - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
新增 --where-file/--set-file 等参数绕过 exec JSON 限制; 新增 --date/--player/--event 简化查询参数; 优化 AI 执行规范，添加最短执行路径指南
v1.0.3
实现 SGF 自动压缩功能（gzip + base64），压缩率约 75%；读取时自动解压，向后兼容旧数据
v1.0.2
新增 get 命令用于获取完整棋谱（含 SGF）; 清理无效的 --json 参数
v1.1.0
SGF解析器重构，复用weiqi-sgf完整解析器; 修复冲突检测逻辑; 添加完整测试套件(28个测试)
v1.0.1
导入冲突检测功能; 支持哈希级和元数据级重复检测; 三种冲突处理策略：skip、overwrite、keep
v1.0.0
feat: 初始版本发布，支持SGF导入、元数据编辑、标签管理、JSON查询语法
Metadata
Frequently Asked Questions
What is 围棋棋谱数据库?
weiqi-db 围棋棋谱数据库 - 本地棋谱管理工具，支持SGF导入、元数据编辑、标签管理、全文搜索。数据存储于单个JSON文件，AI友好的JSON接口设计。 It is an AI Agent Skill for Claude Code / OpenClaw, with 221 downloads so far.
How do I install 围棋棋谱数据库?
Run "/install weiqi-db" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 围棋棋谱数据库 free?
Yes, 围棋棋谱数据库 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 围棋棋谱数据库 support?
围棋棋谱数据库 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 围棋棋谱数据库?
It is built and maintained by tokener (@zhangbin2025); the current version is v1.0.5.
More Skills