DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-code-viewer

d

dsh-code-viewer

Manifest valid

VS Code-style tab in the right Sidebar: workspace file tree, a multi-tab editor with syntax highlighting that saves with mtime conflict checks, whole-workspace search and replace, quick open and a com

UI (client)hasBundlePatch

CodeIDE icon

CodeIDE · VS Code 风格的右侧栏面板

为 DeepSeek Harness Web GUI 增加一个右侧栏标签页(kind = code),形状与 VS Code 一致:

┌──────────────────────────────────────────────────────┐
│ 代码  ·  main            [文件] [Git 图谱] [引用] [↻] │
├───────────────┬──────────────────────────────────────┤
│ 工作区文件树   │ 文件内容(行号 + 语法着色)            │
│ 懒加载目录     │ 或 Git 泳道图 / 单次提交 diff          │
└───────────────┴──────────────────────────────────────┘

它是带编辑能力的查看器:可以保存文本文件(带 mtime 冲突检测),但不改 Git 状态——不做暂存、提交、checkout、分支操作。

能力

  • 多标签编辑(预览 / 固定):文件树单击是预览——只占用同一个预览标签位,再点别的文件就替换,不会越点越多(标签名用斜体标出);双击才把它固定成常驻标签。在预览标签里打字、或双击标签本身,也会固定。标签条可切换、关闭(含中键)与批量保存/关闭;右键标签(或标签栏空白处)有「关闭 / 关闭其它标签 / 关闭右侧标签 / 关闭左侧标签」,预览标签另可「固定」。切换标签前先落盘,未保存且有冲突时先确认放弃;切回标签会恢复滚动位置与选区。
  • 全工作区搜索与替换:新增「搜索」页,支持字面/正则、区分大小写、整词与包含 glob;结果按文件分组,点结果打开文件并定位到行;「全部替换」与单文件替换都先确认,服务端逐文件校验(仅工作区内普通文本、≤ 2 MB、跳过二进制、拒 .git,最多 200 文件 / 5000 处)。
  • 快速打开与命令面板:Ctrl+P 按名字模糊查找工作区文件(支持 路径:行号 直接跳行,输入 > 切到命令模式),Ctrl+Shift+P 打开命令面板,Ctrl+Shift+F 打开搜索页;这些键只在面板获得焦点时生效,嵌在面板里的终端仍把按键交给 shell。
  • 左侧文件树:按工作区根目录懒加载(remote.workspaceFiles.list),默认隐藏 .git、node_modules、dist 等目录,可用标题栏的漏斗按钮显示;已修改/新增/删除/未跟踪文件带 M/A/D/U 角标。
  • 右侧文件内容:remote.workspaceFiles.read 按行分页读取(一次最多 3,000 行,超出提示截断),带行号、横向滚动与轻量语法着色;标题前显示该文件的 Material 图标。
  • 语言渲染细化:
    • Python:三引号字符串(docstring)跨行着色、装饰器 @name、f"…"/rb'…' 前缀字符串、self/cls/内置函数与异常名单独着色;
    • C++:独立关键字表(namespace/template/concept/constexpr/override/auto 等)、#include/#define 等预处理行整行着色、std/string/vector/size_t 等标准名着色;.h 按 C++ 处理;
    • JSON:属性名与字符串值区分着色,数字与 true/false/null 单独着色;默认按 2 空格格式化显示,标题栏可切「格式化 / 原始」;解析失败、或格式化后超过 600 KB / 5000 行时自动保留原始文本;.jsonc 支持注释后再格式化;
    • Markdown:默认渲染(标题层级、粗体/斜体/删除线、行内代码、列表、引用、分隔线、链接、代码块——代码块里的 Python/C++/JSON 等继续按语言着色),标题栏可在「渲染 / 源码」之间切换;
    • 其余常用语言:C、C++、C#、Java、Kotlin、Scala、Go、Rust、Swift、Dart、PHP、Perl、Lua、R、Julia、Haskell、Elixir、Erlang、Clojure、Elm、F#、OCaml、Nim、Zig、Solidity、Groovy、HCL/Terraform、Nix、PowerShell、Batch、Assembly、Vim script、TeX、Protobuf、GraphQL、CMake、Makefile、Dockerfile、Diff/Patch、HTML/XML/Vue/Svelte(标记语法单独扫描:标签、属性、注释、字符串)。
    • 语言识别按扩展名与特殊文件名(Dockerfile、Makefile、CMakeLists.txt 等),.h 按 C++、.mm/.m 按 C 处理。
  • Git 图谱(只读):全部分支的提交泳道图、分支/标签装饰、作者与时间;点任一提交进入该提交的可点击改动文件列表,下方按 修改前 / 修改后 分栏对比选中文件(默认选中第一个文件,点击其他文件即切换),可返回图谱。
  • 命令行分栏(默认打开,可收起):面板底部内嵌一个命令行,使用 Harness 自带的 terminal 服务(ctx.webTerminals)驱动真实 shell(与自带终端标签是同一个 PTY 栈)。优先使用内置的 xterm.js(vendor/xterm.mjs,MIT,见 vendor/LICENSE-xterm)渲染,键盘输入、选中复制、滚回都与自带终端一致;环境缺少 ResizeObserver/matchMedia 或资产加载失败时自动退回文本渲染(去 ANSI、支持命令历史 ↑/↓ 的简易终端)。收起分栏只断开视图,shell 进程保留,重新展开即恢复;标题栏的终端按钮可随时收起/打开,分栏头部的「在自带终端标签中打开」会打开 Harness 自带的终端标签。
  • 可拖拽布局:文件树与内容之间、内容与命令行之间各有一条分隔条,可左右/上下拖拽调整大小(树 140px 起、命令行 110px 起,按面板尺寸自动限幅)。
  • 一键引用(同一个键两种行为,Ctrl+L 与 Ctrl+Shift+L 都绑定此功能):
    • 面板未打开:打开该标签页并聚焦;
    • 面板已打开:把当前正在看的文件以 @文件 原子引用插入对话框光标处;编辑器里有框选时,草稿文本带行号区间(@文件:12 或 @文件:12-20),芯片本身仍指向文件(若内部引用通道不可用,则退化为插入 @路径 纯文本),并把键盘焦点交还输入框(SessionInput.focus(),光标停在刚插入的引用之后,可以直接继续打字)。
    • 两个键通过 Harness 的固定键动作注册,因此不受 Web 快捷键准入限制(Web/Linux 只允许 Ctrl+/ 等三种组合);面板空态与「引用」按钮的提示会显示当前真正生效的按键。
    • 注意:浏览器把 Ctrl+L 当作地址栏快捷键,网页收不到该按键,所以 Web 端实际可用的是 Ctrl+Shift+L;桌面客户端两个键都可用。
  • 中文/英文文案,浅色/深色主题,全部使用 --dsw-* 主题变量。

图标

文件树与文档标题的图标使用 Material Icon Theme(MIT,Copyright (c) 2025 Material Extensions, https://github.com/material-extensions/vscode-material-icon-theme)的官方素材子集,按扩展名/文件名/文件夹名映射, 以内联 data URL 渲染(不联网、不依赖 host 额外路由)。完整许可文本见 LICENSE-material-icon-theme;重新生成用 scripts/gen-icons.mjs。

  • 文件:94 个扩展名 + 36 个特殊文件名(package.json、Dockerfile、README.md、LICENSE 等);
  • 文件夹:21 个常见目录名各有闭合/展开两套图标(src、node_modules、.git、dist、test、docs 等),其余用通用 folder;
  • 浅色/深色:Material 的两套浅色变体(toml、pnpm)会跟随页面主题自动切换,主题切换时图标即时重绘。

组成

半边文件职责
Hostindex.js/plugins/code-viewer 路由:/repo、/log、/commit、/status、/stat、/search、/files、POST /replace、POST /write、POST /mkdir、POST /touch、POST /rename、POST /delete、POST /copy、POST /reveal、/file(图片)、/asset(xterm)
Clientclient.js右侧栏 tab 类型 + 面板 UI + 快捷键 + 引用桥接

读取文件内容走 Harness 自带、按会话授权的 remote.workspaceFiles;仓库历史、图片、xterm 资产和保存走 index.js 的路由。保存接口有独立的路径校验与大小上限。

安全边界

  • Git 只读:只有 rev-parse、log、show、diff、status 这类查询命令,参数由插件固定,调用方只能给目录、提交 hash 与条数。
  • 保存:POST /write 只写已存在的普通文本文件;路径必须解析在工作区内(含软链 realpath 校验)、拒绝 .git/ 内部;body 上限 8 MiB;带 baseMtime 时与磁盘 mtime 不一致返回 409,不会静默覆盖。不新建、不删除文件。
  • 提交 hash 用 ^[0-9a-f]{4,40}$ 校验,避免参数注入;目录必须存在且为绝对路径。
  • Git 子进程禁用交互提示、hooks、可选索引写入与惰性拉取,单命令 8 秒超时、8 MiB 输出上限、LC_ALL=C。
  • 路由先过 DSH 的 connection 访问检查(ctx.connection.requestRejection,与 /api 同一套 Host/DNS-rebinding 与 Origin 校验加浏览器凭据认证):未认证返回 401、不受信 Host 或跨站请求返回 403,且这项检查在方法判定与任何文件、Git 访问之前执行;没有 connection 服务时路由直接拒绝(401),不会失去保护地继续服务。

安装

需要 DSH >=0.2.2-rc.1 <0.3.0。从 GitHub 安装:

dsh plugin add github:Kingzhoudk/dsh-code-viewer
# 等价的显式 git spec
dsh plugin add git+https://github.com/Kingzhoudk/dsh-code-viewer.git

也可以在 Web 的 Plugins 页安装,或让 agent 调用 plugin_manager (action install_bundle,target 用同一 spec)。插件管理器会写入 profile 依赖并启用这个 bundle;开发时可改用 dsh plugin add link:<本仓库绝对路径> 安装本地 checkout。

安装后刷新页面:右侧栏的 Guide 页会出现「CodeIDE」入口,或按面板提示里显示的那个键(桌面端默认 Cmd/Ctrl+L,Web 端 Cmd/Ctrl+Shift+L)。

自测

不需要 DSH 宿主、不联网、不产生依赖:

node scripts/selftest.mjs

覆盖 /search、/files、/replace 的 helper 与 HTTP 分发(临时工作区夹具,含忽略目录、二进制与超大文件),并以桩模块加载器渲染面板的编辑器/搜索/命令面板几个主要状态。

已知边界

  • 暂存、提交、checkout、分支操作仍未实现;多标签只在面板内存在,刷新页面后不会恢复,也不做分屏。
  • 替换只有「全部替换」与「单文件替换」,没有逐处跳过/逐个确认。
  • 搜索优先用系统 rg(因此尊重 .gitignore);没有 rg 或调用失败时回退到内置 Node 走查,回退实现只按固定忽略目录跳过。
  • Markdown 渲染器是内置的轻量实现:支持标题/段落/粗斜体/删除线/行内代码/列表/引用/分隔线/链接/围栏代码块,不支持表格、脚注、原始 HTML、任务列表勾选与图片加载。
  • 命令行分栏优先用 xterm.js 渲染(vendor/xterm.mjs,随插件内置、按需加载,64 KiB gzip 左右),因此 vim、top 这类全屏 TUI 可用;只有浏览器环境缺少 ResizeObserver/matchMedia 或资产加载失败时才退回文本渲染(那时 TUI 显示不完整)。
  • xterm 资产由 scripts/sync-xterm.mjs <@xterm/xterm 包目录> 从已安装依赖同步,版本记录在 vendor/VERSION。
  • 模型侧的 bash 工具是面向模型的工具调用(带沙箱与审批语义),不能嵌进 UI;分栏里跑的是同一台机器上的真实 shell,而不是模型工具。
  • 收起分栏只断开视图,shell 进程继续存活;exit 或终端服务关闭后需要重新打开面板才会重建。
  • 文件树不递归搜索(只有懒加载浏览);根目录很大时首次展开较慢。
  • diff 只显示文本改动,二进制文件显示为 ±。
  • 与已安装的 @linxin666/dsh-client-ui-git-graph 互不影响:那个插件提供空白会话的分支切换与全屏图谱,本插件是右侧栏内的独立只读图谱。

故障排查

  • 文件树出现红色「无法读取该目录」时,下面会直接给出 Host 的错误码与原文(例如 gateway/bad-request、workspace-file/not-found、workspace-file/outside-workspace),并带「重试」按钮。
  • 文件树根目录用的是会话的绝对工作目录(Host 的 workspaceFiles.list 拒绝空路径),若与工作区根目录不一致会自动改用相对形式重试一次。
  • 单次请求 12 秒(读文件 15 秒)未返回即转为可见错误,不会一直转圈。
  • 想对照:右侧栏自带的「Files」标签用的是同一套服务;如果它同样报错,问题在该会话的工作区解析,而不是本面板。

许可证

MIT,见 LICENSE。内置的 Material Icon Theme 素材与 xterm.js 资产分别遵循 LICENSE-material-icon-theme 与 vendor/LICENSE-xterm 中的第三方许可。

Comments

Loading…

Similar plugins

dsh-drag-path

by Rudyy898

Like Codex/Claude Code: drag any file or folder (no format limit) onto the DSH web page and its real absolute path is inserted into the composer instantly — no typing paths by hand. Workspace-first sm

Tools & CapabilitiesUI & ExperienceManifest valid

★ 1

MIT

JavaScript

Aug 27, 2026

dsh plugin --profile web add dsh-drag-path

by Pasumao

[Discontinued 2026-09-11: DSH >=0.1.5 ships a built-in workspace file tree + document preview — use that instead] VS Code-style workspace file explorer for the dsh web GUI (published versions remain i

UI & ExperienceManifest valid

★ 7

↓ 214/wk

MIT

TypeScript

Sep 11, 2026

dsh plugin --profile web add dsh-plugin-workbench

by yangshen830-eng

VS Code-style code editor: sidebar file tree over the workspace, Monaco editing, file read/write, Git status and diff, search, and Markdown preview.

UI & ExperienceTerminal & ClientsManifest valid

★ 3

↓ 158/wk

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-editor

by echoVic

VS Code-like workspace IDE panel for DeepSeek Harness: file tree + syntax-highlighted editor, full-text search, git status/diff/history, VSCode themes

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 5

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-workspace-ide

by xiaoksio

DSH Web GUI right sidebar: VS Code-style file explorer plus source control (git status, stage/unstage/discard, commit, diff, commit graph, sync fetch/pull/push, branch/remote management, git init, mul

Development & InfrastructureManifest valid

★ 11

↓ 549/wk

MIT

TypeScript

Nov 9, 2026

dsh plugin --profile web add dsh-solution-explorer

by TLEWA

Right-click menus for DSH sidebar workspace and session rows: open folders in VS Code or Explorer, copy paths and session links.

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add dsh-sidebar-row-menu