Skip to main content

How to use ui-status-label

Customize the "thinking" status text for agent runtime in the dsh Web chat view, effective immediately without restart.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

ui-status-label

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add --allow-build=dsh-ui-status-label github:alingalingling/ui-status-label

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 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 侧变更，以及空值回退默认。

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Do I need to restart dsh Web after installation?

Yes. The currently running GUI won't hot-load the new plugin bundle. You need to restart the dsh web process and refresh the page to see the entry in settings.

What is the default text?

The default text is '小难梁在0721'. Clearing the input box in settings will also revert to this default value; blank content won't actually display as empty.

Is there a length limit for the input box?

Yes. The input box has a maxLength limit of 40 characters to prevent the chat view layout from being stretched.

Do I still need to click the save button after making changes?

No. Changes take effect immediately—the input is instantly synchronized to the running status line in the chat view, no need to click save.

Will this plugin change the model's response content?

No. The plugin only replaces the status text rendered by the browser; it doesn't touch any model requests or inference processes.

What to do when blocked by pnpm during git installation?

The repository has the pre-built lib/ committed along with the source code, so git installation can skip the prepare script and still work directly; you only need to add the package to pnpm-workspace.yaml's allowBuilds when rebuilding from source.

Can a customized dsh build that already has this plugin built-in install it again?

No. It will register the ui-status-label settings namespace again; the officially unbundled release version can be installed normally.

How to uninstall?

Run dsh plugin --profile web remove dsh-ui-status-label and restart the process.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: >=0.0.1-rc.1 <0.2.0（peer 依赖声明；官方正式版含 0.1.0-rc.6 可直接生效）
  • Node: 未声明

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule

How to use ui-status-label