docs: refresh PPT, recovery and mobile guidance with new hero

This commit is contained in:
QinRui
2026-09-08 18:46:09 +08:00
parent ad5805c02d
commit ff620ab65d
9 changed files with 72 additions and 2 deletions
+10
View File
@@ -57,18 +57,28 @@ DeepSeek Harness ya proporciona el Agent Runtime y la Web UI. DSH Desktop añade
- Comprueba actualizaciones de la aplicación y deja la descarga e instalación bajo control del usuario
- Adapta menús, barra de título, foco de ventana, tema y marca para macOS y Windows
## Creación de PPT
Activa el botón **PPT**, elige una plantilla y describe la presentación que necesitas. El catálogo incluye **16 plantillas y 192 diseños**, con salida PPTX editable. Las vistas previas están en inglés; las presentaciones pueden generarse en inglés o chino, con ajustes de fuentes para ambos idiomas. El idioma de la vista previa no determina el del resultado.
PPT viene preinstalado y sus instrucciones automáticas solo se aplican a las sesiones con el botón PPT activado. Consulta la [guía de PPT](packages/ppt-runtime/README.md) para conocer las plantillas, las validaciones y las fuentes de referencia.
## Acceso desde el teléfono
Elige **Connect Phone…** en el menú `Harness` y escanea el código. El escritorio debe aprobar explícitamente la conexión antes de que el teléfono acceda a las sesiones.
Harness permanece en un puerto aleatorio de `127.0.0.1`. El teléfono usa un Bridge independiente y vinculado: puede limitarse a la red local o activar un Cloudflare Quick Tunnel temporal para el acceso remoto.
Si Cloudflare no se inicia, la aplicación intenta usar Pinggy. Si aparece el enlace de Cloudflare pero el teléfono no puede abrirlo, selecciona **Can’t open? Try another link** para cambiar a Pinggy.
## Modo seguro y recuperación
Si un plugin de terceros impide el inicio o la visualización, DSH Desktop relaciona la evidencia del Runtime y del frontend con los plugins instalados y abre una recuperación guiada.
Elige **Restart as Safe Mode…** en el menú `Harness` para iniciar un Profile aislado con los Bundle oficiales principales. Los plugins externos del Profile normal quedan bloqueados, pero el Agent, las sesiones, los ajustes de modelos y los espacios de trabajo siguen disponibles.
La pantalla de recuperación busca actualizaciones compatibles de los plugins y permite instalarlas cuando están disponibles. El Modo seguro también permite actualizar varios plugins a la vez. Para pedir ayuda, pasa el cursor sobre **WeChat group** para mostrar el código QR, o haz clic en **Discord** para abrir la comunidad.
Si no puedes abrir la interfaz normal, inicia la aplicación con `--safe-mode`. En macOS:
```sh
+10
View File
@@ -56,18 +56,28 @@ DeepSeek Harness は Agent Runtime と Web UI を提供します。DSH Desktop
- デスクトップ更新の確認、ダウンロード、インストールをユーザーが管理
- macOS と Windows 向けのメニュー、タイトルバー、フォーカス、テーマ、ブランド表示
## PPT 作成
**PPT** ボタンを有効にし、テンプレートを選んで作成したい内容を入力します。**16 種類のテンプレート、192 種類のレイアウト**から、編集可能な PPTX を生成できます。プレビューは英語ですが、出力は英語・中国語に対応し、それぞれのフォント設定を備えています。プレビューの言語が出力言語を決めることはありません。
PPT はプリインストールされており、自動指示は PPT ボタンを有効にしたセッションだけに適用されます。詳細と出典は [PPT ガイド](packages/ppt-runtime/README.md)を参照してください。
## スマートフォン接続
`Harness` メニューから **Connect Phone…** を選び、ペアリングコードを読み取ります。スマートフォンがセッションへアクセスする前に、デスクトップ側の明示的な承認が必要です。
Harness 自体はランダムな `127.0.0.1` ポートだけで動作します。スマートフォン接続には別のペアリング Bridge を使い、LAN 内に限定するか、遠隔利用時だけ一時的な Cloudflare Quick Tunnel を有効にできます。
Cloudflare の起動に失敗すると Pinggy を試します。Cloudflare のペアリングリンクが表示されてもスマートフォンで開けない場合は、**Can’t open? Try another link** を選んで Pinggy に切り替えられます。
## セーフモードと復旧
サードパーティープラグインが起動や画面表示を妨げた場合、DSH Desktop は Runtime とフロントエンドの証拠から関連プラグインを特定し、ガイド付き復旧画面を開きます。
`Harness` メニューの **Restart as Safe Mode…** を選ぶと、公式コア Bundle だけを含む隔離 Profile で起動します。通常 Profile のサードパーティープラグインは停止しますが、Agent、セッション、モデル設定、ワークスペースは引き続き利用できます。
復旧画面では互換性のあるプラグイン更新を確認し、利用可能な場合は個別に更新できます。セーフモードでは一括更新も可能です。相談したい場合は **WeChat group** にマウスを合わせて QR コードを表示するか、**Discord** をクリックしてコミュニティを開いてください。
通常画面を開けない場合は `--safe-mode` を指定できます。macOS の例:
```sh
+10
View File
@@ -57,18 +57,28 @@ DeepSeek Harness already provides the Agent runtime and Web UI. DSH Desktop adds
- Checks for desktop updates and keeps download and installation under user control
- Adapts native menus, titlebar behavior, window focus, theme, and application branding for macOS and Windows
## PPT generation
Enable the **PPT** button, choose a template, and describe the deck you need. The built-in catalog includes **16 templates and 192 layouts** with editable PPTX output. Previews use English; decks can use English or Chinese, with corresponding font settings. Preview language does not determine output language.
PPT is preinstalled, and its automatic instructions apply only to sessions where the PPT button is enabled. See the [PPT runtime guide](packages/ppt-runtime/README.md) for templates, validation, and source acknowledgments.
## Phone access
Choose **Connect Phone…** from the `Harness` menu and scan the pairing code. The desktop asks you to approve the connection before the phone can access sessions.
Harness itself remains on a random `127.0.0.1` port. Phone access uses a separate paired bridge. It can stay on the local network or, when you choose remote access, use a temporary Cloudflare Quick Tunnel. Disconnecting the phone from the desktop invalidates the mobile session.
If Cloudflare fails to start, the app tries Pinggy. If a Cloudflare pairing link appears but your phone cannot open it, choose **Can’t open? Try another link** to switch to Pinggy.
## Safe Mode and recovery
If a third-party plugin interferes with startup or rendering, DSH Desktop can identify the implicated plugin from runtime and frontend evidence and open a guided recovery surface.
Choose **Restart as Safe Mode…** from the `Harness` menu to start an isolated profile containing only official core bundles. The Agent, sessions, model settings, and workspaces remain available while third-party plugins from the normal profile stay blocked. You can remove selected plugins or return to a normal launch from the Safe Mode banner.
Recovery screens check for compatible plugin updates. When available, you can upgrade an affected plugin; Safe Mode also offers batch upgrades. For help, hover over **WeChat group** to display its QR code, or click **Discord** to open the community.
If the normal interface cannot be reached, start DSH Desktop with `--safe-mode`. On macOS:
```sh
+10
View File
@@ -57,18 +57,28 @@ O DeepSeek Harness já fornece o Agent Runtime e a Web UI. O DSH Desktop acresce
- Verifica atualizações do aplicativo e mantém download e instalação sob controle do usuário
- Adapta menus, barra de título, foco da janela, tema e marca para macOS e Windows
## Criação de PPT
Ative o botão **PPT**, escolha um modelo e descreva a apresentação desejada. O catálogo inclui **16 modelos e 192 layouts**, com exportação para PPTX editável. As prévias são em inglês; as apresentações podem ser geradas em inglês ou chinês, com configurações de fontes para ambos. O idioma da prévia não determina o idioma do resultado.
O PPT vem pré-instalado e suas instruções automáticas se aplicam apenas às sessões com o botão PPT ativado. Consulte o [guia de PPT](packages/ppt-runtime/README.md) para detalhes sobre modelos, validação e fontes de referência.
## Acesso pelo celular
Selecione **Connect Phone…** no menu `Harness` e leia o código. O desktop precisa aprovar explicitamente a conexão antes que o celular acesse as sessões.
O Harness permanece em uma porta aleatória de `127.0.0.1`. O celular usa um Bridge separado e pareado: ele pode ficar restrito à rede local ou ativar um Cloudflare Quick Tunnel temporário para acesso remoto.
Se o Cloudflare não iniciar, o aplicativo tenta usar o Pinggy. Se o link do Cloudflare aparecer, mas o celular não conseguir abri-lo, selecione **Can’t open? Try another link** para mudar para o Pinggy.
## Modo de segurança e recuperação
Se um plugin de terceiros impedir a inicialização ou a renderização, o DSH Desktop relaciona as evidências do Runtime e do frontend aos plugins instalados e abre uma recuperação guiada.
Selecione **Restart as Safe Mode…** no menu `Harness` para iniciar um Profile isolado apenas com os Bundle oficiais principais. Os plugins externos do Profile normal ficam bloqueados, mas o Agent, as sessões, as configurações de modelos e os espaços de trabalho continuam disponíveis.
A tela de recuperação verifica se há atualizações compatíveis dos plugins e permite instalá-las quando disponíveis. O Modo de segurança também permite atualizar vários plugins de uma vez. Para obter ajuda, passe o cursor sobre **WeChat group** para exibir o QR code ou clique em **Discord** para abrir a comunidade.
Se a interface normal não abrir, inicie o aplicativo com `--safe-mode`. No macOS:
```sh
+10
View File
@@ -57,18 +57,28 @@ DeepSeek Harness уже предоставляет Agent Runtime и Web UI. DSH
- Проверяет обновления приложения и оставляет загрузку и установку под контролем пользователя
- Адаптирует меню, заголовок окна, фокус, тему и оформление для macOS и Windows
## Создание PPT
Включите кнопку **PPT**, выберите шаблон и опишите нужную презентацию. Встроенный каталог содержит **16 шаблонов и 192 макета** с экспортом в редактируемый PPTX. Предпросмотры представлены на английском; презентации могут быть на английском или китайском с соответствующими настройками шрифтов. Язык предпросмотра не определяет язык результата.
PPT установлен заранее. Его автоматические инструкции применяются только к сессиям с включённой кнопкой PPT. Подробнее о шаблонах, проверках и источниках — в [руководстве PPT](packages/ppt-runtime/README.md).
## Подключение телефона
Выберите **Connect Phone…** в меню `Harness` и отсканируйте код. Перед доступом телефона к сессиям требуется явное подтверждение на компьютере.
Сам Harness остаётся на случайном порту `127.0.0.1`. Телефон использует отдельный Bridge с подтверждённым сопряжением: можно ограничиться локальной сетью или включить временный Cloudflare Quick Tunnel для удалённого доступа.
Если Cloudflare не запускается, приложение пробует Pinggy. Если ссылка Cloudflare уже появилась, но телефон не может её открыть, выберите **Can’t open? Try another link**, чтобы переключиться на Pinggy.
## Безопасный режим и восстановление
Если сторонний плагин мешает запуску или отображению интерфейса, DSH Desktop сопоставляет данные Runtime и фронтенда с установленными плагинами и открывает управляемое восстановление.
Команда **Restart as Safe Mode…** в меню `Harness` запускает изолированный Profile только с официальными основными Bundle. Сторонние плагины обычного Profile блокируются, но Agent, сессии, настройки моделей и рабочие пространства остаются доступными.
Экран восстановления проверяет наличие совместимых обновлений плагинов и позволяет установить доступное обновление. Безопасный режим также поддерживает групповое обновление. Для помощи наведите указатель на **WeChat group**, чтобы увидеть QR-код, или нажмите **Discord**, чтобы открыть сообщество.
Если обычный интерфейс не открывается, запустите приложение с `--safe-mode`. Пример для macOS:
```sh
+10
View File
@@ -56,18 +56,28 @@ DeepSeek Harness 已经提供 Agent Runtime 与 Web UI。DSH Desktop 在此基
- 在应用内检查桌面更新,并由用户决定是否下载和安装
- 针对 macOS 和 Windows 优化原生菜单、标题栏、窗口焦点、主题和品牌体验
## PPT 生成
点击 **PPT** 按钮,选择模板,再描述你想制作的内容。内置 **16 套模板、192 种版式**,可输出可继续编辑的 PPTX。模板预览统一使用英文,生成内容支持中文和英文,并配有对应字体设置;预览语言不决定输出语言。
PPT 功能保持预装,相关自动提示词仅在选中 PPT 按钮的会话中生效。模板、校验和参考来源详见 [PPT 说明](packages/ppt-runtime/README.md)。
## 手机连接
从 `Harness` 菜单选择“连接手机…”,再扫描配对二维码。手机获得会话访问权限前,桌面端必须明确批准连接。
Harness 本身始终运行在随机的 `127.0.0.1` 端口。手机访问由独立的配对 Bridge 提供:可以只在局域网内使用,也可以在你选择远程访问时启用临时 Cloudflare Quick Tunnel。桌面端断开连接后,手机会话随即失效。
Cloudflare 启动失败时会尝试 Pinggy。若已显示 Cloudflare 配对链接,但手机无法打开,可点击“**扫码打不开?换一条线路**”切换到 Pinggy。
## 安全模式与故障恢复
如果第三方插件导致启动或页面渲染异常,DSH Desktop 会结合 Runtime 与前端证据定位相关插件,并打开引导式恢复界面。
从 `Harness` 菜单选择“以安全模式重启…”,应用会使用只包含官方核心 Bundle 的隔离 Profile 启动。正常 Profile 中的第三方插件会被屏蔽,但 Agent、会话、模型配置和工作区仍然可用。你可以从页面顶部的安全模式提示卸载选中的问题插件,或恢复正常启动。
恢复页面会检查插件是否有兼容更新;有可用版本时,可升级对应插件,安全模式还支持批量升级。需要帮助时,鼠标悬停“**微信群**”即可显示二维码,点击 **Discord** 则会打开社区链接。
当正常界面无法进入时,也可以通过 `--safe-mode` 启动。例如 macOS:
```sh
Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.3 MiB

After

Width:  |  Height:  |  Size: 403 KiB

+6
View File
@@ -478,6 +478,12 @@ Safe Mode 会在启动隔离 Profile 前停止正常 Harness,因此第三方 H
管理页面只列出同时存在于 dependencies 和 bundles 的直接第三方根,排除传递依赖、`@deepseek-ai/*` 与 `dshmarket`。IPC 会校验来源、action 和数组,并把用户提交集合与当前 Profile 再求交集,避免页面数据过期导致越界删除。
### 9.4 兼容更新与社区帮助
恢复页面会检查市场中的插件兼容更新;找到可用版本时,用户可以升级对应插件。安全模式支持一键升级当前检查结果中已适配的插件,也可以卸载选中的问题插件,再尝试正常启动。没有可用更新或无法连接市场时,不应把它当成“插件一定兼容”或“已是最新版”。
安全模式和启动恢复页都提供社区入口:悬停“微信群”显示二维码,点击 Discord 打开社区链接。反馈启动问题时,建议附上安装包版本、来源或 SHA-256,以及去除密钥等敏感信息后的技术详情和 `harness.log`。
## 10. 当前机制的已知边界
以下是当前源码仍然需要显式记住的边界,不应在设计或排障时隐含忽略:
@@ -1,6 +1,10 @@
# PPT 来源与模板替换建议
审查日期:2026-09-06。当前开发 worktree 基线:`9d4502f`;当前核心包为 `dsh-ppt`,插件为 `dsh-ppt-composer`。下文保留清理前的来源审查和历史包名;最新处理结果如下。
审查日期:2026-09-06。当时的开发 worktree 基线:`9d4502f`;当前核心包为 `dsh-ppt`,插件为 `dsh-ppt-composer`。下文保留清理前的来源审查和历史包名;最新处理结果如下。
## 发布状态(2026-09-08 更新)
下述命名调整、模板清理与扩展、版式精修和校验反馈优化,已通过 [PR #328](https://github.com/dataelement/dsh-desktop/pull/328) 和 [PR #332](https://github.com/dataelement/dsh-desktop/pull/332) 合并,并包含在 [0.8.0-rc.3](https://github.com/dataelement/dsh-desktop/releases/tag/0.8.0-rc.3) 中。当前维护说明见 [PPT runtime README](../packages/ppt-runtime/README.md)。以下测试数字和未验证项保留为各阶段的历史记录。
## 后续:命名与十套模板接入
@@ -21,7 +25,7 @@
- 可维护分发源码、模板源文件、来源和哈希清单已纳入 `packages/ppt-runtime/`;附重建脚本,避免依赖临时 `node_modules` 修改。
- 720 项测试、类型检查和构建通过;54 页均通过源检查,6 个 PPTX 已成功导出并确认含可编辑元素。开发版界面已实测只显示六套模板且选择正常;Keynote 实测工程蓝图的中文封面、流程页显示正常,文字仍为可编辑文本框。尚未验证 Windows 原生包及 PowerPoint。
本次完成的是当前开发分支的模板/文档清理,未发布或合并;没有重写历史 Git/Release,也不将本轮工程检查称为整个引擎或全部历史分发已获得法律确认。
该阶段完成时,模板/文档清理尚未发布或合并(后续发布状态见上文);没有重写历史 Git/Release,也不将本轮工程检查称为整个引擎或全部历史分发已获得法律确认。
## 清理前审查结论