SuperAPI AI 工具集

solidcraft-preferences

编程与开发

查看项目

更新于 11-03 16:16

技能介绍

SolidCraft 偏好设置规范用于约束默认行为的变更与偏好项的添加,确保现有用户习惯不被破坏。

用途:当变更会改变 SolidCraft 的默认行为、现有快捷键、用户已习惯的外观,或在 Preferences 中新增设置时,应遵循本规范。人们依赖 SolidCraft 当前的行为方式,任何让用户开箱即见或所做不同的变更,都属于默认行为的变更。

主要能力:核心规则是保留旧行为可达。新增一个偏好项,其旧值对应旧行为,并测试其仍然生效。PR 模板需填写「Changes a default」行,pr-checks.yml 会在缺少该行时使 PR 失败(#6442;CONTRIBUTING.md「Sending a change」)。格式为:Changes a default: no 或 Changes a default: yes - <变更内容>,旧行为保留在偏好 <名称> 之后。

使用方式:添加偏好时,设置位于 crates/ui-egui/src/prefs.rs 的 preference_settings! 表中,包含字段、默认值、其重置可恢复该设置的页面、控制通道的可选接受范围以及表单控件,在此添加一行即可。默认不改变任何内容的新设置无需在该行填 yes;默认改变用户所见内容的设置则需要。通过目录(skills/solidcraft-ui-text/SKILL.md)提供标签与帮助文本。页面上的重置会恢复默认值;未出现在任何页面中的字段在恢复默认值时保留其值。控制通道 ui.prefs {...} 可按名称读取和设置偏好(docs/control-protocol.md)。需在 UI 场景或设置旁的 *_tests.rs 文件中测试(skills/solidcraft-tests/SKILL.md)。

适用场景:判断什么算默认行为——用户在更新后首次启动时看到或所做不同的任何内容,包括变更的快捷键、相机或导航行为、单位、命名、主题或自动保存行为,或未经请求出现的工具。若修复只是让应用做到其已声称的功能,则不算默认行为变更,应在该行说明。

限制:资料未提供该规范的版本兼容性、性能影响或与其他模块的冲突处理细节,暂未提供。