description	kind
The Web feedback surface: the Like/Dislike pair in the finalized assistant message's action row, the feedback dialog behind Dislike and `/feedback`, and the acknowledgement toast; for users and maintainers of the feedback experience.	package-reference

@deepseek-ai/dsh-client-ui-message-feedback

English | 中文

Summary

This package is the Web GUI's feedback surface: the Like/Dislike pair in the finalized assistant message's action strip, the feedback dialog with its acknowledgement toast in the composer overlay, and a decoration that opens the dialog from a bare /feedback. Like records at once and shows the toast; Dislike opens the dialog, which collects a category and an optional description. One surface per Session backs every entry, so a single list read seeds the whole transcript and one dialog serves the Session and its messages. Ratings, categories, and notes are log-only Session events that never enter model context.

Use this package
Understand the implementation
Further Exploration
Model Experience
Known Limitations and Deferred Work
Dev Note

Use this package

Mount this plugin alongside ui-conversation and ui-commands; the Like/Dislike pair then appears in the action row of each turn's closing assistant message, between copy and branch, and the Feedback row of the composer menu opens the dialog. A recorded rating shows the filled glyph and stays visible without hover. Like records immediately and the toast thanks the user for the feedback. Dislike opens the dialog: seven category chips and a detail box, both optional; Submit records a negative judgment carrying whatever was filled in, and the conversation log travels with every feedback event. Clicking the recorded rating retracts it. A bare /feedback, picked from the menu or typed and sent without text, opens the same dialog for the Session; /feedback <text> keeps the Host command path and its acknowledgement row.

Failures

A rating or list-load failure shows inline in the row; a submission failure shows inside the dialog, which stays open so the draft can be corrected. Only finalized messages reach the message entry — an interruption-frozen partial carries no messageId and therefore no feedback controls.

Understand the implementation

Implementation internals — click to expand

The package contributes the feedback entry (order 10) of conversation.chat.assistant-actions, declared by ui-conversation and rendered inside the finalized assistant message's IconActions row, and the feedback-dialog entry (order 2) of conversation.input.overlay, which renders the Modal and Toast primitives through body portals and centers the toast over the composer card it mounts inside. The /feedback decoration is an action registered through ctx.commandUi.decorate, so a menu pick or a bare Enter consumes the trigger token and opens the dialog while an argued line still reaches the Host command.

Per Session, one MessageFeedbackController backs every message control and one FeedbackDialogController owns the dialog draft, the submission, and the toast sequence. The message controller reads messageFeedback.list once, deferred to the first hover or focus rather than fired on mount, and serializes mutations so each carries the version last observed; a version-conflict reply carries the authoritative item and reconciles the view without refetching. toggle reports the rating now committed, so the row acknowledges a recorded Like and not a retraction. The dialog controller submits by target: a message target puts a negative judgment with the dialog's note and category through the message controller, and the Session target records through ctx.remote.sessionFeedback. Success closes the draft and raises the toast; a late success from a superseded draft raises the toast without closing the new draft; a failure keeps the draft open with its code.

Further Exploration

Read these pages when the feedback surface is not enough. They move from the browser strip to the Session-log backends and the conversation shell.

dsh-message-feedback — the Session-log backend that owns per-item compare-and-set and persistence.
dsh-command-feedback — the /feedback command, the sessionFeedback Remote, and the category taxonomy.
ui-commands — the command decoration contract the /feedback row goes through.
ui-conversation — declares the assistant-actions strip and the composer overlay.
Client package map — adjacent browser UI packages.

Model Experience

None, as ratings, categories, and notes are log-only events, not model input. Optional Session-log delivery uses request metadata rather than model context.

KV Cache effect

None; feedback mutations leave the model-visible history unchanged.

Known Limitations and Deferred Work

These limits define the current feedback surface. They are current package constraints, not a general rating comparison or a task backlog.

Note size is a Host policy — the deployment configures maxNoteBytes (8192 in the Web bundle) and the Host rejects an oversized note with note-too-large. The dialog does not pre-check the limit, so an oversized description for a message fails on submit rather than while typing; a Session remark has no bound.
No note on a Like — only the Dislike dialog collects a category and description; a Like records the bare judgment.
No cross-tab push — a second tab's rating becomes visible on reconnect or on the next conflict reply, not immediately; the controller does not consume feedback log events.
Chat view only — the trajectory and waterfall views render no feedback controls even though their assistant nodes carry the same messageId.

Dev Note

Working context for maintainers — click to expand

None.

Runtime invariant: No companion is published. The plugin owns two slot registrations, one command decoration, and one per-session controller-pair map, all released by the plugin fiber's effect disposers. The lifecycle spec proves the registrations are withdrawn and every controller pair is dropped when the owning fiber is disposed, so no second authority exists to check at runtime.

README.md