Show HN: Shoaku – 你的程式設計導航器

Shoaku（意為“你的編碼導航器”）是一款專為 IntelliJ IDEA 設計的開源外掛，旨在解決 AI 生成程式碼速度過快導致人類難以理解和維護的問題。專案名稱“Shoaku”取自日語，寓意“程式設計導航者”，強調其引導開發者保持程式碼可控的角色。

背景與動機

隨著 AI 程式設計工具的發展，程式碼生成的速度已經超過了人類理解的速度。作者在專案的 README 中明確指出：“AI 可以比我們理解的速度更快地生成程式碼。當理解落後時，審查會減慢，維護風險增加。”Shoaku 的誕生正是為了應對這一挑戰，它致力於讓開發迴歸人性化的節奏，確保程式碼可理解、可維護，並且由開發者真正擁有。

技術架構

該外掛基於 Codex CLI 構建，需要 Node.js 22 或更高版本。Codex CLI 是 OpenAI 推出的命令列工具，能夠透過自然語言生成程式碼。Shoaku 將其整合到 IntelliJ IDEA 中，開發者可以在 IDE 內直接利用 AI 輔助編碼，同時保持對程式碼的完全控制。專案的架構細節可以在 architecture.md 文件中找到。

專案狀態與資料

截至最新統計，Shoaku 在 GitHub 上擁有 1 個星標、0 個復刻和 0 個關注者。儘管社群規模較小，但專案已釋出 17 個版本，最新版本為 v0.1.3（2026 年 6 月 29 日）。程式碼倉庫包含 110 次提交，主要由 Kotlin（67.4%）和 JavaScript（32.6%）編寫。專案結構包括典型的 Gradle 構建檔案、伺服器模組和 IntelliJ 外掛原始碼。

核心功能與特色

Shoaku 的核心功能是透過 AI 生成程式碼的同時，確保開發者能夠理解每一行程式碼的意圖。它不會自動將 AI 生成的程式碼直接應用到專案中，而是以建議的形式呈現，由開發者決定是否採納。這種方式避免了程式碼被盲目引入，減少了潛在的錯誤和難以維護的“黑盒”程式碼。

此外，Shoaku 強調“人類節奏”的開發流程。它透過互動式對話和清晰的程式碼解釋，幫助開發者逐步構建程式碼，而不是一次性生成大量內容。這對於團隊協作尤為重要，因為可理解的程式碼更容易被同事審查和修改。

適用場景與意義

Shoaku 適合那些希望利用 AI 提高程式設計效率，但又不願意犧牲程式碼質量和可維護性的開發者。它特別適用於大型專案或需要長期維護的程式碼庫，因為這類專案對程式碼可讀性有更高的要求。

在 AI 輔助程式設計工具層出不窮的今天，Shoaku 提供了一種不同的思路：讓 AI 成為“副駕駛”而非“駕駛員”。這種理念有助於避免開發者過度依賴 AI，從而保持對軟體工程的深入理解。

總結

Shoaku 是一個有潛力的 IntelliJ 外掛，它針對 AI 時代程式碼理解滯後的問題提出了切實的解決方案。雖然目前仍處於早期階段（v0.1.3），但其設計哲學和技術實現值得關注。對於關心程式碼質量和團隊效率的開發者來說，Shoaku 是一個值得嘗試的工具。