CNKI Skills

面向 Codex、Claude Code 和 WorkBuddy 的知网文献工作流技能包。对应 ScienceDirect 技能包的 8 个操作模块，另附 Claude agent 和 Codex 可安装入口。

默认访问中国知网国内站。 检索统一从 https://kns.cnki.net/kns8s/defaultresult/index 进入（已验证可用：渲染主题 检索与学术期刊筛选，机构登录生效）；https://www.cnki.net/ 作为备用入口。 不以 oversea.cnki.net、global.cnki.net 等海外镜像作为起始地址 —— 官网会按 网络出口静默跳转到国际版。仅当国内站确实无法访问或被限制时，才在明确告知 用户原因后回退到海外站，并标注结果来自哪个平台。详见 浏览器配置。

状态：实验版。 离线引用转换有自动化测试；国内站的检索、结果解析与 PDF 下载已完成真实端到端验证（2026-09-11 机构登录下按主题检索并用详情页 PDF下载 取到 5 篇 PDF，逐篇 %PDF- 与 file 核验通过），原生引用导出与批量下载仍待 验证。结果列表里的「下载」链接不标格式，实际可能给到 CAJ，格式要在详情页确认。 开发早期官网跳转国际版，在国际版进入高级检索遇到拼图验证；国内站详情页也可能 出现拼图验证，需人工完成。请见 测试记录 与 浏览器配置。 本包是由 AI 按实时页面执行的技能说明，不是固定选择器爬虫或知网官方 API。

English · 浏览器配置 · 来源声明

功能

安装

Python 3.9+；先自行配置所在环境支持的浏览器连接。 克隆后可预览安装目标，安装器拒绝覆盖已有同名技能：

git clone https://github.com/longkou1988/cnki-skills.git
cd cnki-skills
python3 scripts/install.py --target codex --dry-run
python3 scripts/install.py --target codex
# Claude Code 用户：
python3 scripts/install.py --target claude

Codex 默认安装到 CODEX_HOME/skills（未设置时 ~/.codex/skills）； Claude 默认安装到 ~/.claude/skills，并安装 ~/.claude/agents/cnki-researcher.md。 如需项目级安装，添加 --project /path/to/project： Codex 使用 .agents/skills，Claude 使用 .claude/skills 和 .claude/agents。 刷新/重新打开会话后确认技能可见。不会更改 MCP、账号或浏览器设置。

WorkBuddy 安装到 ~/.workbuddy/skills（安装器 1.1 起支持；旧版本可手动复制）：

python3 scripts/install.py --target workbuddy
# 或手动：for d in skills/*/; do cp -R "$d" ~/.workbuddy/skills/; done

WorkBuddy 通过 browser-skill 提供的 bsk CLI 驱动已登录的真实浏览器： bsk session start → bsk navigate <url> --session <id> → bsk snapshot → 交互 → bsk session stop <id>。

若 bsk click 报 DOM Error while querying，多为 bsk CLI/daemon 与浏览器扩展 的协议版本漂移：先 bsk update -y 并重启会话；若仍失败，改为只读提取页面已 给出的链接再 bsk navigate。详见 浏览器配置。

使用

Codex 中显式引用 $cnki-researcher 或对应操作技能；Claude Code 中调用 /cnki-researcher，也可请求使用 cnki-researcher agent；WorkBuddy 中直接点名 技能使用，例如「使用 cnki-search 检索……」。

使用 cnki-researcher，在知网期刊库查找 2023 年以来“生成式人工智能”与 “企业创新”的文献，按发表时间倒序列出前 20 篇，分析其中最相关的 5 篇， 导出全部题录和入选 5 篇的 BibTeX。

默认使用当前已授权的知网入口；记录实际日期口径和词扩展设置。 若只能取得摘要，会标注“摘要分析”；不会把摘要当作全文精读。 登录、验证码或缺少订阅时返回明确进度。不会自动购买论文、绕过验证或 复制浏览器凭据。Zotero 可在用户明确要求时通过已有工具导入生成的 .bib， 本包不包含 Cookie 推送。

离线转换

python3 skills/cnki-export/scripts/convert.py records.json --format json --output references.bib
python3 skills/cnki-export/scripts/convert.py export.ris --format ris --output references-ris.bib
python3 skills/cnki-export/scripts/convert.py export.enw --format endnote --output references-endnote.bib

无运行时第三方依赖。支持 JSON、RIS、EndNote tagged 的期刊题录； 输入格式。 保留中文姓名、处理特殊字符、合并一致重复项；作者不全、重复冲突会报错。 不会覆盖已有文件。知网原生导出格式以实际页面为准； 转换结果明确标为“离线转换”，不能冒充原生导出。

测试

python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
.venv/bin/python -m unittest discover -s tests -v

MIT；独立实现，功能结构受 cookjohn/sd-skills 启发，详见来源声明。

关注我

_{扫一扫二维码，关注我的视频号}