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。