一句话定位

dsh 的「共享核心」组合包。它自己不提供运行时 API，作用是把每个 dsh profile 都需要的基础能力一次性挂到 profile 根上——默认的 DeepSeek 适配器、bash / pwsh 工具、文件系统、subagent、权限预设、Settings / Credentials、Telemetry 都在这一层；后续的 web / headless 等表层 bundle 都建立在这一层之上。

核心能力

• 以一份 cordis.patch.yml 一次性插入约 78 行插件，构成所有 dsh profile 的共享基底（cordis.patch.yml:15-451 / tests/base.spec.ts:30-42）
• 引入默认模型适配器：在没有用户 settings 覆盖时，给所有 Agent 装配 deepseek-official provider 的 deepseek-v4-flash 模型（cordis.patch.yml:62-68）
• 提供 bash / pwsh 两套互补的 shell 栈，并在加载时按平台自动只保留其中一套：bash 在 POSIX 启用、PowerShell 在 Windows 启用（cordis.patch.yml:178-217 / README.md:7）
• 给出三层权限预设（read-only / workspace-write / danger-full-access），并把审批服务与权限预设挂钩，全局权限模式可通过 DSH_PERMISSION_MODE 切换（cordis.patch.yml:170-217）
• 提供基础工具集：bash（pwsh）、文件系统读 / 写 / 搜索、jobs、web_search（DeepSeek 搜索源）、todo、goal、subagent（spawn / fork）、str-replace-editor、ralph、skill、workflow（cordis.patch.yml:210-419）
• 持久化与可观测：session 落 JSONL、附件图片走内容寻址本地存储、SQLite 索引默认走内存模式、Telemetry 通过 DSH_TELEMETRY_MODE 环境变量开关（cordis.patch.yml:98-161）

技术实现

• 语言: TypeScript (ESM)，"type": "module"，package.json lib/index.js 入口只导出 export {}
• 关键依赖: @deepseek-ai/cordis（Cordis 插件宿主，对等依赖）、@deepseek-ai/cordis-plugin-loader（patch 加载器）、@deepseek-ai/dsh-invariants（对等依赖 + invariant companion）、约 70 个 dsh-* 工作区包（构成 patch 中插入的 78 个插件行）
• 架构模式: 该包「自己」不是插件——它的 package.json 在 dsh.bundle.patch 字段下挂一份 cordis.patch.yml，由 profile composer 在加载时把它当作「第一个 patch 层」插入空 profile 根；按 id 寻址，后续 bundle / 用户 profile 的 patch 可以覆盖这些行；src/invariant.ts 是只挂占位的 invariant companion（每个被插入的 row 各自的包自带 invariants）
• 入口文件: src/index.ts（空导出，仅含模块注释）+ src/invariant.ts（base-bundle-invariant companion）+ cordis.patch.yml（包的实际内容）

适用场景

任何想自己「从零搭一套 dsh profile」、或要给 profile 加一个共享基底的开发者：装上 dsh-base，等于一次性把 DeepSeek 适配器、bash / pwsh 工具、文件系统、subagent、持久化、telemetry、权限预设这些共用行为默认打开——之后 web / headless / 桌面表层只需在它之上再叠加自己关心的层。普通用户一般不会直接安装这一层，而是通过 dsh-cli 内置或 dsh plugin --profile 安装 web-app、headless 这些表层 bundle 间接使用它。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:fufankeji/deepseek-harness-studio/packages/bundle/base

配置项

本 bundle 自身不直接暴露用户配置——它通过 cordis.patch.yml 给每个被挂载的 row 注入一份配置。下面列出值得记的几条全局 / 行为级默认：

用户也可在 home 的 settings.yaml 中加 llm-deepseek: / llm-pi-ai: 段覆盖默认的 DeepSeek adapter 与激活 pi-ai 多 provider；不在 patch 内的「配置项」不展开。

常见问题

Q: 这个 bundle 是什么？为什么要先装它？

A: dsh 的「共享核心」组合包。它的 cordis.patch.yml 把所有 profile 都需要的基础插件一次性挂到 profile 根上——LLM 适配器、bash / pwsh 工具、文件系统、subagent、持久化、telemetry、权限预设都来自这一层。任何 dsh profile（web / headless / 桌面等）都默认以这一层为底，不装它就只剩空 profile。

Q: 安装 dsh-base 之后，还需要装官方 dsh-cli 吗？

A: 不重复。dsh-base 是 dsh 安装内部的 in-box bundle，普通用户通过 dsh plugin --profile <name> add 安装的通常是 web-app、headless 这类表层 bundle，dsh-base 已经默认存在于 @deepseek-ai/dsh 生产闭包里。

Q: 安装 dsh-base 会同时启用 Codex / Claude Code 子代理吗？

A: 不会。本包显式不带 @deepseek-ai/dsh-subagent-codex 和 @deepseek-ai/dsh-subagent-claude-code，这两类是可选的「产品 provider」，需要单独安装 profile bundle 才会被激活。

Q: 装上后看到 telemetry 行为，是开了吗？

A: 默认没开。session-telemetry-otel 行虽然被 patch 进来，但 mode 默认从环境变量 DSH_TELEMETRY_MODE 取值；该变量为空时落到 'DISABLED'。要上报就把环境变量显式设成 FULL 或 FEEDBACK_ONLY（其它值仍走禁用分支）。

Q: 我用的是 Windows，跑起来为什么 bash / pwsh 工具表现不一样？

A: bundle 在自身 patch 里按平台门控：bash 在 win32 上被 disabled: !!js process.platform === 'win32' 关掉，pwsh 在非 win32 上被关掉——同一份 patch，每台机器恰好挂一个 shell 栈。要在 Windows 上强行使用 bash 需要在 profile 或 home cordis.patch.yml 同时禁 pwsh-sh / tool-pwsh 并重新启用 bash-sh / tool-bash，缺一项会因重复注册同一个 bash 服务而加载失败。

Q: 偏好不联网的本地模型（或 Anthropic / OpenAI / 其它 provider），需要加 provider bundle 吗？

A: 需要。dsh-base 已经把 @deepseek-ai/dsh-llm-pi-ai 作为「零路由」provider 挂上，但没注入任何 provider profile；要让 pi-ai 跑起来要在 home settings.yaml 的 llm-pi-ai: 段填 provider profiles（Web 表层 Models 页面是入口）。不填的话 picker 里只有默认的 DeepSeek adapter。

Q: dsh-base 有自己的运行时 API 吗？我能 import 它的 apply() / 主入口吗？

A: 没有。src/index.ts 是空导出并写明「package's substance is cordis.patch.yml」，profile composer 通过 manifest 的 dsh.bundle.patch 字段解析 patch，不会经过 import。src/invariant.ts 提供一个 no-op companion，理由是本包不挂服务、不发事件、不持可变状态，每条 row 各自的包自带 invariants。

Q: 升级 dsh-base 会修改用户的 home settings.yaml / sessions 目录吗？

A: 不会。settings、sessions、.anonymous-user-id、.credentials.yaml 都由相应的服务独立管理在 $DSH_HOME 下，升级 dsh-base 不动这些位置；session-query-sqlite 默认走 :memory:，重启进程后只把内存中的搜索索引清空，不动磁盘。

上手难度

入门 — 只要会用 dsh plugin --profile 加 bundle、按 home settings.yaml 配 key 和 provider profile 就能让它工作；不需要写 Cordis 插件、不需要跑 loader；要深入则要理解 patch layer 的覆盖语义和键约束。

已知问题与限制

• patch 替换整行 config：profile 覆盖必须重述该行需要保留的每个字段，不存在深度合并层（README.md:19-22 / README.zh.md:19-22）
• Windows 临时目录授权是按会话的私有子目录——workspace-write 把写入限制在工作区与会话自己的 temp 子目录（<temp>\dsh-<hash>，受限子进程的 TMP/TEMP 被改写）；read-only 不授予任何临时目录写入权限（README.md:19-22）
• session 内容搜索默认关闭——session-query-sqlite.openAt: never 让精确读、标题、lineage 仍可用，但搜索调用会以 SESSION_QUERY_SEARCH_DISABLED 失败；想启用需要在更上层 patch 中把 openAt 改为 first-search 或 startup，通常配合一个稳定的 path（cordis.patch.yml:111-122 / 注释在 109-117）
• DSH 基线采用整行替换、不做合并：见 cordis.patch.yml 文件头与 README ## Known Limitations and Deferred Work 节
• telemetry 默认禁用但 OTLP 上报端点仍写死一个官方域名——session-telemetry-otel.exporter.url 默认指向 https://harness-telemetry.deepseeksvc.com/v1/logs，可通过 DSH_TELEMETRY_OTLP_URL 改写但默认就是该域（cordis.patch.yml:148-161）

DeepSeek Harness Studio

官方网站 · 中文 · English

赋范空间出品 · DeepSeek Harness 的零代码桌面增强

视觉增强 + 插件市场 + Preset 广场 · 0 代码一键部署和使用

自动发现并推送生态新插件，AI 智能推荐值得安装的能力；无需命令行即可完成搜索、校验、安装、启停与卸载。

下载 macOS arm64 开发预览版 · 下载 Windows x64 开发预览版

点击快速查看功能演示

https://github.com/user-attachments/assets/0717f7c7-a872-4d2b-acc2-3a1c4874c732

先看功能：当前能力与近期路线图

状态说明：✅ 已支持；🗓️ 规划中。桌面开发工作区、公开插件中心、Preset 广场、应用中心和中文 DeepSeek 控制已经可用；规划能力会在真实功能可运行后更新状态。

项目简介

DeepSeek Harness Studio 使用 Electron 承载 DeepSeek Harness 的 Web 工作区，并由桌面主进程启动和管理本地 dsh web 服务。这个仓库提供完整源码开发环境，使用者可以从 GitHub 克隆或下载代码，在本地安装依赖、编辑源码、启动桌面应用并继续开发。

桌面安装包只通过本仓库的 GitHub Releases 发布，不使用第三方下载站。目前已经提供经过真实 Electron 验收的 macOS arm64 预览 ZIP 和 Windows x64 预览安装程序；需要继续开发时，仍可获取完整源码并在本地启动。

核心功能

• Electron 桌面端：提供应用窗口、系统托盘、单实例运行、外部链接处理和安全的 preload 通信接口。
• 本地 Harness Host：桌面主进程启动 dsh web，等待本地服务就绪，并在应用退出时关闭 Host 进程。
• Web 工作区：保留 DeepSeek Harness 的会话、工作区、模型、工具、Skills 和插件运行能力。
• 插件发现与推荐：自动读取在线目录，通过精选、最近更新、生态热门、场景分类和搜索，帮助用户快速找到值得尝试的插件。
• Agent 智能找插件：用一句自然语言描述需求，Agent 自动检索公开 dsh-plugin 目录、筛选相关候选并说明推荐理由。
• 公开插件中心：通过短包名、完整 npm 包名或明确 GitHub 仓库定位已经发布的 DSH Bundle，在安装前校验确定版本、产物完整性、Bundle 声明和本机兼容性；聚合 Bundle 可以复用当前 Desktop Host 实际打包的 DSH 模块，真正缺失的第三方依赖仍会被阻断。
• Preset 广场：从独立一级页面浏览赋范官方与社区 Agent Preset，查看 Skill、工具和环境要求后安全安装，并从已安装列表直接用于新会话。
• 应用中心：集中启动由赋范桌面端内置维护的完整 AI 应用；应用拥有独立界面、数据目录和运行流程，并可按需显示在左侧导航。
• 对话区视觉增强：保留一个开关；确切模型声明支持图片时发送原图，否则使用已验证的百炼或 OpenRouter 兼容视觉，同一张图片只进入一条链路。
• 桌面外观设置：内置“官方原版”“大肥鱼拟人”和“云端猫咪”三套外观，也支持本地背景图片、主体焦点和界面玻璃层调节。
• 完整开发源码：仓库同时包含桌面应用、Web 界面、CLI、功能包、原生辅助模块、Python SDK、示例和构建脚本。

DeepSeek Harness rc.8 兼容能力

Studio 0.1.0-rc.14 整合 DeepSeek Harness 0.1.0-rc.8 的核心与 Web 能力，同时保留赋范的插件中心、插件发现、Preset 广场、应用中心、主题皮肤和桌面恢复链路。Studio 版本号与 Harness 上游版本号分别管理。

• 模型与视觉：支持 DeepSeek low 推理强度、确切模型的原生图片能力声明，以及原生视觉与兼容视觉的单开关自动路由。
• 附件与引用：接入可持久化图片附件、@ 文件／会话引用，以及可携带图片的 /goal 与 /plan 输入。
• 插件与设置：接入插件动态设置卡片，并沿用插件中心的安装、配置、启停和卸载链路。
• 任务与运行时：接入子 Agent Job、并发 Web Search、历史分叉性能改进和 Windows 持久 PowerShell PTY。
• 桌面兼容：Desktop Host 使用 --no-open 避免额外打开浏览器，并继续使用原生目录选择、插件事务恢复和现有用户数据目录。

插件生态：先发现值得装的，再完成安装与管理

插件发现：不知道装什么，就从这里开始

不知道插件去哪里找、哪些最近刚更新、哪些正在受到生态关注？从左侧进入 插件发现，应用会自动读取在线目录，把分散的插件整理成可以直接浏览和行动的推荐页面。

_{真实 Desktop 界面：目录精选、最近更新、生态热门、场景分类、搜索以及安装与管理入口。}

• 每天都有新发现：打开页面即可看到目录精选、最近更新和生态热门，不必逐个仓库搜索。
• 按场景快速筛选：覆盖 Agent 与工作流、Web UI、浏览器与搜索、视觉与媒体、记忆与上下文、模型与服务、开发工具、集成与通知。
• 直接搜索答案：按插件名称、功能关键词或作者检索，并查看头像、简介、版本和更新时间。
• 发现后立即使用：未安装插件可直接进入安全安装流程；已安装插件可一键转到插件中心继续管理。

不知道准确包名？让 Agent 先替你筛选

只知道“想要一个桌面宠物”这类需求时，不必先猜 npm 包名。在 插件发现 中输入自然语言描述，应用会把它作为 /find-plugins 请求交给当前 Agent；Agent 加载内置技能、只读查询公开 dsh-plugin 目录，并把最相关的候选、版本、作者、更新时间和匹配理由返回当前对话。

_{真实 Desktop 验收：对话发出“找一个桌面宠物插件”，Agent 加载 find-plugins、执行公开目录搜索，并从 8 个结果中列出 5 个相关候选。}

• 不要求记住关键词：直接说明目标、使用场景或希望解决的问题。
• 推荐依据可核对：结果包含精确包名、版本、发布者、更新时间和逐项匹配理由。
• 搜索与安装分开确认：推荐结果只代表公开目录元数据；选定包名后仍通过 插件中心 完成兼容性检查和确认安装。

插件中心：在线安装、启停与移除

_{真实 Desktop 界面：插件头像、公开目录、已安装区域、“安装”按钮与三点管理入口。}

选定插件后进入 插件中心，可以用短包名、完整 npm 包名或明确 GitHub 仓库查找发布到 npm 公共 Registry 的插件与 Skill Pack。dsh-plugin 只是发现信号；GitHub 也只用于映射已发布 npm 包，Studio 不会直接安装仓库源码。确定版本仍须通过 Bundle、完整性和运行兼容校验。

• 在线发现：搜索公开插件，查看版本、能力、权限、兼容性和风险说明。
• 一键安装：下载确定版本并校验包身份、完整性和 Bundle 声明；确认后自动安装并重启 Harness Host 验证运行状态。
• 已安装管理：集中查看系统、公开目录和本地来源，通过三点菜单启用、停用、更新或卸载插件。
• 安全移除：卸载默认保留配置与插件数据；需要清理数据时，再由用户单独确认。

Preset 广场已上线：一键安装完整工作方式

插件通常解决“让 Agent 多一个工具”，Skill 解决“教 Agent 按什么方法做”，而 Agent Preset 解决的是更完整的问题：把角色、工作规则、Skills、Plugin/MCP 与 Harness 标准工具组合成一套可以反复使用的工作方式。用户不需要逐项理解和手工配置，安装一个 Preset 后，就能直接用对应角色创建新会话。

当前源码已经提供与“插件中心”“插件发现”平级的 Preset 广场，并完成发现、详情、安全安装、已安装管理、用于新会话、删除与重新安装的桌面端闭环。

_{真实 Desktop 界面：Preset 广场、赋范官方内置目录、搜索与排序，以及安装、查看详情和用于新会话入口。}

使用路径： 发现 Preset → 查看能力组成与前置条件 → 一键安装 → 在“已安装”中选择“用于新会话” → 按工作流完成任务 → 随时删除或重新安装。

1. 从左侧导航进入 Preset 广场，可搜索用途、名称或作者，并按下载量或更新时间排序。
2. 打开详情查看它包含的角色、Skill、工具、外部依赖和来源说明。
3. 点击安装后，Desktop 会校验来源、大小、摘要和归档路径，再写入本地用户 Preset 目录。
4. 安装完成后无需重启 Host；在 已安装 中点击“用于新会话”，即可带着对应 Preset 开始任务。
5. 用户 Preset 可删除并重新安装；系统 Preset 继续受保护。安装或删除后仍停留在当前页面，不打断浏览过程。

安装、删除和用于新会话涉及本机文件与 Host，只在 Desktop 中执行；浏览器开发模式用于快速查看和验收界面，不会修改本机 Preset。

赋范官方内置 Preset：七套真实场景工作流

内置内容不是“插件合集”，而是七套围绕真实交付结果组织的 Agent Preset + Skills + 工具集成。合计包含 7 套 Agent Preset、9 个 Skills、1 个图像生成 Plugin；飞书数字员工另外接入飞书 MCP 与时间解析 MCP，PPT Office 使用内置动效运行适配器。

命名说明： “赋范官方”表示由赋范桌面端开发团队内置和维护，不代表 DeepSeek Harness 官方。它们安装后仍是普通用户 Preset，可以删除并重新安装。

下方六个案例统一使用 16:10 预览图，避免横幅和长图破坏版面；点击任意图片可查看完整原图。

产品与演示：把想法变成可交付成果

内容与媒体：把一句话或一篇长文变成成品

数据与企业协同：从本地数据到真实业务动作

以上图片均来自六套工作流的真实案例成果。Desktop 随安装包交付的是运行所需的精简 Preset、Skills 与工具适配，不会把案例源码、输入数据、截图或生成成品塞进用户环境。

应用中心已上线：从能力扩展进入完整 AI 应用

插件为 Harness 增加工具或界面能力，Preset 把角色、Skills 与工具组合成一套工作方式，而 应用 面向更完整的产品场景：它拥有独立界面、专属数据和自己的运行流程。应用中心因此与插件中心、插件发现和 Preset 广场平级，用户不需要在插件列表中辨认技术包，直接从一个稳定入口发现并启动完整产品。

_{真实 Desktop 界面：应用中心作为一级入口展示赋范官方应用；可直接打开应用，也可选择是否把快捷入口显示在左侧导航。}

首个内置应用：FF–LLM Wiki 企业知识库

FF–LLM Wiki 面向企业文档分散、知识关系难整理、问答结果无法追溯的问题，把原始资料逐步转换为可检索、可关联、可核查的知识资产。它不是嵌在对话页中的演示卡片，而是一套由 Desktop 管理本地运行环境、在系统浏览器中打开的完整应用。

_{真实运行界面：从文档解析、Wiki 编译和知识图谱构建，到基于检索证据的 Agent 问答与质量评估。}

• 完整知识流水线：文档解析 → 实体与条目抽取 → Wiki 与知识图谱构建 → 向量化和索引 → 可追溯问答。
• 来源可以核查：问答只使用当前检索命中的证据片段，并保留来源引用；模型不可用时会明确降级到本地检索结果。
• 本地数据隔离：文档、Wiki、图谱和 SQLite 数据写入 DSH Home 下的应用专属目录，不混入当前项目工作区。
• 密钥由用户掌控：应用不会携带赋范团队的 API Key。知识编译、浏览和本地检索无需模型密钥；使用 DeepSeek 生成式 RAG 前，需要用户在 Harness 凭证中心配置自己的 DEEPSEEK_API_KEY。
• 入口按需显示：应用中心始终可访问；FF–LLM Wiki 的左侧快捷入口默认关闭，用户可通过“显示在侧边栏”随时开启或隐藏。

使用路径： 打开应用中心 → 选择 FF–LLM Wiki → 点击“打开应用” → 导入或管理企业资料 → 构建 Wiki 与知识图谱 → 在智能问答中核查带来源的答案。

命名说明： “赋范官方”表示由赋范桌面端开发团队内置和维护，不代表 DeepSeek Harness 官方。

内置皮肤与自由换肤

进入 设置 → 背景 即可切换内置皮肤；选择自定义图片时，应用会在本机完成 1920×1080 WebP 裁切与界面配色，不上传原图。

中文权限与 DeepSeek 模型控制

• 权限选择：输入区使用 只读、工作区写入 和 完全访问 三档中文权限，作用于当前会话；通用设置只决定后续新会话的默认权限，启用完全访问前必须确认风险。
• 模型与思考模式：模型和 API Key 仍在设置页统一管理；输入区可查看当前 DeepSeek 模型，并选择 关闭思考、低强度思考、深度思考 或 最大思考。

视觉增强：让 DeepSeek 看懂图片

开启视觉增强后，Host 会按当前确切模型的能力自动选择一条路径：模型声明支持图片时直接发送原图；否则使用已完成配置与验证的百炼或 OpenRouter 兼容视觉，把可追溯观察交给 Agent。两条路径互斥，同一张图片只处理一次。

• 随手可用：输入框左侧提供“视觉增强”快捷开关，悬浮即可查看用途和当前状态。
• 自动选路：按钮显示 原生 或 兼容 · 提供方；原生视觉不需要额外 Key，兼容视觉则要求对应提供方已验证。
• 明确关闭：关闭开关后，图片不进入模型可见上下文；附件历史仍保留在界面中。
• 覆盖开发场景：可理解产品截图、报错界面、设计稿、数据图表、照片和图片文字，也可以按路径读取当前工作区图片。

下载桌面端

GitHub Releases 已提供经过真实 Electron 验收的 macOS Apple Silicon 预览 ZIP 和 Windows x64 预览安装程序，运行桌面端无需另行安装 Node.js 或 pnpm。当前均为开发预览资产；正式版本仍将提供完成平台签名的 macOS .dmg 和 Windows x64 .exe。

下载 macOS arm64 预览版 · 下载 Windows x64 安装程序

macOS arm64

下载并解压预览 ZIP 后，建议先把 DeepSeek Harness.app 拖入“应用程序”目录。由于当前预览包尚未经过 Apple 公证，首次打开前需要在“终端”执行：

xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"
open "/Applications/DeepSeek Harness.app"

如果应用没有放在“应用程序”目录，请把命令中的路径替换为实际路径。该命令只应用于从本仓库 GitHub Releases 下载并核验过 SHA-256 的预览包；不要用于来源不明的应用。首次成功打开后，可以像普通应用一样从 Finder 或程序坞启动。

Windows x64

下载 DeepSeek-Harness-Desktop-Windows-x64-0.1.0-rc.14-Setup.exe 后直接运行安装程序。Release 的公开下载区只保留 macOS ZIP 和 Windows 安装程序；校验文件、blockmap 与平台验收记录保留在对应 GitHub Actions 构建中，避免普通用户误下载开发文件。

开发预览版使用独立 Pre-release 标签，不触发正式安装器发布。正式流程只接受与 Desktop 版本完全一致的 desktop-v* 标签；macOS 与 Windows 安装包分别完成平台签名验证后，GitHub 才会同时公开安装文件和 SHA256SUMS。

快速开始

获取源码

使用 Git 克隆仓库：

git clone https://github.com/fufankeji/deepseek-harness-studio.git
cd deepseek-harness-studio

也可以在 GitHub 仓库页面选择 Code → Download ZIP，下载并解压源码后进入项目目录。

环境要求

• Node.js ^22.19.0 || >=24.0.0
• pnpm 11.7.0

外部服务准备

下载源码、安装依赖和启动桌面开发环境不需要预先填写 API 密钥。需要在应用中实际调用模型时，再在设置中配置所选模型服务与凭证；凭证不要提交到 Git。

安装与启动

安装工作区依赖：

pnpm install

构建所需模块并启动桌面开发环境：

pnpm run dev:desktop

开发启动器会在相关源码或构建输入变化时重新构建；需要强制完整重建时运行：

pnpm run dev:desktop:rebuild

目录结构

deepseek-harness-studio/
├── apps/
│   ├── desktop/       # Electron 主进程、preload、Host 生命周期与桌面构建脚本
│   ├── web/           # DeepSeek Harness Web 界面入口与桌面端组合
│   └── cli/           # dsh CLI、运行配置与 Agent Preset
├── packages/          # Agent、模型、工具、会话、插件和客户端能力包
├── native/            # 原生沙箱辅助模块
├── python/            # Python SDK 与相关运行时
├── examples/          # 可运行示例与配置
├── scripts/           # 构建、检查、生成和发布脚本
├── website/           # 项目文档站源码
├── vendor/            # 固定版本的 Cordis 基础源码
└── assets/            # README 使用的项目图片

常用开发命令

建议阅读顺序

1. apps/desktop/src/main.ts：桌面应用入口、窗口、托盘和本地 Host 组合。
2. apps/desktop/src/host-supervisor.ts：dsh web 的启动、就绪检测与退出管理。
3. apps/desktop/src/preload.ts：Renderer 可访问的固定桌面接口。
4. apps/web/：桌面窗口加载的 Web 工作区。
5. apps/cli/ 与 packages/：CLI 组合以及各项 Harness 能力实现。

与 DeepSeek Harness 的关系

本项目基于 deepseek-ai/deepseek-harness 的 Harness 核心、Cordis 插件体系和 Web 界面继续进行桌面端开发。本仓库维护 Electron 桌面入口、本地 Host 管理、桌面交互与配套开发脚本。

许可证

本项目使用 MIT License。第三方组件的许可证信息见 THIRD_PARTY_NOTICES.md。