opensumi / core Goto Github PK

自开源起，KAITIAN 作为项目内部代号已完成其历史使命，后续框架名称将以 OpenSumi 代替，Open 代表开放，SUMI就是 “粟米” 粮食，人的生存基座，隐喻我们的框架就像粮食一样，是 IDE 研发的基础依赖。

现在有一些迁移的事情需要各位项目组成员一起来做：

• 迁移原有配置目录下的 .kaitian, 将默认目录名称改为 .sumi @erha19

• 框架内硬编码的 kaitianExtensionManagerService 等改为 SumiExtensionManagerService. (不止一个) @Aaaaash

• 兼容旧版本的 kaitian, kaitian-browser 模块导出 ( 标注为废弃)，同时新增 sumi, sumi-browser @Aaaaash

• 其他 kaitian 硬编码内容改造 @erha19

• 模块内 repository 更新 @Aaaaash

• 模块基础依赖，如 common-di, monaco-core 等 @erha19 @Aaaaash

• 基础包名从 @ide-framework -> @opensumi @erha19

• 样式文件中硬编码的文本，如 class、图标等 @erha19

• kaitianContribution 等插件定义改造 @Aaaaash

下面可以补充其他内容或建议～

hideSlotTabBar 这个选项是为了隐藏 bottom slot 的 tabbar 引入的，但是并没有考虑到侧边栏的 TabBar 也会走这个逻辑，需要加一些逻辑来决定哪一部分会被隐藏，哪一部分不会被隐藏。

可以通过配置想来解决，或者只针对 bottom slot 隐藏

潜规则

1. @opensumi/ide-core-common 为 @opensumi/ide-core-node ， @opensumi/ide-core-browser 和 @opensumi/ide-electron 的共同依赖

2. 其他模块不直接依赖 @opensumi/ide-core-common，而是通过 @opensumi/ide-core-node 和 @opensumi/ide-core-browser 间接依赖

3. 由于前端资源一般有脚本进行打包构建，而 Node 资源一般需要直接依赖 node_modules ，故我们前期设计上期望模块的 Browser 层依赖放在 DevDepedence，而 Node 层依赖放在 Dependence.

4. 所有模块的构建，统一依赖 @opensumi/ide-dev-tool 方式引入构建依赖，如 typescript, webpack 等

5. 基于这种目录结构，如果存在多个 Browser 模块的公共依赖，放在 @opensumi/ide-core-browser 将能减少版本维护的烦恼，一般通过脚本 npm run add:browser {moduleName} {depName} 的方式添加，同理也有 add:node 的脚本。

6. 原则上如果模块 common 中只能引入 @opensumi/ide-core-common 中的内容，但如果该模块为纯 Browser 或 Node 模块，则允许从对应的 @opensumi/ide-core-browser 和 @opensumi/ide-core-node 中引入。

图示

现状

当前的 @opensumi/ide-components 中实现的 RecycleTree 为了更灵活的组装形式，分离了视图及数据，牺牲了一定使用的便捷性，而以目前的情况去看，许多简化场景下可能不希望自己去组装，而是希望获得一个能快速使用的Tree组件，参考 AntDesign Tree组件 tree

期望

这部分组件功能前期希望能尽量收敛，支持的 Tree 种类希望能为一个最简化的版本，后续可能更多的是由业务方遵循相关开发规范自行在 @opensumi/ide-components 中实现相应的 Tree 组件的方式

• #79

现状

当前测试中有许多 Mock 方法依赖 tools/dev-tool 目录内的工具方法，这部分方法应当整合到 @opensumi/di 中

期望

DI 提供测试相关的工具函数

当前 sumi-kaitian 中依旧使用 @opensumi/ide-core-browser 中导出的部分组件，导致相关依赖划分不清晰，同时也存在一些待废弃的组件未清理

https://github.com/ide-framework/core/blob/84badf188a8526e37c46b0428c3a302a40793acd/packages/extension/src/browser/sumi-browser/components.ts

需要做的事情：

• 移除框架对 @opensumi/ide-core-browser 中的 RecycleTree 依赖
• 迁移剩余组件至 @opensumi/ide-core-components 中
• 剥离通用的工具函数库 @opensumi/utils，解决重复工具类问题
• 基础易用的 BasicRecycleTree 组件 #93

macOS 或 Windows 必现

大表哥：如果之前有 inlineSuggest 占了这么大地方，切到下一个又没这么多内容，那片空白会留着...

问题如下：

使用 http://xxx.xxx.xxx.xxx:port 的方式不能识别，其实还有一些其它情况也不能识别，比如 webdav://host.local 这种

TODO：

• 识别 Terminal URL

如:

会出现以下错误，导致所创建的父子调试 session 渲染错误

对于

目前解析会报错，当给 clang-format.executable 赋值为 string 时，其余的属性应该被解析成

clang-format: {
 executable: {
    windows: '',
    osx: '',
    linux: ''
}
}

TerminalProfile/TerminalProfileProvider/registerTerminalProfileProvider

#105 会出现鼠标无法移动到 hover 的 widget 上，microsoft/monaco-editor#2156 这个 issue 解释了为什么。

related:

• microsoft/monaco-editor#2156
• microsoft/monaco-editor#2233

支持通过 AppConfig 的方式自定义工作区后缀，目前框架默认的工作区后缀为 .sumi-workspace, 配置定义如下：

export interface AppConfig {
  ...
  workspaceSuffixName: string;
  ...
}

ref: https://code.visualstudio.com/api/references/vscode-api#TerminalLink

e.g:

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Attach to Remote Program",
            "request": "attach",
            "hostName": "localhost",
            "port": "${env:DEBUG_PORT_NUMBER}",
        }
    ]
}

然后报如图错误

现状

typescript-language-feature 1.62.x 插件依赖

期望

正常使用

ref: https://code.visualstudio.com/api/references/vscode-api#Memento

1. 是否需要建立一个类似 https://github.com/umijs/fabric 的规范包？
   像其他项目(如 DI) 也可以依赖这个包做代码规范。
2. 如何做 tslint 迁移到 eslint
   When？ How？

现状

vscode.git 1.55.2 插件依赖

期望

正常使用

ref： https://code.visualstudio.com/api/references/vscode-api#TaskGroup

原来的 editor/title 这个 menu contributes 属性你只有将 group 设置为 "navigation@xx" 才会出现在右上角这里，否则就只会出现在 ··· 那儿。

阿 V 提供了一个 editor/title/run 选项就是可以以

这个图标展示在右上角，作用与 ··· 类似

相关 PR: microsoft/vscode@97c7d2a

问题描述

opensumi electron版在windows上debug, 无法打断点，toolbar 上的几个控件无法点击, 可以用这个 mock debug demo 来调试

复现路径（To Reproduce）

clone 下来 debug 的插件 demo, [email protected]:longyan.zly/mock-debug-demo.git, 在 opensumi 中启动 electron, 将插件 link 到 extensions 目录, 打开 sampleWorkspace 进行调试。

预期表现（Expected behavior）
能够打断点, toolbar 操作可用

问题截图（Screenshots）

环境信息（Environment）

• OS: Windows10/Windows11
• OpenSumi Version, 用的是 kaitian 2.12.8

猜测：windows 下如果没有安装 git-bash 并且安装了 powershell，可能会打开 powershell，并且由于设置了 git-bash 的 login 参数导致终端打开异常。

.d.ts中通过 export { URI } from '@opensumi/ide-core-browser'; 来导出 URI 的类型，但 package.json 中并没有依赖 @opensumi/ide-core-browser

https://github.com/opensumi/core/blob/main/packages/core-electron-main/src/bootstrap/services/ui.ts#L75

electron 13 已经移除了 shell.moveItemToTrash(path); 作为替代，您应当使用异步的 shell.trashItem()。

https://www.electronjs.org/zh/docs/latest/breaking-changes#%E5%B7%B2%E7%A7%BB%E9%99%A4-shellmoveitemtotrash

需要判断一下 electron 版本，然后决定执行哪个

相关 issue:

• desktop/desktop#13426
• microsoft/vscode#132654
• electron/electron#26143 (comment)

看第二个链接中的描述，vscode 是自己 patch 了一个 13 的修复。
他们把自己的 patch 在第三个链接中放了出来。

ref: https://code.visualstudio.com/api/references/vscode-api#TextDocumentChangeEvent

期望

自动根据最新的两个 tag 对比生成 Changelog 信息

看了看，应该是需要改 monaco

ref: https://code.visualstudio.com/api/references/vscode-api#env

例如对于 GitHub Light 主题

预期的颜色类似 VS Code

实际

提供一个简单 Sumi 桌面版

• 添加 tag 自动打包 dmg 格式
• #222
• 使用双层 package.json 减少包体积
• 带 source map 信息

如图，面包屑的 icon 看起来更大一些，不太合理