让 DSH 在委托会话里以一次性无人工方式拉起官方 Claude Code 子代理：通过 `dsh-subagent` 把一条纯文本任务交给 Claude Agent SDK 运行并按严格成功条件回传最终答案。
ⓘ 此插件是大仓库 fufankeji/deepseek-harness-studio 的子包，星数与活跃度统计的是整个仓库。
- 语言
- TypeScript
- License
- MIT
- 分支
- main
安装
$ dsh plugin --profile web add github:fufankeji/deepseek-harness-studio/packages/subagent/subagent-claude-code在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 fufankeji/deepseek-harness-studio/packages/subagent/subagent-claude-code：先查看仓库 https://github.com/fufankeji/deepseek-harness-studio.git 确认安全性，然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。
一句话定位
subagent-claude-code 让 DSH 会话在需要的时候临时拉起一个独立的 Claude Code 子进程来跑一段纯文本任务：每次都开新的 CLI、不需要人按键审批、跑完把最终答案或失败诊断交给上游；它不改写你的 Claude 账户和设置，只是把官方 SDK 接到 DSH 的 subagent 服务上。
核心能力
- 在委托 Session 的工作目录里拉起官方 Claude Agent SDK 的真 CLI 子进程，进程归 dsh-subprocess 的进程树统一管控（src/run.ts:362-368 / src/process.ts:46-94）
- 一次性文本任务：只接受非空纯文本块，按规范结果（
subtype: "success"且非错误且非空白）才作为任务成功；任何偏离都被映射到固定的失败分类（src/run.ts:182-224, 234-260） - 不让任何弹窗等用户：禁用
AskUserQuestion，权限请求一律拒绝，MCP elicitation 一律拒绝，阻塞对话一律取消（src/run.ts:323-360） - 失败会带诊断：把 lifecycle 阶段（query-start / query-run / process / teardown）、SDK 错误分类、子进程退出码/信号拼成最多 4096 字节的失败摘要，写到
SubagentResult.diagnostic（README.md:19 / src/run.ts:82-97） - 一次只跑一次：不持有会话状态、不续接、不持久化，每次都是新的 SDK query + 新的 CLI 进程 + 一次性产品会话（README.md:141 / README.md:115-117）
- 安装/卸载通过 Profile Bundle：安装才让宿主上多出一个休眠 provider，卸载后下次启动就连同其私有运行时一起撤回（README.md:44 / cordis.patch.yml:1-6）
技术实现
- 语言: TypeScript（ESM，发布产物
lib/index.js与lib/types/*.d.ts，见 package.json:13-27）。 - 关键依赖:
@anthropic-ai/claude-agent-sdk@0.3.220（官方 SDK，含八个平台子包携带 Claude Code 2.1.220）、@deepseek-ai/dsh-subagent（共享任务接缝与结果结算）、@deepseek-ai/dsh-subprocess（负责真 CLI 进程的进程树托管）、@deepseek-ai/dsh-timeout（MAX_TIMER_DELAY_MS上限校验）（package.json:40-54 / src/run.ts:9-37 / src/process.ts:9-18）。 - 架构模式: 函数插件 + Profile Bundle——
src/index.ts命名导出name/inject/Config/apply；apply(ctx, config)把一个ClaudeCodeProvider注册到ctx.subagents，由cordis.patch.yml顺势注入 dsh-base 之上。运行时通过 SDK 的spawnClaudeCodeProcess自定义钩子把进程生成路径转交给dsh-subprocess持有的共享 handle，再由ManagedClaudeCodeProcess把事件流回灌给 SDK 协议层（src/index.ts:30-32, 129-151 / cordis.patch.yml:1-6 / src/run.ts:362-368 / src/process.ts:67-159）。 - 入口文件:
src/index.ts（Cordis 注册入口）、src/run.ts（一次性任务生命周期与 SDK 选项）、src/process.ts（SDK 到子进程句柄的投影）。
适用场景
把"我不想动手、就让 Claude 自己去干"的一段独立任务交给子 Agent，常见做法是让 DSH 主对话里的模型在工具白名单里看到 subagent_claude_code 后按需触发，比如一次性生成长文档、批量改文件、或让 Claude 自己拉一份现状总结再带回主对话。本包不适合需要持续对话、要看中间步骤、或者要求 Claude 工具一路弹交互确认的场景——这些需求跟"一次性、无人工、只读最终答案"的定位天然冲突。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH（launcher） | 0.1.0-rc.8 | 本包和同仓库其它包同版本（package.json:4），作为 Profile Bundle 注入 dsh-base 上层（cordis.patch.yml:1-6）。 |
| Node.js | ^22.19.0 || >=24.0.0 | 仓库根 engines.node 约束，subagent-claude-code 自身未声明独立范围（仓库根 package.json:8-10）。 |
| 平台 | 跨平台（macOS / Windows / Linux） | 实际可执行的 CLI 由 @anthropic-ai/claude-agent-sdk 的八个平台子包按系统/CPU/Linux libc 自带；省略 optional dependencies、不被支持的系统、载荷文件缺失都会让 provider 注册能成功但第一次委派在 SDK 启动边界失败（README.md:101, 103）。 |
| Claude Code CLI | 2.1.220（随 SDK 平台包） | 由 SDK 0.3.220 锁定，不依赖宿主 claude；本包也不查 PATH、不做平台选择、不回退到宿主二进制（README.md:42, 103）。 |
| 原生模块 | claude / claude.exe（来自 @anthropic-ai/claude-agent-sdk） | 安装后由 SDK 平台包携带，DSH 这边不再引入新的原生模块（README.md:101）。 |
disposeGraceMs 上限 | ≤ MAX_TIMER_DELAY_MS（2 147 483 647） | apply() 启动时校验，正有限值且不得超过仓库 dsh-timeout 共享上限（src/index.ts:136-145 / packages/util/timeout/src/index.ts:25）。 |
安装方式
dsh plugin --profile web add github:fufankeji/deepseek-harness-studio/packages/subagent/subagent-claude-code
配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
providerName | 字符串（非空） | 在 ctx.subagents 上的注册名，同时给 dsh-tool-subagent 工具行的 provider 字段引用；同一个 Profile 挂多份实例时需要互不重复（src/index.ts:58 / README.md:29）。 | claude-code |
env | 对象（Record<string, string>） | 显式透传给 Claude Code 子进程的环境变量，叠在父环境已被共享机制清掉凭证后的子集上；想让子进程拿到 ANTHROPIC_API_KEY 时必须在这里显式声明（src/index.ts:60 / src/run.ts:321 / README.md:42）。 | {} |
permissionMode | 枚举：dontAsk / acceptEdits / auto / plan / bypassPermissions | 选定这个 provider 实例对子进程的非交互权限策略；选 plan 还会把 ExitPlanMode 也放进 disallowedTools，强迫模型把计划当最终答案（src/run.ts:43-55, 323-342 / README.md:34-40）。 | dontAsk |
disposeGraceMs | 数字（毫秒，正有限值） | 共享进程树主人在各终止 tier 之间的等待时长，随后要等到整棵进程树退出才算清场（src/index.ts:62, 136-145 / src/process.ts:46-61）。 | 3000 |
常见问题
Q: 跟前一个 Claude 工具链有什么区别？是不是更简单的接入？
A: 不一样。这个包是 dsh 的"subagent 供应商"角色，承接 dsh-tool-subagent 那边发来的一次性请求，每次启全新的 Claude Code 进程跑完就结束；它不替 Claude 选模型、不持久化会话、不复制 Claude settings。dsh-base 里默认的 deepseek 入口是主对话模型，跟这个 provider 在进程级别就是独立的两条线（README.md:42, 115-117）。
Q: env 是不是只放 ANTHROPIC_API_KEY？别的变量怎么传？
A: 不是只能放 key，但请把 key 放在这里；父进程里任何被判定为凭证形态的环境变量在传给子进程前都会被 dsh-subprocess 剥掉。PATH、HOME、ANTHROPIC_BASE_URL 这种非凭证变量会被自然继承，要在 env 里显式覆盖也可以。DSH 这边不会创建账户、不会登录 Claude、不会改 settings 文件；登录态和有效 key 都得由 Claude 那一侧自己保证存在（README.md:42 / src/run.ts:321 / src/process.ts:30-38）。
Q: 安装好之后，模型怎么才知道有 subagent_claude_code 这个工具？
A: 并不知道，要靠你的 Agent Preset。full Preset 默认把对应的 tool 行设成 disabled: true，需要先复制 Preset 再去掉这一字段；起一个基于复制品的新 Session 时，模型才会看到那个静态工具名。每个 dsh-tool-subagent 行需要一个独立 toolName 暴露给模型，因此同 Profile 下挂多份 provider 时也要给每个工具起不同的名字（README.md:52）。
Q: 子进程里跟 Claude 的设置文件是怎样生效的？
A: 走原生 Claude settings 的相对路径，本包既不指定 settingSources，也不去 copy / 过滤它们的文件。所以在父会话的工作目录下会按 Claude 自家的 user / project / local 三层去找配置和登录态。也就是说你能在项目里放一份 .claude/settings.json 影响这个 provider，而卸载本包不会动到你这些文件（README.md:17 / README.md:144）。
Q: 怎么从失败里看出到底是 SDK 报错还是子进程没起来？
A: 看 SubagentResult.diagnostic 里的 stage 段：query-start 多半是 SDK / 平台包找不到、query-run 是跑着跑出错（比如 SDK 的四种错误子类型被显式保留成原名）、process 是 CLI 已经跑了但没正确出结果、teardown 是清理阶段 sub-process 退出失败。同时出现的 exit code / signal 行就是进程层的真实退出原因。原始的产品层或 Host 错误永远在 Error 的 cause 链里，不会直接进入这条 diagnostic（README.md:19 / src/run.ts:82-97, 540-568）。
Q: 我能让一个工具实例同时支持 foreground 和后台跑吗？
A: 可以，但需要分两个工具行。dsh-tool-subagent 的 backgroundMode 选 one-shot 时，省略 run_in_background 或传 false 走前台（同步阻塞）；传 true 则立刻返回一个由父 Agent 拥有的 Job id，配合 dsh-tool-jobs 提供的 job_output / job_kill 后续拉。前提是你的 Profile 已经装好本地作业服务（@deepseek-ai/dsh-jobs-local / dsh-tool-jobs）（README.md:52）。
上手难度
进阶 —— 需要先看懂 dsh 的 Profile Bundle 模型、cordis patch 注入顺序、dsh-tool-subagent 与 job 的接缝，并且要会自己配置 Claude 那边的 settings 和 key 才能让子进程跑通；如果只想"插上去就能用"会觉得整条链路偏长。
已知问题与限制
- 每次运行都新建一个 SDK query 和一个新 CLI 进程：不支持续接、resume、池化、进度流、产品会话持久化（README.md:141）
- 实例选择是静态的：Profile 行固定 provider 名与工具绑定；模型不能在调用时挑 provider，每个对外工具必须有唯一
toolName（README.md:142） - 宿主 Claude settings 始终是权威：本包不提供"经过筛选或与宿主环境隔离"的生产模式，项目和用户层 settings 能改模型和工具（README.md:143）
- 认证与账户状态由 Claude 原生侧管理：本包不创建账户、不登录、不改 settings；配置或认证失败会以生命周期阶段 +
unknown回退报出来（README.md:144） - 委派时必须有 SDK 平台载荷：可选依赖被跳过、平台不被支持、平台载荷缺失或损坏都会在首次 query 失败，不存在"宿主 CLI 回退"路径（README.md:145）
- 不存在人工交互通道：
AskUserQuestion已禁用，权限提示会被拒，MCP elicitation 会被拒，未声明的对话会快速失败不挂起（README.md:146 / src/run.ts:323-360） - assistant 载荷仅含最终文本：推理 / 中间消息 / 工具调用 / 用量 / 进程 stderr / 工作区差异都留在 Claude 那侧；失败时按需多带一段独立安全诊断（README.md:147）
- 不支持可选共享能力：共享 subagent 服务会拒掉本 provider 的输出 schema、子角色、工具筛选、harness 深度强制（README.md:148）
- 没有按经过时长触发的超时或副作用回滚：调用方主动 abort 才会停；停之前子进程已经写过、改过、调过外部接口的状态不会被自动还原（README.md:149）
DeepSeek Harness Studio
赋范空间出品 · DeepSeek Harness 的零代码桌面增强
视觉增强 + 插件市场 + Preset 广场 · 0 代码一键部署和使用
自动发现并推送生态新插件，AI 智能推荐值得安装的能力；无需命令行即可完成搜索、校验、安装、启停与卸载。
下载 macOS arm64 开发预览版 · 下载 Windows x64 开发预览版
点击快速查看功能演示
https://github.com/user-attachments/assets/0717f7c7-a872-4d2b-acc2-3a1c4874c732
先看功能：当前能力与近期路线图
状态说明：✅ 已支持；🗓️ 规划中。桌面开发工作区、公开插件中心、Preset 广场、应用中心和中文 DeepSeek 控制已经可用；规划能力会在真实功能可运行后更新状态。
| 能力 | 状态 | 可以做什么 |
|---|---|---|
| 插件发现与热门推荐 | ✅ | 自动读取公开目录，按精选、最近更新、生态热门和使用场景呈现值得关注的插件，并支持按名称、功能或作者搜索。 |
| 公开插件中心 | ✅ | 查看确定版本、能力、权限、兼容性与风险，一键在线安装，并集中管理插件的启用、停用、更新和卸载。 |
| Preset 广场与内置工作流 | ✅ | 浏览赋范官方与社区 Agent Preset，查看能力组成后完成一键安装，并从“已安装”直接用于新会话；当前内置七套真实场景工作流。 |
| 应用中心与内置 AI 应用 | ✅ | 从独立一级入口启动拥有专属界面、数据和运行流程的完整 AI 应用；首个内置应用 FF–LLM Wiki 提供企业文档、Wiki、知识图谱、溯源问答与质量评估。 |
| 桌面开发工作区 | ✅ | 在本地打开项目、管理会话与工作区，调用 Harness 的模型、工具、Skills 和插件能力，并直接修改完整源码。 |
| 视觉增强 | ✅ | 一个开关自动选择原生图片输入，或已验证的百炼／OpenRouter 兼容视觉，并显示当前实际路径。 |
| 中文 DeepSeek 控制 | ✅ | 使用中文权限选项和适配 DeepSeek 的思考模式，在输入区直接完成会话级选择。 |
| 内置皮肤与自由换肤 | ✅ | 默认使用“大肥鱼拟人”皮肤，可切换“官方原版”或“云端猫咪”，也可选择本地图片并自动适配界面配色。 |
| 独立 MCP、Skills 与工具管理 | 🗓️ | 后续提供不依赖 Bundle 包装的 MCP Server、Skills 与工具发现和连接管理，按项目自由组合 Agent 能力。 |
| 自定义 Agent 与多 Agent 协作 | 🗓️ | 在现有 Preset 安装和使用能力之上，自定义 Agent 与子 Agent，把编码、测试、调研和审查任务交给不同角色协同完成。 |
| 任务规划、后台运行与会话恢复 | 🗓️ | 管理计划和待办，让长任务在后台继续运行，并随时查看进度或接续历史会话。 |
| 项目规则、Hooks 与长期记忆 | 🗓️ | 集中管理项目指令、自动化 Hooks 和可持续复用的上下文，让 Agent 按仓库规则稳定工作。 |
| Git、Worktree 与代码审查 | 🗓️ | 在隔离工作区并行开发，查看 Diff、提交和审查结果，减少多人或多任务互相干扰。 |
| 浏览器与桌面自动化 | 🗓️ | 让 Agent 操作网页和本地应用，并通过真实交互结果验证任务是否完成。 |
| 手机远程与消息通道 | 🗓️ | 从移动端查看和接续任务，并通过常用消息渠道接收通知或触发 Agent。 |
项目简介
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 后，就能直接用对应角色创建新会话。
| 能力层 | 它是什么 | 主要解决什么 |
|---|---|---|
| Skill | 可复用的方法、步骤与约束 | 告诉 Agent 一类任务应该“怎么做” |
| Plugin / MCP | 可执行工具或外部服务连接 | 让 Agent 能真实读写系统、调用服务并完成动作 |
| Agent Preset | 角色、Skill、工具与运行规则的组合 | 把零散能力装配成一套开箱即用的数字员工或工作流 |
当前源码已经提供与“插件中心”“插件发现”平级的 Preset 广场，并完成发现、详情、安全安装、已安装管理、用于新会话、删除与重新安装的桌面端闭环。
真实 Desktop 界面：Preset 广场、赋范官方内置目录、搜索与排序，以及安装、查看详情和用于新会话入口。
使用路径： 发现 Preset → 查看能力组成与前置条件 → 一键安装 → 在“已安装”中选择“用于新会话” → 按工作流完成任务 → 随时删除或重新安装。
- 从左侧导航进入 Preset 广场，可搜索用途、名称或作者，并按下载量或更新时间排序。
- 打开详情查看它包含的角色、Skill、工具、外部依赖和来源说明。
- 点击安装后，Desktop 会校验来源、大小、摘要和归档路径，再写入本地用户 Preset 目录。
- 安装完成后无需重启 Host；在 已安装 中点击“用于新会话”，即可带着对应 Preset 开始任务。
- 用户 Preset 可删除并重新安装；系统 Preset 继续受保护。安装或删除后仍停留在当前页面，不打断浏览过程。
安装、删除和用于新会话涉及本机文件与 Host，只在 Desktop 中执行；浏览器开发模式用于快速查看和验收界面，不会修改本机 Preset。
赋范官方内置 Preset：七套真实场景工作流
内置内容不是“插件合集”，而是七套围绕真实交付结果组织的 Agent Preset + Skills + 工具集成。合计包含 7 套 Agent Preset、9 个 Skills、1 个图像生成 Plugin；飞书数字员工另外接入飞书 MCP 与时间解析 MCP，PPT Office 使用内置动效运行适配器。
命名说明： “赋范官方”表示由赋范桌面端开发团队内置和维护，不代表 DeepSeek Harness 官方。它们安装后仍是普通用户 Preset，可以删除并重新安装。
| 分类 | 内置 Preset | 能力组成 | 直接交付 |
|---|---|---|---|
| 产品与应用开发 | AI WebApp | 1 Preset + 3 Skills | 从需求澄清、规格整理到 TDD 验收的可运行 Web 产品 |
| 办公与演示 | PPT Office | 1 Preset + 1 Skill + 动效运行适配器 | 8 页、四主题、可交互的单文件 HTML 演示文稿 |
| 视觉与媒体 | 视频生成 | 1 Preset + 1 Skill | 从一句话调研、分镜到渲染完成的 16:9 MP4 |
| 内容生产 | 内容工厂 | 1 Preset + 1 Skill + 1 图像生成 Plugin | 从长文分析到 1–10 张风格一致的图文卡片 |
| 数据分析 | AI 报表 | 1 Preset + 1 Skill | 从本地 Excel 生成可核验的离线交互报告 |
| 企业协同 | 飞书数字员工 | 1 Preset + 1 Skill + 飞书 MCP + 时间解析 MCP | 从自然语言指令到真实飞书任务与双端回执 |
| 知识库研发 | LLM Wiki Producer | 1 Preset + 1 Skill | 使用「LLM Wiki 全栈工程师」按阶段开发、验证并交付企业知识库项目 |
下方六个案例统一使用
16:10预览图，避免横幅和长图破坏版面；点击任意图片可查看完整原图。
产品与演示：把想法变成可交付成果
 |  |
|
01 · AI WebApp 解决什么：需求讨论结束后，仍不知道如何稳定落成一个可运行、可测试的 Web 产品。 功能逻辑：需求澄清 → 规格整理 → TDD 纵向开发 → 类型检查、构建与浏览器验收。 能力组成： grill-me、to-spec、tdd 3 个 Skills + 专属产品开发 Preset。示例结果：可启动、可拖拽、可更新数据的“创作指挥舱”WebApp。 |
02 · PPT Office 解决什么：只有主题和内容大纲时，快速形成结构完整、视觉统一、可离线播放的演示成果。 功能逻辑：保存原始内容 → 组织 8 页叙事大纲 → 选择主题并生成 → 确定性检查页数、动画与离线性。 能力组成：1 个动效演示 Skill + 专属导演 Preset + 内置动效运行适配器。 示例结果：四套主题、逐页语义动画的单文件 HTML；当前明确不生成 .pptx。
|
内容与媒体：把一句话或一篇长文变成成品
 |  |
|
03 · 视频生成 解决什么：只有一句产品想法时，仍能建立从事实调研到正式成片的完整生产链。 功能逻辑：四维 Web 检索 → 研究与简报 → 设计规范、分镜和视频源码 → HyperFrames 检查 → FFmpeg 渲染与媒体验收。 能力组成：1 个产品发布片 Skill + 专属视频导演 Preset。 示例结果：可编辑视频工程、联系表和 16:9 MP4；运行环境需要 FFmpeg 与 ffprobe。 |
04 · 内容工厂 解决什么：把一篇长文稳定拆解成风格统一、可以连续发布的系列视觉内容。 功能逻辑：分析受众与观点 → 确认风格、布局和配色 → 编写系列大纲与逐图提示 → 生成 1–10 张图片 → 校验尺寸、页数与一致性。 能力组成：1 个图文 Skill + 专属内容视觉 Preset + Codex ImageGen Bridge Plugin。 示例结果：9 张连续图文卡片；真实生图前需要本机 Codex CLI 已登录并具备 ImageGen 能力。 |
数据与企业协同：从本地数据到真实业务动作
 |  |
|
05 · AI 报表 解决什么：把本地 Excel 从“原始表格”转成结构清晰、可追溯、可直接交付的数据叙事。 功能逻辑：只读核对工作簿与数据基线 → 清洗聚合 → 选择图表叙事 → 内联 ECharts 生成 → 桌面与移动双端验收。 能力组成：1 个 Excel 报表 Skill + 专属数据分析 Preset。 示例结果：不依赖 CDN 的单文件交互 HTML，原始 Excel 保持只读，报告只嵌入聚合数据。 |
06 · 飞书数字员工 解决什么：让对话不止返回文字，而是把一句自然语言真正变成企业协作系统中的任务。 功能逻辑：Harness Desktop 或飞书接收指令 → Skill 判断动作 → 时间 MCP 解析“明天下午 6 点” → 飞书官方 MCP 创建任务 → Harness 与飞书双端返回回执。 能力组成：1 个飞书 Skill + 专属数字员工 Preset + 飞书 MCP + 时间解析 MCP。 示例结果：真实飞书任务、负责人和截止时间均可查看；首次使用需要配置飞书应用凭据与默认负责人。 |
以上图片均来自六套工作流的真实案例成果。Desktop 随安装包交付的是运行所需的精简 Preset、Skills 与工具适配，不会把案例源码、输入数据、截图或生成成品塞进用户环境。
应用中心已上线：从能力扩展进入完整 AI 应用
插件为 Harness 增加工具或界面能力，Preset 把角色、Skills 与工具组合成一套工作方式，而 应用 面向更完整的产品场景：它拥有独立界面、专属数据和自己的运行流程。应用中心因此与插件中心、插件发现和 Preset 广场平级，用户不需要在插件列表中辨认技术包，直接从一个稳定入口发现并启动完整产品。
| 形态 | 主要作用 | 典型使用方式 |
|---|---|---|
| Plugin / MCP | 增加可调用工具、服务连接或局部界面能力 | 安装后由 Agent 或 Harness 功能触发 |
| Agent Preset | 组合角色、Skills、工具与工作规则 | 用 Preset 创建新会话并按既定流程完成任务 |
| AI 应用 | 提供专属界面、数据和端到端业务流程 | 从应用中心直接打开并持续管理自己的业务数据 |
真实 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 使用的项目图片
常用开发命令
| 命令 | 用途 |
|---|---|
pnpm run dev:desktop | 构建必要模块并启动 Electron 桌面应用 |
pnpm run dev:desktop:rebuild | 强制完整重建后启动桌面应用 |
pnpm run build | 构建 Host、客户端、Web 与桌面端 |
pnpm run package:desktop | 为当前平台生成未封装桌面应用 |
pnpm run typecheck | 运行 TypeScript 类型检查 |
pnpm run test | 运行 Vitest 单元测试 |
建议阅读顺序
apps/desktop/src/main.ts：桌面应用入口、窗口、托盘和本地 Host 组合。apps/desktop/src/host-supervisor.ts：dsh web的启动、就绪检测与退出管理。apps/desktop/src/preload.ts：Renderer 可访问的固定桌面接口。apps/web/：桌面窗口加载的 Web 工作区。apps/cli/与packages/：CLI 组合以及各项 Harness 能力实现。
与 DeepSeek Harness 的关系
本项目基于 deepseek-ai/deepseek-harness 的 Harness 核心、Cordis 插件体系和 Web 界面继续进行桌面端开发。本仓库维护 Electron 桌面入口、本地 Host 管理、桌面交互与配套开发脚本。
许可证
本项目使用 MIT License。第三方组件的许可证信息见 THIRD_PARTY_NOTICES.md。
收录徽章
[](https://deepseek-plugin.org/plugins/fufankeji/deepseek-harness-studio/packages/subagent/subagent-claude-code)把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。