AI 提問模板(程式碼詳解 / 修改 / 除錯) 使用方式:把「你要分析的檔案/程式碼」貼上後,再選下面一種問題模板。可以混搭。 ======================================== 一、完整解析整支程式碼(深度) ======================================== 請完整解析這份檔案,請用「分段 + 逐行」方式說明,包含: 1. 每一段程式碼的功能與目的 2. 函式之間的呼叫關係與資料流 3. 程式從入口到結束的執行順序 4. 外部依賴的來源(API、store、props、路由參數等) 5. 隱含邏輯或容易忽略的假設 最後請補上: - 可優化之處 - 若要重構,你的建議方向 ======================================== 二、逐行翻譯 + 通俗註解(超細) ======================================== 請逐行解釋這段程式碼,每一行都要說明: - 這行在做什麼 - 對應到整體流程中的哪個階段 - 如果刪掉會造成什麼影響 另外請補充: - 哪些是語法糖 - 哪些是框架特有語法 - 哪些可能會出錯或有副作用 ======================================== 三、流程圖 + 執行路徑 ======================================== 請根據程式碼生成流程圖(文字版即可),並在每個節點說明: - 進入條件 - 執行內容 - 可能的例外 如果資訊不足,請列出需要我補充的檔案或函式名稱。 ======================================== 四、定位問題 / 分析 Bug ======================================== 請幫我從以下角度檢查程式碼: - 可能造成 bug 的邏輯錯誤 - 例外處理不足的地方 - 資料流程不一致的風險 - 效能瓶頸 請列出風險點,並附上改善建議。 ======================================== 五、功能新增(欄位 / 搜尋 / 列表) ======================================== 我要新增一個欄位或搜尋條件,請用以下格式回答: 1. 需要修改哪些檔案(含路徑) 2. 每個檔案要新增或修改哪一段 3. 標出插入位置(行數或相對區塊) 4. 提供修改後的範例程式碼 5. 若需改後端 API 或資料表,也請說明 ======================================== 六、後端 API / 資料表 / SQL 查詢 ======================================== 請幫我查後端 API 使用的資料表與 SQL 篩選條件,回答包含: - Controller / Service / Repository 的位置 - 主要查詢的 SQL(或查詢條件) - 使用的 DB 與資料表名稱 ======================================== 七、專案級理解(多檔案) ======================================== 我會提供多個檔案。請在分析時持續整理: 1. 路由與控制器的對應 2. 函式呼叫鏈 3. 服務與 Repository 的職責拆分 4. Model 與資料流向 請在我逐步貼文件時持續更新。 ======================================== 八、我要你先統整再結論 ======================================== 請先摘要與統整,不要急著生成結論。 我會再告訴你要深入的部分。 ======================================== 補充:針對「新增欄位 / 搜尋 / 匯出 / 匯入」的強化提問版本 ======================================== ======================================== *頁面修改 ======================================== * 如果我要加一個新的編輯欄位,我的程式應該依什麼順序修改? 請用「步驟清單」回答,並提供: 1. 需要修改的檔案路徑 2. 每個檔案要加的行數或區塊位置(可點擊行數) 3. 修改前後的範例程式碼 4. 若後端 API 或資料表需配合,請一起說明 * 如果我要加一個新的新增欄位,我的程式應該依什麼順序修改? 請用「步驟清單」回答,並提供: 1. 需要修改的檔案路徑 2. 每個檔案要加的行數或區塊位置(可點擊行數) 3. 修改前後的範例程式碼 4. 若後端 API 或資料表需配合,請一起說明 * 如果我要加一個新的搜尋欄位,且這個欄位要加入列表顯示,程式應該依什麼順序修改? 請用「步驟清單」回答,並提供: 1. 需要修改的檔案路徑 2. 前端 UI / 搜尋參數 / 列表欄位各在哪裡加 3. 行數或區塊位置(可點擊行數) 4. 修改後的範例程式碼 5. 後端 API / SQL 是否需要調整 * 我需要加一個新的搜尋「老師帳號」,使用輸入框帶出搜尋資料。 請列出: 1. 前端輸入欄位要新增在哪個區塊 2. 搜尋參數要加在哪裡(含 pageSearch / API param) 3. 列表欄位要新增在哪裡 4. 後端 API 是否需要新增查詢條件(含檔案位置) 5. 請告訴我程式碼要加入或修改的位置,可點擊行數直接到該行,且將程式碼列出 * 請focus我當前頁籤的檔案 我需要加一個新的搜尋「訂單編號」在會員ID輸入框後面,用輸入框的方式由後端 API 帶出搜尋資料。 請列出: 1. 前端輸入欄位位置 2. 搜尋參數加入位置 3. 列表欄位加入位置 4. 後端 API 是否需要新增查詢條件 5. 請告訴我程式碼要加入的位置且將程式碼列出(可點擊行數) 6. 列出程式碼給我看 7. 可以提供我完整修正的的程式碼 * 我需要加一個新的搜尋「老師帳號」,區塊位置在「老師名稱」之後, 並且在下面的資料列中加入「老師帳號」欄位在「老師名稱」之後。 請列出: 1. 前端 UI 插入位置(含行數) 2. 列表欄位插入位置(含行數) 3. 搜尋參數加入位置 4. 若後端 API 需配合,請列出改動處與範例 5. 請告訴我程式碼要加入的位置且將程式碼列出(可點擊行數) 6. 列出程式碼給我看 * 我需要加一個新的搜尋使用的是select下拉選項的方式。 請列出: 1. 前端輸入欄位位置 2. 搜尋參數加入位置 3. 列表欄位加入位置 4. 後端 API 是否需要新增查詢條件 5. 請告訴我程式碼要加入的位置且將程式碼列出(可點擊行數) 6. 列出程式碼給我看 * 我需要在這個頁面加上「篩選匯出」按鈕, 可以匯出目前表列的所有資料,若有篩選條件,匯出結果也需跟著變。 請列出: 1. 前端按鈕應插入的位置(含行數) 2. 匯出函式需要新增或修改的地方 3. 匯出時如何帶入目前搜尋條件 4. 若後端 API 需配合,請列出改動 5. 請告訴我程式碼要加入的位置且將程式碼列出(可點擊行數) 參考位置:@vue/admin/src/views/php/TeacherPlatformMs/OrderItemUnitLite/PageRecord.vue:236-246 ======================================== *程式解說Prompt ======================================== *!!!!!!!!! 請告訴我程式碼的位置且將程式碼列出,列出程式碼時請列出行數範圍並可一鍵跳轉,程式碼需要有顏色,我也需要程式的流程圖 * 這邊的預覽列印是這麼做的呢? http://localhost/pidi_admin/appReport/admin 請告訴我程式碼的位置且將程式碼列出,列出程式碼時請列出行數範圍並可一鍵跳轉,程式碼需要有顏色,我也需要程式的流程圖 *可以畫流程圖給我嗎? 預覽列印 http://localhost/pidi_admin/appReport/admin 這邊的預覽列印程式流程和程式碼是這麼做的呢? 請告訴我程式碼的位置且將程式碼列出,列出程式碼時請列出行數範圍並可一鍵跳轉,程式碼需要有顏色 * 請逐行解釋這段程式碼,並附上通俗易懂的註解, 「請用可點擊的程式碼引用呈現:要包含完整(或相對)檔案路徑和起訖行號,方便我點標題跳到編輯器那一行。」 「不要只用純 markdown 程式碼區塊;請用 Cursor 那種帶 檔案:行號-行號 標題的引用格式。」 「請標註程式碼位置:每段都要寫清楚哪個檔、第幾到第幾行,我要能一鍵跳轉。」 讓我能理解每一行在做什麼。如果有隱含邏輯或特殊語法,也請補充說明。 * 這邊的匯入是怎麼做的?請告訴我程式碼的位置且將程式碼列出(可點擊行數), 包含後端 API 的流程,請逐行解釋這段程式碼,並附上通俗易懂的註解, 讓我能理解每一行在做什麼。如果有隱含邏輯或特殊語法,也請補充說明。 *招募函管理的檔案上傳filesUpload() http://localhost/pidi_admin/recruitDocs/admin 請告訴我這邊是這麼做的? 並請告訴我程式碼的位置且將程式碼列出, 包含後端 API 的流程,請逐行解釋這段程式碼,並附上通俗易懂的註解, 讓我能理解每一行在做什麼。如果有隱含邏輯或特殊語法,也請補充說明。 * 這邊的xx是怎麼做的?請告訴我程式碼的位置且將程式碼列出(可點擊行數), 包含後端 API 的流程,請逐行解釋這段程式碼,並附上通俗易懂的註解, 讓我能理解每一行在做什麼。如果有隱含邏輯或特殊語法,也請補充說明。 *這邊的資料是怎麼撈取的?請告訴我程式碼的位置且將程式碼列出(可點擊行數), 包含後端 API 的流程,請逐行解釋這段程式碼,並附上通俗易懂的註解, 讓我能理解每一行在做什麼。如果有隱含邏輯或特殊語法,也請補充說明。 *可以幫我找出資料表互相join的欄位有哪些嗎?可以列出清單給我嗎? *這邊的資料是怎麼撈取的? 幫我找出主資料表互相join的欄位有哪些嗎? 含db_name.table可以列出清單給我嗎(表格清單)? 需要有中文表格欄位對照 **** 可以給我完整的sql語法嗎?也需要註解使用的資料表 入國引進許可函 http://localhost/pidi_admin/visaDoc/admin 這邊的資料是怎麼撈取的?請告訴我程式碼的位置且將程式碼列出(可點擊行數), 包含後端 API 的流程,請逐行解釋這段程式碼,並附上通俗易懂的註解, 讓我能理解每一行在做什麼。如果有隱含邏輯或特殊語法,也請補充說明。 可以再幫我找出資料表互相join的欄位有哪些嗎? 含db_name.table可以列出清單給我嗎(表格清單)需要有中文表格欄位對照 資料庫設定檔/home/olt/SbGen52/api/ClientApi/.env *請註解在程式碼中 *請告訴我程式碼要加入修改的位置且將程式碼列出(可點擊行數) *這個是什麼可以詳細白話文解釋給我嗎? 請逐行解釋這段程式碼,並附上通俗易懂的註解?用新手的方式 讓我能理解每一行在做什麼。 請明確指出程式碼的位置且將程式碼列出(可點擊行數) 如果有隱含邏輯或特殊語法,也請補充說明。 *請告訴我程式碼的位置且將程式碼列出(可點擊行數) *我需要針對文檔修改模組 我要這麼去修改呢? 請告訴我程式碼要加入的位置且將程式碼列出(可點擊行數) 列出程式碼給我看 請完整說明: 1. 這個模組有哪些主要頁面 / UI 元件 2. UI 頁面在哪些檔案 3. UI 初始化時會呼叫哪些 API 4. 使用者操作按鈕、表單、下拉選單時,會送出哪些參數 5. 前端參數是怎麼組成的 6. API 路由是哪一支 7. 進到哪個 Controller / Method 8. 後端如何接收 request 參數 9. 後端如何驗證、處理、轉換資料 10. 最後查詢或寫入哪些 Model / 資料表 11. API 回傳格式長什麼樣 12. 前端拿到 response 後,怎麼更新畫面 請告訴我程式碼的位置且將程式碼列出(可點擊行數) 請用「前端 UI → API → Controller → Model / DB → Response → UI 更新」的流程幫我整理。 請附上相關檔案路徑、方法名稱、參數名稱、資料流向,並用白話文解釋。 ======================================================= 請你掃描整個專案資料夾,幫我建立一份「專案結構說明文件」。 請依照以下格式整理: 一、專案整體架構 請先判斷這是什麼類型的專案,例如 Laravel、Vue、React、純 PHP、前後端分離、傳統 MVC 等。 二、根目錄重要檔案 請列出根目錄下重要檔案,說明用途。 三、主要資料夾說明 請逐一分析每個主要資料夾的用途。 四、前端結構 請說明前端頁面、元件、路由、API 呼叫、樣式檔案的位置。 五、後端結構 請說明後端 route、controller、model、service、middleware、validation、config 的位置。 六、資料庫結構 請說明 migration、seeder、model、SQL 或資料表相關檔案的位置。 七、系統入口與執行流程 請說明使用者進入系統後,程式大概從哪裡開始執行。 八、建議閱讀順序 請告訴我如果我是新手,要先看哪些資料夾或檔案。 九、請用表格整理: 路徑|用途|相關功能|重要程度|維護注意事項 請用白話文說明,不要只列檔名。 ============================================================