AIStarter项目管理平台使用说明手册【初稿】电子版下载：
一、前言
- AIStarter启动器是一款AI项目管理平台，旨在为用户提供一键下载、安装、启动和管理各种AI项目，同时支持用户通过脚本编辑创建自己的AI项目。
二、AIStarter介绍
2.1、自动化
- 用户只需点击一下即可完成AI项目的环境检测、安装、安装和优化，从而轻松下载、安装、启动各类AI项目，开始正常使用。
2.2、脚本编辑
- 用户可以通过脚本编辑在AIStarter上创建自己的AI项目，以满足其特定需求并扩展项目功能。这些简单的脚本语言涵盖了命令，但不限于：编写文件、执行、安装库和其他应用程序、发布文件、下载文件、浏览网络以及管理项目等。
- AIStarter 的脚本功能使得几乎所有计算机都可以自动完成各种任务，无需人工干预。
2.3、更新与分享
- AIStarter支持项目的维护、更新和一键分享、下载功能，用户可以及时获取最新的项目更新，并轻松分享自己的项目给其他用户。
2.4、多平台支持
- AIStarter支持多平台，包括Windows、Mac和Linux，确保用户无论使用哪种作业方式都享受便捷的AI项目管理和启动体验。
2.5、硬件要求
- AI项目的运行需要一定的硬件支持，以下是建议的最低硬件配置，以确保您的项目能够顺利运行：
- 显卡：8GB
- 内存：8GB
- CPU核心数：8核
请注意，这些是建议的最低硬件配置。对于某些大型或计算密集的AI项目，可能需要更高配置的硬件来提供更好的性能和稳定性。根据具体的AI项目需求进行建议和配置做出最终的硬件选择。
三、AIStarter本体和AI项目下载、安装、卸载
3.1 AIStarter本体下载
3.1.1登录官网，下载AIStarter，请根据您所使用的操作系统选择。
AIStarter官网地址，中文：www.starter.top |中文：www.starter.one
3.1.2下载AIStarter本体后，点击下一步Next即可完成程序安装。
3.2 AI项目下载
3.2.1在AIStarter的市场界面上，用户可以直接点击所需AI项目的下载按钮，系统将自动完成AI项目的下载和安装。
3.2.2分流下载即用户可以选择AI项目的离线下载方式。在官网下载页面，用户可以自行选择网盘、BT等方式进行下载，下载完成后解压把文件放置在AIStarter指定的目录中。
AIStarter启动器下载地址：https://www.starter.top/download/
AI项目下载地址：https://www.aihubpro.cn/collection/aistarter
3.3 程序安装
3.3.1 AIStarter安装
- 左边AIStarter程序安装包，如下图，根据提示下一步完成下一步安装。
第一步：左边AIStarter安装程序
第二步：根据用户需求选择，点击下一步
第三步：指定安装位置，通常默认即可
（路径不要使用中文字符或特殊字符，使用中文命名）
第四步：安装完成
- 安装完成后，首次启动需要设置项目根目录，请注意，根目录路径不要使用中文字符或特殊字符，使用中文命名。
由于AI项目占用了较大的空间，请尽量选择足够的硬盘空间作为根目录。
3.3.2 AI项目安装
- 首次启动软件界面
- 打开软件点击市场-AI应用市场
- 点击下载所需的AI项目
- 点击首页-点击下载AI项目
- 点击首页-下载-安装AI项目
- 点击首页-启动AI项目
- AIStarter打开所启动的AI项目，即可正常使用
3.3.3 AI项目离线下载
- 您可以在网选择盘、BT等方式进行下载。下载完成后，请解压文件，将其放置在“Products”文件夹中。请注意，解压后的文件名必须采用驼峰命名格式，并且不支持文件夹内部解释或修改文件名。
3.4 程序卸载（您可以按以下任一方式卸载程序）
- 开始菜单卸载流程：选择-应用-安装的应用-AIStarter程序-卸载
- 右键AIStarter打开文件所在的位置，卸载AIStarter.exe卸载。
四、文件（插件安装和模型安装）
项目本体默认目录和AI目录如下：
4.1程序本体目录
在程序本体目录下，包含以下几个子目录：
根目录：程序的主要目录，包含程序的执行文件和主要配置文件。
模型目录：放置程序本体的模型文件目录。
软件目录：软件目录是存放已下载安装好的AI项目的位置，其中包括项目的执行文件、主要配置文件以及所依赖的库文件和运行时环境。
临时目录：用于存放临时文件的目录，例如临时生成的中间文件、缓存文件等。
第三方库目录：中东程序所依赖的各种第三方库文件，包括Python库、Git、Torch、Xformers、CuDNN运行环境等。
分享目录：用于存放用户分享备份的文件或项目的目录，方便用户之间进行文件或项目的分享下载。
4.2 AI项目文件目录
根目录： AI项目的主要目录，包含项目的执行文件和主要配置文件。
模型目录：存放AI项目所使用的模型文件，包括训练好的模型和模型参数等。
插件目录：关注AI项目所使用的插件文件，用于扩展项目的功能和特性。
脚本目录：用于用户共享的脚本文件，经过审核后的脚本会在市场的人工智能应用市场中展示。这些脚本可以包括各种功能性脚本，例如安装脚本、环境配置脚本、工作流程脚本等通过将脚本的脚本目录下并进行分享，用户可以方便地共享自己的脚本，并让其他用户受益。
以上为默认设置，同时，AIStarter还支持用户自定义添加文件路径。AI项目相关插件安装和模型安装，请参考项目官方说明。通常情况下，大多数主流项目将插件或模型放置到对应的文件夹中，然后重新启动即可完成安装。
五、设置
5.1 软件设置功能和选项
5.1.1 语言设置：
- 支持中文和英文语言设置：您可以选择界面显示的语言为中文或英文。
- 用户编辑语言文件：如果您希望使用其他，您可以编辑语言文件，路径为：[语言文件路径]。编辑完成后，重新启动软件即可选择相应的设置。
5.1.2 显卡GPU设置：配置显卡的相关选项，包括性能和功耗设置等。
5.1.3 CPU设置：调整CPU的性能模式和核心分配等设置。
5.1.4 项目根目录：指定AI项目的根目录，用于商城项目文件及相关数据。
5.1.5 开发人员选项：提供高级设置和开发人员工具，适用于开发人员调试和测试。
5.1.6 API设置：配置API接口的相关选项，包括调用限制和安全设置等。
- API接口调用：使用API接口进行数据访问和交互。
5.1.7 网络设置：配置网络连接的相关选项，包括代理和VPN设置。
- 网络代理：配置代理服务器以访问互联网。
- VPN设置：配置虚拟专用网络以进行安全连接。
5.1.8环境检测：环境检测功能为保证系统正常运行，包括两个方面的检测：
1.系统环境检测：
- 包含常用的Python、Git、Torch、Xformers、CuDNN等软件的版本检测。
- 保证这些软件的安装和版本符合系统要求，以保证后续功能的正常运行。
2.硬件设备检测：
- 检测系统中的硬件设备，如GPU、CPU等。
- 保证硬件的正常连接和功能，满足后续设备承载任务的要求。
通过环境检测功能，用户可以快速了解系统的运行环境是否符合要求，从而及时调整和处理可能出现的问题，确保系统正常运行。
5.1.9 版本信息：显示当前系统和应用程序的版本信息。
5.2 AI项目设置
5.2.1 显卡或GPU选择：选择用于运行AI项目的显卡或GPU。
5.2.2 开放API：允许AI项目中使用API接口，以实现数据交互和功能扩展。
六、终端
- 在AIStarter软件上，您可以通过终端来查看软件的运行日志，这对于出现问题时进行排查非常有用。
- 最后，您可以实时监控监控监视软件的运行情况，了解其执行过程中是否出现了任何错误或异常。您可以使用命令来查看最新的日志信息，或者通过过滤特定的关键字，以便快速定位并解决问题。
- 您还可以通过直接右键管理员打开系统自动的终端，将AIStarter程序直接拖到终端上运行，这样您就可以查看更详细的运行日志。通常，此类操作适用于开发人员或者需要进行软件资源共享的用户。
- 通过这种方式，您可以获得更加精彩和全面的运行日志信息，有助于开发人员快速定位和解决潜在的问题，并确保软件的稳定性和可靠性。
七、用户管理
7.1 用户登录-注册
7.2 用户密码
- “点击’更改密码’或’忘记密码’，输入注册邮箱后，系统将向您的注册邮箱发送包含密码重置链接的邮件。”
7.3 用户中心
- 用户中心为用户提供了全面的功能，包括新项目和更新提醒、常规消息通知、项目、点赞和评论等功能。用户可以与其他收藏用户互动交流，同时记录下载历史，并支持用户对自己的下载下载下载项目进行资源共享、更新和删除管理。
八、脚本管理
8.1 脚本文件路径
脚本文件位于各个独立项目的目录中，具体路径为`.aistarter`文件夹内。
译文：
8.2 脚本说明
8.2.1、脚本概述
1、init :async function(){}
初始化方法，软件进入加载脚本时会调用一次（必要）
2、安装：async function(){}
安装程序方法，点击安装按钮会调用此方法（必要）
3、下载：async function(){}
下载实现，点击下载的时候会调用此方法，通常调用软件自带的bt下载方法（必要）
4、运行：async function(){}
运行软件方法，点击运行按钮调用（必要）
5、退出：async function(){}
退出项目方法，点击项目退出的时候调用（必要）
6、onAppExit :async function(){}
软件退出后会调用此方法
7、isRunning :async function(){}
返回AI项目是否正在运行中，软件使用该接口判断项目是否真正运行（必要）
8、onSettingChange : 异步函数(settingKey,settingValue,settingClass){}
当软件设置改变的时候会回调这个方法，回传的三个参数对应addSetting里面配置的值
参数：
settingKey 设置选项的键值
settingValue 设置选项的值
设置类别 配置类别的类别
9、addSetting :async function(){}
给项目添加设置选项，返回设置配置相关的结果
返回参数（json对象）：
className 设置选项所属的类名
title 设置的标题
configList配置的列表（json对象备份）
key 设置选项的键值
标签设置标题
desc 设置的详细描述（可选）
type设置的类型，支持（switch:开关、dir:目录选择、select:下拉菜单）
default默认值，没有设置时的初始值
8.2.2、脚本API
1、async zn.markPluginInstalled (pluginName){}
标记项目已经安装成功，当安装该脚本已经正确安装完成后调用方法，通知软件标记修改项目已经安装成功。
参数：
pluginName本身脚本的名称，通常传this.pluginName即可
2、async zn.markPluginDownloaded (pluginName) {}
同上标记项目是否已经下载并解压成功。注：调用zn.downloadProjectTorrent方法不需要在标记下载成功，该方法已经实现。
3、async zn.pluginLog (日志){}
安装的时候显示安装日志（全屏菊花带文本）
4、async zn.isPluginInstalled (pluginName){}
判断项目是否已经安装成功，当调用zn.markPluginInstalled标记成功后返回true
5、async zn.isProjectDownloaded (pluginName){}
判断项目是否已经下载解压完成，当调用zn.markPluginDownloaded标记成功后返回true
6、async zn.addDirToClass (className, dirInfo){}
在软件的目录选项卡添加跳转目录
参数：
className 目录的类别，通常用this.pluginName即可
dirInfo 目录信息（json结构）
icon：目录的图标
viewName：目录显示的名称
viewPath：显示的路径，只是显示实际的路径太长了
dirPath：目录实际实际的路径，相对于软件工作目录或者绝对路径
7、async zn.execute (命令, 参数, 选项 = {}, 回调 = {}) {}
创建子进程执行命令
参数：
command 执行命令
args 命令参数
options 包含cwd:执行目录、env:执行的环境变量
callbacks回调，包含标准输出stdout(std)、stderr(err)、created(childProcess)、close(code)
8、async zn.killProcessTree (pid){}
杀掉进程
参数：
pid 进程ID，使用zn.execute的回调创建返回的childProcess参数
9、异步zn。showLoading（isShow、文本、autoHideTime）{}
在软件中显示全屏Loading
参数：
isShow 是否显示,true为显示
文本显示内容
autoHideTime (可选)自动隐藏的时间，毫秒
10、async zn.getGupInfo (){}
获取系统GUP信息，包含显存、显卡型号等信息。可通过console.log打印日志查看
11、异步zn。获取NvidiaSmi (){}
获取系统nvidia-smi命令的信息，用于判断CUDA版本
12、async zn.getSettingValue (keyName, keyClass){}
获取软件设置值，由addSetting方法定义的值
参数：
keyName 设置的键值
keyClass设置的类别
13、async zn.setSettingValue (keyName, keyVal, keyClass){}
设置软件配置的值，参数同上
参数：
keyVal 配置的值
14、异步zn.showMessage（文本）{}
在软件中弹出消息提示
参数：
文字提示消息的内容
15、async zn.zn.terminalMessage（文本）{}
在软件中的打印输出文本
参数：
text 打印的文本
16、async zn.downloadProjectTorrent (pluginName){}
BT下载AI项目，使用软件自带资源调用此方法
参数：
pluginName本身脚本的名称，通常传this.pluginName即可
17、async zn.changeBtnState (pluginName, state){}
改变项目按钮的状态
参数：
state按钮状态，包含run:启动按钮状态、exit:结束按钮状态
8.3脚本下载
九、资源共享
9.1 备用软件说明
AIStarter启动器集成了AI项目所需的常规环境，同时支持自定义增加环境，具体集成的环境可打开以下路径，环境放置在AIStarter项目根目录的`Third`文件夹中，同时也支持用户自定义增加环境目录。
译文：
9.2 备用示例
9.2.1脚本配置的步骤如下：
1. 在Products目录下新建一个目录，目录名应采用驼峰命名，只支持大小写英文、数字和下划线，不支持中文和特殊字符。
2. 将 AI 项目复制到新建的目录中。
3. 在该目录下创建.aistarter目录，并在其中创建main.js脚本文件和main.json描述文件（您可以直接复制前面的文件）。
9.2.2 main.json示例
{
“name”: “ComfyUI铁锅炖迷你版”,
“description”: “ComfyUI铁锅炖迷你版一款强大的基于节点的界面，用于稳定扩散”,
“version”: “2024-04-27 “,
“install_dir”: “BlenderComfyUIMini”,
“作者”: ” [email protected] “,
“平台”: [
“win”
],
“库”: [],
“compress_list”: [
“Blender_ComfyUI_Mini”,
“工作流程“
]，
“project_zip_size”：5513058
}
9.2.3 main.js示例
{
// 执行初始化
init:async function(){
let pluginPath = this.pluginPath; //AI软件所在目录
console.log(‘插件启动:’, this.pluginName);
this.runInstance = null
this.addDir();
},
//执行安装
install:async function(){
// 标记安装成功（安装完成就要标记它，用于判断安装是否成功）
await zn.markPluginInstalled(this.pluginName);
this.addDir();
},
//执行下载
download:async function(){
console.log(“插件下载！！”);
等待 zn.downloadProjectTorrent(this.pluginName);
},
//运行
run:async function(){
if(this.runInstance){
console.log(this.runInstance.pid)
//this.runInstance.stdin.write(“stop”)
//this.runInstance.stdin.end ();
zn.killProcessTree(this.runInstance.pid);
//this.runInstance.kill(‘SIGKILL’);
this.runInstance = null
返回；
}
zn.showLoading(true, “正在启动，启动时间比较长请耐心等候！”);
让 runMode = 等待 zn.getSettingValue(‘RunMode’, “BlenderComfyUI”);
让useCpu =“”；
if(runMode!= “gpu”){
useCpu = ” –cpu”
}
// callbacklet
回调 = {
创建:(process) => {
this.runInstance = process
},
stdout:(data) => {
let stdoutStr = data.toString();
if(stdoutStr.includes(“开始”)){
zn.showLoading(false);
}
}
}
const options = {
cwd: `${this.pluginPath}Blender_ComfyUI_Mini`
};
尝试 {
等待 zn.execute(‘cmd.exe’, [‘/c’, `.python_embededpython.exe -u -s ComfyUImain.py${useCpu} –windows-standalone-build`], 选项, 回调))) ;
} catch (错误) {
console.error(error.message);
if(this.runInstance){
zn.showMessage(“启动失败请查看终端日志！”);
zn.changeBtnState(this.pluginName, “运行”);
this.runInstance = null;
}
}
zn.showLoading(假);
},
//点击退出
exit:async function(){
if(this.runInstance){
let pid = this.runInstance.pid;
this.runInstance = null
zn.killProcessTree(pid);
}
},
//软件退出时调用
onAppExit:async function(){
this.exit();
},
// 是否正在运行
isRunning:async function(){
return this.runInstance != null;
},
//添加目录
addDir:async function(){
let isInstalled = wait zn.isPluginInstalled(this.pluginName);
if(isInstalled){
zn.addDirToClass(this.pluginName, {icon:”文件夹”, viewName:”ComfyUI根目录”, viewPath:`..ComfyUI`, dirPath:`产品${this.pluginName}Blender_ComfyUI_MiniComfyUI`} ）；
zn.addDirToClass(this.pluginName, {icon:”文件夹”, viewName:”模型目录”, viewPath:`..ComfyUImodels`, dirPath:`产品${this.pluginName}Blender_ComfyUI_MiniComfyUImodels`} )
;
,
//设置菜单
addSetting:async function(){
const settings = {className:”BlenderComfyUI”, title:”铁锅炖ComfyUI设置”, configList:[
{
key: ‘RunMode’,
label:’启动模式’,
type: ‘select’,
options: [
{ label: ‘CPU’, value: ‘cpu’ },
{ label: ‘GPU’, value: ‘gpu’ },
// …其他 GPU 选项
],
default: ‘cpu’
}
]};
返回设置；
},
//设置值改变回调
onSettingChange:async function(settingKey,settingValue,settingClass){
//console.log(“onSettingChange::” + settingKey + “_” +settingValue + “_” +settingClass);
}
}
十、BT做种
10.1 AIStarter做种，需登录账号操作：点击分享后，AIStarter启动器将自动创建脚本并压缩AI项目，生成BT种子文件。要和分享您准备的AI整合包，网络必须支持IPv6，并且请保留AIStarter启动器处于运行状态。
10.2 AIStarter转种：当前网络环境不支持IPv6，因此需要将不知道在不支持IPv6的网络中的种子转移到支持IPv6的电脑上继续做种。具体操作步骤如下：
第一台电脑（不支持IPv6）：
- 找到存放种子文件和压缩的AI项目文件夹位置，如下路径所示：
– 种子文件：`AIStarterWorkProductsChatglmCpp.aistarter`
– 人工智能项目：`AIStarterWorkShare`
说明：
1. `.aistarter` 和 `Share` 是种子文件和AI项目的相对路径，表示它们的路径。
2.当使用这个相对路径时，假设种子文件和AI项目位于当前工作目录的根目录下。
3.请确保在使用相对路径时，当前工作目录是正确的，以便程序能够正确找到种子文件夹。
4. 复制AIStarter生成的种子文件和AI项目。
第二台电脑（支持IPv6）：
- 安装AIStarter启动器软件。
- 第二台电脑复制的种子文件和AI项目粘贴到第二台电脑上对应的.aistarter和分享文件夹位置。
- 保持AIStarter启动器运行，这样就可以正常进行种子做种。
通过以上步骤，你就能够将种子从不支持IPv6的电脑转移到支持IPv6的电脑上，确保做种的连续性和稳定性。
10.3 您也可以通过第三方BT下载工具做种，以qBittorrent为例，做种步骤如下：
第一步：打开qBittorrent软件，点击工具-选择生成Torrent
第二步：
1、选择要做种的文件或文件夹；
2、勾选完成后开始做种；
3、复制粘贴Tracker URL；
这里有每天更新的BitTorrent Tracker列表：
https://github.com/XIU2/TrackersListCollection/blob/master/README-ZH.md
4、制作Tornet；
5、完成制作：一旦您的种子文件制作完成，即可发布。
请确保您的电脑网络支持Pv4公网或IPv6网络，并在每次开机时运行qBittorrent软件，以确保种子下载的顺利进行。
十一、常见问题
11.1 AIStarter启动器怎么获取？是否需要付费？
答：AIStarter启动器是免费下载和使用的软件，可授权任何商家进行收费。我们强烈建议您通过正规途径获取启动器，通过其他渠道支付费用。如果您通过其他渠道支付费用获得了软件本，请立即退款并投诉相应商家。
11.2安装点击一直转圈怎么办？
答：正常情况下安装时一般不会出现这个问题，但如果您选择离线下载安装，可以参考3.3.3节的AI项目离线下载说明。
11.3 提示安装cuda怎么办？
答：当安装过程中出现提示安装CUDA时，这意味着您的系统需要CUDA支持。N卡的用户，请根据自己的显卡版本下载相应的CUDA。您可以参考以下相关教程：
请注意，安装CUDA可能需要管理员权限，并且可能需要重新启动系统才能生效。
11.4 AI应用市场点击下载没反应怎么办？
答：通过AIStarter下载或分享的AI项目，您的电脑网络必须支持IPv6网络。如果您的网络不支持IPv6，您可以参考第3.3.3节的AI项目离线下载说明进行操作。
十二、交流与支持
12.1 点击“交流”按钮，您将直接进入AIStarter的交流社区，您可以在这里向我们提供反馈和建议。此外，您还可以通过官方公布的QQ群、微信群、Telegram、Twitter、Discord等即时线上交流工具加入AIStarter大家庭，参与讨论和交流。
12.2 点击“支持”可以直接赞助作者一杯咖啡，您也可以点击更多支持方案。AIStarter启动器的持续发展和提升需要您的支持和捐赠。作为一款免费平台，我们依赖用户的角色贡献来推动产品的开发并提供更好的用户支持。
12.3 如果您对AIStarter启动器感到满意并认为它对您有所帮助，我们真诚地邀请您考虑捐赠，了解更多赞助方式。您的参与不仅将激励我们持续改进产品，并有助于确保我们能够能够为您提供更优秀的服务。
感谢您对AIStarter启动器的支持！我们将竭尽全力确保您的捐赠产生最大的价值，坚定我们能够不断改进和完善我们的平台，以满足您的需求和期望。
十三、用户协议
13.1 感谢您选择使用AIStarter启动器。启动器的AI项目集成包含基于GitHub上开源的AI项目，同时还包括用户创建和分享的AI集成包。热门的AI项目包括AI绘画、AI视频、AI换脸、AIDialog、StableDiffusion、ComfyUI、SoftVcVits等。我们不断更新这些集成包，提供更多的AI项目选择。我们的目标是为AIGC技术提供一个便捷的算法运行环境，让我们共同努力支持AI开源项目的发展为了保证您的权益和顺利使用本软件，我们特此发布以下用户协议，请您仔细阅读：
您同意严格遵守法律法规，禁止使用本软件从事任何违法行为，包括但不限于：
* 反对宪法所规定的基本原则；
* 破坏国家安全，泄露国家秘密，转移国家政权，破坏国家统一；
* 损害国家荣誉和利益；
* 煽动民族仇恨、制裁，破坏民族团结；
* 破坏国家宗教政策，宣扬邪教和封建迷信；
*散布谣言，扰乱社会秩序，破坏社会稳定；
*散布淫秽、色情、赌博、暴力、凶杀、恐怖或教唆犯罪；
* 侮辱或诽谤他人，侵害他人合法权益；
* 实施任何破坏“七条底线”的行为；
* 含有法律、行政法规禁止的其他内容。
十四、免责声明
14.1 使用条款
- 使用AIStarter启动器即代表您已详细阅读并同意以下使用条款。任何由使用AIStarter启动器产生的数据的产生、收集、处理、使用等相关事项的违法违规行为均由您自行承担责任，与AIStarter启动器器器无关。所有使用AIStarter启动器的行为和后果均由用户个人承担。
14.2 解释权和修改权
- AIStarter作者保留最终的解释权和修改权，以最新的修改权限。用户使用AIStarter启动器即视为同意并接受AIStarter作者对用户协议的解释权和修改权。
14.3 法律责任
- 违反本使用条款可能导致AIStarter启动器使用权被终止，并可能承担相应的法律责任。使用AIStarter启动器即代表您已阅读、理解并同意本使用条款。
感谢您的理解与合作。