# jsc-wiki

## 指令

### `/jsc-wiki:wiki [關鍵字]`

顯示 [JSC 知識庫](https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/wiki)（本 repo 的 wiki，一本書）的目錄；給關鍵字則跨章搜尋並讀取最相關的頁面。

```text
/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 |

```text
/jsc-wiki:database 怎麼安裝 PostgreSQL 並建立使用者
```

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

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

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

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

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

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

## 說明

- 讀取：第一次使用會 clone wiki 到 `~/.cache/jsc-wiki`，之後每次先更新，離線時用快取。
- 頁面格式：規則在 wiki 的 [頁面格式](https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/wiki/%E9%A0%81%E9%9D%A2%E6%A0%BC%E5%BC%8F) 頁，包含固定結構、簡化技術中文（參考 [ASD-STE100 skill](https://github.com/danyuchn/asd-ste100-skill)），以及繁體中文無亂碼、盡量用圖表。
- 寫入：`scripts/book.sh`（TypeScript，需要 Node 與 git；Node 不支援直接執行 TypeScript 時自動用 `npx tsx`）。推送需要 `tea` 的預設 login，或環境變數 `JSC_WIKI_TOKEN`。
- 新增領域：在 marketplace repo 的 clone 內執行 `book-import`，技能檔才會寫進 repo（可 commit）；寫進已安裝的插件目錄，下次更新插件時會消失。新指令需 `/reload-plugins` 後才會出現。
- 其他環境變數：`JSC_WIKI_URL`（wiki git 位址）、`JSC_WIKI_CACHE`（讀取快取）、`JSC_WIKI_WORK`（寫入工作副本）。

```bash
scripts/book.sh chapters                 # 列出章節與篇目
scripts/book.sh find redis               # 找已存在的主題
scripts/book.sh lint <頁面檔>            # 檢查格式
scripts/book.sh add-chapter "資訊安全" "防火牆與 SSH 加固。" --key security
```