常見問題_通義靈碼_智能編碼助手 - AI Coding Assistant Lingma

靈碼的啟動和登入、支援語言、資料安全、收費和OpenAPI等相關問題，可以在本文找到相關答案。

說明

如果在使用的過程中遇到問題，可先嘗試重啟 IDE。重啟後依然無法解決，可加入DingTalk群：53770000738，我們將儘快為您解決問題。

關於外掛程式啟動、登入失敗、無許可權提示

1. 提示“靈碼啟動中”怎麼辦？

如果在使用靈碼時看到“靈碼啟動中”的提示，您可以按照以下步驟逐一排查並解決問題。

檢查版本與運行環境：
- 確保您已將靈碼升級至最新版本，並確認您的作業系統和系統架構支援靈碼運行。
- 如果您使用的是 Jetbrains IDE，請進行以下檢查：保證 IDE 的堆記憶體大小足夠。操作步驟：依次點擊 File -> Invalidate Caches，清理緩衝後重啟 IDE。
網路連接與代理配置：
- 確保以下地址可以正常訪問。如果無法訪問，請聯絡公司 IT 部門將其加入白名單：
  - 執行命令：
```
curl https://lingma.alibabacloud.com/algo/api/v1/ping
```
    傳回值應為 pong。
- 如果公司防火牆限制且無法加白名單，需手動設定Proxy 位址（具體地址請聯絡公司 IT 提供）：
  代理格式：http(s)://使用者名稱:密碼@Proxy 伺服器地址:連接埠
  - 如果網域名稱儲存未生效，可手動修改設定檔：
    路徑：C:\Users\使用者名稱\AppData\Local\.lingma\config.json
    修改 http_proxy 欄位後，結束靈碼進程並重啟。
- 清理 DNS 緩衝：
  - Windows：執行命令 ipconfig /flushdns
  - macOS：執行命令 sudo killall -HUP mDNSResponder
清理本機快取並重新啟動 IDE。以管理員權限啟動 IDE，開啟一個非空專案檔夾後，嘗試以下操作：
1. 結束 Lingma 進程。
2. 刪除 .lingma 目錄：
  1. Windows：路徑為 C:\使用者\[使用者名稱]\.lingma
  2. macOS：路徑為 ~/.lingma
3. 完成上述操作後，重新啟動 IDE。
手動啟動 Lingma 服務。如果問題仍未解決，可嘗試手動啟動 Lingma 服務：
進入目錄：.lingma/bin/x.x.x/CPU架構_64_系統/
執行命令：
```
Lingma.exe start
```
等待啟動成功後，重新點擊登入按鈕。
解決“不相容的程式”問題：如果在 Windows 上收到“不相容的程式”提示，可能是由於解壓不完整導致的。解決方案如下：
- 點擊右下角的靈碼表徵圖，選擇 進階設定。
- 修改解壓路徑為非 C 盤的其他路徑，並確保路徑以空檔案夾結尾。
- 重啟 IDE 後重試。
說明
注意：部分公司內網會對二進位程式進行加鎖，導致無法運行。
防火牆或安全軟體限制：如果 Lingma 進程仍然無法正常啟動或登入無反應，可能是因為防火牆或公司安全軟體限制了運行。請按以下步驟操作：
- 添加防火牆白名單：
  開啟控制台 -> 系統和安全 -> Windows Defender 防火牆 -> 允許的應用，將 Lingma 加入白名單。
- 在公司安全軟體中添加進程檔案白名單：
  路徑樣本：C:\Users\xxx\.lingma\bin\2.1.x\x86_64_windows\lingma.exe
  （請聯絡公司 IT 技術服務人員協助完成。）
- 如果靈碼的 JetBrains 外掛程式版本為 2.1.4 或更高版本，您可以按下圖所示切換到 stdio 模式：

2. 顯示登入失敗、無許可權怎麼辦？

當從 IDE 用戶端單擊登入後，會前往瀏覽器登入阿里雲，出現登入失敗或帳號無許可權，可能有 2 種情況：

當登入參數失效時，可能會出現登入失敗的情況，可稍後在 IDE 用戶端單擊登入，再次嘗試登入。
當所在的網路環境需要使用代理訪問公網時，可能會提示登入失敗或帳號無許可權，需將靈碼升級到最新版本，確保以下 host 可訪問，如發現網路不通，需要添加白名單，可參考網路代理程式配置解決問題。

curl  https://lingma.alibabacloud.com/algo/api/v1/ping

配置完成後從進程管理器裡找到 Lingma 進程，結束進程後，返回 IDE 重新登入。

3. Remote SSH、WSL 等進行遠程開發時，如何登入靈碼？

在使用 VS Code、JetBrains IDEs 上串連遠程伺服器進行開發時，可使用阿里雲帳號的 AK/SK 進行登入後使用靈碼。查看詳細方式：安裝和登入。

4. Web IDE 中可以使用靈碼嗎？

可通過阿里雲帳號的 AK/SK 進行登入後使用，安裝和登入。

關於網路問題

1. 如何配置網路代理程式？

靈碼支援 HTTP、HTTPS、Socks5 網路代理程式配置，可在外掛程式設定頁進行配置，具體操作參考：網路代理程式配置。

2. 如何測試網路連通性？

可以嘗試在 Terminal 中輸入以下命令，如果返回 pong，則大機率可連通至靈碼服務端。

curl  https://lingma.alibabacloud.com/algo/api/v1/ping

3. 遇到網路問題如何排查？

為了更好地協助你解決問題，請按照以下步驟操作並提供相關資訊：

請進入“Lingma 設定” > “網路” > 運行診斷，並將完整的診斷結果發送給我們。
你當前是否正在使用 VPN、代理或商業網路？如果是，請嘗試關閉這些服務或將網路切換至其他串連。
嘗試在聊天介面中選擇不同分級的模型，觀察響應速度是否有改善。
如果以上操作後問題仍然存在，請進一步提供以下資訊以便我們深入調查：
- 發生延遲的具體樣本提示及對應的時間戳記；
- 開啟“協助”>“切換開發人員工具”> 查看控制台錯誤記錄檔並截圖發送；
- 此問題是在所有專案中都出現，還是僅限於某個特定的工作區？
- 此問題在相同網路下的其他使用者是否能複現？
以上資訊通過”問題上報”功能進行反饋。

關於收費

1. 靈碼如何收費？

面向個人開發人員提供個人基礎版、個人專業版，個人專業版當前為限時免費使用階段，所有使用者均可享受個人專業版服務，限免期結束後，也會對所有開發人員免費提供個人基礎版服務，限免周期暫未確定，敬請關注後續產品公告。企業版計費資訊可參考：計費說明。

關於帳號

1. 使用什麼帳號進行登入體驗靈碼？

需要使用阿里雲帳號登入後體驗靈碼，在 IDE 用戶端的靈碼助手視窗中單擊登入按鈕，即可完成阿里雲登入。如果您還未註冊阿里雲帳號，請首先完成帳號註冊。

關於支援的 IDE、系統、語言

1. JetBrains IDEs 版本相容是多少？

目前 JetBrains IDEs 相容 2020.3（203.x）及以上，包含 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDEs。

2. Visual Studio Code 版本相容是多少？

目前 Visual Studio Code 相容 1.68.0 及以上。

3. Visual Studio 2022 版本相容是多少？

目前相容 Visual Studio 2022 17.3.0 及以上版本。

4. 支援作業系統版本有哪些？

JetBrains IDEs 相容的作業系統：Windows 7 及以上、macOS、Linux。
Visual Studio Code 相容的作業系統：Windows 7 及以上、macOS、Linux
Visual Studio 2022 相容的作業系統：Windows 10 及以上

5. 支援哪些程式設計語言？

全面覆蓋主流程式設計語言，在 Java、Python、Go、JavaScript、TypeScript、C/C++、C# 編碼情境表現更優。

關於資料安全和品質

1. 靈碼會儲存My Code資料嗎？

我們不會儲存您的代碼資料：

代碼補全時，我們需要擷取您的代碼上下文資訊以完成補全，但上下文資訊不會被儲存或用於其他任何目的，該等資料完全由您所有及控制。
研發智能問答時，我們僅會在您點踩/點贊後，僅針對聊天記錄（不包含代碼），並將資料進行脫敏、去標識化處理後，用於演算法的升級、迭代。

更多隱私政策，可前往靈碼隱私政策。

2. 靈碼的訓練資料包含哪些？

訓練資料主要包含優質開原始碼、技術社區文章和技術文檔、阿里雲的雲端服務文檔、阿里雲 SDK/API 使用文檔等。

3. My Code片段會與其他使用者共用嗎？

不會。使用大模型進行代碼補全時，我們需要擷取您的代碼上下文資訊以完成補全，但上下文資訊不會被儲存或用於其他任何目的，該等資料完全由您所有及控制。

4. 靈碼產生的程式碼可以直接使用嗎？

靈碼產生的程式碼只是建議代碼，無法確保其可用性，需要開發人員自行對代碼進行審核和決定是否採納。

使用過程中可能的問題

1. 如果發現 Lingma 進程佔用 CPU 或記憶體過高怎麼辦？

情況1：可能因為您的代碼工程檔案較多，導致代碼索引時消耗 CPU 或記憶體過高，可以在工程根目錄建立 .tongyiignore 檔案，將不需要索引的目錄或檔案排除，從而減少索引時的 CPU 或記憶體佔用，.tongyiignore 內容格式與 .gitignore 相同，修改 .tongyiignore 內容後，手動結束 Lingma 進程後配置即可生效。
情況2：可能是因為開啟了本地離線模型，本模型會佔用 500M 左右記憶體，如您無需使用離線模型，可在設定中關閉離線模型補全功能。

2. VS Code 提示延伸主機意外終止

如果您遇到以下錯誤資訊：“extension host terminated unexpectedly 3 times within the last 5 minutes 延伸主機在過去5分鐘內意外終止3次”。

問題原因：這通常是由某個外掛程式導致的記憶體流失。可先按照擴充二等分法確認崩潰是否由靈碼外掛程式導致。

解決方案：如果確認是該外掛程式引起，可按照以下方式解決：

重裝 VS Code 後重啟系統（推薦）。
Windows 使用者：關閉安全軟體或對code.exe進行加白。

如果問題依舊存在，請加入DingTalk群：53770000738，並提供以下資訊：

作業系統版本和 VS Code 版本。

收集 verbose 日誌：

完全退出 VS Code。
命令列中執行code --verbose啟動 VS Code。
執行導致崩潰的操作。

檢查輸出的日誌，類似2、3行會給出崩潰的初步原因，技術人員才能更快定位到外掛程式裡的代碼。如：

[main 2025-05-02T14:35:31.249Z] [UtilityProcess id: 3, type: extensionHost, pid: 25816]: received exit event with code 18446744072635810000
[main 2025-05-02T14:35:31.249Z] Extension host with pid 25816 exited with code: 18446744072635810000, signal: unknown.
[main 2025-05-02T14:35:31.250Z] [UtilityProcess id: 3, type: extensionHost, pid: 25816]: crashed with code -1073741819 and reason 'crashed'
[19684:0502/223531.251:INFO:CONSOLE(3255)] "Extension host (LocalProcess pid: 25816) terminated unexpectedly. Code: 18446744072635810000, Signal: unknown", source: vscode-file://vscode-app/d:/Microsoft%20VS%20Code/resources/app/out/vs/workbench/workbench.desktop.main.js (3255)

若上述日誌無法確認是外掛程式裡的代碼引起，需參考 Native-Crash-Issues 收集更詳細的崩潰日誌：
1. 完全退出 VS Code。
2. 命令列中執行 code --crash-reporter-directory <絕對路徑>。
3. 執行會導致崩潰的操作。
4. 尋找第二步的目錄下是否有一個.dmp尾碼的檔案，並將其發送給技術團隊。

3. VS Code外掛程式中的個人中心頁面報錯怎麼辦？

如果您看到以下報錯資訊，"Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state."

這是一個 VS Code 1.56 中的已知問題，當某些 Windows 使用者以管理員身份運行 VS Code 時，就會發生這種情況。您可以嘗試以下方式進行解決。

方式1： --no-sandbox 命令列標誌啟動 VS Code：
```
$ code --no-sandbox
```
方式2：關閉 VS Code，然後在終端中嘗試運行：killall code

4. 在 JetBrains IDEs 中安裝靈碼完成後，側邊欄不顯示`Lingma`按鈕怎麼辦？

一般來說，安裝完成後，Lingma助手按鈕會預設顯示到 IDE 側邊欄。如遇到不顯示的情況，您可選擇view > Tool Windows > Lingma（視圖 > 工具視窗 > 通義靈碼）手動顯示。

5.Lingma 啟動失敗，提示“檔案路徑找不到”怎麼辦？

當 Lingma 啟動失敗並報錯提示檔案路徑不存在/找不到時，可按以下步驟排查並修複：

在編輯器中使用 Ctrl/Cmd + Shift + P 開啟命令選擇區，搜尋並進入 User Settings（Open User Settings (JSON)）。
在開啟的 settings.json 中尋找是否存在配置項：Lingma.LocalMachineStoragePath。
若存在：
1. 檢查該配置項對應的路徑是否真實存在且可訪問，並按需修正為有效路徑；或
2. 直接刪除該配置項。
儲存配置後，重啟/重新載入視窗，再次啟動 Lingma，確認是否恢複正常。

OpenAPI相關問題

1. 每頁查詢的資料量是否有上限？

建議不超過10000條。但是在進行資料查詢與展示時，設定每頁查詢的資料量上限對於確保系統效能和最佳化使用者體驗至關重要，具體數值應根據實際應用情境及系統能力靈活調整。

2. API的資料在每天淩晨更新，更新頻率是什嗎？

API 資料從每日淩晨開始每15分鐘更新一次，通過多重校正機制確保資料的即時性、可靠性和靈活性。所以在淩晨兩點是可以擷取到昨天最新且準確的完整資料集。

3. API使用頻率有沒有要求？

為確保服務穩定高效，我們的 API 呼叫頻率上限為 100 QPS，即每秒最多 100 次請求。

4. organizationId 擷取方式

在靈碼控制台右上方的頭像，單擊管理後台，然後在基本資料頁面複製組織ID 。

莫小@1x