前言¶
DeepSeek Harness (DSH) 生态强调“一切皆插件”。在使用 dsh-better-sidebar 时，默认的代码预览功能通常较为基础。dsh-code-nav 是一个配套插件，它接管侧边栏的代码预览，根据文件类型提供更专业的语法高亮、符号导航和文件内查找功能，解决代码阅读体验不佳的问题。
插件简介¶
dsh-code-nav 是 DSH Web 插件，作为 dsh-better-sidebar 的扩展存在。它通过扩展名识别语言，在侧边栏打开代码文件时自动接管预览。该插件由 AnakinCao 维护，采用 MIT 许可证。
核心功能¶
按类型语法高亮¶
根据文件扩展名自动识别编程语言，支持深浅色主题自动跟随。解析逻辑包含关键字、注释、字符串、类型、数字和函数等元素。
符号大纲切换¶
解析代码中的符号结构，包括类、接口、函数、变量等。支持按“全部 / 类 / 方法 / 变量”进行筛选，点击列表可定位到对应行。
文件内查找¶
在预览区域进行查找时，支持高亮全部匹配项和当前匹配项。支持 n / m 键计数，使用 ↑/↓ 或 Enter/Shift+Enter 进行上下跳转，并支持区分大小写切换。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add <dsh-code-nav-0.1.0.tgz>
- 重启
dsh web服务（新增 bundle 需 host 侧重载）。 - 在浏览器中硬刷新页面（
Cmd/Ctrl + Shift + R）。 - 在 better-sidebar 设置页的「侧边卡片」中，找到「代码预览导航」开关进行启用或关闭。
典型用法¶
安装并启用后，在 dsh web 的侧边栏打开代码文件即可生效。
* 导航：在符号大纲列表中点击，或使用键盘快捷键进行跳转。
* 查找：在查找框输入关键词，按 n 下一个，m 上一个，Enter 跳转。
适用场景与注意¶
- 适用场景：适用于需要快速浏览代码、查看语法高亮和符号导航的场景。
- 已知限制：
- 高亮与大纲基于轻量正则解析，非编译器级精度。在处理复杂泛型、宏、模板元编程时可能存在漏检或误检。
- 代码预览为只读模式。如需编辑，可在 better-sidebar 设置中关闭本插件以回退到内置编辑器。
- 单文件内容上限为 500KB，超出时仅显示提示。
- Vue / Svelte 文件仅高亮
<script>块中的 JS/TS 代码，模板部分不进行高亮。
