llm-wiki-sidebar：DSH 側邊欄內的 LLM Wiki 工作臺

前言¶

DeepSeek Harness 的內置側邊欄支持文件瀏覽。llm-wiki-sidebar 將此擴展爲一個 Wiki 工作臺，允許在側邊欄中直接瀏覽和檢查 Karpathy 風格的互連 Markdown Wiki。它提供可點擊的 [[wikilinks]]、溯源鏈接、反向鏈接，並內置了 Wiki Lint 工具和 llm-wiki 代理技能。

安裝¶

通過官方 CLI 安裝插件，然後重啓 DeepSeek Harness：

dsh plugin --profile web add "github:ApeInCodeMountain/llm-wiki-sidebar"

安裝後，請重啓 dsh --profile web 並強制刷新瀏覽器（Cmd/Ctrl+Shift+R）。

核心功能¶

1. Wiki 側邊欄標籤頁¶

在側邊欄中，該插件註冊了一個專門的標籤頁，用於管理 Wiki 內容：
* 目錄結構：按實體、概念、比較和查詢分頁。
* 搜索與篩選：支持按 slug、標題或標籤搜索。
* 質量標記：顯示質量信號，如 conf: low 或 contested。
* 操作：提供“一鍵打開爲文件資源”、“刷新”按鈕，並將頁面刷新快捷鍵綁定到產品命令。

2. Wiki 頁面渲染¶

位於 Wiki 根目錄內的 .md 文件由該插件的資源標籤頁類型接管，使用 markdown-it 渲染（支持 GFM 表格、圍欄代碼、引用、列表、圖片）。
位於 Wiki 根目錄之外的文件將保持產品原生的文檔預覽行爲。

3. 可點擊的 `[[wikilinks]]`¶

支持 [[target]] 和 [[target|label]] 格式，根據 Wiki 地圖解析鏈接。
未解析的鏈接會渲染爲刪除線並顯示提示。
渲染過程在源文本層面進行，不會將鏈接寫入磁盤，文件保持不變。

4. 標題錨點¶

[[page#section]] 打開頁面並滾動到指定標題。
[[#section]] 在當前頁面內跳轉。
匹配規則接受標題文本或 slug（GitHub 風格），支持 Unicode，因此中文標題也適用。

5. 溯源與相對鏈接¶

溯源標記（如 ^([來源](raw/...))）和任何相對 Markdown 鏈接均通過目錄的同一資源路徑打開。

6. 反向鏈接¶

每個 Wiki 頁面底部顯示一個“🔗 Linked here (N)”欄，列出鏈接到此頁面的文檔。

7. 源碼 / 預覽切換¶

在側邊欄內無需離開即可查看原始 Markdown（包含 frontmatter）。
frontmatter 字段在預覽上方渲染爲緊湊的芯片行。

8. Lint 報告¶

提供 12 項檢查：斷鏈、孤立頁面、索引完整性、frontmatter 驗證、過時頁面、爭議標記、質量信號、SHA256 源漂移、頁面大小、標籤分類、日誌輪轉。
檢查結果按嚴重性分組。
CLI 端同樣提供 scripts/wiki_lint.py 腳本執行相同檢查。

9. 多 Wiki 管理¶

默認 Wiki 位於 <workspace>/wiki。
插件會自動發現工作區內符合 Wiki 結構的兄弟目錄（例如包含 SCHEMA.md 或 index.md 以及 entities/ 或 raw/ 目錄的文件夾），並在標籤頁標題中顯示切換器。
頁面渲染通過最長前綴匹配跟隨文件所屬的 Wiki 根。
可通過 wikiRoots 插件配置顯式註冊額外根目錄。

10. llm-wiki 技能¶

插件打包了 llm-wiki 技能。
該技能通過獨立的 dsh-skill-filesystem 實例掛載，確保插件和技能作爲單元安裝和卸載。

典型用法¶

初始化 Wiki¶

在對話中告訴代理：“幫我在這個工作區初始化一個 wiki”或“create a wiki here”。打包的 llm-wiki 技能會創建 wiki/ 目錄，包含 SCHEMA.md、index.md、log.md 及分層目錄結構，並自動攝取源數據。

瀏覽與檢查¶

打開右側側邊欄，找到 📚 LLM Wiki 標籤頁。
在目錄中瀏覽，使用搜索功能定位頁面。
點擊頁面打開，查看渲染後的內容、可點擊的 [[wikilinks]] 以及底部的反向鏈接。
使用 Source 查看原始 Markdown。

多 Wiki 場景¶

若需要在同一工作區管理多個知識庫，創建一個同級的 Wiki 目錄（約定命名如 wiki-game/），並保持相同的分層佈局。側邊欄會自動發現它，標籤頁標題會出現 Wiki 切換器。每個 Wiki 保持獨立的 slug 命名空間；跨 Wiki 引用使用相對 .md 鏈接。

注意事項¶

版本要求：需要 DeepSeek Harness 版本 0.1.7-rc.2 或更高，且必須包含內置的右側邊欄（@deepseek-ai/dsh-client-ui-sidebar-right）。
插件衝突：不需要第三方側邊欄插件。必須移除 dsh-better-sidebar 插件，因爲它與內置側邊欄衝突。
許可證：MIT。