阅读指南
Nonead DSH Desktop 用户使用手册
这是一份给普通使用者的操作手册。它不要求你会写代码，也不需要事先安装 Node.js、pnpm 或任何开发工具——安装包里已经带好了全部运行环境，装完就能用。
本册导览
十三节按「装好 → 用起来 → 出问题」的顺序排。只想解决某个具体问题，可以直接跳到第十二节。
- 一 · 这是什么——三层结构，日常只碰最上面那一层。
- 二 · 安装——三个平台各取哪个包、怎么装。
- 三 · 第一次打开——五步向导，以及「关闭不等于退出」。
- 四 · 主界面速览——四个区域各自管什么。
- 五 · 第一次对话——怎么把需求说清楚。
- 六 · 托盘菜单——六个系统级入口。
- 七 · 设置页——五个分区能改什么。
- 八 · Profile——多套配置怎么切换、失败怎么回退。
- 九 · 插件与插件市场——两种安装途径与「装完要重启」。
- 十 · 已装插件清单——本机 35 个插件逐个讲用途与用法。
- 十一 · 更新——五个阶段与四个可复用操作。
- 十二 · 遇到问题——常见现象对照表与诊断导出。
- 十三 · 数据与帮助——文件位置与更多文档入口。
一、这是什么
一句话：它把 DeepSeek Harness 的智能体能力装进了一个桌面应用，双击图标就能开始对话、让它读写文件、执行命令、调用工具。
整个产品由三层组成，你只需要和第三层打交道，前两层在后台自动运行。
二、安装
到产品下载页取对应平台的安装包，双击即可。安装包已经内置 Electron、Node.js、pnpm 和固定版本的 DSH 运行时，不需要另外装任何环境。本版内置的是 Electron 44.0.0、Node.js 24.21.0、pnpm 11.8.0、Python 3.12.14，以及 DSH 运行时 0.2.2-rc.1。
| 平台 | 下载到 | 怎么装 |
|---|---|---|
| Windows x64 | .exe 安装程序 | 双击运行，按提示下一步完成 |
| macOS（Intel / Apple 芯片通用） | .dmg 磁盘映像 | 打开后把图标拖进「应用程序」 |
| Linux x64 | .AppImage | 先 chmod +x 赋予执行权限，再双击或命令行运行 |
注：Windows ARM64 目前是实验性构建，内置的 Python / Node 运行时仍是 x64 载荷，未在 ARM 设备上完成完整验证，普通用户建议使用 x64 版本。
三、第一次打开
首次启动会自动准备好一套默认配置，并在本机启动界面服务。你会先看到一段向导：
- 欢迎页——介绍产品的基本定位。
- 插件市场——选择是否启用社区插件市场。选「不启用」也会被记住，之后不会反复问你。
- 远程控制——是否允许手机等设备连接本机桌面端。
- Computer Use——是否允许它操作你的鼠标键盘。
- 恢复模式——介绍出问题时的「安全网」怎么用。
四、主界面速览
主窗口的结构很简单，从上到下、从左到右只有四个区域。
| 区域 | 作用 |
|---|---|
| 桌面框 | 顶部那条 36 像素的深色条。空白处可以拖动窗口，上面的图标可以直接点击。 |
| 侧边栏 | 会话列表、工作区与文件入口、插件入口。会话可以随时切换，历史都留着。 |
| 对话内容区 | 你输入的内容、它的回复、工具执行结果都在这里。 |
| 输入框 | 描述需求的地方。越具体，结果越接近你想要的。 |
五、开始第一次对话
- 在输入框里用中文写清楚你要什么，例如「把这个目录下的所有 png 转成 webp，保持原尺寸」。
- 按回车发送。它会先理解、再规划，必要时调用工具。
- 涉及写入、删除、执行命令这类有风险的操作时，会弹出原生确认框，由你点同意或拒绝。
- 结果会显示在对话里；不满意就直接说「改成……」，不必重新开始。
六、托盘菜单
大部分系统级操作都收在托盘图标里。右键托盘图标，你会看到这些入口：
- 打开设置——进入桌面设置页。
- 检查更新——手动检查新版本；即使已是最新也会给出结果。
- 切换 Profile——在多套配置之间切换（见第八节）。
- 恢复助手——启动异常时回滚到最近一次能用的配置。
- 打开 DSH 终端——打开一个已经配好环境变量的终端。
- 退出——真正关闭应用。
七、设置页
设置页按功能分成五个区域，从左到右：
| 分区 | 你能在这里做什么 |
|---|---|
| 通用 | 开机自启、界面语言、本地 Web 端口、更新卡片（含「更新说明」与手动检查）。 |
| Profile | 查看与新建配置档，切换当前使用的 Profile。 |
| 工具 | 打开 DSH 终端、普通重启、以恢复模式重启。 |
| 恢复 | 列出健康快照并回滚；每次回滚前会先给当前状态留一份快照。 |
| 权限 | 管理 Computer Use 等系统权限。 |
八、Profile：多套配置
Profile 可以理解成「一套独立的配置档」：不同的插件组合、不同的补丁、不同的设置。你可以同时准备多套，按场景切换，互不干扰。
记住三点：
- 切换 Profile 会重启应用，这是设计使然，不是卡住了。
- 不同 Profile 之间不会自动复制插件——需要另一套插件就在终端里显式安装。
- 大多数情况下，所有 Profile 共用同一份会话与设置数据，切换过去历史还在。
九、插件与插件市场
插件是给这个助手加能力的方式：加模型、加工具、加界面面板、加自动化流程。官方插件可以直接装，多个插件可以同时生效。
两种安装途径：
- 插件市场——在界面里浏览、按名字搜索、点安装。市场与桌面端在同一套组合里互斥，不会冲突。
- 命令行——在托盘打开的 DSH 终端里执行
dsh plugin add <插件名>，remove卸载，update升级。
十、我装的 35 个插件怎么用
这一节按你当前 desktop 配置档里实际安装的 35 个插件逐个介绍，名称与版本是从本机配置档实测采集的（快照日期 2026-11-08）。按用途分成七组，每组先给一句总览，再逐个说明它是干什么的、什么时候会用到它。
它们不是各自孤立的，实际使用时会形成一条从「记住上下文」到「交付成果」的链路：
dsh plugin add <插件名>；卸载用 remove；升级用 update。任何变更后都要重启应用。命令默认作用在当前激活的 Profile 上，想指定就加 --profile <名字>。
第一组 · 记忆与上下文（5 个）
这一组解决「它记不住上次说过什么」的问题。
@a9i5k4/dsh-auto-memory3.3.17主动式联想记忆：模型开口前先自动召回相关记忆，分三层自动整理，还能把重复做的流程固化成技能。
怎么用：不需要额外操作，它自己判断该召回什么；想让它整理旧记忆就说「把最近的经验整理一下」。
@yolk_vat-y/dsh-project-memory0.6.11把文档（PDF / Markdown / 文本）和代码符号索引成每个工作区独立、可检索的库，召回时带出处引用。
怎么用：进入一个项目后先让它索引一次，之后问「这个项目里 XX 是怎么实现的」，它会带文件出处回答。
dsh-context0.82.1看清当前上下文是由什么构成的、占了多少，并据此做精简，避免对话越聊越慢。
怎么用：对话变慢或提示上下文过长时，打开它的面板看构成，把不需要的历史裁掉。
dsh-nonead-prompt-recall0.8.7输入框为空时按 ↑ 调出上一条输入，再按继续往前翻；按 ↓ 往回走。历史按工作区分开存，重启后还在。模型选择器旁边还有一个改写按钮：用当前模型把你写到一半的提示词重写一遍，@ 引用会保留。
怎么用：想复用刚才那段长提示词，不用重新打字，空输入框按 ↑ 即可。
dsh-nonead-prompt-rewind0.5.4在窗口内把对话回退到之前某一轮，并且可以同时把工作区文件一起还原。
怎么用：改错了方向想说「回到三步之前重来」时用它，比新开一个会话更省事。
第二组 · 技能与专家（8 个）
这一组解决「遇到具体任务时，怎么让它按专业套路做」的问题。
@michengai/dsh-skills-manager1.2.35统一加载并安全管理本机的 Agent Skills，避免多个来源的技能互相覆盖。
怎么用：装完新技能后在这里确认它被正确加载、来源清楚，再决定启用哪些。
@weibaohui/skills-management0.9.3一个页面管理本机所有编程助手的技能（Claude、Codex、ZCode 等十余个），可一键收编进 DSH；内置 6600+ 技能市场，支持按注入开销排序。
怎么用：想给某个能力找现成技能时先搜这里；装之前看它的 token 开销，别一次装太多。
@linxin666/dsh-client-ui-skill-explorer0.4.15按来源（内置 / 项目 / 用户 / 自定义 / 运行时）浏览已加载技能，可启用停用、新建删除。
怎么用：怀疑某个技能没生效时，先在这里确认它属于哪一层、是不是被停用了。
@wenaixi/dsh-superpower8.0.0打包 15 个 obra/superpowers 工程技能（需求澄清、TDD、系统化调试、代码审查等），中英双语描述，可逐个开关。
怎么用：开发类任务优先让它走这套流程；不需要的单个技能可以关掉，减少干扰。
@michengai/dsh-agency-agents1.2.26331 名可召唤的专业智能体，覆盖 22 个领域分工，可按需召唤单个专家或组队。
怎么用：遇到需要专业视角的问题，直接说「让 XX 专家看」；复杂任务可以组队并行。
dsh-github-skills0.2.1移植 OpenAI Codex 的 GitHub 工作流语义：看 PR、处理审查意见、查 CI、发布等。
怎么用：在仓库里说「看看这个 PR 的审查意见」或「CI 为什么挂了」，它会走对应流程。
@tt-a1i/archify-dsh1.0.0把需求或代码结构画成可交互的架构图、流程图、时序图，独立 HTML 输出，支持深色模式与导出。
怎么用：说「画一下这个系统的架构」，它会先读代码再画，不是凭空构图。
dsh-ppt-master6.1.0AI 驱动的演示文稿工作流：生成可编辑的 PPTX、页面快照、填充原生模板。
怎么用：给它主题和要点，或让它基于现有文档生成；要改版式就说「换成原生模板」。
第三组 · 界面与效率（8 个）
这一组改善的是「你每天看到的界面」和「花费多少」。
dsh-better-sidebar0.30.1把文件树、编辑器、变更、任务和侧聊收进同一列，且每个会话互不干扰。它还对外提供一个服务，让别的插件把自己的页签和文件查看器挂进这条侧边栏——第十二节里「右侧面板报 4xx」就是某个插件没拿到这个服务。
怎么用：改代码时不用来回切窗口，在右侧直接看文件、看 diff、开侧聊。
@linxin666/dsh-client-ui-task-board0.4.15Host 权威的任务板：卡片可真实执行、支持 cron 定时与跨平台休眠保护。
怎么用：把要做的事拆成卡片排进看板，让它按顺序或按时间自动跑。
@linxin666/dsh-client-ui-git-graph0.4.14空会话时的分支选择器 + Git 关系图，带真实的 Host 侧 git 操作与安全检查。
怎么用：开新会话前先在图上看清分支关系，避免在错误的分支上动手。
@changfenhuang/dsh-genui0.15.0在回复里直接渲染可交互组件：布局、图表、函数图、表单、测验等。
怎么用：想要图表或对比表时直接说「用表格/图表给我看」，它会渲染成可操作的面板。
dsh-notify-say0.5.3桌面通知会真的念出来：Windows 自带 TTS 开箱可用（不用下载任何东西），VOICEVOX 音色可选，也可以退回系统音效。它还会等你派出去的子代理全部跑完，才念「这一轮做完了」。
怎么用：长任务跑着你去干别的，完成时它会出声提醒；可在设置里换音色。
dsh-cost-meter1.9.58统计本会话与当日费用，内置 170+ 模型价格目录并自动匹配；还能查 16 家 Coding Plan 的订阅额度，以及自定义 Provider 的余额（配任意 HTTP 端点）并显示成进度条。
怎么用：跑长任务前看一眼当日花费；换模型时对比单价，避免用贵模型做便宜活。
@michengai/dsh-archive-manager1.2.8归档、恢复、收藏、永久删除会话，并能诊断损坏的会话日志。
怎么用：会话列表太长时归档旧的；某个会话打不开时先用它诊断日志。
dsh-client-auto-continue0.17.4会话因网络错误等非人为原因中断时，自动替你发一条继续提示把对话接上；引擎跑在宿主进程里，关掉浏览器标签页也会继续工作。默认只做「中断恢复」，跑完还想接着做的自主循环要在设置里手动开启。
怎么用：网络不稳或要跑长任务时打开它，回来时对话已经接上；想让它一轮接一轮地自己干，再单独开启自主循环。
第四组 · 协作与开发（8 个）
这一组让「一个助手」变成「一个团队」。
@deepseek-ai/dsh-tool-subagent0.2.2-rc.1面向模型的子代理委派工具：把独立的子任务丢给另一个代理去做，不占用当前对话的上下文。
怎么用：任务能拆成互不依赖的几块时，让它并行分派，主对话只收结论。
@deepseek-ai/dsh-subagent-claude-code0.2.2-rc.1基于官方 Agent SDK 的一次性 Claude Code 子代理，把任务交给它跑完再收结果。
怎么用：需要 Claude Code 那套能力（大范围改代码、跑测试）时点名用它。
@deepseek-ai/dsh-subagent-codex0.2.2-rc.1基于官方 app-server 协议的一次性 Codex 子代理。
怎么用：想把某段实现交给 Codex 独立完成时用它，与 Claude Code 子代理可并存。
@michengai/dsh-code-review1.0.8Codex 风格代码审查：独立原生子 Agent、可选审查范围、中英文报告。
怎么用：提交前问「审一下我这次的改动」，它按 diff、相关代码、未提交文件分范围检查。
dsh-superagent0.1.0面向单个 GitHub 仓库的主动代理：监听 GitHub（可选飞书），按规则评估请求。
怎么用：想让它替你盯 issue / PR 时启用；先确认它作用的仓库与触发规则。
dsh-find-plugins0.3.0跨五个社区目录 + 实时 GitHub / npm 搜索找插件，按相关性 × 信任 × 新鲜度 × 热度排序。
怎么用：想加个功能先问「有没有这样的插件」，比直接去市场翻更准。
dshmarket1.73.14界面里的可视化插件市场：逛、搜、一键安装。
怎么用：设置页打开市场，搜到就点装；装完重启才生效。
dsh-mcp-connector0.2.94连接企业、金融、法律、专利、科研等数据源的 MCP 市场，管理授权、搜索与调用。
怎么用：需要外部数据时先在这里找连接器并授权；调用前看清它要什么权限。
第五组 · 机器人控制（2 个，拓德科技自研）
这一组让 DSH 用自然语言直接驱动 Universal Robots 机械臂。
dsh-nonead-universal-robots0.8.6用自然语言控制 UR 机械臂：读状态、动关节、走直线、力控、I/O 与寄存器、传送带跟踪等，基于自研 nUR MCP Server 的同源逻辑。
怎么用：先说「连接 192.168.x.x」，再做动作。涉及运动的指令默认受审批门禁约束，需要你逐条确认。
dsh-nonead-ursim0.3.14同一套逻辑的离线仿真版：在没有真机的情况下驱动虚拟 UR 机械臂验证轨迹。
怎么用：先在仿真里把动作跑通、确认不撞，再上真机；仿真只做运动学，力控与 I/O 没有语义。
第六组 · 图像与媒体（3 个）
这一组负责把结果做成能直接交付的东西：图、视频、文档。
dsh-image-gen0.10.3把 ChatGPT 式的图像生成带进 DSH：支持 Gemini、OpenAI、Seedream、DashScope，也可以走本机 ComfyUI 工作流；配套一个可画草图、选参考图的工作台画布。
怎么用：说「画一张……」它就出图并直接附在对话里；要改已有图片就说「把这张改成……」。想换供应商或模型要明确说出来，它默认用设置里配好的那个。
dsh-remotion0.10.5官方 Remotion 技能 + 工程检索、模板、素材排序、Studio 预览与 MP4 导出。
怎么用：要做一个视频或片头时启用；先看模板再改，比从零写组件快。首次准备环境会下载依赖，需要联网。
dsh-univer-office0.4.0DSH 与 Univer 集成：文档内联预览、浮动 Worktree 窗口、会话结束时的评审动作。
怎么用：让它产出表格 / 文档 / 演示稿时，结果会直接在面板里预览，不必下载再看。
第七组 · 系统维护（1 个）
dsh-config-manager0.4.3备份、恢复、导出、导入、迁移与同步整套 DSH 配置：设置、插件、MCP、技能、代理预设等。
怎么用：大改配置前先导出一次；换机器时用导入恢复，比逐项重配快得多。
profiles/desktop/package.json 里的 dependencies。
也不建议一股脑全开。插件越多，上下文与启动开销越大。前面那个「技能市场」能看每个技能的注入开销，装之前先估一下；暂时用不上的可以先停用，需要时再启。
十一、更新
应用会在后台悄悄检查新版本，不打扰你。发现新版本时只会在托盘上提示，不会自己弹窗。
几个实用开关：
| 操作 | 效果 |
|---|---|
| 跳过此版本 | 该版本以后不再提示；重启后依然有效 |
| 不再跳过 | 清除跳过记录，该版本重新参与提示 |
| 重试安装 | 复用已下载的安装包，不重新下载 |
| 安装并重启 | 准备好之后直接安装并重启 |
十二、遇到问题怎么办
先对照下表，绝大多数问题都能自己解决。
| 现象 | 怎么办 |
|---|---|
| 窗口不见了 | 看系统托盘。关闭窗口只是隐藏，不是退出。 |
| 点了没反应 / 一直转圈 | 等一会儿；仍无响应就用托盘菜单重启，或「以恢复模式重启」。 |
| 启动就崩、进不去 | 用「恢复助手」回滚到最近一次能用的配置。回滚前会自动备份当前状态，所以回滚本身也能再回滚。 |
| 插件装了不生效 | 确认命令作用在正确的 Profile 上，并重启应用。 |
| 让它出图却没出 | 图像生成要先在设置里配好一个图像供应商（API 凭据，或已登录的订阅账号）。没配好之前它只会告诉你没有可用的供应商。 |
| 终端里找不到命令 | 从托盘重新打开一个「DSH 终端」；桌面端不会修改系统 PATH。 |
| 右侧「文件」等面板一直报 4xx | 通常是某个插件缺依赖服务而卡住。在数据目录的 logs/ 里搜 pending (waiting for service:，禁用对应插件后重启。 |
| 没收到更新提醒 | 后台检查是静默的。用托盘或设置里的「检查更新」手动看结果。 |
导出诊断信息
如果问题需要反馈给维护者，可以右键托盘图标导出诊断包。它会收集最近的日志；日志中的可识别凭据会被打码，但本地路径、工作区名、会话 ID 可能残留——公开上传前请先自己检查一遍内容。
十三、数据在哪、去哪找帮助
| 内容 | 位置 |
|---|---|
| 数据目录（会话 / 设置 / 日志） | 默认 ~/.dsh，Windows 上是 %USERPROFILE%\.dsh |
| 日志 | 数据目录下的 logs/ |
| 窗口位置尺寸 | 应用数据目录下的 window-state.json |
| 桌面设置（含端口） | 数据目录下的 desktop-preferences.json |
| 环境变量覆盖 | 应用数据目录下的 .env（严格 KEY=VALUE，不覆盖真实环境变量） |
更多文档
- 更简短的上手指南——
docs/user-guide.md - 常见问题（平台差异、使用边界）——
docs/faq.md - 为什么做桌面版——
docs/why-desktop.md - 架构说明——
docs/architecture.md - 插件开发与生态——
docs/plugin-development.md、docs/plugin-ecosystem.md
致谢
这一册能写出来，靠的是两层人的工作。
DeepSeek 与 DeepSeek Harness 上游团队——本产品建立在未修改的上游之上：智能体循环、工具调用、插件宿主、Web 界面都来自上游，上游的公开代码与文档是这份手册的技术底稿。
35 个插件的作者——第十章逐个介绍的插件，绝大多数由社区独立开发与维护。按仓库归属归并，下面是各自的 GitHub 账号或组织：
Aik358·omdsh-dev·zhu1090093659·MichengAI·Wenaixi·weibaohui·tt-a1i·00080000·HsiangNianian·xiajiajun516·bowenliang123·Han-1413141·Eray114514·Starfie1d1272·shanliuling·duhu2000·unifilitence·pn1024·STARDUSTLC666·DreamNum / Univer·dsh-market·DeepSeek Harness Team·NoneadChina
安装包本身也站在开源项目肩上：Electron、electron-builder、pnpm、Node.js 与 Python 运行时，以及上游依赖树里的众多作者。名单若有遗漏或署名有误，欢迎在仓库提 issue 指正。
公司全称：苏州拓德机器人科技有限公司
地址：中国江苏苏州园区星汉街 5 号腾飞新苏坊 B 栋 4 楼 9-10 号
网址：https://www.nonead.com
电话：0086-0512-67263000
邮箱：service@nonead.com