安装可回退,卸载也必须说清保留什么、删除什么
现在
常用
截至 11 月 4 日 · 项目源码和已装模块

AI CLI Profile Manager · 功能说明

安装和升级先在旁边验新版本,失败保留旧版;卸载时明确哪些个人配置与本机密钥保留,远端登录授权另行处理。

当前情况:11 月 4 日 11:18 读到本机装的是 0.3.19,GitHub 上最新的正式发行仍是 9 月 22 日的 0.3.18;Codex 桌面版的桥接发行另行登记:10 月 30 日读到启用登记是 a97016bff2f2576e(10 月 28 日 11:55 写入),只核到登记;10 月 22 日选中的 ee35736204370d9b 和 10 月 11 日核对一致的 b47fea3ce81f7a67 都是更早的版本。升级、旧版回退与真实模型运行分别验收,不由安装成功包办。旧 Qwen3.7 的一次性迁移脚本已经从源码删除,安装成功后改为直接清理身份对得上的旧模块。

内容按 2026-10-11 14:00(北京时间)前的改动整理,源码对应 10 月 8 日 09:55 的提交;本机模块版本和正式发行按 11 月 4 日只读核对,桌面桥启用登记按 10 月 30 日读数,已删除的脚本按 10 月 22 日只读核对;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

安装可回退,卸载也必须说清保留什么、删除什么
现在
常用
截至 11 月 4 日 · 项目源码和已装模块

AI CLI Profile Manager · 功能说明

安装和升级先在旁边验新版本,失败保留旧版;卸载时明确哪些个人配置与本机密钥保留,远端登录授权另行处理。

当前情况:11 月 4 日 11:18 读到本机装的是 0.3.19,GitHub 上最新的正式发行仍是 9 月 22 日的 0.3.18;Codex 桌面版的桥接发行另行登记:10 月 30 日读到启用登记是 a97016bff2f2576e(10 月 28 日 11:55 写入),只核到登记;10 月 22 日选中的 ee35736204370d9b 和 10 月 11 日核对一致的 b47fea3ce81f7a67 都是更早的版本。升级、旧版回退与真实模型运行分别验收,不由安装成功包办。旧 Qwen3.7 的一次性迁移脚本已经从源码删除,安装成功后改为直接清理身份对得上的旧模块。

内容按 2026-10-11 14:00(北京时间)前的改动整理,源码对应 10 月 8 日 09:55 的提交;本机模块版本和正式发行按 11 月 4 日只读核对,桌面桥启用登记按 10 月 30 日读数,已删除的脚本按 10 月 22 日只读核对;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

直接覆盖旧安装可能留下半套文件;卸载时一句“完成”也可能让人误以为所有模型、账号授权和个人配置都没了。安装先验候选,卸载明确保留范围。

举个实际例子

我可以说:“把 main 的最后修复装上;若遇到未知旧文件就先停。以后普通卸载保留我的 Profile 和密文,只有我明确彻底清理时才删本工具数据。”我会得到安装、保留内容和可回退位置的明确结果。

最后我会得到什么

拿到当前用户可用的 aicli 命令和已核对的安装版本;失败有旧版可回退。普通卸载保留配置和本机密钥,明确彻底清理才删本工具数据,远端账号授权还要到服务侧另办。

结果怎么看
正常时

候选安装、切换和新命令窗口回读都通过后,说明本工具安装完成。

发现问题时

旧模块还在使用或上游变更时提示关闭旧窗口、更新对应部件或暂用旧版。

入口不可用或证据不足时

未知旧文件、候选不完整或安装目录被占时不做半套替换,保留原安装。

这项功能怎样使用

用途与实际影响

为什么需要它

直接覆盖旧安装可能留下半套文件;卸载时一句“完成”也可能让人误以为所有模型、账号授权和个人配置都没了。安装先验候选,卸载明确保留范围。

举个实际例子

我可以说:“把 main 的最后修复装上;若遇到未知旧文件就先停。以后普通卸载保留我的 Profile 和密文,只有我明确彻底清理时才删本工具数据。”我会得到安装、保留内容和可回退位置的明确结果。

最后我会得到什么

拿到当前用户可用的 aicli 命令和已核对的安装版本;失败有旧版可回退。普通卸载保留配置和本机密钥,明确彻底清理才删本工具数据,远端账号授权还要到服务侧另办。

结果怎么看
正常时

候选安装、切换和新命令窗口回读都通过后,说明本工具安装完成。

发现问题时

旧模块还在使用或上游变更时提示关闭旧窗口、更新对应部件或暂用旧版。

入口不可用或证据不足时

未知旧文件、候选不完整或安装目录被占时不做半套替换,保留原安装。

从哪里开始

在本机用项目安装器处理已核对的源码或 Release 包;卸载时明确普通保留还是彻底清理本工具数据。

需要准备什么
  • 可信安装包或源码
  • 现有 Profile 和密文是否要保留
  • 已知旧版及回滚位置
从开始到拿到结果
1先预检旧状态
检查已有安装与退役对象,未知用户文件先停下核对。
2安装可回退候选
构建独立候选并切换,失败时恢复旧版。
3新开终端验入口
重新打开命令窗口,检查版本、保存的配置档、静态体检和启动预览;普通卸载保留本工具数据,彻底清理与远端账号授权撤销分开办理。
从哪里开始

在本机用项目安装器处理已核对的源码或 Release 包;卸载时明确普通保留还是彻底清理本工具数据。

需要准备什么
  • 可信安装包或源码
  • 现有 Profile 和密文是否要保留
  • 已知旧版及回滚位置
从开始到拿到结果
1先预检旧状态
检查已有安装与退役对象,未知用户文件先停下核对。
2安装可回退候选
构建独立候选并切换,失败时恢复旧版。
3新开终端验入口
重新打开命令窗口,检查版本、保存的配置档、静态体检和启动预览;普通卸载保留本工具数据,彻底清理与远端账号授权撤销分开办理。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
0.3.18 正式发行(9 月 22 日)有完整验收;当前已装 0.3.19 尚无对应正式发行;10 月 30 日读到桌面启用登记是 a97016bff2f2576e(10 月 28 日 11:55 写入),只核到登记,七文件验真和实际加载未核对,模型任务仍另验
关键规则与设计选择
1
源码版本、发布包、当前用户模块和桌面内容寻址发行是不同对象;模块升级不会自动重建或切换正在工作的桌面发行。
2
旧 Qwen3.7 对象当初只把可验证的移入 quarantine(可恢复隔离区),SecretRef 和 Key 不参与;这次一次性迁移已经做完,迁移脚本已从源码删除,现在安装成功后直接清理身份对得上的旧模块。
3
普通卸载保留 Profile 和 DPAPI 密文,也不动密码中心里的厂商钥匙;--purge-user-data 才删除本工具数据,仍不代表远程 OAuth(账号授权协议) 撤销。两个已退役代理留下的旧资料不再由卸载程序当作现役功能管理。
当前怎样实现
  • Install.ps1 从当前 PSModulePath 选择 CurrentUser 模块根,在临时候选中导入验证,再对同一父目录执行原子重命名。
  • 原来的 Invoke-AiCliRetirementMigration.ps1 只移动 marker、路径、内容 hash(内容指纹) 与 state 都闭合的退役 Qwen3.7 对象,未知项在写前阻断。它是一次性迁移,已经从源码删除(变更记录写在尚未正式发行的“未发布/移除”段落),10 月 22 日 scripts 目录里已没有这个文件,不再是可用入口。
  • UpdateService 识别实际启动入口和安装渠道;只读检查与指引不静默升级上游。
  • Uninstall.ps1 移除模块、shim(受保护入口垫片)、PATH 与受管 Profile 块;用户数据和上游产品默认保留。两个代理 9 月 29 日退役后,它只在模块已不可用、却发现旧代理状态文件时拒绝盲删,这是遗留的安全收口,不是代理管理入口。
  • 《AI CLI(命令行工具) Profile Manager 使用手册》讲产品安装、Profile、Doctor/Live、更新、卸载与排障;《Codex、Claude Code 与 Open Interpreter CLI(命令行工具) 中文手册》讲上游会话内模型、effort(思考等级)、权限、上下文、恢复和命令差异。当前部分用户手册段落仍写着旧的“configure 询问 Key”和 Toolkit 同步,以当前实现为准。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
0.3.18 正式发行(9 月 22 日)有完整验收;当前已装 0.3.19 尚无对应正式发行;10 月 30 日读到桌面启用登记是 a97016bff2f2576e(10 月 28 日 11:55 写入),只核到登记,七文件验真和实际加载未核对,模型任务仍另验
关键规则与设计选择
1
源码版本、发布包、当前用户模块和桌面内容寻址发行是不同对象;模块升级不会自动重建或切换正在工作的桌面发行。
2
旧 Qwen3.7 对象当初只把可验证的移入 quarantine(可恢复隔离区),SecretRef 和 Key 不参与;这次一次性迁移已经做完,迁移脚本已从源码删除,现在安装成功后直接清理身份对得上的旧模块。
3
普通卸载保留 Profile 和 DPAPI 密文,也不动密码中心里的厂商钥匙;--purge-user-data 才删除本工具数据,仍不代表远程 OAuth(账号授权协议) 撤销。两个已退役代理留下的旧资料不再由卸载程序当作现役功能管理。
当前怎样实现
  • Install.ps1 从当前 PSModulePath 选择 CurrentUser 模块根,在临时候选中导入验证,再对同一父目录执行原子重命名。
  • 原来的 Invoke-AiCliRetirementMigration.ps1 只移动 marker、路径、内容 hash(内容指纹) 与 state 都闭合的退役 Qwen3.7 对象,未知项在写前阻断。它是一次性迁移,已经从源码删除(变更记录写在尚未正式发行的“未发布/移除”段落),10 月 22 日 scripts 目录里已没有这个文件,不再是可用入口。
  • UpdateService 识别实际启动入口和安装渠道;只读检查与指引不静默升级上游。
  • Uninstall.ps1 移除模块、shim(受保护入口垫片)、PATH 与受管 Profile 块;用户数据和上游产品默认保留。两个代理 9 月 29 日退役后,它只在模块已不可用、却发现旧代理状态文件时拒绝盲删,这是遗留的安全收口,不是代理管理入口。
  • 《AI CLI(命令行工具) Profile Manager 使用手册》讲产品安装、Profile、Doctor/Live、更新、卸载与排障;《Codex、Claude Code 与 Open Interpreter CLI(命令行工具) 中文手册》讲上游会话内模型、effort(思考等级)、权限、上下文、恢复和命令差异。当前部分用户手册段落仍写着旧的“configure 询问 Key”和 Toolkit 同步,以当前实现为准。
技术实现与依据(二)
1
从可信源码或已核对 Release 包启动安装。
2
只读预检安装目录。
3
构建并导入临时候选。
4
原子移动旧版与候选,失败则恢复;成功后清理身份对得上的旧模块(源码现行做法,取代已删除的一次性迁移脚本)。
5
新开 PowerShell 并回读 aicli version/list/show/doctor/native/eject。
6
退出时选择普通卸载或显式 purge,并另外处理远程授权。
  • 两本 PDF 是同版本 Markdown 的打印制品;只有源 hash(内容指纹)、文本抽取和逐页视觉复核闭合时才 current(当前状态),但它们仍不证明安装或 Live。10 月 11 日没有重新渲染或逐页核对,是否与当前 Markdown 完全一致未验证。
  • 0.3.18 已由原安装器交付并在 GitHub 正式发行;当前源码和本机模块为 0.3.19,还没有对应的正式发行。11 月 4 日逐文件比对 SHA-256:模块清单、Private\ModelRouting.ps1、VendorCredential.ps1、LaunchPlan.ps1、RecoveryService.ps1、Support\GetDesktopModelPlan.ps1、Support\ResolveDesktopEngine.ps1、Support\DesktopBridge\RpcTransport.OpenAiChild.cs 和 data\providers\codex-official.json 与当前源码都相同;只比了这几个文件,不等于整个安装目录都验过,也不证明正在运行的桌面已加载。历史:10 月 11 日比对过的模块清单、ChildProcess.ps1 和 VendorCredential.ps1 与源码相同,但当时模块里的 ResolveDesktopEngine.ps1 还是 9 月 23 日的旧副本,这项差异现在已不在;真实桌面走的是桥里的版本,10 月 30 日读到启用登记的桥 a97016bff2f2576e 带的副本没有比对。DryRun/WhatIf(只读预演)在任何写入前返回,未知参数拒绝;原来的 Toolkit 接线 9 月 28 日已退役。桌面启用、停用和设置同步使用各自显式入口。
执行流程
技术实现与依据(二)
1
从可信源码或已核对 Release 包启动安装。
2
只读预检安装目录。
3
构建并导入临时候选。
4
原子移动旧版与候选,失败则恢复;成功后清理身份对得上的旧模块(源码现行做法,取代已删除的一次性迁移脚本)。
5
新开 PowerShell 并回读 aicli version/list/show/doctor/native/eject。
6
退出时选择普通卸载或显式 purge,并另外处理远程授权。
  • 两本 PDF 是同版本 Markdown 的打印制品;只有源 hash(内容指纹)、文本抽取和逐页视觉复核闭合时才 current(当前状态),但它们仍不证明安装或 Live。10 月 11 日没有重新渲染或逐页核对,是否与当前 Markdown 完全一致未验证。
  • 0.3.18 已由原安装器交付并在 GitHub 正式发行;当前源码和本机模块为 0.3.19,还没有对应的正式发行。11 月 4 日逐文件比对 SHA-256:模块清单、Private\ModelRouting.ps1、VendorCredential.ps1、LaunchPlan.ps1、RecoveryService.ps1、Support\GetDesktopModelPlan.ps1、Support\ResolveDesktopEngine.ps1、Support\DesktopBridge\RpcTransport.OpenAiChild.cs 和 data\providers\codex-official.json 与当前源码都相同;只比了这几个文件,不等于整个安装目录都验过,也不证明正在运行的桌面已加载。历史:10 月 11 日比对过的模块清单、ChildProcess.ps1 和 VendorCredential.ps1 与源码相同,但当时模块里的 ResolveDesktopEngine.ps1 还是 9 月 23 日的旧副本,这项差异现在已不在;真实桌面走的是桥里的版本,10 月 30 日读到启用登记的桥 a97016bff2f2576e 带的副本没有比对。DryRun/WhatIf(只读预演)在任何写入前返回,未知参数拒绝;原来的 Toolkit 接线 9 月 28 日已退役。桌面启用、停用和设置同步使用各自显式入口。
执行流程
名词和入口
本模块用到的名词
名词意思
CurrentUser(当前用户范围)模块只安装给当前 Windows 用户,不要求系统级管理员安装。
quarantine(可恢复隔离区)把身份已闭合的退役文件移出活动位置并保留前像,而不是直接删除。
atomic switch(原子切换)候选完整验证后用同父目录重命名替换,避免复制中途留下半套文件。
专业定义

模块、用户数据、上游 CLI(命令行工具) 与远程授权各有自己的生命周期。

名词和入口
本模块用到的名词
名词意思
CurrentUser(当前用户范围)
意思:
模块只安装给当前 Windows 用户,不要求系统级管理员安装。
quarantine(可恢复隔离区)
意思:
把身份已闭合的退役文件移出活动位置并保留前像,而不是直接删除。
atomic switch(原子切换)
意思:
候选完整验证后用同父目录重命名替换,避免复制中途留下半套文件。
专业定义

模块、用户数据、上游 CLI(命令行工具) 与远程授权各有自己的生命周期。

出问题时
解决什么
防止升级造成半套模块、退役误删用户配置,以及卸载把多个独立生命周期说成一个动作。
边界
10 月 11 日的整理不创建新的 GitHub Release,也不安装或卸载。
不静默升级 Codex、Claude、Ollama 或 Open Interpreter。
文档与 PDF 是用户入口,不是当前安装、运行或 Live 的替代证据。
失败与恢复
  • 同版本已经安装但未给 -Force: 默认拒绝覆盖,避免意外替换正在使用的版本。
  • 退役对象无法证明归属: 安装在任何迁移前阻断,保留原件供人工审阅。
  • 安装后当前 shell 仍加载旧模块: 关闭重开 PowerShell,或 Remove-Module 后强制 Import-Module,再核对路径和版本。
出问题时
解决什么
防止升级造成半套模块、退役误删用户配置,以及卸载把多个独立生命周期说成一个动作。
边界
10 月 11 日的整理不创建新的 GitHub Release,也不安装或卸载。
不静默升级 Codex、Claude、Ollama 或 Open Interpreter。
文档与 PDF 是用户入口,不是当前安装、运行或 Live 的替代证据。
失败与恢复
  • 同版本已经安装但未给 -Force: 默认拒绝覆盖,避免意外替换正在使用的版本。
  • 退役对象无法证明归属: 安装在任何迁移前阻断,保留原件供人工审阅。
  • 安装后当前 shell 仍加载旧模块: 关闭重开 PowerShell,或 Remove-Module 后强制 Import-Module,再核对路径和版本。
依据与来源(一)
真实入口
  • scripts/Install.ps1:候选验证与原子安装
  • scripts/Invoke-AiCliRetirementMigration.ps1(已删除):原来的旧 Qwen3.7 退役迁移,一次性做完后已从源码删除,10 月 22 日 scripts 目录里没有这个文件;现在由 Install.ps1 安装成功后直接清理身份对得上的旧模块
  • scripts/Uninstall.ps1:模块、shim(受保护入口垫片)、PATH 与数据边界
  • docs/user/AI CLI Profile Manager 使用手册.md:安装、Profile、验证、更新、卸载与排障事实源
  • docs/user/Codex、Claude Code 与 Open Interpreter CLI 中文手册.md:原生 CLI(命令行工具) 会话内命令与差异
  • docs/compatibility/VERIFIED-COMPATIBILITY.md:每条 Profile 的证据边界(文档日期 9 月 17 日)
如何验证
  • 0.3.18 正式发行(GitHub 9 月 22 日 15:28)时完整 Pester 555/555、发行 smoke 与隔离安装/同版替换通过;旧32项退役、385项全量和 Junction(目录联接) 修复保留原日期。9 月 29 日的全量离线测试 470/470 只针对源码,不等于 0.3.19 正式发行或一次新安装。
  • 10 月 11 日零写入诊断读到本机模块 0.3.19、桌面桥 b47fea3ce81f7a67 已启用、安装状态 verified、七个文件全部一致。这次没有执行安装或切换。这是 10 月 11 日的历史结论;10 月 30 日读到启用登记的桥已是 a97016bff2f2576e,还没有对应的七文件验真。11 月 4 日读到 GitHub 最新正式发行仍是 v0.3.18(北京时间 9 月 22 日 15:28:07),已装 0.3.19 不能写成已正式发布。
依据与来源(一)
真实入口
  • scripts/Install.ps1:候选验证与原子安装
  • scripts/Invoke-AiCliRetirementMigration.ps1(已删除):原来的旧 Qwen3.7 退役迁移,一次性做完后已从源码删除,10 月 22 日 scripts 目录里没有这个文件;现在由 Install.ps1 安装成功后直接清理身份对得上的旧模块
  • scripts/Uninstall.ps1:模块、shim(受保护入口垫片)、PATH 与数据边界
  • docs/user/AI CLI Profile Manager 使用手册.md:安装、Profile、验证、更新、卸载与排障事实源
  • docs/user/Codex、Claude Code 与 Open Interpreter CLI 中文手册.md:原生 CLI(命令行工具) 会话内命令与差异
  • docs/compatibility/VERIFIED-COMPATIBILITY.md:每条 Profile 的证据边界(文档日期 9 月 17 日)
如何验证
  • 0.3.18 正式发行(GitHub 9 月 22 日 15:28)时完整 Pester 555/555、发行 smoke 与隔离安装/同版替换通过;旧32项退役、385项全量和 Junction(目录联接) 修复保留原日期。9 月 29 日的全量离线测试 470/470 只针对源码,不等于 0.3.19 正式发行或一次新安装。
  • 10 月 11 日零写入诊断读到本机模块 0.3.19、桌面桥 b47fea3ce81f7a67 已启用、安装状态 verified、七个文件全部一致。这次没有执行安装或切换。这是 10 月 11 日的历史结论;10 月 30 日读到启用登记的桥已是 a97016bff2f2576e,还没有对应的七文件验真。11 月 4 日读到 GitHub 最新正式发行仍是 v0.3.18(北京时间 9 月 22 日 15:28:07),已装 0.3.19 不能写成已正式发布。
依据与来源(二)
  • 安装、进程加载、Profile 配置与真实模型结果分别证明;9月14日73/73和9月3日损坏Profile拒绝不冒充新版 E2E(端到端验证)。
与其他模块的关系

这是产品进入和退出本机的生命周期;配置档与秘密模块拥有用户数据,验证模块负责安装后的真实功能回读。

依据与来源(二)
  • 安装、进程加载、Profile 配置与真实模型结果分别证明;9月14日73/73和9月3日损坏Profile拒绝不冒充新版 E2E(端到端验证)。
与其他模块的关系

这是产品进入和退出本机的生命周期;配置档与秘密模块拥有用户数据,验证模块负责安装后的真实功能回读。

复制 AI 续作说明

项目:安装可回退,卸载也必须说清保留什么、删除什么;仓库:wlyaaaaa/ai-cli-profile-manager;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。