smalljs$mol搜尋⌘ K文件遊樂場比較生態系統關於ZH_HK
工具鏈Getting Started介紹心智模型快速開始從 TypeScript 到 view.tree專案結構工具鏈Essentials安裝視圖狀態與響應式路由渲染測試部署疑難排解Data資料獲取資料模式Giper BazaMore展示來自 React、Vue 和 Svelte食譜Advanced外掛模組元資料離線幽靈視圖About常見問題團隊發布API$mol_button_major$mol_button_minor$mol_string$mol_number$mol_text$mol_paragraph$mol_list$mol_row$mol_link$mol_check$mol_switch$mol_select$mol_scroll$mol_page$mol_pick

工具鏈

$mol 在任何編輯器中都能運作，但一小套工具能讓 .view.tree 和帶型別的樣式舒適得多：一個專案腳手架、一個語言伺服器、面向 Zed 和 VS Code 的編輯器整合，以及一個把框架教給 LLM 助手的技能。

用腳手架產生專案

create-view-tree-lsp 會產生一個開箱即用的 $mol 模組，這樣你就不必手工拼湊樣板程式碼：1npx create-view-tree-lsp bog/myapp請在自己的 MAM 檢出根目錄下執行：模組路徑從那裡解析，專案也該待在那裡。不在工作區裡時，指令會先警告，而不是讓你到第一次建置才發現。參數是模組路徑（namespace/name，或等價的 bog_myapp）。它會為一個可運行的應用寫出 view.tree、view.ts、view.css.ts 和 index.html，外加用於部署的 GitHub Actions。生成器能加的東西，預設全都加上。你只需要點名不想要的那些：1npx create-view-tree-lsp bog/myapp --no-tauri --no-backend--no-baza — local-first 儲存 Giper Baza--no-docker — 含 docker-compose.yml 與 nginx 設定的 Docker 設定--no-tauri — Tauri 桌面外殼--no-backend — 帶 node:sqlite 儲存和共享 TypeScript 項目型別的 $mol_server REST 後端--no-prerender、--no-seo — 搜尋引擎可見性，見下文 持續整合遇到不認識的旗標就停下，免得一個手誤悄悄把東西留在專案裡。腳手架只是語言伺服器中 CLI 的一層薄封裝，所以 npx view-tree-lsp create bog/myapp 會直接做同樣的事。

翻譯

翻譯檔案跟自己的模組放在一起，位於 <模組>/<名稱>.locale=<lang>.json。這對程式碼很方便，對譯者卻不然：他拿到的不是一份句子清單，而是三十個零碎檔案。 $yuf_localizer 正是為此而生。把專案網址和語言代碼告訴它，它就會把所有鍵匯成一份可搜尋的清單，並標出尚未處理的部分：只有英文的鍵、改動過但還沒提交的鍵，以及專案中已不存在的過期鍵。譯文保存在瀏覽器裡，直到你匯出為止，因此兩次工作之間不會遺失。譯者完成後，匯出結果並把它拆回各個模組：1# 在 MAM 根目錄下執行2npx view-tree-lsp locale bog/myapp/app/- --exclude=mol --update參數可以是資料夾，也可以是單一語言檔案。選項：每個鍵本身帶著所屬模組的路徑，所以 $my_page_greeting 會落到 my/page/page.locale=ru.json，就在它所屬的原始碼旁邊。不過要算出這個模組，比看起來更微妙：_ 既分隔資料夾也分隔字詞，因此「最長相符路徑」是錯誤答案。$my_page_lang_hint 的屬性名以 lang 開頭，若旁邊真的存在 my/page/lang 子模組，這個鍵就會被它吞掉。因此指令會逐一詢問候選模組宣告了哪些鍵——MAM 正是把這些鍵寫進它在 -view.tree 下的語言檔案——再把鍵交給真正的擁有者。

持續整合

腳手架會把 GitHub Actions 寫入 .github/workflows/，於是新專案無需額外設定即可部署和發布。deploy.yml 在每次 push 時運行。它用 hyoo-ru/mam_build 建置應用，從 main 把 app/- 發布到 GitHub Pages，並給每個 feature/* 分支各自的預覽資料夾——分支被刪除時會自動移除。

SEO

兩者預設都開著，也都在 v* 標籤上觸發：--no-prerender 去掉那一步：用 b-on-g/mol-prerender-action 把你列出的畫面（例如 home）算成靜態 HTML —— 爬蟲和連結預覽能看到真內容，靠的就是它。--no-seo 去掉 $bog_seo 執行期：帶網站地圖、robots.txt、llms.txt 和逐頁 meta 注入的 pathname 路由器。該工作會伺服建置產物、匯出規範的預先算好的 HTML，再摺回部署裡。兩者覆蓋同一片地、寫同一個目錄，所以 deploy.yml 裡只會留下一個：$bog_seo 開著就是它，一旦傳了 --no-seo 就換成預先算好的 action。需要網站地圖和逐頁中繼資料就留著 $bog_seo；如果活兒就是幾個公開畫面，退到預先算好的 action 即可。

Tauri 桌面

在 GitHub 上編輯此頁這有幫助嗎？是否上一頁專案結構下一頁安裝本頁內容用腳手架產生專案翻譯持續整合SEOTauri 桌面語言伺服器ZedVS CodeLLM 技能連結
Type to search the documentation.