ui-status-label 使用指南
在 dsh Web 聊天视图中自定义智能体运行时的"思考中"状态文案,无需重启即时生效。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
ui-status-label
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add --allow-build=dsh-ui-status-label github:alingalingling/ui-status-label
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- dsh Web(
dsh --profile web或自定义 Web 组合)。本插件只面向浏览器交互面;headless/TUI profile 装它没有意义。 src/schema.ts— 仅 node 半边;ui-status-label设置 schema(放在浏览器 bundle 之外,运行时不依赖 schemastery)。src/status-settings.ts— 两个半边共享的常量与 section 类型。src/client/StatusLabelRow.tsx— General 设置文本行。src/client/status-label-policy.ts— 实时 snapshot store、持久化写穿、采纳 Host 侧变更,以及空值回退默认。
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装后需要重启 dsh Web 吗?
需要。当前运行中的 GUI 不会热加载新插件 bundle,装完重启 dsh web 进程、刷新页面才能在设置里看到入口。
默认文案是什么?
默认文案是「小难梁在0721」。在设置行清空输入框也会回到这个默认值,空白内容不会真正显示为空。
输入框有长度限制吗?
有。输入框 maxLength 限制 40 字符,避免聊天视图布局被撑开。
修改后还需要点保存按钮吗?
不需要。输入即生效——写入即时同步到聊天视图的运行状态行,无需点保存。
这个插件会改变模型的回复内容吗?
不会。插件只替换浏览器渲染的状态文案,不触及任何模型请求或推理过程。
用 git 安装时被 pnpm 阻止了怎么办?
仓库已把预构建的 lib/ 随源码一起提交,git 安装即使跳过 prepare 脚本也能直接用;只有在从源码重新构建时才需要把包加入 pnpm-workspace.yaml 的 allowBuilds。
已经内置了该插件的定制 dsh 构建能再装一次吗?
不能。会重复注册 ui-status-label 设置命名空间,官方未内置的发布版则可正常安装。
怎么卸载?
运行 dsh plugin --profile web remove dsh-ui-status-label,重启进程即可。
— 源: plugin_wiki.faq_json
兼容性
- DSH: >=0.0.1-rc.1 <0.2.0(peer 依赖声明;官方正式版含 0.1.0-rc.6 可直接生效)
- Node: 未声明
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则