

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 日只读核对;具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

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 和密文是否要保留
- 已知旧版及回滚位置


在本机用项目安装器处理已核对的源码或 Release 包;卸载时明确普通保留还是彻底清理本工具数据。
- 可信安装包或源码
- 现有 Profile 和密文是否要保留
- 已知旧版及回滚位置



- 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 同步,以当前实现为准。


- 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 同步,以当前实现为准。

- 两本 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\与当前源码都相同;只比了这几个文件,不等于整个安装目录都验过,也不证明正在运行的桌面已加载。历史:10 月 11 日比对过的模块清单、ChildProcess.ps1 和 VendorCredential.ps1 与源码相同,但当时模块里的 ResolveDesktopEngine.ps1 还是 9 月 23 日的旧副本,这项差异现在已不在;真实桌面走的是桥里的版本,10 月 30 日读到启用登记的桥 a97016bff2f2576e 带的副本没有比对。DryRun/WhatIf(只读预演)在任何写入前返回,未知参数拒绝;原来的 Toolkit 接线 9 月 28 日已退役。桌面启用、停用和设置同步使用各自显式入口。providers\ codex-official.json


- 两本 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\与当前源码都相同;只比了这几个文件,不等于整个安装目录都验过,也不证明正在运行的桌面已加载。历史:10 月 11 日比对过的模块清单、ChildProcess.ps1 和 VendorCredential.ps1 与源码相同,但当时模块里的 ResolveDesktopEngine.ps1 还是 9 月 23 日的旧副本,这项差异现在已不在;真实桌面走的是桥里的版本,10 月 30 日读到启用登记的桥 a97016bff2f2576e 带的副本没有比对。DryRun/WhatIf(只读预演)在任何写入前返回,未知参数拒绝;原来的 Toolkit 接线 9 月 28 日已退役。桌面启用、停用和设置同步使用各自显式入口。providers\ codex-official.json



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

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



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

- 同版本已经安装但未给 -Force: 默认拒绝覆盖,避免意外替换正在使用的版本。
- 退役对象无法证明归属: 安装在任何迁移前阻断,保留原件供人工审阅。
- 安装后当前 shell 仍加载旧模块: 关闭重开 PowerShell,或 Remove-Module 后强制 Import-Module,再核对路径和版本。

- 同版本已经安装但未给 -Force: 默认拒绝覆盖,避免意外替换正在使用的版本。
- 退役对象无法证明归属: 安装在任何迁移前阻断,保留原件供人工审阅。
- 安装后当前 shell 仍加载旧模块: 关闭重开 PowerShell,或 Remove-Module 后强制 Import-Module,再核对路径和版本。

scripts/:候选验证与原子安装Install.ps1
scripts/(已删除):原来的旧 Qwen3.7 退役迁移,一次性做完后已从源码删除,10 月 22 日 scripts 目录里没有这个文件;现在由 Install.ps1 安装成功后直接清理身份对得上的旧模块Invoke-AiCliRetirementMigration.ps1
scripts/:模块、shim(受保护入口垫片)、PATH 与数据边界Uninstall.ps1
docs/:安装、Profile、验证、更新、卸载与排障事实源user/ AI CLI Profile Manager 使用手册.md
docs/:原生 CLI(命令行工具) 会话内命令与差异user/ Codex、Claude Code 与 Open Interpreter CLI 中文手册.md
docs/:每条 Profile 的证据边界(文档日期 9 月 17 日)compatibility/ VERIFIED-COMPATIBILITY.md
- 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/(已删除):原来的旧 Qwen3.7 退役迁移,一次性做完后已从源码删除,10 月 22 日 scripts 目录里没有这个文件;现在由 Install.ps1 安装成功后直接清理身份对得上的旧模块Invoke-AiCliRetirementMigration.ps1
scripts/:模块、shim(受保护入口垫片)、PATH 与数据边界Uninstall.ps1
docs/:安装、Profile、验证、更新、卸载与排障事实源user/ AI CLI Profile Manager 使用手册.md
docs/:原生 CLI(命令行工具) 会话内命令与差异user/ Codex、Claude Code 与 Open Interpreter CLI 中文手册.md
docs/:每条 Profile 的证据边界(文档日期 9 月 17 日)compatibility/ VERIFIED-COMPATIBILITY.md
- 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。





