@deepseek-ai/dsh-client-ui-plugin-recommendations 0.0.0-stage → 0.2.2-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,37 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/experimental/client-ui-plugin-recommendations/README.md
+/:
+  en: 56ef0772b237c7f1
+  zh: 02f3a41d3b778505
+/deepseek-ai-dsh-client-ui-plugin-recommendations:
+  en: 54f686f0de0dc75d
+  zh: 33341df7cfb4fa5c
+/deepseek-ai-dsh-client-ui-plugin-recommendations/summary:
+  en: a4484eb034e7311a
+  zh: 34e47149ecf23d67
+/deepseek-ai-dsh-client-ui-plugin-recommendations/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: b00dddf4c88f0a45
+/deepseek-ai-dsh-client-ui-plugin-recommendations/use-this-package:
+  en: 10c47fd420b1f232
+  zh: 7094c3b465978372
+/deepseek-ai-dsh-client-ui-plugin-recommendations/understand-the-implementation:
+  en: 1b20e5e631381ab1
+  zh: a3f0bbc3dc14001d
+/deepseek-ai-dsh-client-ui-plugin-recommendations/further-exploration:
+  en: 4fd18141ccbba60b
+  zh: 137a74a945ac3f23
+/deepseek-ai-dsh-client-ui-plugin-recommendations/model-experience:
+  en: d73a452f8bf206b7
+  zh: 67db0a1b3a5767cf
+/deepseek-ai-dsh-client-ui-plugin-recommendations/model-experience/kv-cache-effect:
+  en: 4faf0dd1beff482e
+  zh: a2794bbdb956d557
+/deepseek-ai-dsh-client-ui-plugin-recommendations/known-limitations-and-deferred-work:
+  en: e3f3f2ef1459fb1b
+  zh: 427dbabb303f6284
+/deepseek-ai-dsh-client-ui-plugin-recommendations/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 8ec3e73528ddb1a6

package/README.md

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+---
+description: "Show official plugin recommendation cards after completed answers."
+kind: "package-reference"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @deepseek-ai/dsh-client-ui-plugin-recommendations
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Users see one plugin recommendation below the completed answer, with the plugin's current title and description in the interface language. The title and description form one target that highlights on hover; clicking it opens that plugin's details in Plugins without enabling it or changing the current Session. Enable and Not now remain separate choices. Decisions and the details link remain available after reconnecting.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+Enable the [Personalized recommendations bundle](../personalized-recommendations/README.md). This browser contribution has no configuration fields; it fills the shared [action card frame](../client-ui-action-cards/README.md) for `enable_official_plugin` cards.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals — click to expand</summary>
+
+The plugin mounts its catalog-text Remote, then registers its body with the shared card frame, which places the card after its Turn and supplies the card, its recorded decision and card-bound actions. The body asks the Host for the plugin's current catalog text and selection and renders the header with the Official badge, the details target, status, and Enable and Not now through the frame's action. The details target is named View details with the plugin title, and the catalog description remains its accessible description. A refused lookup shows its reason and a lost reply says the details could not be loaded; both offer Not now and Try again, which repeats the lookup, but no Enable. A recorded outcome stays as recorded even after its plugin leaves the catalog. While an action runs, only its own button reads Working, and both stay disabled. The plugin keeps returned catalog text by plugin name for its lifetime, so a revisited card renders it at once while its own lookup refreshes the selection. Until a plugin's first lookup returns, the card shows the proposed title, a placeholder description line and the disabled actions, so its layout holds. The Remote, the body registration and its dictionaries share one plugin lifetime.
+
+Cards use the application font, a distinct title and compact body scale, and a separate action footer. The built entry supplies generated Remote descriptors to the source-tested mount lifecycle.
+
+- [Source](src/client/index.ts)
+- [Tests](tests/)
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+- [Recommendation service](../plugin-recommendations/README.md) — eligibility, enabling and decisions.
+- [Action card display](../client-ui-action-cards/README.md) — the frame, kind bodies and the process row.
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through card actions: the shared Host card service adds a logged status notice to the next model request. The browser contribution adds no model tools or prompt content.
+
+#### KV Cache effect
+
+The card adds no model context. Its Enable action can change subsequent tool declarations through the Host.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- Only the first proposal in a Turn appears.
+- Before a plugin's first lookup returns, the card reserves one description line; a longer description still extends the card when it arrives.
+- Historical decisions do not track later changes made from the Plugins page.
+- After a refused or lost lookup, Enable returns only when Try again gets the plugin's catalog text.
+- A card whose plugin has left the catalog shows the proposed title instead of catalog text.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,81 @@
+---
+description: "在完整回答之后显示官方插件推荐卡片。"
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-client-ui-plugin-recommendations
+
+[English](README.md) | 中文
+
+## 概述
+
+用户在完整回答下方看到一张插件推荐卡片，显示插件当前的界面语言标题和描述。标题和描述是同一个点击区域，悬停时整体高亮；点击可打开插件页中的对应详情，不会启用插件或改变当前 Session。启用和暂不需要仍是独立操作。重新连接后仍能看到之前的选择并打开详情。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [实现原理](#understand-the-implementation)
+- [延伸阅读](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与后续工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+启用[个性化推荐 Bundle](../personalized-recommendations/README.zh.md)。这个浏览器端贡献没有配置项；它为 `enable_official_plugin` 卡片填充共享的[操作卡片框架](../client-ui-action-cards/README.zh.md)。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 实现原理
+
+<details>
+<summary>实现细节 — 点击展开</summary>
+
+插件先挂载读取目录文本的 Remote，再向共享的卡片框架注册正文；框架把卡片放在所在回合之后，并提供卡片、已记录的决定和绑定到卡片的操作。正文向 Host 读取插件当前的目录文本和启用状态，渲染带「官方」标记的标题栏、详情点击区域、状态，以及通过框架操作发出的启用和暂不需要。详情点击区域的无障碍名称是「查看详情」加插件标题，目录描述仍作为它的无障碍描述。查询被拒绝时显示原因，回复丢失时说明无法读取插件信息；两种情况都提供「暂不需要」和重新查询的「重试」，不提供启用。已记录的结果保持不变，插件之后离开目录也一样。操作进行中只有被点击的按钮显示「正在处理…」，两个按钮都禁用。插件在自身生命周期内按插件名记住读到的目录文本，再次进入会话时卡片立即显示，同时卡片自己的查询会刷新启用状态。某个插件的第一次查询返回前，卡片显示提议的标题、一行描述占位和禁用的按钮，布局不跳动。Remote、正文注册和词典共用同一个插件生命周期。
+
+卡片沿用应用字体，通过标题、正文和独立操作区区分信息层级。构建入口将生成的 Remote 描述传给可直接从源码测试的挂载流程。
+
+- [Source](src/client/index.ts)
+- [Tests](tests/)
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 延伸阅读
+- [推荐服务](../plugin-recommendations/README.zh.md) — 推荐范围、启用和决定。
+- [操作卡片显示](../client-ui-action-cards/README.zh.md) — 框架、种类正文和过程行。
+
+<a id="model-experience"></a>
+## 模型体验
+
+间接影响来自卡片操作：共享的 Host 卡片服务在下一次模型请求中追加一条已记录的状态通知。本界面不增加模型工具或提示词。
+
+#### KV Cache effect
+
+卡片不增加模型上下文。启用操作可能通过 Host 改变之后的工具声明。
+
+## 已知限制与后续工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- 每个回合只显示第一条推荐。
+- 插件第一次查询返回前，卡片只预留一行描述；更长的描述返回后卡片仍会变高。
+- 历史选择不会跟踪之后在插件页面进行的修改。
+- 查询被拒绝或回复丢失后，要等「重试」读到插件的目录文本，才会重新提供启用。
+- 插件离开目录后，卡片显示提议时的标题，而不是目录文本。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文 — 点击展开</summary>
+
+无。
+
+</details>