Metadata-Version: 2.4
Name: cnkibug
Version: 0.9.0
Summary: CNKI literature metadata collection with a desktop GUI
License: MIT License
        
        Copyright (c) 2026 Kaffu_Alcaid
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Repository, https://github.com/KaffuAlcaid/CNKIBug
Project-URL: Issues, https://github.com/KaffuAlcaid/CNKIBug/issues
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: playwright==1.60.0
Requires-Dist: openpyxl==3.1.5
Requires-Dist: pywin32==311; sys_platform == "win32"
Requires-Dist: psutil==7.2.2
Requires-Dist: rich==15.0.0
Requires-Dist: tomli>=2.0; python_version < "3.11"
Provides-Extra: gui
Requires-Dist: ttkbootstrap==1.20.4; extra == "gui"
Dynamic: license-file

# CNKIBug

面向中国知网的本地文献检索与整理工具，支持批量检索、文献筛选、Excel/CSV/RIS 导出和 Zotero 发送

[项目首页](https://github.com/KaffuAlcaid/CNKIBug) · [使用说明](https://github.com/KaffuAlcaid/CNKIBug/blob/main/docs/usage.md) · [Windows 下载](https://github.com/KaffuAlcaid/CNKIBug/releases/latest/download/CNKIBug-GUI.exe)

## 安装

推荐使用图形界面完成检索、筛选和导出

需要 Python 3.10–3.14、图形桌面和可用浏览器，建议在虚拟环境中安装

### 图形界面（推荐）

```bash
python -m pip install "cnkibug[gui]"
cnkibug-gui
```

### 终端版（可选）

```bash
python -m pip install cnkibug
cnkibug
```

Windows 优先使用 Microsoft Edge，Linux 优先使用系统 Chrome 或 Chromium；Linux GUI 需要 Tk，Debian/Ubuntu 可安装 `python3-tk`

浏览器检查和安装方法见[配置说明](https://github.com/KaffuAlcaid/CNKIBug/blob/main/docs/configuration.md)，macOS 目前不在正式支持范围

## 更新

```bash
python -m pip install --upgrade "cnkibug[gui]"
```

仅使用终端版时，将命令中的 `"cnkibug[gui]"` 换为 `cnkibug`

## 使用与数据

知网安全验证需要手动完成，PDF 下载需要相应的全文访问权限

文献保存目录由用户选择，配置和登录状态的存放位置见[配置说明](https://github.com/KaffuAlcaid/CNKIBug/blob/main/docs/configuration.md#配置与数据位置)

本项目采用 MIT License，与中国知网及其关联方无隶属或合作关系，请遵守适用法律、网站协议和所在机构规定
