@zhangzhian/dsh-devtools-files

中文文档
0.3.1发布于 2026/11/03MITTypeScriptES Module

dsh-devtools 的文件组件:文件树 + 对话区文件页签(预览/固定)+ 编辑器与预览

中文使用文档
文档目录7 节
  1. 安装
  2. 提供什么
  3. 要求
  4. 英语
  5. 安装
  6. 它提供了什么
  7. 要求

英语 | 简体中文

@zhangzhian / dsh-devtools-files

dsh-devtools 中文名称:中文名称: 预览编辑器语义的文件页签。

安装

dsh plugin add @zhangzhian/dsh-devtools

@zhangzhian/dsh-devtools 是清单包,装它会带齐所有组件(包括这个)。只想用文件 组件的话:

dsh plugin add @zhangzhian/dsh-devtools-files

提供什么

  • 文件树 —— 删除、上传、下载。
  • 预览标签 —— 单击用预览标签打开(标题斜体),再点别的文件就替换它; 双击固定为新页签;在预览标签里一编辑就自动固定。空白会话(内容区还没有页签条) 时改走平台官方的资源导航,在右栏新开一个页签 —— 不盖住文件树。
  • 编辑器 ——CodeMirror 6,Mod-S 保存, 并且带版本守卫:并发改动会弹冲突对话框,而不是静默覆盖。
  • 预览 -- -降价 右上角那颗「大纲」按钮可以展开浮动目录,展开时正文让位、不会被压住)、 HTML: http://www.chinesechina.org, http://www.chinese/chinese/chinese/chinese/chinese/chinese/。
  • 办公室 —— .xlsx / .xlsm 用官方同款栈在浏览器里解析和渲染 (ExcelJS解析+ FortuneSheet画格子:选区,复制,公式栏,工作表标签,冻结都 (1)、(2)、(3).docx / .pptx / .ppt / .doc / .xls liboffice软件。PDF软件。表格的两个库放在懒加载分块里, 第一次打开表格才下载。两种都开在中间的内容区,不是右栏。

要求

  • 近年来 0.2.0-rc.2 或更新。
  • 没有别的依赖。it it . it it . it it . it @zhangzhian/dsh-devtools-git 时出现。
  • 表格预览依赖 @fortune-sheet/[email protected] + [email protected](和官方预览同版本)。 财富表patches/@[email protected],修 allowEdit:false 时公式栏的无限 setContext),pnpm install 会自动应用; rebase。

英语

@zhangzhian / dsh-devtools-files

的文件组件 dsh-devtools:在右侧栏中有一个文件树,另外 在VSCode的 预览编辑器 语义。

安装

dsh plugin add @zhangzhian/dsh-devtools

@zhangzhian/dsh-devtools 是舱单包裹;安装它会把每一个 组件,包括这个。只使用files组件:

dsh plugin add @zhangzhian/dsh-devtools-files

它提供了什么

  • 文件树 -工作空间树与Git状态点,搜索,新建 文件/文件夹、重命名、删除、上传和下载。
  • 预览选项卡 -单击打开文件 预览 选项卡(斜体 标题);单击另一个文件替换它。双击将其固定为 永久选项卡,编辑预览选项卡会自动固定它。在一片空白中 会话(在会话区域中还没有TAB条)单击 平台自己的资源导航,而不是打开 right-sidebar 选项卡, 所以文件树永远不会被覆盖。
  • 编辑器 - CodeMirror 6与语法高亮显示约40种语言,软 包装, Mod-S 要保存,并进行版本保护,因此并发编辑将引发 冲突对话框,而不是静默覆盖。
  • 预览 - Markdown渲染使用平台自己的渲染器(所以它 匹配助手准确回复;角落里的“”按钮打开一个 浮动大纲,文本回流而不是覆盖),HTML中的 沙箱iframe,图像,音频,视频,PDF和页面查看文件 大到无法编辑。
  • 电子表格及办公软件 - - - - - - .xlsx / .xlsm 使用 和 官方预览 在浏览器(ExcelJS解析)中,FortuneSheet绘制 网格:选择,复制,公式栏,工作表选项卡和冻结窗格来自 组件本身),不涉及Office转换; .docx / .pptx / .ppt / .doc / .xls 由主机的本地LibreOffice转换为PDF 并显示在内容区。这两个电子表格库生活在一个懒惰的 Chunk,第一次打开工作表时下载。都是从中间打开的, 不在右边栏。

要求

  • 近年来 0.2.0-rc.2 或更新。
  • 什么都没有。Git状态点仅在以下情况下出现 @zhangzhian/dsh-devtools-git 也已安装。
  • 电子表格预览取决于 @fortune-sheet/[email protected] + [email protected] (与官方预览版本相同)。FortuneSheet带有只读 补丁(patches/@[email protected]修理一个无尽的 setContext 从公式栏中取出 allowEdit:false); pnpm install 自动应用它,并且PNPM会在依赖项发生变化时请求一个重基 升级。

版本与发布记录

@zhangzhian/dsh-devtools-files 共发布 6 个版本,首次发布于 2026/10/20;过去 12 个月发布了 6 个版本。

版本发布日期距今
0.3.1latest2026/11/03今天
0.3.02026/11/011 天前
0.2.22026/10/2113 天前
0.2.12026/10/2014 天前
0.2.02026/10/2014 天前
0.0.0-stage2026/10/2014 天前

关于 @zhangzhian/dsh-devtools-files 的常见问题

@zhangzhian/dsh-devtools-files 是什么?

dsh-devtools 的文件组件:文件树 + 对话区文件页签(预览/固定)+ 编辑器与预览

如何安装 @zhangzhian/dsh-devtools-files?

在项目目录运行 npm install @zhangzhian/dsh-devtools-files,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(~4.0.4)、@deepseek-ai/dsh-fs(^0.2.0-rc.2)、@deepseek-ai/dsh-sandbox(^0.2.0-rc.2)、@deepseek-ai/dsh-session(^0.2.0-rc.2)、@deepseek-ai/schemastery(~3.18.4)、@deepseek-ai/dsh-api-gateway(^0.2.0-rc.2)、@deepseek-ai/dsh-host-webserver(^0.2.0-rc.2)、@deepseek-ai/dsh-sandbox-policy(^0.2.0-rc.2)、@deepseek-ai/dsh-client-ui-slots(^0.2.0-rc.2)、@deepseek-ai/dsh-typert-protocol(^0.2.0-rc.2)、@deepseek-ai/dsh-api-workspace-files(^0.2.0-rc.2)、@deepseek-ai/dsh-client-ui-primitives(^0.2.0-rc.2)、@deepseek-ai/dsh-client-ui-conversation(^0.2.0-rc.2)、@deepseek-ai/dsh-client-ui-sidebar-files(^0.2.0-rc.2)、@deepseek-ai/dsh-client-ui-sidebar-right(^0.2.0-rc.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@zhangzhian/dsh-devtools-files 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@zhangzhian/dsh-devtools-files 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@zhangzhian/dsh-devtools-files 可以商用吗?

@zhangzhian/dsh-devtools-files 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@zhangzhian/dsh-devtools-files 还在维护吗?

最新版本 0.3.1 发布于 2026/11/03(今天);至今共发布 6 个版本,其中过去 12 个月发布了 6 个;首次发布于 2026/10/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。