English | 简体中文 | Github | Gitee
Just like the abyss — limitless, mysterious, and filled with treasures.
喜欢这个项目？请给它 Star ⭐️ 或 赞赏 💰
> [!Warning] > > - `abyss` 中的应用清单是基于 [bin/utils.ps1](./bin/utils.ps1) 编写的 > - 它们包含 Scoop 官方规范之外的 [特性](#特性)，其他 bucket 不应该合并它们，以避免冲突和错误 ### 特性 - 部分应用无法做到 [Persist](#persist)，会使用 [Link](#link) 实现 - 部分应用会使用安装程序而不是当作 zip 包进行安装 - 通过 [配置](#config) 进行功能扩展 - 通过 [abgox/scoop-i18n](https://scoop-i18n.abgox.com) 提供 i18n 支持 - 参考了 [winget-pkgs](https://github.com/microsoft/winget-pkgs) - 清单命名格式: `Publisher.PackageIdentifier` - 目录结构: `bucket/a/abgox/abgox.scoop-i18n.json` ### 演示  --- ### 如果你没有使用 Scoop > [!Tip] > > - 如果你无法访问 Github ，建议使用 [Scoop 镜像](https://gitee.com/scoop-installer-mirrors) > - 它可以让你正常安装并使用 Scoop，无需访问 Github - [Scoop](https://scoop.sh/) - [Scoop 文档](https://github.com/ScoopInstaller/Scoop/wiki) - [什么是 Scoop 中的 bucket?](https://github.com/ScoopInstaller/Scoop/wiki/Buckets) - [什么是 Scoop 中的应用清单(App Manifests)?](https://github.com/ScoopInstaller/Scoop/wiki/App-Manifests) ### 如果你正在使用 Scoop > [!Warning] > > 请确保使用 `abyss` 作为 bucket 的名称，避免部分清单在解析 depends 时找不到 `abyss` bucket 1. 添加 [abyss](https://abyss.abgox.com) (使用 [Github](https://github.com/abgox/abyss) 或 [Gitee](https://gitee.com/abgox/abyss) 仓库) ```shell scoop bucket add abyss https://github.com/abgox/abyss ``` ```shell scoop bucket add abyss https://gitee.com/abgox/abyss ``` 2. 使用 [PSCompletions](https://gitee.com/abgox/PSCompletions) 添加 `scoop` 命令补全 ```shell scoop install abyss/abgox.PSCompletions ``` ```shell Import-Module PSCompletions ``` ```shell psc add scoop ``` 3. 安装 [scoop-i18n](https://scoop-i18n.abgox.com) 以提供 i18n 支持 ```shell scoop install abyss/abgox.scoop-i18n ``` ### 如果你无法访问 Github - 可以使用 [scoop-tools](https://scoop-tools.abgox.com)，它允许你临时使用替换之后的代理 url 来下载安装包，以解决下载问题 - Github: https://github.com/abgox/scoop-tools - Gitee: https://gitee.com/abgox/scoop-tools ### Config #### abgox-abyss-app-uninstall-action - 使用此配置项控制应用卸载时的额外操作 - 你可以通过以下命令去设置 ```shell scoop config abgox-abyss-app-uninstall-action 123 ``` - 如果没有设置，则默认为 `1` - 配置值的含义如下，你可以任意组合这些值，如 `12` 表示 `1` 和 `2` 都要执行 - 如果不希望有这些额外行为，设置为不包含它们的任意值即可 | 配置值 | 行为 | | :----: | ----------------------------------------------- | | `1` | 卸载/更新时先尝试终止相关进程，然后进行卸载操作 | | `2` | 卸载时删除通过 [Link](#link) 创建的文件或目录 | | `3` | 卸载时删除临时数据 | #### abgox-abyss-app-shortcuts-action - 由于 `abyss` 中的一些应用直接使用安装程序安装，安装程序会自动创建快捷方式 - Scoop 也会创建清单中定义的快捷方式，这会导致存在多个重复的快捷方式 - 因此，你可以使用此配置项控制是否创建清单中定义的快捷方式 ```shell scoop config abgox-abyss-app-shortcuts-action 2 ``` - 如果没有设置，则默认为 `1` - 配置值的含义如下 | 配置值 | 行为 | | :----: | --------------------------------------------------------------------------------------- | | `0` | **不创建** 清单中定义的快捷方式 | | `1` | **创建** 清单中定义的快捷方式 | | `2` | 如果应用使用安装程序创建了快捷方式，就 **不创建** 清单中定义的快捷方式，否则就 **创建** | #### abgox-abyss-bucket-name - 此配置项仅用于记录添加到本地的 `abyss` 的名称，然后在部分特殊情况中使用 - 不要手动修改它，当安装/更新/卸载 `abyss` 中的应用时，会自动更新此配置项 - 举个例子： - 你可以安装 JetBrains.WebStorm 的指定版本 ```shell scoop install abyss/JetBrains.WebStorm@2025.1.2 ``` - 安装时会用到这个配置项的值，避免安装错误 - 参考: https://github.com/abgox/abyss/issues/10 ### Persist > [!Tip] > > 假设 Scoop 的根目录是 `D:\scoop` - Scoop 在清单文件中提供了 `persist` 配置，可以持久化保存应用目录中的数据文件 - 以 [abgox.PSCompletions](./bucket/a/abgox/abgox.PSCompletions.json) 为例，Scoop 会将它安装到 `D:\scoop\apps\abgox.PSCompletions` 目录中 - 然后会持久化(persist)数据目录和配置文件: - `D:\scoop\apps\abgox.PSCompletions\completions` => `D:\scoop\persist\abgox.PSCompletions\completions` - `D:\scoop\apps\abgox.PSCompletions\data.json` => `D:\scoop\persist\abgox.PSCompletions\data.json` - 当卸载 [abgox.PSCompletions](./bucket/a/abgox/abgox.PSCompletions.json) 时，Scoop 只会删除 `D:\scoop\apps\abgox.PSCompletions` 目录，而不会删除 `D:\scoop\persist\abgox.PSCompletions` 目录 - 因此，它的设置、补全数据仍然会保存在 `D:\scoop\persist\abgox.PSCompletions` 目录中 - 重新安装后，又会继续使用这些数据 - 如果卸载时使用了 `-p/--purge` 参数，`D:\scoop\persist\abgox.PSCompletions` 目录才会被删除 - 这是 Scoop 最强大的特性，可以快速的恢复应用环境 - `abyss` 中的一些应用使用了 [Link](#link)，无法通过 `scoop reset` 正确重置 - 建议通过 `scoop update --force