前言¶
在 DeepSeek Harness（DSH）里用大模型写论文，常见失败往往不在文笔，而在三件事：检索没有真的打开知网、读文献只扫摘要就下结论、一次生成全文没有大纲和校订。普通对话式「帮我写论文」很难把检索式、题录和写作步骤钉死在可复现的流程上。
CNKIAgent（dsh-cnki-agent）是维护者 Jerry113245 发布的联网工具类插件，通过 dsh-browser-cdp 驱动本机 Edge 访问 kns.cnki.net 做真实检索，再按核心期刊编辑视角精读、合成研究版图，并按「大纲 → 引言 → 正文 → 校订」分步写作；右侧栏提供「CNKI 文献库」面板。插件在 GitHub 开源（MIT），当前包版本为 0.5.0（见仓库 package.json），依赖 DSH 引擎 >=0.2.0-rc.2 <0.3.0-0。
这是什么¶
CNKIAgent 的定位是：知网论文检索—精读—评估—写作—去 AIGC 一体化 DSH 插件。它把流程反过来做：真实检索 → 编辑视角精读 → 分步写作，并强调全程不虚构文献、不虚构数据，检索式可复现。
社区目录站点与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」，安装前建议自行阅读源码与许可证。
核心功能¶
下面按 README 已列能力归纳，只写资料中明确出现的行为。
真实知网检索与回退¶
cnki_search 有两条通道：
| 通道 | 条件 | 说明 |
|---|---|---|
| 浏览器通道（推荐） | 安装 dsh-browser-cdp，本机有 Edge/Chrome |
打开知网结果页，解析题录：标题、期刊、日期、文献类型等 |
| 回退通道 | DSH 配置了可用的 web 搜索 provider | 多为摘要页/镜像，site: 命中率不稳；不可用时会标注通道 |
检索按关键词逐个顺序执行，一条检索式对应一个词，失败不中断；支持 precise（短语加引号）与 general（主题词组合）。浏览器不可用时插件可优雅降级到 ctx.web，并明确标注通道。
首次访问知网可能出现滑块验证：浏览器窗口可见，需人工过一次；插件不会也无法绕过验证码。
精读、研究版图与分步写作¶
cnki_reading_plan：生成精读检查单（目录、引言逐句、正文覆盖、语体与 AIGC 特征、可仿写句型等）。cnki_research_map：多篇文献五维对照 → 共同点/分歧 → 三个切入点 → 三个实证题目。- 写作链为三级大纲 → 引言 → 逐节正文（约 800–1000 字/节）→ 校订；每步停下等用户确认，不会一口气写完。
技能包 cnki-agent 用 Markdown 定义路由与工作流（如 SKILL.md、references/workflow.md），写作纪律写进技能与系统提示：检索词单元化、未获取段落标「未获取」、不得虚构数据与文献等。
去 AI 味与 Word 排版¶
cnki_de_aigc：mode为scan/review/check，做语体体检与改写方案，强调「语体优先于降重率」、不靠口语凑降低率。cnki_word_plan：输出 Word 排版步骤、GB/T 7714 参考文献格式审计（2015/2025 要点）、域与样式纪律；仓库还提供assets/tools/format_docx.py的check/build命令用于 docx 体检与从 Markdown 生成带样式骨架的 docx。
右侧栏文献库¶
插件在 sidebar.right.pane.tab 注册「CNKI 文献库」页签：检索历史（含模式、命中、检索式成功/失败）、文献清单（标题链到知网摘要页）、统计与约 20 秒轮询；与工具 cnki_library 共用 /api/cnki/library 数据。
安装与启用¶
安装命令以仓库 README 为准。生效时安装返回 application: applied。版本替换需先卸载再安装。
方式一：源码目录安装（README 推荐）¶
先在本地取得仓库目录（README 示例使用 git clone），再在 DSH 中执行（target 为克隆下来的绝对路径）：
plugin_manager install_bundle target = "<克隆路径>/dsh-cnki-agent"
方式二：npm 包安装¶
README 示例版本为：
plugin_manager install_bundle target = "dsh-cnki-agent@0.3.0"
卸载与升级示例：
plugin_manager remove_bundle target = "dsh-cnki-agent"
plugin_manager install_bundle target = "<路径或版本>"
浏览器通道（真实知网检索）¶
plugin_manager install_bundle target = "dsh-browser-cdp@1.7.4"
典型用法¶
在对话中直接描述论文需求即可触发技能 cnki-agent，例如：
帮我写一篇关于"人工智能对教育公平影响"的论文，要求核心期刊水平
插件会拆分检索词并顺序调用检索，示意如下：
cnki_search(keywords = ["人工智能 教育公平", "数字鸿沟 教育"], mode = "general")
拿到题录后精读与研究版图：
cnki_reading_plan(titles = ["...", "..."])
cnki_research_map(topic = "人工智能与教育公平", papers = [...])
cnki_search 常用参数（资料原文）：keywords（必填）、mode（precise | general，默认 general）、site（回退通道，默认 kns.cnki.net）、maxResultsPerKeyword（1–20，默认 8）、saveTo（写入 Markdown 检索报告目录）、noBrowser（强制回退通道）。
去 AI 味与 Word 方案示例：
cnki_de_aigc(text="……", mode="scan")
cnki_word_plan(topic="人工智能与教育公平", numberByChapter=true, refs=["张三. 题名[J]. 刊名, 2025, 45(3): 1-9."])
README 记载 2026-10-30 在本机 Edge 上的实测：如 人工智能 教育公平（general）知网页显示大量命中、插件返回前若干条题录；precise 短语检索可返回具体期刊论文题录。题录含摘要页链接，便于点开核对。
适用场景与注意¶
适合谁： 需要在 DSH 对话里走「可复现知网检索 → 结构化精读 → 分步写作 → 引用与排版自检」链路的研究者或开发者；尤其依赖本机浏览器真实打开知网、又希望 Agent 工具与右侧栏同步文献清单的场景。
务必注意：
- 插件以当前 DSH 进程权限运行；安装前请检查源码、依赖（含
dsh-browser-cdp）与 MIT 许可证。 - 无浏览器通道时检索质量会下降，且仍无法替代机构知网账号与版权要求。
- 知网验证码、网络与 DSH 版本需满足
package.json中engines.dsh范围；README 中的 npm 安装示例版本与仓库当前 0.5.0 可能不一致，升级时按remove_bundle/install_bundle流程替换目标即可。 - 不要指望插件绕过知网安全验证或代填未授权全文；未获取正文时应标「未获取」，避免模型补写。
结尾¶
CNKIAgent 把写论文时最容易出错的「假检索、浅阅读、一次成稿」拆成可工具化、可确认的步骤，并把检索式与文献库留在面板里便于核对。若要在 DSH 中试用，可从社区目录页查看条目说明，并在 GitHub 阅读完整 README、技能包与 CHANGELOG。
- 目录页：https://www.skillhub.cn/plugins/Jerry113245/dsh-cnki-agent
- GitHub：https://github.com/Jerry113245/dsh-cnki-agent
