左侧账号空间
存放你操作的影刀业务账号，与登录系统的账号不是同一套。这里是所有资源加载的起点。
01
登录与界面概览
打开系统地址后先填写账号、密码，完成滑块拼图验证，再登录控制台。拖动验证失败时可以刷新重试；也可聚焦滑块后用方向键调整位置，按回车确认。
登录与滑块验证
顶部操作栏
主题切换、使用指南、操作日志、修改密码、当前账户和退出账号都在这一行。
功能导航与资源列表
资源管理包含本地应用、分享应用、指令管理；空间与设置包含账号管理，管理员还会看到账户管理。点击资源概览也可以切换列表。
加载逻辑说明：每次点击账号名称时，系统会先校验系统里保存的 Token 是否还有效；有效直接复用，过期才用该账号在系统里保存的登录名和密码换新 Token。所以账号一旦改过密码，需要先在系统里同步修改（见下一节）。
02
账号维护与分组
左侧账号空间右侧的「+」用于新增影刀业务账号。账号显示的名称优先取备注，没有备注时显示账号本身，所以建议把备注写成「电商主店」「华东区-测试」这类一眼能认出的名字。鼠标移到账号行时，右侧铅笔图标用于修改账号。
左侧账号列表按「分组」分段展示：没有选择分组的账号归入未分组，选了分组的按分组聚合，分组标题右侧的数字是该组账号数量。点分组标题可以展开 / 收起，收起状态会被记住，下次打开还是收起的；侧栏只列出有账号的分组，空分组在「账号管理」里可见。同一分组内可以拖动账号调整先后顺序，跨分组拖动不会生效——要换分组请到「账号管理」里改。
单个新增
- 点击左侧账号空间右侧的「+」。
- 填写账号、密码；备注建议写清用途。
- 需要归类时在「分组」里选择已有分组（默认分组即可先跑通）。
- 点击「确认新增」，保存后点击账号名称验证能否加载资源。
同一弹窗点「修改」再打开时，底部会多出「删除账号」。删除只影响系统内的记录，不会影响影刀上的账号本身，但该账号下的资源将无法在系统里继续操作。
批量新增
粘贴格式：一行一个账号；同一行内可用空格、Tab、逗号、分号、竖线、斜杠或中文标点分隔，备注可以留空。解析后先看「状态」列，标红的行不会入库。
账号分组与排序
搜索账号
顶部搜索框支持账号或备注关键词，输入后列表实时收窄。备注规范统一时检索最快。
删除分组
删除分组会同时删除该分组内保存的业务账号记录。要保留账号，请先把它们拖到其他分组或「未分组」，再删除空分组。这只删除本系统记录，不会删除影刀上的账号或资源。
03
本地应用管理
先在左侧选中账号，再进入「本地应用管理」。列表每一行是一个应用，更新时间用于判断是否需要同步或更新。工具栏的批量按钮只对已勾选的行生效。
工具栏操作
| 工具栏按钮 | 作用 | 使用前提 |
|---|---|---|
| 本地上传 | 把本地 ZIP / BOT 包创建为新应用，或覆盖同名应用 | 需要上传权限；文件须可信 |
| 批量下载 | 把勾选的应用打包下载到本地留档 | 至少勾选 1 行 |
| 更新指令 | 更新应用内部引用的市场指令版本，不改应用名称 | 至少勾选 1 行，需「市场指令更新」权限 |
| 批量迁移 | 把勾选的应用创建或更新到其他账号 / 分组 | 至少勾选 1 行，需应用迁移权限 |
本地上传
- 开始创建：目标账号下没有这个应用，需要新建。
- 开始更新：目标账号下已有同名应用，要用本地包覆盖版本。
上传后看进度条与结果提示；同名应用是否被覆盖，取决于应用名称是否一致（下一节有详细规则）。
更新市场指令
04
指令管理
「指令管理」列出当前账号下的指令资源，操作方式与应用列表一致：搜索、勾选、批量下载 / 迁移，另外多一个「指令同步」。
指令列表与同步
迁移后的指令编码
新建迁移会保留完整原指令编码作为一部分，生成 guoke_原指令编码_6位随机字母数字。例如原编码为 data_clean，新编码可能是 guoke_data_clean_A3b9X2。随机后缀使用大小写字母和数字。
更新已有指令或执行版本回退时，会保留目标指令现有编码，不会重新生成编码。原编码缺失时会提示失败，请检查源指令包。
同名更新：应用更新按应用名称匹配，指令更新按指令名称匹配。目标没有同名资源时，系统会明确提示「不存在同名应用 / 指令」，该项更新失败。执行前先核对两边名称。
05
分享应用管理
「分享应用管理」是独立页签，展示别人分享给当前账号的应用，列表会多一列开发者。它支持搜索、批量下载和批量迁移，但不支持本地上传。
查看与迁移分享应用
下载或迁移失败
下载 / 迁移失败先看这里：分享应用的下载与迁移依赖运行详情里解析出的包地址。如果列表能正常显示、但操作失败，通常是服务端签名密钥未配置或运行详情未成功返回，请联系管理员排查，不用反复重试。
06
迁移、更新与额度
迁移弹窗里有两个必须先做的判断：迁移类型（创建还是更新）和目标类型（账号还是分组）。选错类型会在目标端产生重复应用，或者覆盖掉不该覆盖的版本。
选择迁移方式与目标
选「创建」
目标账号下没有这个应用 / 指令时使用。目标已存在同名资源时会失败或产生重复，先确认再提交。
选「更新」
目标账号下已有同名应用或指令，且要用源版本覆盖时使用。找不到同名资源时，该项更新会失败并给出原因。
「加密可视化流程」是什么：只有当来源应用包含可视化流程时，这一块才会出现。勾选后可为流程选择提示模板（模板可在右侧「管理」里维护）。不熟悉时保持默认，不要随意改动流程打开后的提示行为。
提交与执行进度
- 先预检目标账号登录态逐个校验目标账号的 Token，必要时用账密换新。任何一个账号校验失败，系统不会创建任务，直接提示你核对目标账号密码。
- 预扣额度按「资源数量 × 目标账号数量」预扣。选择分组时，会展开为分组内的实际目标账号；例如 2 个资源迁移到 3 个账号，预扣 6 次。
- 按进度执行弹窗内显示百分比进度，期间不要重复提交。单个任务失败不影响其它任务。
- 核对结果完成后切到目标账号重新加载列表，确认资源已出现或版本已更新；失败项去「操作日志」看具体原因。
额度与失败退款
额度怎么算
迁移按资源与目标账号的组合数量计算；本地上传、回退、指令同步按实际任务项计算。管理员账户不受额度限制，其他账户以管理员分配的额度为准。
失败会退额度吗
会。任务结束时按「预扣数量 − 成功数量」自动退还，失败项不消耗额度，无需单独申请。
07
版本回退
列表操作列第一个图标就是「回退」。弹窗里只列出非在线版本，每条带版本号和保存时间，选择后点该行的「回退」即可。
选择历史版本
备份与权限
回退前先备份：回退会把当前在线版本替换成历史版本。先下载当前版本，确认回退目标版本号与时间无误，再执行。
权限说明：应用回退使用「本地应用回退」权限；指令回退使用「本地指令回退」权限。
权限说明：应用回退使用「本地应用回退」权限；指令回退使用「本地指令回退」权限。
08
操作日志与排查
顶部「操作日志」按页展示历史操作，字段包括操作时间、应用 / 指令名称、账号信息、操作类型和状态。迁移、同步、回退之后都应该来这里核对一次。
查看操作记录
先看状态列
失败条目通常已经写明原因（权限不足、账号不支持、名称不匹配等），按提示处理比重试更快。
再看错误编号
页面右下角浮层提示失败原因；服务端异常会附带「错误编号」，把这个编号给管理员即可在日志里定位完整堆栈。
09
密码、主题与退出
修改登录密码
- 顶部点「修改密码」。
- 填写旧密码、新密码与确认密码。
- 提交后用新密码重新登录一次，确认生效。
这里改的是系统登录密码，不是左侧影刀业务账号的密码。业务账号密码在账号卡片的「修改」里更新。
深浅主题
安全退出
安全提醒：截图、导出文件和群聊里不要出现真实账号密码、Token、Cookie。公共电脑用完请点「退出账号」；「记住账号」只保存账号名，不要把密码写进备注或工单。
10
常见问题
登录与资源操作
登录页提示「MySQL 尚未配置」
请管理员在项目根目录的 .env 中填写 MySQL 配置，创建数据库并执行 php bin/init-db.php，然后重启服务。数据库准备完成前仍可查看本文档。
滑块验证过期、失败或提示请求过于频繁
验证与当前浏览器会话、填写的账号绑定。更改账号、验证过期或登录失败后，需要重新验证；拼图加载异常可点刷新。连续失败触发限制时，按页面提示等待后重试，不要频繁刷新或重复提交。
看不到应用或指令，列表是空的
先确认已经点击左侧账号名称，并且列表上方显示「当前账号：xxx（已加载）」。仍为空时，刷新页面或重新登录；再不行就确认该账号在影刀上确实有资源，以及你的账号是否被授予对应权限。
提示「账号或密码错误，请检查该账号的登录名和密码后重试」
说明影刀认证服务明确拒绝了这个业务账号的登录。通常是该账号在影刀侧改过密码，而系统里保存的还是旧密码。请到账号卡片「修改」里更新密码后再选择账号。
提示「无法连接影刀认证服务」
这是网络或认证接口异常，不是账号密码问题。换网络稍后重试；多次失败请联系管理员检查服务端网络与接口可用性。
点「开始迁移」直接被拦下，没有生成任务
说明目标账号的登录态预检没通过。系统在创建任务前会逐个校验目标账号，只要有一个账号无法认证就会整体拦下。请核对这些账号的密码与状态，修正后重新提交。
更新提示「目标账号中不存在同名应用 / 指令」
核对所选目标账号，并检查两边资源名称是否一致。系统找不到同名资源时会将该项标记为失败；批量任务结束后仍需检查成功与失败明细。目标尚未存在资源时，可改用「创建」。
提示「社区版或基础账号不能使用高级指令集」或「未开通高级应用迁移权限」
这次迁移涉及高级依赖处理，需要「高级应用迁移」权限。联系管理员为你的账号勾选该权限后再试。
服务重启后，任务会丢失或自动重试吗
任务状态保存在 MySQL 中。后台服务重启时，正在执行但未完成的任务会标记为中断，并退还未完成项的额度；不会自动重复提交。重试前先核对远端资源与操作日志，确认是否已经提交成功，避免重复创建。
提示「任务不存在或无权限访问」
确认当前登录的是提交任务的系统账户，并且服务仍连接同一个数据库。请管理员按操作时间核对任务记录，不要直接反复提交。
分享应用能看到，但下载或迁移失败
分享应用的下载 / 迁移依赖运行详情链路解析包地址，服务端签名密钥缺失时就会失败。这属于服务端配置问题，请联系管理员，不用反复点击。
迁移失败了，额度会白扣吗
不会。任务开始时按数量预扣，结束时按「预扣 − 成功」自动退还，失败项不消耗额度。
按钮点了没反应，或提示没有权限
先确认左侧已选中账号；再确认你的账号是否被授予对应权限。权限由管理员在「账户管理」里分配，普通账号无法自行开启。
为什么看不到「账户管理」页签
该页签只对管理员开放。普通用户只能管理自己的业务账号与资源，不能新增或修改系统账户。
还是解决不了？把三样信息一起发给管理员：操作时间、操作日志里的失败条目截图、页面右下角浮层提示（含错误编号）。有这三样基本能一次定位。