Art Knowledge Helper Skill

艺术知识库管理技能包。用于维护藏书整理、散文件清理、百度网盘同步、新书归档、藏书统计等日常管理工作。配合 art-tutor 技能使用。首次使用前请在 config.json 中填写知识库路径。

Security Scan

The skill's code, instructions, and requested configuration are consistent with an offline Windows-based book-management tool that organizes and copies local files to a Baidu-synced folder; no hidden network endpoints, credentials, or unrelated permissions are requested.

Purpose & Capability

The name/description (art knowledge base management) matches the included scripts and SKILL.md: scanning a Downloads folder, classifying files by filename, archiving into a local knowledge-base path, syncing to a Baidu-synced directory, and reporting stats. No unexpected binaries or credentials are requested.

Instruction Scope

Runtime instructions are limited to editing config.json and running the included Python scripts. Scripts operate on three configured paths (downloads, knowledge base, Baidu sync). A notable behavior: sync_to_baidu.py will recursively copy all files from the knowledge-base directory (with minimal skip patterns) into the Baidu path — this can include non-book files if present. scan_downloads.py writes a JSON scan result to DOWNLOADS.parent (art_books_scan_YYYYMMDD.json), which may be surprising but not malicious.

Install Mechanism

No install spec; skill is instruction-and-scripts only. No downloads or external install steps are performed by the skill itself, so nothing arbitrary is written to disk beyond running the included scripts (which the user must execute).

Credentials

The skill requires no environment variables, secrets, or external credentials. It uses filesystem paths supplied via config.json, which is appropriate for a local sync/archiving utility.

Persistence & Privilege

always is false and the skill does not request system-wide persistence or modify other skills. It can be invoked autonomously per platform defaults; that is expected for skills and not flagged by itself.

Scan Findings in Context

[static_scan_no_findings] expected: No regex-based pre-scan/injection signals were detected. The presence of multiple plaintext Python scripts is consistent with the declared functionality.

Assessment

This package appears to do what it claims, but review a few practical hygiene points before use: (1) Edit config.json carefully — ensure knowledge_base_path and baidu_path point to the intended folders to avoid accidental copying of unrelated files. (2) sync_to_baidu.py copies all files under the KB (except a short skip list); remove any sensitive files from the KB or adjust the script to limit file types before running. (3) scan_downloads.py saves its scan JSON to the parent of your downloads folder — know where that file will land. (4) Run scripts in a controlled environment (or on a test folder) first to verify behavior. (5) If you plan to share content via Baidu, confirm you have the right to upload those files and that your Baidu client is configured correctly.

🎨 艺术知识库 · 管理助手

本技能用于维护艺术知识库藏书，支持：扫描下载目录归档新书、清理 EPUB 散文件、百度网盘双向同步、藏书量统计、生成藏书清单。

---

⚙️ 首次配置（必须）

编辑 config.json，填写你自己的路径：

{
  "knowledge_base_path": "D:\\艺术知识库",
  "baidu_path": "D:\\BaiduSyncdisk\\小艺\\艺术知识库",
  "downloads_path": "C:\\Users\\你的用户名\\Downloads"
}

三个路径均可自定义。只需改 config.json，所有脚本自动读取，无需修改脚本。

---

功能概览

脚本	功能
scan_downloads.py	扫描下载目录近30天内艺术类书籍
archive_books.py	将下载的新书归档到知识库对应分类
kb_stats.py	统计藏书总量、各分类数量、总大小
sync_to_baidu.py	双向同步本地与百度盘
verify_sync.py	验证两边是否完全一致

---

快速开始

1. 安装

下载本技能包，解压到 OpenClaw 工作目录：

skills/art-knowledge-helper/
├── SKILL.md
├── config.json        ← 【首次必填】路径配置
├── SOUL.md
├── USER.md
├── README_SKILL.md
├── SHARE_GUIDE.md
├── FRIEND_TUTORIAL.md
└── scripts/
    ├── scan_downloads.py
    ├── archive_books.py
    ├── kb_stats.py
    ├── sync_to_baidu.py
    └── verify_sync.py

2. 配置路径

编辑 config.json（见上方）。

3. 扫描新书

python scripts/scan_downloads.py

4. 归档新书

python scripts/archive_books.py

5. 统计藏书

python scripts/kb_stats.py

6. 同步百度盘

python scripts/sync_to_baidu.py

7. 验证同步

python scripts/verify_sync.py

---

目录结构说明

skills/
├── art-tutor/              ← 艺术学习助手（推荐藏书、规划路径）
│   └── references/
│       ├── corpus.md
│       └── learning_paths.md

└── art-knowledge-helper/   ← 知识库管理（藏书整理、同步、归档）
    ├── config.json          ← 【必填】路径配置
    ├── scripts/             ← 管理脚本（自动读 config.json）
    ├── SOUL.md
    ├── USER.md
    └── README_SKILL.md

---

依赖

• Python 3
• PowerShell 5+（Windows）

---

更新日志

• v1.1.0（2026-04-22）：路径配置从硬编码改为 config.json，所有脚本统一读取，路径完全自定义。
• v1.0.0（2026-04-22）：初始版本，包含5个管理脚本和完整文档。