@qilin-agent/desktop 3.1.7 → 3.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.i18n.yaml CHANGED
@@ -12,11 +12,14 @@
12
12
  en: 7bc8bf30de693222
13
13
  zh: e85993d8852b6cab
14
14
  /qilin-desktop-desktop/table-of-contents:
15
- en: 05fd227f99ee535a
16
- zh: 60d7d62bc0026973
15
+ en: 75cfb6ac828ae849
16
+ zh: 956aa41c12594155
17
17
  /qilin-desktop-desktop/application-overview:
18
- en: 5ec800129a3b52e1
19
- zh: f168527405890d73
18
+ en: dde584cce090e62b
19
+ zh: 10133e5fec8392de
20
+ /qilin-desktop-desktop/menus:
21
+ en: 3ee11667b076ead0
22
+ zh: f193d79c88948853
20
23
  /qilin-desktop-desktop/terminal-command:
21
24
  en: 24390aa079a4a210
22
25
  zh: 13779319413d18e1
package/README.md CHANGED
@@ -15,6 +15,7 @@ Desktop runs the Harness workspace in a native application. This reference cover
15
15
  - [Application overview](#application-overview)
16
16
  - [Terminal command](#terminal-command)
17
17
  - [Closing the window and quitting](#closing-the-window-and-quitting)
18
+ - [Menus](#menus)
18
19
  - [Key technical decisions](#key-technical-decisions)
19
20
  - [Bundled command runtime](#bundled-command-runtime)
20
21
  - [Installation ownership](#installation-ownership)
@@ -36,8 +37,6 @@ The desktop application is an Electron shell around the complete qilin Web appli
36
37
 
37
38
  Desktop binds `127.0.0.1`, the address Electron dials for the ready URL and the WebSocket credential filter. WebSocket streams use `ws:` or `wss:` according to the Host listener; credentials require matching authority and scheme.
38
39
 
39
- The first application-menu command, **About QiLin Desktop**, opens Electron's native About panel with the application icon, product name, and installed release version. The menu follows the Desktop shell locale. On macOS, Hide, Hide Others, Show All, and Quit use localized labels; Hide and Quit include the QiLin Desktop product name. These commands retain their native actions and shortcuts. macOS reads the icon from its application bundle, so an unpackaged development launch displays Electron's icon; Windows receives the packaged PNG.
40
-
41
40
  Desktop’s local native directory flow opens an Electron folder dialog attached to the application window, restoring, showing, and focusing that window first. Concurrent requests share one dialog; cancellation returns no path and failures remain retryable. Ordinary Web uses the Host chooser. Browse mode lists Host directories. On Linux without zenity or kdialog, automatic selection uses browse instead of the Electron dialog.
42
41
 
43
42
  Desktop ships one pnpm distribution at `resources/runtime/primary-runtime/dependencies/pnpm`. Build-time production installation, the installed `qilin` CLI, Creator and the Web Plugin Manager execute its `bin/pnpm.mjs` with Electron Node mode; package operations do not require pnpm on PATH. The private Node launcher environment applies only to package operations. Agent workspace dependencies copy the same self-contained primary-runtime payload into the Harness home and execute pnpm with its standalone Node.
@@ -52,6 +51,18 @@ Desktop microphone access is restricted to audio requests from the primary `qili
52
51
 
53
52
  Press F12 (Fn+F12 on media-key keyboards), Command+Option+I on macOS, or Ctrl+Shift+I on Windows to toggle DevTools for the focused application page, including in packaged builds. These native shortcuts use hidden application-menu items. Update overlays and packaged embedded browser guests disable DevTools.
54
53
 
54
+ <a id="menus"></a>
55
+
56
+ ## Menus
57
+
58
+ The menu bar follows the Desktop shell locale and drives the same commands as the Web client. macOS and Linux render a native bar with Application, File, Edit, View, Window, and Help menus; Windows draws File, Edit, View, and Help inside the title bar, pops the same native menus from them, and keeps only the hidden developer shortcuts on its native menu.
59
+
60
+ File offers New Session, Search Sessions, Add Workspace, Settings outside macOS, Close Window, and Exit outside macOS. Edit keeps the native editing roles on macOS and Linux; on Windows the shell forwards the editor-owned undo, redo, cut, copy, paste, delete, and select-all keys, so the Web composer's own history applies. View toggles the left and right sidebars, adjusts page zoom, toggles full screen, and, in development builds, reloads the page, force-reloads it, and toggles developer tools. Help opens the project home and issue tracker, and outside macOS carries Check for Updates and About. The application menu keeps About, Settings, Check for Updates, Manage qilin Command, and the native Hide and Quit commands, and development builds add Reload Page and Restart App and Host.
61
+
62
+ About opens Electron's native About panel with the application icon, product name, and installed release version; macOS reads the icon from its application bundle, so an unpackaged development launch displays Electron's icon, while Windows receives the packaged PNG. Hide, Hide Others, Show All, and Quit use localized labels that name the QiLin Desktop product, and keep their native actions and shortcuts.
63
+
64
+ Renderer entries show the binding the user currently has and stay disabled until the Web client publishes its shortcut configuration. Each entry dispatches by command id through the same channel as a physical key, so a customized binding changes both the shown accelerator and the dispatched command. The menu rebuilds when a binding, the available command set, or the shell locale changes.
65
+
55
66
  <a id="terminal-command"></a>
56
67
 
57
68
  ## Terminal command
package/README.zh.md CHANGED
@@ -15,6 +15,7 @@ Desktop 在原生应用中运行 Harness 工作区。本参考文档说明应用
15
15
  - [应用概览](#application-overview)
16
16
  - [终端命令](#terminal-command)
17
17
  - [关闭窗口与退出](#closing-the-window-and-quitting)
18
+ - [菜单](#menus)
18
19
  - [关键技术决策](#key-technical-decisions)
19
20
  - [内置命令运行时](#bundled-command-runtime)
20
21
  - [安装归属](#installation-ownership)
@@ -36,8 +37,6 @@ Desktop 在原生应用中运行 Harness 工作区。本参考文档说明应用
36
37
 
37
38
  Desktop 绑定 `127.0.0.1`,即 Electron 为就绪 URL 与 WebSocket 凭据过滤器拨号的地址。WebSocket 流按 Host 监听器使用 `ws:` 或 `wss:`;附加凭据要求 authority 与 scheme 均匹配。
38
39
 
39
- 应用菜单第一项“**关于 QiLin Desktop**”打开 Electron 原生关于面板,展示应用图标、产品名称和当前安装的发布版本。菜单文案跟随桌面壳的语言。macOS 的隐藏、隐藏其他、显示全部和退出条目使用本地化文案,隐藏和退出条目包含 QiLin Desktop 产品名称。这些条目保留原生动作和快捷键。macOS 从应用包读取图标,因此未打包的开发启动会显示 Electron 图标;Windows 使用随包分发的 PNG。
40
-
41
40
  Desktop 的本地原生目录流程打开绑定应用窗口的 Electron 文件夹对话框,并先恢复、显示和聚焦该窗口。并发请求共用一个对话框;取消不返回路径,失败后可以重试。普通 Web 使用 Host 选择器。浏览模式列出 Host 目录。Linux 缺少 zenity 或 kdialog 时,自动选择使用浏览模式,不使用 Electron 对话框。
42
41
 
43
42
  Desktop 在 `resources/runtime/primary-runtime/dependencies/pnpm` 中携带一份 pnpm 分发包。构建时的生产依赖安装、安装版 `qilin` CLI、Creator 和 Web 插件管理器通过 Electron Node 模式执行其中的 `bin/pnpm.mjs`;包操作不要求 PATH 上存在 pnpm。私有 Node 启动器环境仅用于包操作。agent(智能体)的工作区依赖将同一份完整 primary-runtime 复制到 Harness 主目录,并使用其中的独立 Node 执行 pnpm。
@@ -52,6 +51,18 @@ Desktop Host 的 Platform API 请求与更新策略请求用相同的 Platform
52
51
 
53
52
  按 F12(多媒体功能键键盘上为 Fn+F12)、macOS 的 Command+Option+I 或 Windows 的 Ctrl+Shift+I,可切换当前获得焦点的应用页面的 DevTools,打包版本同样支持。这些原生快捷键通过隐藏的应用菜单项注册。更新遮罩和打包版本的内嵌浏览器禁用 DevTools。
54
53
 
54
+ <a id="menus"></a>
55
+
56
+ ## 菜单
57
+
58
+ 菜单栏文案跟随桌面壳的语言,执行的动作与 Web 客户端一致。macOS 与 Linux 渲染原生菜单栏,含应用、文件、编辑、视图、窗口和帮助菜单;Windows 在标题栏内绘制文件、编辑、视图和帮助菜单,由它们弹出同一批原生菜单,其原生菜单只保留隐藏的开发者快捷键。
59
+
60
+ 文件菜单提供新建会话、搜索会话、添加工作区、macOS 之外的设置、关闭窗口,以及 macOS 之外的退出。编辑菜单在 macOS 与 Linux 上使用原生编辑条目;Windows 由桌面壳转发编辑器自有的撤销、重做、剪切、复制、粘贴、删除和全选按键,因此生效的是 Web 输入框自己的历史。视图菜单切换左右侧栏、调整页面缩放、切换全屏,并在开发构建中提供刷新页面、强制重新加载和开发者工具。帮助菜单打开项目主页与问题反馈,在 macOS 之外还含检查更新与关于。应用菜单保留关于、设置、检查更新、管理 qilin 命令,以及原生的隐藏与退出条目;开发构建额外提供刷新页面和重启应用与 Host。
61
+
62
+ “关于”打开 Electron 原生关于面板,展示应用图标、产品名称和当前安装的发布版本;macOS 从应用包读取图标,因此未打包的开发启动显示 Electron 图标,Windows 使用随包分发的 PNG。隐藏、隐藏其他、显示全部和退出条目使用本地化文案并写出 QiLin Desktop 产品名称,同时保留原生动作与快捷键。
63
+
64
+ 渲染进程条目显示用户当前的绑定,并在 Web 客户端发布快捷键配置前保持禁用。每个条目按命令 id 经与物理按键相同的通道派发,因此自定义绑定会同时改变显示的加速键与实际执行的命令。绑定、可用命令集合或桌面壳语言变化时,菜单重建。
65
+
55
66
  <a id="terminal-command"></a>
56
67
 
57
68
  ## 终端命令