AI Coding Assistant Lingma：Repo Wiki

當你在開發過程中查詢知識點、代碼解釋、增加功能特性時，Repo Wiki 會深入分析專案結構和代碼實現，結合Repo Wiki 與上下文資訊，給出更準確、詳細的解答和文檔支援，並且讓智能體具備更深入程式碼程式庫認知。

Wiki產生

倉庫中的 Wiki 不是靜態——它會與代碼保持同步。

Wiki 會在三種關鍵情況下更新。瞭解它們的觸發時機與原因，有助於你保持 Wiki 的即時更新。

1. 初次產生 Wiki

   當你首次開啟專案時，預設不存在 Wiki。你可以一鍵從零產生。

   典型產生耗時：約 120 分鐘（以包含 4,000 個檔案的倉庫為例）。

   在左側 REPO WIKI (BETA) 面板中，從語言下拉框選擇目標語言（如 English），然後單擊紫色的產生按鈕即可開始產生。

2. 檢測到代碼變更

   初次產生後，系統會持續監控代碼的變更。

   如果你修改了已被 Wiki 記錄的內容（例如函數簽名、類定義、API 端點），系統會檢測到當前代碼與現有 Wiki 的不一致。你可以點擊更新僅重建受影響的部分。

   請將代碼變更控制在 10,000 行以內，以避免 Wiki 建置錯誤。

   # 核心模組
   
   <cite>
   **本文檔引用的檔案**
   - [src/app.js](file://src/app.js)
   - [src/index.js](file://src/index.js)
   - [src/utils.js](file://src/utils.js)
   - [README.md](file://README.md)
   </cite>
   
   ## 目錄
   1. [簡介](#簡介)
   2. [專案結構](#專案結構)
   3. [核心組件](#核心組件)
   4. [架構概覽](#架構概覽)
   5. [詳細組件分析](#詳細組件分析)
   6. [依賴分析](#依賴分析)
   7. [效能考慮](#效能考慮)
   8. [故障排除指南](#故障排除指南)
   9. [結論](#結論)
   
   ## 簡介
   
   WikiTest 是一個簡單的 JavaScript 應用程式，展示了基礎的模組化設計和物件導向編程概念。該專案包含三個核心模組：應用模組、工具模組和主入口模組。每個模組都有明確的職責分工，體現了單一職責原則和模組化開發的最佳實務。
   
   該專案的主要目標是示範：
   - 模組化 JavaScript 開發模式
   - 物件導向編程在前端和後端環境中的應用
   - 基礎的資料管理和操作模式
   - 簡單的使用者介面互動
   
   ## 專案結構
   
   專案採用扁平化的檔案組織圖，所有原始碼都位於 `src` 目錄下：
   graph TB
   subgraph "專案根目錄"
   Root[專案根目錄]
   subgraph "src 目錄"
   App[src/app.js<br/>應用模組]
   Index[src/index.js<br/>主入口模組]
   Utils[src/utils.js<br/>工具模組]
   end
   subgraph "文檔"
   end
   end

3. Git 目錄同步

   如果你直接在 Git 目錄中編輯 Markdown 檔案，系統會檢測到 Git 內容與 Wiki 不一致。你可以點擊同步將 Git 中的變更同步並更新 Wiki。

   請不要編輯 Git 檔案 repowiki/…/meta——這可能導致 Wiki 無法載入。該檔案由系統自動管理。

限制

• 每個專案最多 10,000 個檔案

  如果專案包含超過 10,000 個檔案，建議在 靈碼設定 → 程式碼程式庫索引 → 索引排除 中排除非必要路徑。

• 全量產生支援所有倉庫；累加式更新僅支援 Git 倉庫且至少包含一次提交。

Wiki共用

我們支援 Wiki 共用，助力團隊內的知識更高效流動。當你在本地產生 Wiki 時，系統會在代碼倉庫中自動建立一個專用目錄：.lingma/repowiki。

該目錄內部按語言和模組組織，例如 .lingma/repowiki/zh/content/ 下會按模組產生對應的 .md 檔案（如 核心模組.md、使用者服務模組.md、主入口模組.md 等）。

你可以將該目錄提交並推送到遠程分支。團隊成員隨後可通過git pull拉取產生的 Wiki 內容——無需額外配置。

多語言支援

Wiki 系統支援多語言——你可以在產生 Wiki 時選擇慣用語言。目前支援 English 和 中文。在產生 Wiki 時，系統會根據你的語言選擇，在 Git 目錄下為每種選定的語言自動建立獨立目錄（例如 repowiki/zh/、repowiki/en/）。

使用情境

• 架構與實現相關查詢
  智能體憑藉預構建的架構知識，幾乎無需調用工具，即可快速解答諸如“X 是如何?的？”或“哪些服務依賴此模組？”之類的問題。
  

• 智能體驅動的開發工作單位
  在上下文寬度受限時，Repo Wiki 可加速代碼定位，支援以下任務：
  

  • 添加新功能

  • 修複漏洞