imccyu
b64da061a8
Each owner package's README states which of its cordis events are forwarded and that the declaration now lives in the client-safe ./types export. api/remotes documents the allowlist as the single control point and the deliberate both-faces listing of src/types.ts; development.md keeps the split-tsconfig rule current.
2.7 KiB
@deepseek-ai/dsh-client-ui-settings-general
English | 中文
设置界面无特定功能归属的文案与产品引导插件：在设置界面注册所有不属于单一功能的内容，包括外壳的触发器、标题栏与关闭控件内容、本地配置文件操作，「通用」分区及其 settings.general.item slot、settings 字典，以及第一个有序欢迎步骤。归具体功能所有的行（「权限」、「语言」、「外观」）、分区（「模型」）和条件式首次使用引导步骤仍由各自的功能包提供。
回环浏览器通过 settings.describe 加载提供方的 hasDocument 能力，且只有在 Host 确认可准备好一份由提供方持有的本地文档时才渲染打开配置文件。该操作发送无路径参数且仅限回环访问的 settings.openDocument 请求；Host 会再次解析提供方路径、在文档缺失时将其创建出来，并交给原生文本编辑器（macOS 上使用 open -t，绕过浏览器文件关联；Linux 和 Windows 上使用桌面文件关联；WSL 上经 wslpath -w 转换后使用 Windows 文件关联）。打开失败时该操作仍可使用，并渲染本地化错误。临时读取失败或 Host 拓扑变化后，重新打开对话框或重新连接会刷新可用性。远程浏览器从不注册该操作，也从不发起这项特权设置读取。
src/onboarding-copy.ts 是完整通知文案和 WELCOME_NOTICE_VERSION 的唯一可编辑来源；GUI 支持的两种 locale 都有意渲染同一份中文文案。宿主端在用户设置 seam 中注册 ui-onboarding。回环浏览器会比较 welcomeNoticeVersion 是否精确相等，仅在「继续」操作成功后写入当前值。该路径变更在不同标签页间幂等，并会保留同级设置；转发的 settings/document-updated 事件则让页面在通知被外部确认后，无需重新加载即可推进。非回环浏览器不能访问受保护的设置 API：它仍会显示通知，但「继续」只推进当前浏览器进程，重新加载后会再次显示通知。版本不同时，系统也会有意重新显示通知。欢迎页保留原文的每个段落，仅强调最后一段中指定的句段，初始焦点落在标题上，并且没有关闭操作、Escape、点击遮罩或次要操作路径。其文案和确认状态均不会进入会话日志或模型请求。通知明确以 DSH_TELEMETRY_DISABLED=1 作为遥测关闭方式。
模型体验
无。该插件渲染浏览器设置 UI；这里没有任何内容进入模型请求。
KV Cache 影响
无；该包既不组装也不发送提供方请求。
已知限制与暂缓事项
- 「通用」分区没有内置行；每一行仅在其所属功能插件挂载时出现。