備考軟考這幾年我最煩兩件事一是知識點(diǎn)散落在各種文檔、云筆記、截圖里換臺電腦就找不到二是下午論文摘要卡 300 字、正文卡 20002500 字Word 里數(shù)格子既不準(zhǔn)又折磨人。寫完還得自己對照評分標(biāo)準(zhǔn)摳「切題、實踐、結(jié)構(gòu)、表達(dá)」。所以我做了軟考通一款本地優(yōu)先的軟考備考筆記桌面端。它不只是記筆記論文練習(xí)時實時按軟考習(xí)慣統(tǒng)計字?jǐn)?shù)寫完還可以交給 AI 評分、潤色并給出修改意見。技術(shù)棧很克制桌面端Vue 3 TypeScript ElectronAI 后端Spring Boot AgentScope 2.xJava數(shù)據(jù)筆記全部落本地 Markdown不登錄、不上傳數(shù)據(jù)無縫遷移需要源碼的同學(xué)可以私信我。客戶端界面一、它到底能干什么能力說明分學(xué)科架構(gòu)、高項、軟設(shè)、網(wǎng)工、庫工等常見科目一鍵切換本地倉庫自己選一個文件夾當(dāng)筆記根目錄應(yīng)用按科目自動建目錄知識點(diǎn)筆記富文本工具欄標(biāo)題 / 字號 / 對齊 / 下劃線 / 列表保存為 Markdown截圖粘貼粘貼或拖入圖片存到assets/Markdown 里引用相對路徑論文練習(xí)題目、摘要、正文分塊編輯摘要 ≤300 字正文建議 20002500 字字?jǐn)?shù)統(tǒng)計漢字 1 字、英文/數(shù)字整詞 1 字、標(biāo)點(diǎn) 1 字貼近考場習(xí)慣AI 潤色可單獨(dú)潤色摘要、正文或一次潤色全部AI 評分按 75 分制打分≥45 合格給維度分、優(yōu)點(diǎn)和改進(jìn)建議拖動排序筆記列表原生拖拽順序?qū)懭?order.json不啟動 AI 后端時記筆記、寫論文、打包安裝包照樣能用。AI 是可選插件不是強(qiáng)綁定。二、為什么做成桌面端而不是又一個 Web 筆記備考資料往往帶項目經(jīng)歷、架構(gòu)圖、論文底稿我不希望默認(rèn)就上云。所以產(chǎn)品原則是本地優(yōu)先選一個文件夾筆記就是普通.mdVS Code、Typora、Obsidian 都能打開。無登錄打開就能寫配置只記「根目錄 上次科目」。AI 解耦桌面端只負(fù)責(zé)編輯和展示評分 / 潤色走本機(jī) HTTP默認(rèn)127.0.0.1:9001。目錄約定很簡單你的目錄/ architect/ # 系統(tǒng)架構(gòu)設(shè)計師 notes/ # 知識點(diǎn) .md notes/assets/ # 截圖 notes/.order.json essays/ # 論文練習(xí) .md essays/assets/ essays/.order.json pm/ # 高項 notes/ essays/ ...論文落盤時按固定結(jié)構(gòu)組裝方便以后用別的編輯器繼續(xù)改--- title: 論大模型智能運(yùn)維技術(shù)及應(yīng)用 type: essay updatedAt: 2026-08-15T12:00:00.000Z --- # 論大模型智能運(yùn)維技術(shù)及應(yīng)用 ## 題目描述 首行題目名 下方題目背景與寫作要求 ## 摘要 …… ## 正文 ……三、整體架構(gòu)┌─────────────────────────────────────────────┐ │ 軟考通 桌面端 │ │ Vue 3 Pinia Vue Router渲染進(jìn)程 │ │ ? preload contextBridge │ │ Electron 主進(jìn)程fs / dialog / IPC │ │ 讀寫本地 Markdown / 圖片 │ └──────────────────────┬──────────────────────┘ │ HTTP JSON ▼ ┌─────────────────────────────────────────────┐ │ Spring Boot AgentScope 2.x │ │ POST /api/ai/essay/polish 論文潤色 │ │ POST /api/ai/essay/score 論文評分 │ │ ReActAgent無記憶、無工具一次一評 │ └─────────────────────────────────────────────┘進(jìn)程劃分層技術(shù)職責(zé)渲染進(jìn)程Vue 3、Pinia、marked / turndownUI、字?jǐn)?shù)、論文結(jié)構(gòu)、調(diào) AI預(yù)加載contextBridge只暴露受控window.api不把 Node 直接塞給頁面主進(jìn)程Electron Nodefs選目錄、讀寫筆記、存圖、排序AI 服務(wù)Java AgentScope 2.x按軟考論文標(biāo)準(zhǔn)潤色、打分工程用electron-vite把主進(jìn)程、preload、渲染進(jìn)程打在一起開發(fā)時熱更新發(fā)布用electron-builder打 Mac DMG / Windows 安裝包。四、Electron 安全橋頁面不直接碰文件系統(tǒng)渲染進(jìn)程不能require(fs)。所有本地 IO 都走 IPC。preload 里只暴露白名單方法import{contextBridge,ipcRenderer}fromelectronconstapi{getConfig:()ipcRenderer.invoke(config:get),saveConfig:(config)ipcRenderer.invoke(config:save,config),selectDirectory:()ipcRenderer.invoke(dialog:selectDirectory),ensureSubject:(rootPath,subjectId)ipcRenderer.invoke(notes:ensureSubject,rootPath,subjectId),listNotes:(rootPath,subjectId,kind)ipcRenderer.invoke(notes:list,rootPath,subjectId,kind),readNote:(rootPath,subjectId,kind,fileName)ipcRenderer.invoke(notes:read,rootPath,subjectId,kind,fileName),writeNote:(payload)ipcRenderer.invoke(notes:write,payload),saveNotesOrder:(payload)ipcRenderer.invoke(notes:saveOrder,payload),saveImage:(payload)ipcRenderer.invoke(notes:saveImage,payload),}contextBridge.exposeInMainWorld(api,api)窗口創(chuàng)建時打開隔離webPreferences:{preload:join(__dirname,../preload/index.js),contextIsolation:true,nodeIntegration:false,}主進(jìn)程這邊選目錄用系統(tǒng)對話框科目目錄按需創(chuàng)建ipcMain.handle(dialog:selectDirectory,async(){constresultawaitdialog.showOpenDialog({title:選擇筆記保存目錄,properties:[openDirectory,createDirectory],})if(result.canceled||!result.filePaths[0])returnnullreturnresult.filePaths[0]})ipcMain.handle(notes:ensureSubject,async(_e,rootPath,subjectId){ensureSubjectDirs(rootPath,subjectId)})exportfunctionensureSubjectDirs(rootPath:string,subjectId:string):void{ensureDir(join(rootPath,subjectId,notes))ensureDir(join(rootPath,subjectId,essays))ensureDir(join(rootPath,subjectId,notes,assets))ensureDir(join(rootPath,subjectId,essays,assets))}讀圖還有一層路徑約束只允許assets/下的相對路徑拒絕..避免任意讀盤。五、論文練習(xí)結(jié)構(gòu)拆開字?jǐn)?shù)按考場習(xí)慣算軟考論文不是「一個大文本框」?？蛻舳瞬鸪扇龎K題目首行當(dāng)題目名稱下面貼題目描述和要求摘要硬限制 300 字正文建議 20002500 字底部實時變色提示字?jǐn)?shù)規(guī)則刻意貼近考場而不是text.length中文每個漢字計1英文 / 數(shù)字連續(xù)串整個單詞計1中間加空格就變成兩個詞標(biāo)點(diǎn)計1空白不計exportfunctioncountExamWords(text:string):number{if(!text)return0constmatchestext.match(/[\u4e00-\u9fff]|[A-Za-z0-9]|[^\s\u4e00-\u9fffA-Za-z0-9]/g,)returnmatches?matches.length:0}界面上摘要超 300 會標(biāo)紅禁止保存正文落在 20002500 顯示為合適區(qū)間。打開 / 保存 / AI 潤色之后還會做一次「章節(jié)消毒」摘要框里如果誤帶了## 正文會截斷避免三個框互相污染。這對從 Word 粘貼、或模型偶爾把結(jié)構(gòu)標(biāo)題一起吐出來特別有用。論文 Markdown 組裝大致如下exportfunctionbuildEssayMarkdown(parts:EssayParts):string{constcleanedsanitizeEssayParts(parts)consttitlecleaned.title||未命名論文consttopicBlockcleaned.prompt.trim()||titlereturn--- title: ${title.replace(//g,\)} type: essay updatedAt: ${newDate().toISOString()} --- #${title}## 題目描述${topicBlock}## 摘要${cleaned.abstract}## 正文${cleaned.body}}知識點(diǎn)筆記走另一條路contenteditable編輯保存時turndown轉(zhuǎn) Markdown打開時marked轉(zhuǎn)回 HTML。標(biāo)題只寫 YAML frontmatter正文不再重復(fù)插# 標(biāo)題避免每次保存疊一層標(biāo)題。六、AI 評分與潤色桌面端只負(fù)責(zé)「問」和「展示」前端請求很薄默認(rèn)打本機(jī)9001constAI_BASEimport.meta.env.VITE_AI_BASE_URL||http://127.0.0.1:9001exportfunctionpolishEssay(payload:EssayPolishRequest){returnpostJson(/api/ai/essay/polish,payload)}exportfunctionscoreEssay(payload:{subject:stringtopic:stringabstractText:stringbodyText:string}){returnpostJson(/api/ai/essay/score,payload)}潤色可以指定partabstract/body/all。寫回編輯器前同樣走sanitizeEssayParts防止模型把「## 摘要」這類結(jié)構(gòu)標(biāo)題帶回來。評分彈窗直接消費(fèi)后端 JSONtotalScore總分滿分 75level合格 / 不及格≥45 合格dimensions切題、實踐、結(jié)構(gòu)、表達(dá)等維度分 評語strengths/improvements優(yōu)點(diǎn)和改進(jìn)建議asyncfunctionrunScore(){constresawaitscoreEssay({subject:store.subject.name,topic:topic.value.trim(),abstractText:abstractText.value,bodyText:body.value,})scoreResult.valueres scoreOpen.valuetruestatus.valueAI 評分完成${res.totalScore}分${res.level||-}}開發(fā)環(huán)境在.env.development里配VITE_AI_BASE_URLhttp://127.0.0.1:9001七、后端AgentScope 2.x Java 實現(xiàn)論文智能體論文潤色、評分都屬于「一次任務(wù)、不要記憶」的場景。我沒有用帶 Redis 會話的長對話 Agent而是每次請求新建一個ReActAgent無 Toolkit不需要搜網(wǎng)頁、不需要調(diào)工具無會話記憶、無壓縮系統(tǒng)提示詞里寫死軟考論文規(guī)則強(qiáng)制模型只吐 JSON方便桌面端直接渲染依賴AgentScope Java 2.xdependencygroupIdio.agentscope/groupIdartifactIdagentscope-core/artifactIdversion2.0.0/version/dependencydependencygroupIdio.agentscope/groupIdartifactIdagentscope-extensions-model-openai/artifactIdversion2.0.0/version/dependency模型走 OpenAI 兼容協(xié)議本地 Ollama、DeepSeek、通義等都可以換baseUrlConfigurationpublicclassEssayAgentConfig{BeanpublicModelchatModel(Value(${essay.llm.base-url})StringbaseUrl,Value(${essay.llm.api-key})StringapiKey,Value(${essay.llm.model})StringmodelName){returnOpenAIChatModel.builder().baseUrl(baseUrl).apiKey(apiKey).modelName(modelName).stream(false).build();}}評分 Agent 的核心注入「軟考下午論文」身份要求按 75 分制輸出結(jié)構(gòu)化結(jié)果。ServicepublicclassEssayAiService{privatefinalModelchatModel;privatefinalObjectMapperobjectMappernewObjectMapper();publicEssayAiService(ModelchatModel){this.chatModelchatModel;}publicEssayScoreResponsescore(EssayScoreRequestreq){ReActAgentagentReActAgent.builder().name(ruankao-essay-score).sysPrompt(SCORE_PROMPT).model(chatModel).toolkit(newToolkit()).build();Msgreplyagent.call(newUserMessage(buildScoreUserText(req))).block();returnparseScore(reply.getTextContent());}publicEssayPolishResponsepolish(EssayPolishRequestreq){ReActAgentagentReActAgent.builder().name(ruankao-essay-polish).sysPrompt(POLISH_PROMPT).model(chatModel).toolkit(newToolkit()).build();Msgreplyagent.call(newUserMessage(buildPolishUserText(req))).block();returnparsePolish(req.getPart(),reply.getTextContent());}}系統(tǒng)提示詞是效果的關(guān)鍵。評分側(cè)我會明確告訴模型你不是通用作文老師而是軟考閱卷老師。privatestaticfinalStringSCORE_PROMPT 你是軟考高級/中級下午論文閱卷老師。滿分 75 分45 分及格。 結(jié)合科目、題目要求、摘要和正文從下面維度打分 1. 切合題意20 2. 應(yīng)用深度與技術(shù)方案20 3. 實踐性與角色貢獻(xiàn)15 4. 結(jié)構(gòu)完整性摘要/背景/問題/對策/效果10 5. 表達(dá)與條理性10 要求 - 只輸出 JSON不要 Markdown 代碼塊 - 分?jǐn)?shù)必須是整數(shù)總分等于各維度之和 - 摘要超過 300 字、正文明顯不足 2000 或嚴(yán)重超 2500要在 improvements 里指出 JSON 字段 { totalScore: 0, level: 合格|不及格, summary: 總評, dimensions: [{name:,score:0,max:0,comment:}], strengths: [], improvements: [] } ;潤色側(cè)則強(qiáng)調(diào)「像考生自己改稿」不要寫成 AI 腔也不要發(fā)明沒寫過的項目privatestaticfinalStringPOLISH_PROMPT 你是軟考論文寫作教練。請潤色考生文稿保留其項目事實不要編造經(jīng)歷。 摘要控制在 300 字以內(nèi)正文盡量落在 20002500 字。 按 part 只改對應(yīng)部分abstract / body / all。 只輸出 JSON {part:abstract|body|all,abstractText:,bodyText:} 未修改的字段也要原樣帶回。 ;Controller 對上桌面端路徑RestControllerRequestMapping(/api/ai/essay)publicclassEssayAiController{privatefinalEssayAiServiceessayAiService;publicEssayAiController(EssayAiServiceessayAiService){this.essayAiServiceessayAiService;}PostMapping(/polish)publicEssayPolishResponsepolish(RequestBodyEssayPolishRequestreq){returnessayAiService.polish(req);}PostMapping(/score)publicEssayScoreResponsescore(RequestBodyEssayScoreRequestreq){returnessayAiService.score(req);}}為什么這里用獨(dú)立 ReActAgent而不是帶記憶的 HarnessAgent論文評分如果把上一篇稿子的上下文帶進(jìn)來分?jǐn)?shù)會被污染。每次新建 Agent等價于「換一份卷子、換一個閱卷老師」結(jié)果更穩(wěn)也更省 token。模型返回偶爾會包一層 json解析前要剝一下privateStringunwrapJson(Stringraw){Stringtextrawnull?:raw.trim();if(text.startsWith()){texttext.replaceAll(^(?:json)?\s*,).replaceAll(\s*$,);}intstarttext.indexOf({);intendtext.lastIndexOf(});if(start0endstart){returntext.substring(start,end1);}thrownewIllegalStateException(模型未返回 JSON);}八、列表拖動排序不引入第三方拖拽庫中間欄用原生draggable。拖動過程中 Pinia 即時換位松手后把文件名數(shù)組寫進(jìn).order.json。functiononDragOver(e:DragEvent,fileName:string):void{e.preventDefault()if(!dragFrom.value||dragFrom.valuefileName)returnconstfromIndexstore.notes.findIndex((n)n.fileNamedragFrom.value)consttoIndexstore.notes.findIndex((n)n.fileNamefileName)if(fromIndex0||toIndex0)returnstore.moveNote(fromIndex,toIndex)}asyncfunctiononDrop(e:DragEvent):Promisevoid{e.preventDefault()awaitstore.persistNotesOrder()}列表讀取時排序表里有的按表排沒有出現(xiàn)過的文件按修改時間補(bǔ)在后面。新建默認(rèn)插到最前刪除 / 重命名會同步維護(hù)這份順序。九、本地跑起來桌面端Node.js 18cdruankaotongnpminstallnpmrun dev需要 AI 時先啟動 Java 后端默認(rèn) 9001再確認(rèn)VITE_AI_BASE_URLhttp://127.0.0.1:9001打包npmrun dist:mac# macOS DMGnpmrun dist:win# Windows NSIS 便攜包未配置蘋果 / 微軟代碼簽名時別人第一次打開可能被系統(tǒng)攔截需要在「隱私與安全性」里允許或右鍵打開。正式分發(fā)再補(bǔ)簽名即可。十、幾個做下來比較有用的點(diǎn)筆記是 Markdown不是私有庫。卸載應(yīng)用不會帶走倉庫換編輯器也不怕被鎖死。字?jǐn)?shù)規(guī)則要單獨(dú)寫。length對英文單詞和標(biāo)點(diǎn)都不符合軟考直覺正則按「漢字 / 整詞 / 標(biāo)點(diǎn)」切一次就夠用。AI 不要塞進(jìn) Electron 主進(jìn)程。模型、提示詞、JSON 解析都放 Java 服務(wù)里桌面端保持可獨(dú)立分發(fā)。評分 Agent 不要記憶。論文是試卷不是聊天。AgentScope 的 ReActAgent 很適合這種一次性任務(wù)。模型輸出要契約化。彈窗、維度分、優(yōu)缺點(diǎn)列表全靠 JSON 字段提示詞里把 schema 寫死解析失敗再兜底。寫在最后軟考通解決的是我自己備考時的真實摩擦知識點(diǎn)要本地可檢索論文要能看見字?jǐn)?shù)寫完還想有個「閱卷老師」給修改意見。它不是又一個 ChatGPT 套殼而是本地 Markdown 倉庫 軟考論文編輯器 AgentScope 2.x 評分潤色智能體。前端 Vue 3 / Electron后端 Java AgentScope 2.x兩邊通過兩個 HTTP 接口對接結(jié)構(gòu)很干凈。如果這篇文章對你有幫助歡迎點(diǎn)贊收藏。需要完整源碼桌面端 AI 后端的同學(xué)私信我即可。