Files
jsc-marketplace/plugins/jsc-wiki

jsc-wiki

指令

/jsc-wiki:wiki [關鍵字]

顯示 JSC 知識庫(本 repo 的 wiki,一本書)的目錄;給關鍵字則跨章搜尋並讀取最相關的頁面。

/jsc-wiki:wiki traefik

/jsc-wiki:<領域> [主題]

依領域讀取對應章節。不給主題時列出該章篇目,給主題則讀取對應頁面回答。

指令 章 內容
/jsc-wiki:system 1 系統維護 時區、磁碟延展、憑證、busybox、Kernel Panic
/jsc-wiki:network 2 網路與儲存 netplan、53 埠、SMB、TGT、OpenSSH、OpenWrt、DSM
/jsc-wiki:virt 3 虛擬化 Proxmox VE、直通、Hyper-V、WSL
/jsc-wiki:container 4 容器與編排 Docker、K3s、k3d、Traefik
/jsc-wiki:database 5 資料庫與搜尋 PostgreSQL、SQL Server、Redis、Elasticsearch
/jsc-wiki:dev 6 開發與持續整合 Gitea、Runner、GitLab、ASP.NET、Django、Coder
/jsc-wiki:ai 7 AI 工具 ccstatusline、CLIProxyAPI、OpenClaw、OpenCode、PicoClaw
/jsc-wiki:apps 8 應用服務 Emby、MeTube、Vaultwarden、ezBookkeeping
/jsc-wiki:database 怎麼安裝 PostgreSQL 並建立使用者

/jsc-wiki:book-search <主題>

到網路蒐集主題的知識,交叉驗證後依頁面格式整理成草稿(~/.cache/jsc-wiki/drafts/)。只產生草稿,不修改 wiki。

/jsc-wiki:book-search Caddy 在 Ubuntu 安裝與反向代理

/jsc-wiki:book-import <草稿路徑>

把草稿加入 wiki:判斷領域與章節 → 主題已存在就修改該頁,否則新增 → 套用頁面格式 → 重建目錄與上下頁導覽 → lint → 確認後推送。沒有合適的章節時可新增領域,並自動產生對應的 /jsc-wiki:<領域> 技能。

/jsc-wiki:book-import ~/.cache/jsc-wiki/drafts/caddy-ubuntu-reverse-proxy.md

說明

  • 讀取:第一次使用會 clone wiki 到 ~/.cache/jsc-wiki,之後每次先更新,離線時用快取。
  • 頁面格式:規則在 wiki 的 頁面格式 頁,包含固定結構、簡化技術中文(參考 ASD-STE100 skill),以及繁體中文無亂碼、盡量用圖表。
  • 寫入:scripts/book.sh(TypeScript,需要 Node 與 git;Node 不支援直接執行 TypeScript 時自動用 npx tsx)。推送需要 tea 的預設 login,或環境變數 JSC_WIKI_TOKEN。
  • 新增領域:在 marketplace repo 的 clone 內執行 book-import,會同步更新插件 README、市集 README、marketplace.json、plugin.json 的指令清單並升一個修訂版本,技能檔也才會寫進 repo(可 commit);寫進已安裝的插件目錄,下次更新插件時會消失。新指令需 /reload-plugins 後才會出現。
  • 其他環境變數:JSC_WIKI_URL(wiki git 位址)、JSC_WIKI_CACHE(讀取快取)、JSC_WIKI_WORK(寫入工作副本)。
scripts/book.sh chapters                 # 列出章節與篇目
scripts/book.sh find redis               # 找已存在的主題
scripts/book.sh lint <頁面檔>            # 檢查格式
scripts/book.sh add-chapter "資訊安全" "防火牆與 SSH 加固。" --key security