留下想法的來路、論述的依據，以及每一次由你做出的決定。
English edition ｜ What changed in each release
你有一個研究構想，想找文獻、拆解問題、打磨論證，最後寫成提案。AI 可以幫你推進這些工作，但流暢的文字不一定有根據，完整的答案也可能藏著未經查證的推論。
Spark2Groundwork 是一套放在研究專案資料夾裡的工作規則、文件模板與檢查工具。它讓 AI 記錄構想、標示來源、交代修改，再把需要判斷的地方交回給你。
| 你想知道的事 | 框架提供的協助 |
|---|---|
| 這個構想值得繼續嗎？ | 用猜想台帳記錄理由、未知與反證條件 |
| 這句論述的依據在哪裡？ | 用主張台帳連到文獻中的逐字錨點與頁碼 |
| AI 改了什麼？哪些還沒看過？ | 保存工作進度、查看差異，分開記錄人工已閱 |
| 換了 AI 或隔了一段時間，怎麼接著做？ | 透過交接封包與工作備忘錄接續 |
你不必懂程式，但需要參與研究判斷。 框架協助暴露缺漏、留下可追溯的紀錄；它不能保證找出所有錯誤，也不能替你保證研究結論正確。
這是 Spark2Groundwork 的設計起點：框架需要和你的研究一起成長。 不同題目、不同 AI、不同工作習慣，會遇到不同的問題。下載一份框架，不代表從此不會出錯；真正有價值的是，把使用中發現的問題，變成下一次能派上用場的經驗。
| 在研究中發生的事 | 讓它留下什麼 |
|---|---|
| 你發現 AI 犯錯，或某個流程不適合這個專案 | 請 AI 記下事件、影響與當時的情境 |
| 累積幾次經驗後，請 AI 一起回頭整理 | 找出反覆出現的原因與失誤模式，而不只記住某一次錯誤 |
| AI 提出改進建議，你衡量是否適合 | 由你決定要不要調整流程、加入或修訂專案規則 |
中間的整理很重要。 下一次的錯誤未必長得一樣；理解反覆失誤的原因，才有機會在新的情境中認出它。改進也不等於每出一次事就加一條禁令，還要看規則能否幫忙、會不會增加不必要的負擔。
最後的決定始終在你手上。 AI 可以記錄、分析和提案，但不能自行把建議變成往後約束整個專案的規則。
用了一段時間，你的框架可能和別人的不同，因為它累積了你的研究經驗，逐漸適合你的工作。這正是設計目的。 保留修改的理由，下一位 AI 才能理解這些選擇；把專案自訂規則與事故紀錄放在 my/，也讓它們能與公版框架的更新分開保存。
- 從 正式版本下載頁 下載並解壓縮。要開始正式研究，請選已發布版本；開發分支可能尚未完成驗收。
- 只取
Spark2Groundwork_zh/，複製到你的工作位置，改成自己的專案名稱。若偏好英文，取Spark2Groundwork_en/；兩者各自完整，不必同時保留。 - 打開資料夾裡的
SETUP.md，把專案資料夾交給能讀取本機檔案的 AI，依INITIALIZE_PROMPT.md開始。 - 填寫
PROJECT.md與第一個想法.md，說明研究方向、界線與原始構想。其餘紀錄可由 AI 協助維護。 - 依設定指引檢查工具、確認初始內容，再開始第一輪工作。
自動檢查與快照需要可用的 Python、Git；設定指引與本機啟動說明會引導安裝。Windows 使用 .bat，Mac 使用 .command。按鈕可能開啟終端機視窗顯示結果，日常操作不以輸入或貼上命令為前提。若啟動受阻，依 啟動說明 處理。
AI 能讀檔，不代表它能在你的電腦執行工具。只有聊天／上傳附件的環境，也可以使用 純對話工作方式，但需要手動傳遞文件，不能把遠端執行結果當成本機檢查通過。
先說清楚這輪要解決的問題，再讓 AI 工作。收工時，請它交代改動、證據、仍未查明的部分，以及需要你決定的事項。你檢視研究內容與修改後，才確認已閱。
v1.4.5 將常用操作分開，避免把「檔案已存好」誤當成「你已經看過」：
| 按鈕 | 什麼時候用 |
|---|---|
| 儲存進度 | 先保存目前工作；不表示你已閱讀，也不移動已閱標記 |
| 查看變更 | 查看與人工已閱基準的差異；缺少可信基準時，不能據此認定沒有未讀工作 |
| 記錄快照 | 你確實看完之後才按，建立或更新人工已閱基準；AI 不得代按 |
| 檢查專案 | 檢查工具環境與可自動檢查的項目，閱讀通過、缺陷或無法判定的結果 |
| 同步規則 | 補入缺少的框架條文、檢查既有條文差異；差異仍需由你決定如何處理 |
| 檢查更新 | 查詢版本與已下載更新的差異；不會直接套用更新 |
新專案先依設定指引閱讀初始內容、建立人工已閱基準，再派工。尚未讀完只需儲存進度。詳細操作見 更新、儲存與已閱。
自動檢查可以協助確認：引用錨點是否出現在提取文字中、必填欄位是否齊全、引用檔案是否存在，以及部分跨文件規則是否一致。
原文是否支持你的推論、研究方法是否適切、結果能否外推，仍需要實質判讀。 文字比對成功，不等於論據成立；有填反證條件，也不等於它真的能被觀察或檢驗。
結果分為「通過」「有缺陷」「無法判定」。缺資料、缺工具或未進入查證，不能當成通過。感測器只涵蓋已定義的檢查範圍；人工已閱標記也只是工作紀錄，不是程式能驗證你已理解的證明。
研究稿、文獻、台帳、自訂規則與專案設定，都是你需要保全的內容。框架的公版規則、提示模板、工具與說明則可以更新。自建工具放在 my/tools/，避免混進更新時會替換的 scripts/。
升級前，先在專案外完整備份。 Git 快照可能排除部分檔案，不能取代完整備份。依 更新指引 比對並逐包處理，不要拿整個下載資料夾覆蓋你的研究專案。
v1.5.0 聚焦自然閱讀與互動：一般文字不需逐句標籤；保留型號資訊來源，不因完整版本未知反覆詢問；歷史交接提醒集中呈現，詳細資訊仍可查。保存與人工已閱的區分維持不變。
平台驗證範圍：v1.5.0 的原生 Windows 驗證已完成；Mac 原生、Finder／Gatekeeper 與真人雙擊尚未驗證，依本版安排另行補測，不視為已通過。
v2 正在開發，是一次重新設計。 目標包括更清楚的資料歸屬、單一核心與所選語言更新，以及更完整的來源、主張、查證與人類裁決紀錄。這些是開發方向，並非 v1.4.5 已提供的能力。
詳見 版本紀錄中的 v2 預告。現在不需要改造研究資料夾；先依 v2 升級準備 備份與盤點。未來會在 v2 接近完成時規劃 AI 協助的遷移指引。
Spark2Groundwork 由 Yama 主持設計與維護，負責研究需求、產品方向、工作指派及最終裁決。開發過程使用多家 AI 協助規劃、實作、測試、覆核與文件撰寫。
| AI 協作工具 | 在本專案中的參與 |
|---|---|
| OpenAI Codex | 以 Astra、Sol 等專案角色參與規劃、實作、測試與覆核 |
| Anthropic Claude | 參與實作、獨立覆核、研究工作流評估與文件整理 |
| Google Gemini | 參與主要施工、返修、測試與設計提案 |
上述為累積參與情況，各輪任務由 Yama 指派；個別工作的角色、模型版本與驗證範圍依實際紀錄區分。使用 AI 不代表每項成果都經所有模型覆核，也不代表其供應商參與維護、贊助或背書。
我們保留 AI 協作的貢獻，也保留人的責任：AI 提供建議與產物，Yama 決定專案方向及是否接受成果；使用者仍需自行判讀其研究內容。
框架採用 MIT 授權。你使用框架產生的研究內容，仍由你保有；所引用文獻的權利依原來源處理。