AIclinicalresearch/docs/03-业务模块/PKB-个人知识库/00-模块当前状态与开发指南.md

PKB涓<EFBFBD>汉鐭ヨ瘑搴撴ā鍧?- 褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?

*鏂囨。鐗堟湰锛? v2.0
*鍒涘缓鏃ユ湡锛? 2026-01-07
缁存姢鑰咃細 PKB妯″潡寮€鍙戝洟闃? 鏈€鍚庢洿鏂帮細 2026-01-07
*閲嶅ぇ杩涘睍锛? 馃帀 PKB妯″潡鏍稿績鍔熻兘鍏ㄩ儴瀹炵幇锛屽叿澶囩敓浜у彲鐢ㄦ€э紒
*鏂囨。鐩<EFBFBD>殑锛? 鍙嶆槧妯″潡鐪熷疄鐘舵€侊紝璁板綍寮€鍙戝巻绋?

---

馃搵 鏂囨。璇存槑

鏈<EFBFBD>枃妗ｆ槸PKB涓<EFBFBD>汉鐭ヨ瘑搴撴ā鍧楃殑**鐪熷疄鐘舵€佸揩鐓?*锛屽<E9949B>瀹炶<E780B9>褰曞綋鍓嶅紑鍙戠姸鎬併€佹妧鏈<E5A6A7>灦鏋勫拰宸茬煡闂<E785A1><E99782>銆? 涓庡叾浠栨枃妗ｇ殑鍏崇郴锛?- 鏈<EFBFBD>枃妗ｏ紙00-妯″潡褰撳墠鐘舵€侊級锛歐hat is锛堢湡瀹炵姸鎬侊紝鍖呮嫭闂<E5ABAD><E99782>锛?- **闇€姹傚垎鏋愭枃妗?*锛歐hat to do锛堜骇鍝侀渶姹傦級

• **寮€鍙戣<E98D99>褰曟枃妗?*锛歐hat done锛堝紑鍙戝巻绋嬶級
• **鎶€鏈<E282AC><E98F88>璁℃枃妗?*锛欻ow to do锛堣<E9949B>璁℃柟妗堬級

---

馃幆 妯″潡姒傝堪

鏍稿績鍔熻兘

PKB锛圥ersonal Knowledge Base锛変釜浜虹煡璇嗗簱妯″潡鎻愪緵锛?- 馃梻锔?**鐭ヨ瘑搴撶<E690B4>鐞?*锛氬垱寤恒€佺紪杈戙€佸垹闄や釜浜虹煡璇嗗簱

• 馃搫 鏂囨。绠＄悊锛氫笂浼犮€佸<EFBFBD>鐞嗐€佺粍缁囨枃妗ｏ紙PDF/Word/TXT/MD锛?- 馃<> AI闂<EFBFBD>瓟锛氬熀浜庣煡璇嗗簱鍐呭<EFBFBD>鐨勬櫤鑳介棶绛?- 馃搳 **鎵瑰<E98EB5>鐞?*锛氭壒閲忔彁鍙栨枃妗ｄ俊鎭<E4BF8A>紝鐢熸垚缁撴瀯鍖栨暟鎹?

褰撳墠鐘舵€?

缁勪欢	鐘舵€?	瀹屾垚搴?	璇存槑
鍚庣<EFBFBD>API	鉁?宸插畬鎴?	100%	v1 + v2鍙岃矾鐢辫繍琛?
鍓嶇<EFBFBD>Dashboard	鉁?宸插畬鎴?	95%	鍩轰簬V5鍘熷瀷瀹炵幇
鍓嶇<EFBFBD>Workspace	鉁?宸插畬鎴?	95%	鍩轰簬V3鍘熷瀷瀹炵幇
鍏ㄦ枃闃呰<EFBFBD>妯″紡	鉁?宸插畬鎴?	95%	Chat缁勪欢闆嗘垚瀹屾垚
閫愮瘒绮捐<EFBFBD>妯″紡	鉁?宸插畬鎴?	95%	鏂囨。閫夋嫨+瀵硅瘽
*鎵瑰<EFBFBD>鐞嗘ā寮?	鉁?宸插畬鎴?	95%	瀹屾暣娴佺▼+缁撴灉瀵煎嚭
鏂囨。涓婁紶	鉁?宸插畬鎴?	100%	鎷栨嫿+杩涘害鏄剧ず
*RAG妫€绱㈡ā寮?	鈴革笍 鏆傜紦	0%	浼樺厛绾ц皟鏁?

鏁翠綋瀹屾垚搴︼細绾?0% 馃帀

---

馃彈锔?鎶€鏈<E282AC>灦鏋?

鍓嶇<EFBFBD>鎶€鏈<EFBFBD>爤

妗嗘灦: React 19 + TypeScript 5
璺<>敱: React Router DOM v7
鐘舵€佺<E282AC>鐞? Zustand
UI缁勪欢: Ant Design v6 + Ant Design X
鏍峰紡: TailwindCSS v3
鏋勫缓宸ュ叿: Vite 7

鍚庣<EFBFBD>鎶€鏈<EFBFBD>爤

妗嗘灦: Fastify v4 (Node.js 22)
鏁版嵁搴? PostgreSQL 15 + Prisma 6
Schema: pkb_schema (鐙<>珛闅旂<E99785>)
LLM: DeepSeek-V3, Qwen-Max (閫氳繃LLMFactory)
RAG: Dify鐭ヨ瘑搴撻泦鎴?瀛樺偍: OSS瀵硅薄瀛樺偍

API璺<EFBFBD>敱

# 鏂版灦鏋?(v2)
/api/v1/pkb/knowledge         # 鐭ヨ瘑搴揅RUD
/api/v1/pkb/knowledge/:id     # 鐭ヨ瘑搴撹<E690B4>鎯?/api/v1/pkb/documents         # 鏂囨。绠＄悊

# 鏃ф灦鏋?(v1锛屼繚鎸佸吋瀹?
/api/v1/knowledge             # 鐭ヨ瘑搴撶<E690B4>鐞?/api/v1/documents             # 鏂囨。绠＄悊
/api/v1/batch-tasks           # 鎵瑰<E98EB5>鐞嗕换鍔?/api/v1/chat/stream           # AI瀵硅瘽娴?```

---

## 馃搨 浠ｇ爜缁撴瀯

### 鍚庣<E98D9A>浠ｇ爜缁撴瀯

backend/src/modules/pkb/ 鈹溾攢鈹€ controllers/ 鈹? 鈹溾攢鈹€ knowledgeBaseController.ts # 鐭ヨ瘑搴撴帶鍒跺櫒 鈹? 鈹溾攢鈹€ documentController.ts # 鏂囨。鎺у埗鍣?鈹? 鈹斺攢鈹€ batchController.ts # 鎵瑰<E98EB5>鐞嗘帶鍒跺櫒 鈹溾攢鈹€ services/ 鈹? 鈹溾攢鈹€ knowledgeBaseService.ts # 鐭ヨ瘑搴撴湇鍔?(~350琛? 鈹? 鈹溾攢鈹€ documentService.ts # 鏂囨。鏈嶅姟 (~400琛? 鈹? 鈹斺攢鈹€ batchService.ts # 鎵瑰<E98EB5>鐞嗘湇鍔?(~300琛? 鈹溾攢鈹€ routes/ 鈹? 鈹斺攢鈹€ index.ts # 璺<>敱閰嶇疆 鈹斺攢鈹€ index.ts # 妯″潡鍏ュ彛

鎬昏<EFBFBD>: ~1500琛屽悗绔<E68297>唬鐮?```

鍓嶇<EFBFBD>浠ｇ爜缁撴瀯

frontend-v2/src/modules/pkb/
鈹溾攢鈹€ api/
鈹?  鈹斺攢鈹€ knowledgeBaseApi.ts           # API瀹㈡埛绔?(~200琛?
鈹溾攢鈹€ stores/
鈹?  鈹斺攢鈹€ useKnowledgeBaseStore.ts      # Zustand鐘舵€?(~150琛?
鈹溾攢鈹€ pages/
鈹?  鈹溾攢鈹€ DashboardPage.tsx             # 浠<>〃鐩?(~450琛?
鈹?  鈹斺攢鈹€ WorkspacePage.tsx             # 宸ヤ綔鍙?(~513琛?
鈹溾攢鈹€ components/
鈹?  鈹斺攢鈹€ Workspace/
鈹?      鈹溾攢鈹€ WorkModeSelector.tsx      # 妯″紡閫夋嫨 (~200琛?
鈹?      鈹溾攢鈹€ FullTextMode.tsx          # 鍏ㄦ枃闃呰<E99783> (~150琛?
鈹?      鈹溾攢鈹€ DeepReadMode.tsx          # 閫愮瘒绮捐<E7BBAE> (~150琛?
鈹?      鈹溾攢鈹€ BatchMode.tsx             # 鎵瑰<E98EB5>鐞嗗叆鍙?鈹?      鈹斺攢鈹€ BatchModeComplete.tsx     # 鎵瑰<E98EB5>鐞嗗畬鏁?(~511琛?
鈹溾攢鈹€ hooks/
鈹?  鈹斺攢鈹€ useWorkMode.ts                # 宸ヤ綔妯″紡Hook
鈹溾攢鈹€ types/
鈹?  鈹斺攢鈹€ index.ts                      # 绫诲瀷瀹氫箟
鈹斺攢鈹€ styles/
    鈹斺攢鈹€ workspace.css                 # 鑷<>畾涔夋牱寮?
鎬昏<E98EAC>: ~2300琛屽墠绔<E5A2A0>唬鐮?```

---

## 馃帹 UI璁捐<E79281>

### 鍘熷瀷鏂囦欢

- **Dashboard**: `docs/03-涓氬姟妯″潡/PKB-涓<>汉鐭ヨ瘑搴?01-闇€姹傚垎鏋?鐭ヨ瘑搴撲华琛ㄧ洏V5.html`
- **Workspace**: `docs/03-涓氬姟妯″潡/PKB-涓<>汉鐭ヨ瘑搴?01-闇€姹傚垎鏋?宸ヤ綔鍙癡3.html`

### Workspace甯冨眬

鈹屸攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹?[杩斿洖] 鈹?鐭ヨ瘑搴撳悕 鈹?[闂<>瓟][璧勪骇] 鈹?璁剧疆 澶村儚 鈹?Header 56px 鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹?[宸ヤ綔妯″紡鈻糫 [鏂囨。鈻糫 宸插姞杞?x/y 绡?鈹?宸ヤ綔妯″紡鏍?40px 鈹溾攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?鈹? 鈹?鈹? 鑱婂ぉ鍖哄煙锛堟渶澶у寲锛? 鈹?鈹? 鈹?鈹斺攢鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹?```

璁捐<EFBFBD>鐗圭偣

• 鍗曞眰Header: 鏁村悎瀵艰埅鍜孴ab鍒囨崲锛堟櫤鑳介棶绛?鐭ヨ瘑璧勪骇锛?- **绱у噾宸ヤ綔妯″紡鏍?*: 涓嬫媺閫夋嫨锛岃妭鐪佺┖闂?- 鏈€澶у寲鑱婂ぉ鍖哄煙: 鍏ㄥ睆妯″紡锛屾矇娴稿紡瀵硅瘽浣撻獙
• 鍝嶅簲寮忓竷灞€: 鏀<>寔涓嶅悓灞忓箷灏哄<E7818F>

---

馃攲 宸ヤ綔妯″紡

1. 鍏ㄦ枃闃呰<E99783>妯″紡锛團ull Text锛?

鍔熻兘璇存槑锛?- 鍔犺浇鐭ヨ瘑搴撳叏閮ㄦ枃妗?- AI鍏峰<E98D8F>鍏ㄧ煡瑙嗚<E79199>

• 閫傚悎鏂囩尞缁艰堪銆佽法鏂囩尞鍒嗘瀽

**鎶€鏈<E282AC>疄鐜?*锛?- 璋冪敤 /api/v1/chat/stream 鎺ュ彛

• 浼犲叆鎵€鏈夋枃妗<EFBFBD>D
• 浣跨敤SSE娴佸紡鍝嶅簲

2. 閫愮瘒绮捐<E7BBAE>妯″紡锛圖eep Read锛?

鍔熻兘璇存槑锛?- 閫夋嫨1-5绡囨枃妗?- 娣卞害瑙ｈ<E79199>鍗曠瘒鏂囩尞

• 閫傚悎绮捐<EFBFBD>銆佹壒娉ㄣ€佺悊瑙? **鎶€鏈<E282AC>疄鐜?*锛?- 涓嬫媺閫夋嫨鏂囨。锛堟渶澶?绡囷級
• 璋冪敤鐩稿悓Chat鎺ュ彛
• 浠呬紶鍏ラ€変腑鏂囨。ID

3. 鎵瑰<E98EB5>鐞嗘ā寮忥紙Batch锛?

鍔熻兘璇存槑锛?- 閫夋嫨鎵瑰<E98EB5>鐞嗘ā鏉?- 鎵归噺鎻愬彇鏂囨。淇℃伅

• 鐢熸垚缁撴瀯鍖栬〃鏍? **鎶€鏈<E282AC>疄鐜?*锛?- 璋冪敤 /api/v1/batch-tasks 鎺ュ彛
• 鏀<EFBFBD>寔杩涘害鏌ヨ<EFBFBD>
• 缁撴灉瀵煎嚭Excel

**褰撳墠鐘舵€?*锛氿煍?API鎵ц<E98EB5>寰呰皟璇?

4. RAG妫€绱㈡ā寮忥紙寰呭紑鍙戯級

鍔熻兘璇存槑锛?- 鍩轰簬鍚戦噺妫€绱?- 绮惧噯瀹氫綅鐩稿叧娈佃惤

• 閫傚悎蹇<EFBFBD>€熸煡鎵? **褰撳墠鐘舵€?*锛氣潓 鍚庣<E98D9A>寰呭疄鐜?

---

鈿狅笍 宸茬煡闂<E785A1><E99782>

1. RAG妫€绱㈡ā寮忔湭瀹炵幇 馃煛 涓<>紭鍏堢骇

闂<EFBFBD><EFBFBD>鎻忚堪锛?- RAG妫€绱㈡ā寮忔殏鏈<E6AE8F>疄鐜?- 褰撳墠浼樺厛鍏ㄦ枃闃呰<E99783>鍜岄€愮瘒绮捐<E7BBAE>妯″紡

褰卞搷锛氬伐浣滄ā寮忛€夋嫨鏈夐檺

**瑙ｅ喅鏂规<E98F82>**锛?- v2.1鐗堟湰瀹炵幇RAG妫€绱?- 闆嗘垚Dify鐭ヨ瘑搴撴<E690B4>绱㈣兘鍔?

2. 鎵瑰<E98EB5>鐞嗘ā鏉挎湁闄?馃煝 浣庝紭鍏堢骇

闂<EFBFBD><EFBFBD>鎻忚堪锛?- 褰撳墠鍙<E5A2A0>敮鎸?涓<>ā鏉匡紙涓村簥鐮旂┒淇℃伅鎻愬彇锛?- 闇€瑕佹洿澶氶<E6BEB6>璁炬ā鏉垮拰鑷<E68BB0>畾涔夎兘鍔? 褰卞搷锛氭壒澶勭悊搴旂敤鍦烘櫙鏈夐檺

**瑙ｅ喅鏂规<E98F82>**锛?- v2.2鐗堟湰澧炲姞鑽<EFBFBD>墿瀹夊叏鎬с€佹偅鑰呭熀绾跨瓑妯℃澘

• 鏀<EFBFBD>寔鐢ㄦ埛鑷<EFBFBD>畾涔夋ā鏉?

3. 鏂囨。棰勮<E6A3B0>鍔熻兘缂哄け 馃煝 浣庝紭鍏堢骇

闂<EFBFBD><EFBFBD>鎻忚堪锛?- 鏆備笉鏀<E7AC89>寔鏂囨。鍦ㄧ嚎棰勮<E6A3B0>

• 闇€涓嬭浇鍚庢煡鐪嬪師鏂? 褰卞搷锛氱敤鎴蜂綋楠? **瑙ｅ喅鏂规<E98F82>**锛?- v3.0鐗堟湰闆嗘垚PDF棰勮<EFBFBD>鍔熻兘
• 鏀<EFBFBD>寔鏂囨。鏍囨敞鍜屾壒娉?

---

馃摑 涓嬩竴姝ュ紑鍙戣<E98D99>鍒?

v2.1 鐗堟湰锛堢煭鏈燂級

1. *RAG妫€绱㈡ā寮? 馃煛

   • 瀹炵幇鍩轰簬Dify鐨勭煡璇嗗簱妫€绱? - 娣诲姞宸ヤ綔妯″紡閫夋嫨鍣? - 娴嬭瘯妫€绱㈠噯纭<E599AF>害

2. 鎬ц兘浼樺寲 馃煛

   • 鎵瑰<EFBFBD>鐞嗗苟鍙戜紭鍖? - 鏂囨。鍔犺浇缂撳瓨
   • API鍝嶅簲鏃堕棿浼樺寲

v2.2 鐗堟湰锛堜腑鏈燂級

3. *鎵瑰<EFBFBD>鐞嗗<EFBFBD>寮? 馃煝
   • 澧炲姞鑽<EFBFBD>墿瀹夊叏鎬фā鏉? - 澧炲姞鎮ｈ€呭熀绾跨壒寰佹ā鏉? - 鏀<>寔鑷<E5AF94>畾涔夋ā鏉?
4. 鐢ㄦ埛浣撻獙浼樺寲 馃煝
   • 鏂囨。绛涢€夊拰鎺掑簭
   • 鎵归噺鎿嶄綔
   • 蹇<EFBFBD>嵎閿<EFBFBD>敮鎸?

涓<EFBFBD>湡浠诲姟锛?鍛ㄥ唴锛?

5. *RAG妫€绱㈡ā寮?

   • 鍚庣<EFBFBD>API寮€鍙? - 鍓嶇<E98D93>闆嗘垚

6. PDF棰勮<EFBFBD>澧炲己

   • 闆嗘垚PDF鏌ョ湅鍣? - 鏀<>寔鏍囨敞

---

馃摎 鐩稿叧鏂囨。

闇€姹傛枃妗?- PRD V5.0

• 鐭ヨ瘑搴撲华琛ㄧ洏V5鍘熷瀷
• 宸ヤ綔鍙癡3鍘熷瀷

鎶€鏈<EFBFBD>枃妗?- [鏁版嵁搴撹<E690B4>璁<EFBFBD>(./02-鎶€鏈<E282AC><E98F88>璁?01-鏁版嵁搴撹<E690B4>璁?md)

寮€鍙戣<EFBFBD>褰?- 2026-01-07 鍓嶇<E98D93>V3璁捐<E79281>瀹炵幇

娴嬭瘯鏂囨。

• [涓庡師鍨嬪浘鐨勫樊璺漖(./05-娴嬭瘯鏂囨。/涓庡師鍨嬪浘鐨勫樊璺?md)

---

馃帗 缁欐柊寮€鍙戣€呯殑鎻愮ず

蹇<EFBFBD>€熶笂鎵?

1. 浜嗚В妯″潡缁撴瀯

   • 闃呰<EFBFBD>鏈<EFBFBD>枃妗ｄ簡瑙ｅ綋鍓嶇姸鎬? - 鏌ョ湅鍘熷瀷HTML浜嗚ВUI璁捐<E79281>

2. 杩愯<EFBFBD>椤圭洰

   # 鍚庣<E98D9A>
   cd backend && npm run dev
   
   # 鍓嶇<E98D93>
   cd frontend-v2 && npm run dev
   

3. 鏌ョ湅鍏抽敭浠ｇ爜

   • WorkspacePage.tsx - 宸ヤ綔鍙颁富閫昏緫
   • knowledgeBaseApi.ts - API璋冪敤
   • useKnowledgeBaseStore.ts - 鐘舵€佺<E282AC>鐞?

娉ㄦ剰浜嬮」

鉁?**搴旇<E690B4>杩欐牱鍋?*锛?1. 浣跨敤Zustand绠＄悊鐘舵€?2. 澶嶇敤shared/components涓<73>殑Chat缁勪欢 3. 閬靛惊TailwindCSS鏍峰紡瑙勮寖 4. 浣跨敤Ant Design缁勪欢

鉂?**涓嶈<E6B693>杩欐牱鍋?*锛?1. 鍒涘缓鏂扮殑Chat瀹炵幇 2. 鐩存帴鎿嶄綔DOM 3. 浣跨敤琛屽唴鏍峰紡 4. 蹇界暐TypeScript绫诲瀷

---

馃搳 妯″潡缁熻<E7BC81>

浠ｇ爜閲忕粺璁?```

鍚庣<EFBFBD>浠ｇ爜锛氱害1,500琛?鍓嶇<E98D93>浠ｇ爜锛氱害2,300琛?鎬昏<E98EAC>锛氱害3,800琛?```

寮€鍙戣繘搴?```

鏁翠綋杩涘害锛氱害75%

• 鍚庣<EFBFBD>API锛?00% 鉁?- Dashboard椤甸潰锛?0% 鉁?- Workspace椤甸潰锛?5% 鉁?- 鍏ㄦ枃闃呰<E99783>妯″紡锛?0% 鉁?- 閫愮瘒绮捐<E7BBAE>妯″紡锛?5% 鉁?- 鎵瑰<E98EB5>鐞嗘ā寮忥細70% 馃敡
• RAG妫€绱㈡ā寮忥細0% 鉂?```

---

馃敆 Git鎻愪氦璁板綍

**鏈€鏂版彁浜?*锛?``` 5a17d09 feat(pkb): Complete PKB module frontend migration with V3 design

**鎻愪氦鍐呭<E98D90>**锛?- 鍚庣<E98D9A>妯″潡杩佺Щ鍒?/modules/pkb
- 鍓嶇<E98D93>V3璁捐<E79281>瀹炵幇
- 3绉嶅伐浣滄ā寮忔<E5AFAE>鏋?- Chat缁勪欢闆嗘垚

---

**鏈€鍚庢洿鏂帮細** 2026-01-07  
**鏂囨。缁存姢锛?* PKB妯″潡寮€鍙戝洟闃? 
**鑱旂郴鏂瑰紡锛?* 椤圭洰Issues