# @eduwork/dsh-knowledge-studio 中文文档

规范地址：https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/

版本：0\.6\.5
npm 元数据更新时间：2026-11-12T07:51:22.460Z
中文译文更新时间：2026-11-13T07:36:29.590Z
软件包许可：MulanPSL-2\.0 AND MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40eduwork/dsh-knowledge-studio
原文对照：https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/?lang=original
项目主页：https://github.com/ECNU/EduWork/tree/main/packages/dsh-knowledge-studio#readme
源码仓库：https://github.com/ECNU/EduWork

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.4 MB，59 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.18\.0
- 运行依赖：6 个
- peer 依赖：zod ^4\.4\.3，react ^18\.2\.0，@deepseek-ai/cordis \>=4\.0\.5 \<4\.1\.0 \|\| 4\.1\.0，@deepseek-ai/dsh-fs \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-llm \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-skill \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-tools \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/schemastery \>=3\.18\.5 \<3\.19\.0 \|\| 3\.19\.0，@deepseek-ai/dsh-settings \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-workspace \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-home-paths \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-api-remotes \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-client-locale \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-typert-protocol \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-client-ui-layout \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-client-ui-workspace \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-api-session-controller \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0，@deepseek-ai/dsh-client-ui-conversation \>=0\.2\.1-rc\.2 \<0\.3\.0-0 \|\| \>=0\.2\.2-rc\.1 \<0\.2\.3-0
- 首次发布：2026-09-06T09:29:57.257Z
- 最新版本发布：2026-11-12T07:51:21.920Z
- 近 30 天下载量：3507（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

DeepSeek Harness的工作空间本土创作工作室,拥有本地源源检索和AI驱动的文件,学习工具,音频和视频.

## 安装

```sh
npm install @eduwork/dsh-knowledge-studio
```

也可以使用：`pnpm add @eduwork/dsh-knowledge-studio`、`yarn add @eduwork/dsh-knowledge-studio`、`bun add @eduwork/dsh-knowledge-studio`

## README

# DSH Knowledge Studio

版本：Studio `0.6.0` / Artifact Services `0.3.0`，要求 Node.js 24.18+ 与 DSH 0.2.1-rc.2。无需 EduWork 桌面桥接或机构账号。

[English](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/README_EN.md)

为 DeepSeek Harness 的工作区提供资料驱动的创作与学习工具。直接使用现有文件、对话和模型配置；直接读取原始资料，已有本地索引可供成果检索使用。

| Studio | 成果 |
| --- | --- |
| 报告 | 简报、学习指南、自定义报告；DOCX、PDF、Markdown |
| 演示文稿 | 可编辑 PPTX、PDF、HTML |
| 数据表 | XLSX、CSV |
| 思维导图 | 节点浏览、引用和追问；PNG、SVG、Markdown |
| 测验 / 闪卡 | 答题反馈、学习进度；含答案的 Markdown、PDF |
| 音频 / 视频概览 | WAV、MP4、字幕、可选旁白和配乐、视频预览 |

成果使用官方侧栏全屏阅读，保留原会话与输入草稿，引用可追溯到工作区资料。支持的成果类型见上表。

Office 技能复用宿主提供的官方处理流程。Studio 报告、表格和幻灯片的结构检查及 PDF 转换与对话共用官方组件，PDF 从实际保存的 Office 文件生成。宿主依赖和旧格式支持见[Office 工作流](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/packages/artifact-services/docs/OFFICE_PROCESSING.md)。

从官方侧栏「开始」页打开 Studio。宿主管理标签页、折叠和全屏状态；Studio 界面跟随蓝色/红色与明暗主题，导出文件保留自己的配色。

DSH 0.2 桌面版中，已保存的 Word、表格和演示文稿可点击「打开文件预览」，进入官方文件查看器，与对话中的文件使用同一入口。Studio 保留生成、下载、讲稿、引用和成果管理；测验、闪卡、导图及音视频仍可直接交互。旧宿主保留原有 Office 预览兼容实现。官方表格视图以单元格内容为主，复杂排版和对象请用 Office 或 WPS 查看。

## 两个独立包

| 包 | 版本 | 职责 |
| --- | --- | --- |
| `@eduwork/dsh-knowledge-studio` | `0.6.0` | 工作区资料、成果检索、Studio 界面与成果 |
| `@eduwork/dsh-artifact-services` | `0.3.0` | Office 与预览、TTS/ASR、媒体渲染、对话工具与通用技能 |

Studio 精确依赖共享包，两包版本应配套安装。共享服务也可以供其他应用或插件直接使用，不依赖 Studio 或机构服务。

## 安装

插件管理器会安装配套共享服务。使用宿主已有的模型配置；Office、语音和媒体能力还需要下述运行环境。

在已有 Profile 项目中安装精确版本：

```sh
dsh plugin --profile web add @eduwork/dsh-knowledge-studio@0.6.0
```

从源码构建（在 `EduWork/packages/dsh-knowledge-studio` 执行）：

```sh
npm ci
npm run build
npm run pack:release
```

将 `dist/packages/` 中两个压缩包复制到目标 Profile 项目，再在该项目中一起安装：

```sh
npm install ./eduwork-dsh-artifact-services-0.3.0.tgz ./eduwork-dsh-knowledge-studio-0.6.0.tgz
```

安装本地 tarball 不会自动启用目标 Profile；启用步骤、独立 Web 启动及运行环境配置见 [使用指南](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/docs/USAGE.md)。加载 Studio bundle 时会注册共享服务；不要另装第二份共享服务或旧 Office 执行插件。

成果完成与失败可接入宿主的[插件通知协议](https://github.com/ECNU/EduWork/blob/main/docs/PLUGIN_NOTIFICATIONS.md)。通知服务可选，未安装时仍可使用 Studio；成果状态和点击导航由 Studio 自己管理。

Office 需要另行准备 Python 3.12+ 和共享包的 `python/requirements.txt`，以 `DSH_OFFICE_PYTHON` 指向解释器。PDF、视频使用 Chromium；可注入已准备的运行时，独立渲染首次使用可准备 Remotion 浏览器；Studio 的能力检查本身不会下载组件，离线使用须事先配置。共享媒体运行时固定 Remotion `4.0.520`、mediabunny `1.55.5`、React/React DOM `18.3.1`。Windows System.Speech 和 macOS 系统 say 可使用本机已安装的音色离线配音；其他系统或厂商可通过统一接口注册语音提供方。音频转写通过共享 ASR 服务扩展，本地 whisper.cpp 可执行文件与模型需宿主另行准备，不随 npm 包分发。详见 [扩展接口](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/docs/ARCHITECTURE.md)。

## 开发与边界

[开发和测试](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/docs/DEVELOPMENT.md) · [架构](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/docs/ARCHITECTURE.md) · [迁移](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/docs/MIGRATION.md) · [版本记录](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/CHANGELOG.md) · [发布流程](https://github.com/ecnu/EduWork/blob/main/packages/dsh-knowledge-studio/docs/RELEASING.md)

索引和检索在本机运行。生成报告或媒体脚本会调用用户配置的模型并发送所需资料；费用和数据处理由该模型服务决定。打开 Studio 不会自动扫描全工作区或启动模型任务。

对话与 Studio 复用同一套 Office、语音、媒体生成和真实文件预览服务。Studio 保留资料引用与学习交互；可编辑 React 视频工程等高级操作由对话工具提供，并非每个对话工具都有 Studio 卡片。

Office 处理支持文档中列出的结构化功能，不承诺完整 Office 排版、宏或演示动画编辑；公式重算复用官方 LibreOffice Kit。字幕按实际语音片段同步，不承诺逐字时间戳。可编辑视频工程会执行工作区 React 代码，只应渲染可信工程。

项目原创贡献按[木兰 PSL v2](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/LICENSE)提供，历史 MIT 代码的适用范围见 [LICENSING.md](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/LICENSING.md)。Remotion、Chromium、PDF.js 和其他依赖保留自己的许可；项目代码许可不覆盖它们的全部使用条件。见 [第三方说明](https://npmcn.com/package/%40eduwork/dsh-knowledge-studio/THIRD_PARTY_NOTICES.md) 和 [配乐来源](https://github.com/ecnu/EduWork/blob/main/packages/dsh-knowledge-studio/packages/artifact-services/media/BGM-USAGE.md)。

平台支持取决于已准备的 Office、语音与媒体运行环境，要求见[平台说明](https://github.com/ecnu/EduWork/blob/main/packages/dsh-knowledge-studio/packages/artifact-services/docs/PLATFORMS.md)。

源码、Issue 与 PR 统一在 [EduWork](https://github.com/ecnu/EduWork/tree/main/packages/dsh-knowledge-studio)。开发命令在 `EduWork/packages/dsh-knowledge-studio` 中执行，npm 安装保持独立；发布流程见[包维护说明](https://github.com/ecnu/EduWork/blob/main/docs/PACKAGES.md)。

## 常见问题

### @eduwork/dsh-knowledge-studio 是什么？

DeepSeek Harness的工作空间本土创作工作室,拥有本地源源检索和AI驱动的文件,学习工具,音频和视频\.

### 如何安装 @eduwork/dsh-knowledge-studio？

在项目目录运行 npm install @eduwork/dsh-knowledge-studio，或使用 pnpm add / yarn add / bun add。

### @eduwork/dsh-knowledge-studio 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/eduwork\_\_dsh-knowledge-studio 是否存在。

### @eduwork/dsh-knowledge-studio 支持 ESM 还是 CommonJS？

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

### @eduwork/dsh-knowledge-studio 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.18\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @eduwork/dsh-knowledge-studio 可以商用吗？

@eduwork/dsh-knowledge-studio 使用 MulanPSL-2\.0 AND MIT 许可。声明的许可为 MulanPSL-2\.0 AND MIT，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @eduwork/dsh-knowledge-studio 的下载量有多少？

根据 npm 官方下载统计，@eduwork/dsh-knowledge-studio 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,507 次，日均约 117 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @eduwork/dsh-knowledge-studio 还在维护吗？

最新版本 0\.6\.5 发布于 2026/11/12（1 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/09/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

