前言¶
在 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
