前言¶
在 DeepSeek Harness（DSH）里和智能体协作时，常见做法是：对话在宿主窗口，文件树、编辑器、终端和 Git 差异分散在外部 IDE 或终端里。上下文要靠复制路径、粘贴代码片段带进会话，Agent 改完文件后还要切出去逐行对比 diff。
dsh-cursorlike-sidebar 是面向 DSH 的客户端插件，把文件浏览、代码编辑、Markdown 预览、Git 差异、原生终端、侧边对话和分屏嵌进 DSH 原生右侧栏，主题随 DSH 切换。维护者为 Oxygen-Wang，在 SkillHub 社区目录归类为客户端插件；与 Cursor / Anysphere 无隶属关系，是独立的 DSH 生态插件。
下面介绍插件定位、核心能力、安装步骤和典型用法。
这是什么¶
dsh-cursorlike-sidebar（npm 包名 dsh-cursorlike-sidebar）解决的是：让对话与项目文件在同一工作区内协作——浏览文件、把代码带入聊天、在 DSH 内审查 Agent 的编辑结果，而不必反复切换外部工具。
README 写明：插件基于 Better Sidebar v0.28.0 演进，改动审查交互参考 dsh-diff-approval；采用 MIT 许可证。安装前需停用原版 dsh-better-sidebar，二者不能同时启用。
核心功能¶
三种文件浏览视图¶
同一工作区可在文件面板工具栏切换：
- 桌面图标网格（默认）：三列排列，首格返回上级；适合直观浏览。
- 树形列表：展开目录层级，适合定位源码。
- Miller 多列：逐级目录并排展开，适合深层路径。
右键可打开文件、新建 Tab、侧边打开、添加引用或复制路径；支持多选、复制/剪切/粘贴、重命名、删除及操作历史。网格中 Ctrl + 滚轮可调图标大小（24–160px）；树形视图支持 10–32px 图标缩放。
Ctrl+L 与拖放：把上下文带入对话¶
选中文件或代码后按 Ctrl+L，将上下文加入当前对话：
- 文件浏览器：添加文件引用。
- 代码编辑器：有选区时添加行范围，无选区时添加当前行。
- Markdown 预览：选中文字映射到源码行号。
引用示例：@src/app.ts line 12-18。也可将文件引用或选中代码拖入聊天输入区。
根目录 .ignore 隐藏无关文件¶
在工作区根目录创建 .ignore，规则为 gitignore 风格 glob；仅读取根目录文件，不支持 ! 反向选择。也可把文件或文件夹拖到工具栏的 .ignore 眼睛图标自动追加规则。隐藏只影响展示，不删除磁盘文件。
node_modules
.cache
*.log
按块审查 Agent 修改¶
- 原生「第 N 轮改动」页默认单栏对比，可切左右分栏；连续改动行合并为一块，支持同意/不同意、全部同意/全部不同意，
Ctrl+K/Ctrl+J/Ctrl+Z。 - 编辑器内联显示 Agent 修改：按 hunk 保留 / Revert，可自动跳到下一处。
- 「更改」页按块审查本轮 write/edit；拒绝改动会立即写回磁盘。无法重建完整旧内容或磁盘不匹配时，diff 为只读并说明原因。
未处理的编辑器审查状态按会话与文件保存在本地，重启后在文件仍匹配待审版本时可恢复。
编辑、终端、分屏与可选集成¶
插件内提供代码编辑、Markdown 预览、搜索、Git 差异、原生终端与侧边对话；分屏便于并排查看。若已安装 dsh-diff-approval，还提供右侧栏 dock 集成与 Keep/Revert 快捷键转发。
插件保留 DSH 原有 Ctrl+B 行为；无需额外桌面软件或 Python 运行时，不包含 PDF 依赖。
安装与启用¶
适配 DSH 0.2.1-rc.1 及兼容版本。当前 npm 已发布版本为 0.28.0-cursorlike.4-beta.1（latest 指向该测试版）。安装或更新后需完全退出并重启 DSH。
先做： 停用 dsh-better-sidebar。
再做： 按所用 profile 选择下面一种方式（Web 用户将 desktop 换成 web）。
npm 安装或更新到 latest（推荐）：
dsh plugin --profile desktop add dsh-cursorlike-sidebar
固定版本：
dsh plugin --profile desktop add dsh-cursorlike-sidebar@0.28.0-cursorlike.4-beta.1
也可在 DSH「添加插件」中填写包名 dsh-cursorlike-sidebar。只有 npm / GitHub 来源能被 DSH Plugin Market 检查更新；本地 link: 与固定 tag 的 tarball 不会自动更新。
典型用法¶
1. 把选中代码引用进会话¶
在右侧栏打开目标文件，选中行范围，按 Ctrl+L。输入区会出现带行号后缀的 @file 引用，再向智能体提问即可，无需手抄路径。
2. 审阅一轮 Agent 改动¶
Agent 完成编辑后，在「第 N 轮改动」或「更改」页用 ↑ / ↓ 跳转修改块，Ctrl+K 同意、Ctrl+J 不同意；需要时用 Ctrl+Z 撤销上一步决定。全部处理完后，编辑器恢复为普通视图。
3. 收窄文件树噪音¶
在项目根新建 .ignore，写入 node_modules、构建目录或 *.log，刷新文件浏览器（F5），只保留与当前任务相关的树节点。
常用快捷键（随焦点上下文）¶
| 快捷键 | 作用 |
|---|---|
Ctrl+L |
文件、选区或当前行添加到会话 |
Ctrl+K / Ctrl+J |
同意 / 不同意当前改动块 |
Ctrl+Alt+K / Ctrl+Alt+J |
全部同意 / 全部不同意 |
F5 |
刷新文件浏览器 |
完整列表见 GitHub README · Shortcuts。
适用场景与注意¶
适合谁： 希望在 DSH 单窗口内完成「看文件 → 引用上下文 → 跑终端 → 审阅 Agent diff」的开发者；尤其需要 Miller 列、Markdown 预览行号引用、或分屏侧边对话的场景。
权限与安全： DSH 插件以当前 DSH 进程权限访问工作区与执行相关操作。安装前应阅读仓库源码与 LICENSE，确认符合团队策略。
生态说明： DSH 奉行「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
与同类插件： 本插件替代并扩展 dsh-better-sidebar 的使用场景；若已装 dsh-diff-approval，可获得可选的 dock 与快捷键集成，但并非必需。
结尾¶
经过上面的步骤，dsh-cursorlike-sidebar 把 Cursor 式右侧工作区搬进 DSH：文件树、编辑、Git、终端与 Ctrl+L 引用在同一栏完成，Agent 改动可在宿主内按块审阅。
