PI-Desktop 模型别名功能详解给你的常用模型起一个快捷名字的完整指南【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-DesktopPI-Desktop 是一款本地优先的 AI 编程智能体桌面应用它的模型别名功能让你可以为配置中的模型起一个简短的个人名字如 fast、pro。别名会显示在输入框、模型选择器等所有提到模型名的位置而实际请求仍使用真实模型 ID完全不影响调用。下面带你快速上手这个实用功能。为什么需要模型别名日常使用中一个服务商下往往挂着好几个名字非常相似的模型比如同一系列的 mini / pro / max在输入框的模型下拉菜单里很容易混淆。而模型目录里发布的显示名是只读的你没法改。模型别名Model Alias就是来解决这个问题的给某个模型绑一个你自己的短标签一眼就能认出它。这是由 docs/adr/0192-model-alias.md 这份架构决策文档正式确定的功能设计。三步设置模型别名第 1 步打开模型配置页进入设置 → 智能体 → 模型你会看到服务商列表。点击某个服务商行展开选择你想起名的模型。第 2 步展开高级选项在选中的模型行右侧点击高级Advanced展开详细配置区第一个字段就是别名Alias占位提示是例如 fast。第 3 步输入别名自动保存输入你想要的名字最多 60 个字符别名会作为服务商模型配置的一部分自动持久化。清掉这个字段就会恢复目录里的原始显示名。别名输入框的实现位于 ModelSelectionPanes.tsx输入时会按 Unicode 码点截断到 60 字符与后端校验保持一致。别名在哪里生效按设计约定别名的显示遵循一条清晰的规则——面向人的地方显示别名面向机器的地方保持真实 ID位置显示内容输入框Composer模型选择器✅ 别名输入框搜索✅ 可搜到别名不区分大小写的子串匹配模型配置页的模型行真实 ID 别名片会话记录中的模型徽章真实 ID这条规则的好处是即使别名起得再随意你也永远不会搞错到底会调用哪个模型。显示名的解析逻辑见 composer-models.ts别名非空时用别名否则用目录显示名最后回退到模型 ID。别名规则与限制一览长度上限 60 个字符后端 Rust 核心会校验超长时返回MODEL_ALIAS_TOO_LONG错误校验代码见 validation.rs纯显示标签id永远是发给服务商的请求标识别名不会改变任何请求行为空白即删除空别名会被直接丢弃并恢复目录命名不存在残留的空标签零架构成本别名存在现有的服务商配置 JSON 里无需协议或数据库结构变更一个典型使用场景假设你在同一服务商下配了两个模型把日常快速问答的模型别名设为fast把处理复杂重构的模型别名设为deep之后在输入框的模型选择器里你会看到清爽的fast/deep而不是一串长得几乎一样的发布名。切换模型、搜索模型都更快多服务商、多模型的管理成本大幅下降。 小贴士配置页的模型 ID 现在也支持直接拖选复制.selectable样式不用再手动重打一长串 ID 了。模型别名的国际化文案各语言的别名标签与提示语维护在 packages/i18n/src/locales/zh-CN/index.ts功能细节更多可参考 13-model-catalog-and-selection.md 规格文档。【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
PI-Desktop 模型别名功能详解：给你的常用模型起一个快捷名字的完整指南
PI-Desktop 模型别名功能详解给你的常用模型起一个快捷名字的完整指南【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-DesktopPI-Desktop 是一款本地优先的 AI 编程智能体桌面应用它的模型别名功能让你可以为配置中的模型起一个简短的个人名字如 fast、pro。别名会显示在输入框、模型选择器等所有提到模型名的位置而实际请求仍使用真实模型 ID完全不影响调用。下面带你快速上手这个实用功能。为什么需要模型别名日常使用中一个服务商下往往挂着好几个名字非常相似的模型比如同一系列的 mini / pro / max在输入框的模型下拉菜单里很容易混淆。而模型目录里发布的显示名是只读的你没法改。模型别名Model Alias就是来解决这个问题的给某个模型绑一个你自己的短标签一眼就能认出它。这是由 docs/adr/0192-model-alias.md 这份架构决策文档正式确定的功能设计。三步设置模型别名第 1 步打开模型配置页进入设置 → 智能体 → 模型你会看到服务商列表。点击某个服务商行展开选择你想起名的模型。第 2 步展开高级选项在选中的模型行右侧点击高级Advanced展开详细配置区第一个字段就是别名Alias占位提示是例如 fast。第 3 步输入别名自动保存输入你想要的名字最多 60 个字符别名会作为服务商模型配置的一部分自动持久化。清掉这个字段就会恢复目录里的原始显示名。别名输入框的实现位于 ModelSelectionPanes.tsx输入时会按 Unicode 码点截断到 60 字符与后端校验保持一致。别名在哪里生效按设计约定别名的显示遵循一条清晰的规则——面向人的地方显示别名面向机器的地方保持真实 ID位置显示内容输入框Composer模型选择器✅ 别名输入框搜索✅ 可搜到别名不区分大小写的子串匹配模型配置页的模型行真实 ID 别名片会话记录中的模型徽章真实 ID这条规则的好处是即使别名起得再随意你也永远不会搞错到底会调用哪个模型。显示名的解析逻辑见 composer-models.ts别名非空时用别名否则用目录显示名最后回退到模型 ID。别名规则与限制一览长度上限 60 个字符后端 Rust 核心会校验超长时返回MODEL_ALIAS_TOO_LONG错误校验代码见 validation.rs纯显示标签id永远是发给服务商的请求标识别名不会改变任何请求行为空白即删除空别名会被直接丢弃并恢复目录命名不存在残留的空标签零架构成本别名存在现有的服务商配置 JSON 里无需协议或数据库结构变更一个典型使用场景假设你在同一服务商下配了两个模型把日常快速问答的模型别名设为fast把处理复杂重构的模型别名设为deep之后在输入框的模型选择器里你会看到清爽的fast/deep而不是一串长得几乎一样的发布名。切换模型、搜索模型都更快多服务商、多模型的管理成本大幅下降。 小贴士配置页的模型 ID 现在也支持直接拖选复制.selectable样式不用再手动重打一长串 ID 了。模型别名的国际化文案各语言的别名标签与提示语维护在 packages/i18n/src/locales/zh-CN/index.ts功能细节更多可参考 13-model-catalog-and-selection.md 规格文档。【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考