KODO Browser 参考 OSS Browser 设计，提供类似 Windows 资源管理器功能。用户可以很方便的浏览文件，上传下载文件，支持断点续传等。
本工具使用开源框架 React + Electron 制作。
Electron 框架可以让你使用 JavaScript，HTML 和 CSS 构建跨平台的桌面应用程序。它是基于node.js 和 Chromium 开源项目。Electron 可以打包出跨平台的程序，运行在 Mac，Windows 和 Linux 上。
功能
|-- 登录：支持 AccessKey 和 SecretKey 登录
|-- Bucket 管理: 新建 bucket，删除 bucket。
|-- 文件管理：目录和文件的增删改查， 复制, 文件预览等。
|-- 文件传输任务管理： 上传下载，断点续传。
|-- 地址栏功能（支持 kodo://bucket/object，浏览历史前进后退，保存书签）
如果你要在此基础上开发，请按照以下步骤进行。
cnpm 是 npm（node 包管理工具）的中国镜像，可以提高下载依赖包的效率。
- 需要安装 git 和 choco:
请自行下载安装。
然后安装相关的依赖包。
choco install python vcredist-all makegit clone git@github.com:qiniu/kodo-browser.git安装依赖:
make imake run # 开发模式运行，cmd+option+i 可用打开调试界面，Windows 或 Linux 按 F12开发模式下，会自动监听源码，如有修改，会自动 build 前端代码到 dist 目录。
make build # build 前端代码到 dist 目录make win64 # 打包 win64 程序，可选: mac, dmg, linux64, linux32, win32, win64, all.Mac 分别提供 Intel 和 Apple Silicon 安装包：
| 命令 | 产物 | 适用设备 |
|---|---|---|
make mac |
build/kodo-browser-darwin-x64-v<版本>.zip |
Intel Mac；Apple Silicon Mac 运行时需要 Rosetta |
make mac-arm64 |
build/kodo-browser-darwin-arm64-v<版本>.zip |
Apple Silicon Mac，无需 Rosetta |
make dmg 仍生成 Intel 版 DMG。发布前应解压 ZIP，直接启动其中的 .app，核对主程序与 Helper 的架构，并验证登录、上传、下载、任务恢复和分享链接。
make mac-arm64 会在压缩前从内到外为应用及其组件补齐临时签名（ad-hoc），并执行 codesign --verify --deep --strict；签名或校验失败会中止构建。临时签名无需开发者证书，但不提供发布者身份认证，浏览器下载后仍可能需要在系统设置中手动允许打开。
版本 tag 触发 .github/workflows/publish.yml，分别构建 x64、ARM64 包，上传至 GitHub Release 草稿和七牛下载空间。七牛对象名分别为：
- Intel：
kodobrowser/client/kodo-browser-Mac OS-v<版本>.zip，保留现有路径。 - Apple Silicon：
kodobrowser/client/kodo-browser-Mac OS-arm64-v<版本>.zip。
官网的下载页和线上 https://kodo-toolbox.qiniu.com/kodobrowser/update.json 由仓库外维护，发布时还需：
- 等待两个架构的构建及实机验证通过，再发布 Release 草稿。
- 官网下载页分别标注 Intel、Apple Silicon，并指向对应安装包。
- 保留更新配置的
downloads.darwin.x64，新增downloads.darwin.arm64，分别填写对应安装包 URL；核对其余平台链接及版本号后再更新线上配置。 - 旧 x64 版即使运行在 Apple Silicon 上，更新检测使用的
process.arch仍是x64，首次切换需手动下载 ARM64 版，退出旧版后替换应用。两种架构使用相同的用户配置目录。
Developer ID 签名及 Apple 公证需使用发布方的开发者证书及凭据单独配置；架构验证及临时签名校验通过不代表已通过 Developer ID 签名或 Apple 公证。应使用浏览器重新下载最终产物，检查系统安全校验下的首次打开行为。
kodo-browser/
├── build # 打包好的 应用程序
├── dist # 打包好的 js 代码
├── gulpfile.js
├── package.json
├── src
│ ├── common # 通用模块
│ ├── main # electron 主进程与子进程
│ └── renderer # 前端子进程
└── webpack # 打包工具
将配置文件放在 $HOME/.kodo-browser-v2/config.json（如果是 Windows 10，则位置是 C:\Users\<UserName>\.kodo-browser-v2\config.json）下，配置文件示例如下：
{
"regions": [
{
"id": "cn-east-1",
"endpoint": "https://s3-cn-east-1.qiniucs.com"
},
{
"id": "cn-north-1",
"endpoint": "https://s3-cn-north-1.qiniucs.com"
},
{
"id": "cn-south-1",
"endpoint": "https://s3-cn-south-1.qiniucs.com"
},
{
"id": "us-north-1",
"endpoint": "https://s3-us-north-1.qiniucs.com"
},
{
"id": "ap-southeast-1",
"endpoint": "https://s3-ap-southeast-1.qiniucs.com"
}
],
"uc_url": "https://uc.qbox.me"
}可以修改配置文件示例中的 endpoint 来修改服务器地址。
编辑 src/renderer/customize.ts 中的代码然后重新打包以定制部分 OEM 功能，目前支持的 OEM 定制有：
- 禁止创建 Bucket
- 禁止删除 Bucket
- 禁止使用自有域名
- 配置升级检测地址
将在 Kodo Browser 启动时尝试读取此配置。如已定义该配置，则支持借此改变部分 Kodo Browser 初始行为； 如未定义，也不影响 Kodo Browser 正常启动。
launchConfig.json 文件位于 Kodo Browser 可执行程序同级目录：
- Windows/Linux：
kodo-browser/launchConfig.json - macOS：
Kodo Browser.app/Contents/MacOS/launchConfig.json
launchConfig.json 的格式具体参见 launchConfig.schema.json。当前支持以下配置：
preferredEndpointType，登录默认服务端类型。可用值：public（公有云）,private（私有云）；defaultPrivateEndpointConfig，私有云服务默认地址；ucUrl，Bucket 管理服务地址，必须；regions，区域信息，对于较新的私有云可选，详细请向管理员询问；
preferenceValidators，配置部分设置表单的校验；并发越大传输速度不一定越快，请慎重调整。maxMultipartUploadPartSize，最大上传分片大小maxMultipartUploadConcurrency，最大上传分片并发数maxUploadJobConcurrency，最大上传任务并发数maxDownloadJobConcurrency，最大下载任务并发数
disable，禁止某些功能；nonOwnedDomain，非自有域名；
baseShareUrl，分享链接的基本 URL；
例如以下配置将修改默认登录私有云指定服务端：
{
"$schema": "https://github.com/qiniu/kodo-browser/blob/v2.1.0/lauchConfig.schema.json",
"preferredEndpointType": "private",
"defaultPrivateEndpointConfig": {
"ucUrl": "http://uc.example.com",
"regions": [
{
"id": "cn-east-1",
"label": "华东",
"endpoint": "http://s3.example.com"
}
]
}
}当前 $schema 字段本身对程序运行无影响，但建议书写，表明当前配置文件是参考哪一版本编写的。