mirror of
https://github.com/dataelement/dsh-desktop.git
synced 2026-09-28 05:23:01 +08:00
docs: refresh PPT, recovery and mobile guidance with new hero
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 |
@@ -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,也不将本轮工程检查称为整个引擎或全部历史分发已获得法律确认。
|
||||
|
||||
## 清理前审查结论
|
||||
|
||||
|
||||
Reference in New Issue
Block a user