Version: 2.1.0 Concept
Author: H.C. Chen & Assistant
Status: Draft / Behavioral Reference
Project K 是一個極簡、可自舉擴展的 Forth 核心。本規格定義 Project K 系統在支援人工智慧 (AI) 整合時的概念架構與行為契約 (Conceptual Contract)。
VM、Task、Input、Word)本身不內建任何 AI Client、Model 呼叫或通訊協定。yield vm.pause()、Task.resume() 以及 Host 互通機制完成對接。(ai) 與 ai:。不引進非核心的週邊設備管理、複雜看板或重型框架。 ┌────────────────────────────────────────────────────────┐
│ User / REPL │
└───────────────────────────┬────────────────────────────┘
│
forth> ai: prompt
│
▼
┌────────────────────────────────────────────────────────┐
│ Forth Vocabulary │
│ : ai: ... (ai) ... ; (immediate) │
└───────────────────────────┬────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────┐
│ Host AI Extension (e.g. ai.py) │
│ ┌──────────────────────────────────────────────────┐ │
│ │ (ai) Generator │ │
│ │ - Manages Session & Turns │ │
│ │ - Streams Assistant Text to User │ │
│ │ - Dispatches Tools │ │
│ └─────────────┬──────────────────────┬─────────────┘ │
└────────────────┼──────────────────────┼────────────────┘
│ │
1. Tool: search_words │ 2. Tool: run_forth
│ │
▼ ▼
┌──────────────────┐ ┌──────────────────┐
│ Read Dictionary │ │ Security Check │
│ (Read-only) │ │ (Safe? Trust?) │
└──────────────────┘ └─────────┬────────┘
│
[Unsafe & Untrusted]
│
▼
yield vm.pause()
(Task Pauses, Control Returns)
系統僅向 Forth 詞彙庫暴露以下兩個詞彙:
(ai)( prompt-string stream? -- [response-string] )stream? 與提示字串 prompt。prompt 發送至 AI 服務。stream? 為 true:即時將 AI 回覆的文字片段串流印出至輸出終端,結束後堆疊不留返回值。stream? 為 false:將 AI 完整回覆的文字字串壓入資料堆疊(Data Stack),供後續 Forth 程式處理。yield pause 暫停當前 Task。ai:( <prompt> -- )stream? = true) 呼叫 (ai)。ai: tell me a joke。Project K 的 Task 與 pause/resume 機制在此展現其最大價值:
(ai) 不應鎖死執行緒,而是產生暫停信號(yield vm.pause())。forth> 提示字元)。使用者可在此刻檢查資料堆疊、查詢詞彙原始碼,完全掌握主控權。resume,Task 從暫停點無縫繼續推進,接收結果並回報給 AI 完成該回合。AI Extension 為模型提供兩項基礎工具,讓 AI 成為認識當前 VM 的專家:
projectk_search_words)vm.words),檢索匹配的名稱、說明(help)、註解(comment)與原始碼。projectk_run_forth)為防止 AI 自動執行具破壞性的程式碼,系統實施雙層安全審核:
word.properties["safe"])safe = True。vm.call Decorator)projectk.py 不做修改。Host 在掛載 AI 時,以 Decorator 包裹 vm.call。resume,只放行當前步驟。trust-task resume),則該 Task 在其生命週期內後續的所有動作一律放行,直到任務終止(done/failed/aborted)。ai: hello,AI 回覆文字以打字機串流即時印於終端機,執行完畢印出 ok。ai: 系統有哪些堆疊詞彙?,AI 透過 projectk_search_words 查詢本地字典並給出精確答案。forth>,使用者確認輸入 resume 後順利完成。trust-task resume 批准該 Task,該 Task 後續詞彙一氣呵成執行完畢,不反覆中斷。Project K 2.1.0 的 AI 支援並非將 AI 堆砌成龐然大物,而是透過優雅的語意邊界、Word 自宣告屬性、Task 暫停續行與 Task 範疇批准,展示一個極簡 Forth 核心如何以最小的代價,優雅且安全地駕馭現代生成式 AI。