# @zhangzhian/dsh-devtools-files 中文文档 规范地址：https://npmcn.com/package/%40zhangzhian/dsh-devtools-files/ 版本：0\.3\.1 npm 元数据更新时间：2026-11-03T00:21:43.026Z 中文译文更新时间：2026-11-03T00:39:25.581Z 软件包许可：MIT 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40zhangzhian/dsh-devtools-files 原文对照：https://npmcn.com/package/%40zhangzhian/dsh-devtools-files/?lang=original 源码仓库：https://codeup.aliyun.com/67617ae720a07de19c7c1633/dsh-plugins ## 关键信息（来自 npm 元数据） - 包体积（解压后）：19 MB，33 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：22 个 - 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 - 首次发布：2026-10-20T03:13:32.151Z - 最新版本发布：2026-11-03T00:21:42.843Z - 已发布版本数：6（近 12 个月 6 个） ## 中文简介 dsh-devtools 的文件组件：文件树 + 对话区文件页签（预览/固定）+ 编辑器与预览 ## 安装 ```sh npm install @zhangzhian/dsh-devtools-files ``` 也可以使用：`pnpm add @zhangzhian/dsh-devtools-files`、`yarn add @zhangzhian/dsh-devtools-files`、`bun add @zhangzhian/dsh-devtools-files` ## README [英语](https://npmcn.com/package/%40zhangzhian/dsh-devtools-files/#readme-english) | 简体中文 # @zhangzhian / dsh-devtools-files `dsh-devtools` 中文名称：中文名称： **预览编辑器**语义的文件页签。 ## 安装 ```sh dsh plugin add @zhangzhian/dsh-devtools ``` `@zhangzhian/dsh-devtools` 是清单包，装它会带齐所有组件（包括这个）。只想用文件 组件的话： ```sh 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/react@1.0.4` + `exceljs@4.4.0`（和官方预览同版本）。 财富表`patches/@fortune-sheet__react@1.0.4.patch`，修 `allowEdit:false` 时公式栏的无限 `setContext`），`pnpm install` 会自动应用； rebase。 * * * ## 英语 # @zhangzhian / dsh-devtools-files 的文件组件 `dsh-devtools`：在右侧栏中有一个文件树，另外 在VSCode的 **预览编辑器** 语义。 ## 安装 ```sh dsh plugin add @zhangzhian/dsh-devtools ``` `@zhangzhian/dsh-devtools` 是舱单包裹；安装它会把每一个 组件，包括这个。只使用files组件： ```sh 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/react@1.0.4` + `exceljs@4.4.0` （与官方预览版本相同）。FortuneSheet带有只读 补丁(`patches/@fortune-sheet__react@1.0.4.patch`修理一个无尽的 `setContext` 从公式栏中取出 `allowEdit:false`); `pnpm install` 自动应用它，并且PNPM会在依赖项发生变化时请求一个重基 升级。 ## 常见问题 ### @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 和提交记录判断。