跳到主内容

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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则

ui-status-label 使用指南