eduwork

EduWork

让 AI 围绕你的资料，把任务做到交付。
_{本机工作区 · 可交付成果 · 学校与企业服务接入}

EduWork 是基于 DeepSeek Harness 的桌面 AI 工作助手。选择一个文件夹，说清楚你想完成的任务：从阅读资料、搜索信息、分析数据，到生成文档、表格和演示文稿，都可以在同一个工作区完成。

个人用户连接自己的模型 API；学校和企业通过配置接入统一身份与模型服务。每位用户在自己的电脑上独立运行，无需部署额外的 EduWork 服务端。

_{资料、对话与成果放在一起，让一项工作可以持续做下去。}

你可以用它做什么

围绕文件工作 读取资料、编辑文档、分析数据、运行脚本，让 AI 在你的本机工作区完成任务。	把结果做成交付物 用 Studio 制作报告、表格、演示文稿与学习材料，预览、下载，再继续修改。
自由选择模型 连接自己的 API，或使用机构账号登录。个人模型与企业模型可以同时使用。	接入你的服务 通过配置接入身份与模型，通过技能和插件补充专业方法与内部业务能力。

从一个具体任务开始

你正在做什么	可以这样交给 EduWork
备课与学习	“根据课程材料制作演示文稿，再生成配套的测验和复习闪卡。”
研究与调研	“阅读这些资料，按主题整理观点，标出来源和仍需核实的问题。”
数据与办公	“比较这几份表格，找出差异，生成分析报告和汇总表。”

Agent 可以读写文件、运行脚本，并通过子代理协作处理复杂任务。工作区保留会话和成果，方便接着修改、补充资料和继续推进。

在 Studio 里，把成果做出来

打开右侧 Studio，选择成果类型即可开始；也可以直接在对话中提出要求。两种入口共用生成、预览与下载能力。

报告 · 数据表 · 演示文稿 · 思维导图 · 测验 · 闪卡 · 音频 · 视频

_{图中为机构配置示例。Studio 由公版提供，界面名称和标识可通过配置调整。}

报告、表格和演示文稿可生成 DOCX、XLSX、PPTX 文件；学习材料支持交互预览，音视频可预览并下载媒体与字幕。文生图和云端 TTS 需配置兼容服务，本机语音取决于系统及本地资源，详见媒体服务配置。

让工作方式适合你

• 搜索与浏览器：配置 DeepSeek 搜索 Key 时使用官方搜索，未配置时使用免 Key 的浏览器搜索。
• 技能中心：浏览和管理内置技能，导入或编写自己的任务指引，无需重新编译客户端。
• 记忆与邮件：用本地记忆延续工作背景；配置邮件账户后，可通过邮件助手处理相关任务。
• 语音、模型与偏好：使用本机语音转写、系统语音合成，选择自己的模型，切换蓝色或红色主题，设置模型请求总并发。

看看技能中心

技能提供任务指引，插件提供可执行能力；身份、模型和兼容媒体服务优先通过配置接入。

安装与使用

当前桌面目标平台为 Windows x64，采用 Electron 绿色包，解压即可运行。macOS 版本正在适配，进展见 macOS 说明。

1. 获取客户端

从 GitHub Releases 获取完整桌面包，解压到可写目录，运行 EduWork-Electron.exe。请保留同目录下的资源文件，不要只复制 EXE。

若 Releases 暂无可用安装包，可按构建指南从源码运行；GitHub 的 Source code 压缩包不是桌面安装包。

2. 连接模型

打开 设置 → 模型，填写服务商的 API Key、接口地址和模型。使用学校或企业服务的用户，可按下方说明加载机构配置，再通过浏览器登录获得模型。

3. 开始工作

选择一个本机工作区，放入任务资料，直接描述你想得到的结果。需要文档、表格等成果时，也可以打开右侧 Studio，选择对应类型开始。

窗口行为与自动更新

窗口关闭后默认收起到系统托盘；需要完全退出时，使用托盘菜单。Windows 公版默认从 GitHub 获取更新，公测与开发渠道可在设置中选择，机构可通过配置切换更新源；自动更新保留历史数据与用户配置，详见更新说明。

学校与企业接入

企业接入是公版的内置能力。 学校或企业可以向用户分发一份配置，让同一个 EduWork 客户端连接自己的身份平台、模型网关和媒体服务，无需修改公版代码或重新打包。

可以配置什么	接入后能做什么
OIDC 身份认证	在系统浏览器中使用学校或企业账号登录，支持配置多个机构。
模型凭据与目录	服务端实现 EduWork 资源协议后，客户端在用户授权及必要确认后获取 Key、配置企业模型，无需手动复制凭据。
文生图与云端 TTS	按兼容接口、模型、尺寸和音色配置启用，复用公共媒体能力。
名称、Logo 与更新源	调整界面品牌，配置发行方的更新渠道；用户配置在更新时保留。

企业模型和用户自己配置的模型可以同时使用。标准 OIDC 只解决身份登录；自动获取 Key 和模型目录需要服务端另外实现资源接口。

三步配置你的机构

1. 在设置中点击 打开配置文件，编辑客户端目录下的 config/eduwork.jsonc。
2. 文件内含完整注释示例。按管理员提供的信息填写 organizations；需要图像或语音服务时再加入 media。更多示例在客户端的 config/examples/ 目录。
3. 保存后从托盘完全退出并重新启动，再选择机构登录。

配置文件只保存公开接入信息和凭据引用。个人 API Key 在模型设置中管理，企业凭据由登录流程保存在本机受保护存储中；不要把密码或令牌写入配置文件。界面 Logo 可配置，程序内嵌图标由发行包提供。

管理员配置： 完整企业配置示例 · 媒体配置示例。

开发者接入： 以下两份文档描述同一套身份与资源协议，按工作角色选择阅读：

• 服务端实现与联调（RFC EW-IDENTITY-1）：服务端需要实现哪些接口、请求与响应字段、认证要求、curl 示例和验收步骤。新接入的服务端工程师从这里开始。
• 客户端接入模式与模型发现：如何选择纯身份或托管模型模式、使用静态或自动模型目录，以及插件如何通过 Host RPC 和账户事件对接客户端。

通过插件扩展内部能力

学校和企业还可以通过插件接入内部系统，将专属的信息检索、业务工具或账户服务带入 EduWork。插件提供可执行能力，技能提供面向具体任务的操作指引；已有的身份、模型和媒体接口则优先通过配置接入。

机构可以将插件、技能和默认配置组合成自己的发行版，复用 EduWork 的工作台、Studio、文件预览和桌面能力。通用功能持续由公版维护，机构只需维护自己的扩展。

EduWork@ECNU 是一个机构扩展示例，展示了华东师范大学如何基于公版接入内部服务。可参考该仓库组织自己的扩展与发行配置，设计说明见发行边界。

一次接入，更多客户端

让机构的账号与模型服务，被更多 AI 客户端复用。

我们发起开放身份与模型接入倡议，邀请身份平台、模型网关和客户端开发者，共同用公开协议连接登录、模型凭据与模型目录，让机构接入新工具时能够复用已有服务。

dsh-oidc 是我们的实现起点：身份遵循标准 OIDC，托管模型通过公开资源接口接入，提供独立 npm 包、服务端规范、OpenAPI 和联调示例。其他客户端也可以按协议独立实现，无需采用 EduWork 的界面。当前倡议面向社区讨论，跨客户端互通需要按版本实际验证。

阅读开放接入倡议 · 实现服务端 · 接入客户端 · 一起讨论

数据与隐私

会话、工作区引用和记忆在本机管理。连接远程模型、搜索或媒体服务时，执行任务所需的内容会发送给相应服务商；数据处理规则以所选服务为准。

跨机使用可通过设置中的历史数据导入功能合并会话和客户端目录内的资料；客户端目录之外的工作区文件需要另行复制。故障排查可导出诊断 ZIP，具体会话问题可另外提供 Session log，详见使用指南。

详细文档

文档	内容
使用指南	模型、搜索、语音、文件操作与故障诊断。
配置示例	企业登录、品牌、媒体服务、更新源与并发设置。
媒体服务配置	文生图、云端 TTS 的接口要求及配置方法。
版本与升级 · 更新源部署	开发版与公测版、数据迁移和自动更新。
构建指南 · macOS 说明	从源码运行、桌面装配与平台适配。
贡献指南 · 发行边界	参与开发及公版与机构扩展的分工。

公共模块

以下模块的源码和文档统一维护在本仓库，npm 包仍独立安装、版本管理和发布，也可供其他 DSH 应用使用。

模块文档	功能
身份与模型接入（dsh-oidc）	OIDC 登录、模型凭据、企业模型目录与服务端接入协议。
本地记忆（dsh-memory）	本地记忆与历史检索，延续任务背景。
邮件助手（dsh-mail）	通过 IMAP 读取邮件、SMTP 发送邮件，并管理相关权限。
Studio（dsh-knowledge-studio）	创作、预览和管理报告、表格、演示文稿、学习材料及音视频成果。
成果与媒体服务（dsh-artifact-services）	供对话和 Studio 共用的 Office、语音、图像与媒体生成服务。

模块开发、检查和 npm 发布见包维护说明。

致谢与许可

感谢 DeepSeek Harness 及其开源生态提供的基础能力。

EduWork 项目代码采用 MIT 许可证。第三方组件保留各自的许可证，详见第三方声明。