@deepseek-ai/dsh-experimental-client-ui-cot-translation 0.0.0-stage → 0.2.1-alpha.2

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-cot-translation/README.md
+/:
+  en: c2a264438157aa27
+  zh: b52d9d387759a1b6
+/deepseek-ai-dsh-experimental-client-ui-cot-translation:
+  en: f0c620cc1849b0a4
+  zh: dce4b301af1d6ef6
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/summary:
+  en: 8d78ff49b12e8101
+  zh: f04c7111dceef20f
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: ce40cab8e7534137
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/use-this-package:
+  en: 94c2a52dd06ffb3d
+  zh: 363bf773e5307b93
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/understand-the-implementation:
+  en: e38f4caa4efcdeee
+  zh: bfd3fe1a78fd2c7f
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/further-exploration:
+  en: f4a5c92999a62f37
+  zh: e1e69493f11f1368
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/model-experience:
+  en: 3abb215d69a83fa6
+  zh: 5000ed802a0db760
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/model-experience/kv-cache-effect:
+  en: ef2f52503c155a69
+  zh: 3d5d50ba6b31414a
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/known-limitations-and-deferred-work:
+  en: 280e59a910068659
+  zh: 8230bebfd7b18cf6
+/deepseek-ai-dsh-experimental-client-ui-cot-translation/known-limitations-and-deferred-work/dev-note:
+  en: 0225ba087c5266f3
+  zh: 0400e21a2683a23c

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+---
+description: "Machine-translate expanded reasoning while retaining the original text and saved results."
+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-experimental-client-ui-cot-translation
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Read expanded model reasoning in another language and switch back to its original text. Choose a translation service and target language from the Plugins panel. Translation sends displayed reasoning to the selected external service, which may include private code or conversation details. Original reasoning remains in the Session and model context.
+
+## 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 [reasoning translation bundle](../cot-translation-bundle/README.md) in Plugins, then open a reasoning disclosure. The feature is absent until the bundle is enabled. Its bundle details provide staged Translation service and Target language controls; Save applies both preferences. Bing is the default provider, and `auto` targets the active UI language. An explicit language code such as `zh`, `en`, or `ja` overrides that choice.
+
+View original and View translation share one always-visible action in the plugin's toolbar above the translated body. The plugin owns this action and its state; the Think title only controls the disclosure. Both views reuse the same compact Markdown renderer and typography, without changing the reasoning preview or making another request. Completed paragraphs and request-sized prefixes of long streaming paragraphs translate asynchronously; the unfinished tail stays original. A failure retains the original body and provides Retry; View translation remains disabled until the retry starts. Closing the disclosure or disabling the bundle cancels its requests.
+
+For custom compositions, mount this plugin alongside the [translator service](../translator/README.md) and the ordinary Web GUI. The plugin's configuration fields are `provider` and `targetLanguage`; the generated [configuration catalog](../../../docs/config-catalog.md) owns their complete schema.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Maintainer details — click to expand</summary>
+
+The browser registers a wrapper in Chat's `conversation.chat.reasoning.body` single Slot and renders original or translated text through the official `conversation.chat.reasoning.content` Factory. The wrapper owns its toolbar and view state, and passes its localized Markdown labels to the Factory; the Factory owns typography. The Host exposes cancellation-aware translation Remote methods. The Host supplies accepted provider and language preferences before the browser enables translation. Settings updates and reconnects refresh these preferences and the translator's request limit. A changed limit cancels and splits the expanded text again. One disclosure lifecycle controller serializes completed fragments, caches their translations while mounted, preserves whitespace and Unicode pairs when splitting long paragraphs, and excludes results after cancellation.
+
+The browser binds each request to the disclosure's Session. The Host requires the accepted provider and any explicitly configured target language; `auto` uses the browser locale. The authenticated Client supplies source text and Session identity, and the Host does not verify that the source text belongs to that Session. The translator durably stores provider-independent request/result records and reuses completed results after collapse, reload or reopening the Session. The browser cache only optimizes the current display.
+
+A saved result needs no activation. On an uncached inactive Session, the Host joins the ordinary Session controller activation and retries translation once through its existing writer. This uses normal preset startup hooks, resume markers, and interrupted-turn repair. Cancellation ends this caller's wait and prevents later translation dispatch; shared activation can still finish for other readers.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+- [Translator service](../translator/README.md) — providers and network limits.
+- [Chat rendering](../../client/ui-chat/README.md) — reasoning disclosure and display extensions.
+- [Web Client Slots](../../../docs/subsystems/slots.md) — contribution lifetimes.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through optional independent paid Flash requests and normal Session activation on cache misses; the translator owns translation prompts, and the Session's preset owns startup context.
+
+#### KV Cache effect
+
+Translation records do not replace model input. Normal activation may append context or repair an interrupted turn, with the same cache effects as opening the conversation. The [translator](../translator/README.md#model-experience) owns the independent paid query's token and cache effects.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- Google and Bing anonymous endpoints may reject requests or become unavailable; requests never fall back to another provider.
+- Translation may change Markdown formatting or code examples. Original text remains available.
+- An inactive subagent Session without a saved translation retains the original text and reports a translation failure; ordinary Session activation cannot restore subagent ownership.
+- Collapsed previews remain original. Saved results belong to the Session; future format migrations retain experimental records on a best-effort basis.
+- Provider reachability from mainland China requires network-specific verification.
+
+-----
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Maintainer details — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,90 @@
+---
+description: "对展开的思考内容进行机器翻译，同时保留原文和已保存结果。"
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-experimental-client-ui-cot-translation
+
+[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>
+## 使用本包
+
+在插件中启用[思考过程翻译组合包](../cot-translation-bundle/README.zh.md)，然后展开思考内容。启用组合包之前，此功能不会出现。组合包详情页提供暂存的翻译服务和目标语言设置；保存后两项选择一起生效。默认翻译服务为 Bing，`auto` 跟随当前界面语言。填写 `zh`、`en` 或 `ja` 等语言代码可指定目标语言。
+
+“查看原文”和“查看译文”复用译文正文上方插件工具栏内的一个常显入口。插件自行维护此操作及其状态，思考标题只控制展开与折叠。两种视图复用同一个紧凑 Markdown 组件和排版，不改变思考预览，也不重复发送请求。完整段落和流式长段落中达到请求长度的前缀异步翻译，未完成的末尾片段保留原文。失败时保留原始正文，并提供重试；开始重试前，“查看译文”保持禁用。关闭思考内容或停用组合包会取消对应请求。
+
+自定义组合可将本插件与[翻译服务](../translator/README.zh.md)和普通 Web GUI 一起挂载。本插件的配置字段是 `provider` 和 `targetLanguage`；完整定义见生成的[配置目录](../../../docs/config-catalog.zh.md)。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 了解实现
+
+<details>
+<summary>维护者细节 — 点击展开</summary>
+
+浏览器向 Chat 的 `conversation.chat.reasoning.body` single Slot 注册包装组件，通过官方 `conversation.chat.reasoning.content` Factory 渲染原文或译文。包装组件自行维护工具栏与视图状态，将自己的本地化 Markdown labels 传入 Factory；Factory 负责排版。Host 暴露可取消的翻译 Remote 方法。Host 在浏览器启用翻译前提供已接受的翻译服务和语言偏好。设置更新及重新连接会刷新这些偏好和 translator 的请求长度限制。限制变化时，展开内容的请求被取消并重新分片。每个展开区域的生命周期控制器串行处理完整片段，在挂载期间缓存译文，在拆分长段落时保留空白和 Unicode 代理对，并忽略取消后的结果。
+
+浏览器将每个请求绑定到展开区域的 Session。Host 要求请求使用已接受的提供方以及配置中显式指定的目标语言；`auto` 使用浏览器区域语言。已认证的 Client 提供原文与 Session 身份，Host 不校验原文是否属于该 Session。translator 持久化与 Provider 无关的请求／结果记录，在折叠、重载或重新打开 Session 后复用已完成结果。浏览器缓存只优化当前展示。
+
+已保存结果无需激活 Session。未激活 Session 缓存未命中时，Host 等待普通 Session controller 的激活流程，再通过现有写入器重试一次翻译。此过程使用正常的 preset 启动钩子、恢复标记和中断轮次修复。取消会结束当前调用者的等待，并阻止随后派发翻译；共享激活仍可为其他读者继续完成。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 延伸阅读
+
+- [翻译服务](../translator/README.zh.md) — 服务接口和网络限制。
+- [Chat 渲染](../../client/ui-chat/README.zh.md) — 思考内容展开和显示扩展。
+- [Web Client Slots](../../../docs/subsystems/slots.zh.md) — 渲染贡献的生命周期。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+间接影响来自可选的独立付费 Flash 请求，以及缓存未命中时的正常 Session 激活；translator 负责翻译提示词，Session 的 preset 负责启动上下文。
+
+#### KV Cache 效果
+
+翻译记录不替换模型输入。正常激活可能追加上下文或修复中断轮次，其缓存影响与打开对话相同。独立付费查询的 token 和缓存影响由 [translator](../translator/README.zh.md#model-experience) 负责。
+
+## 已知限制与后续工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- Google 和 Bing 匿名接口可能拒绝请求或不可用；请求不会回退到其他服务。
+- 翻译可能改变 Markdown 格式或代码示例，原文始终可查看。
+- 未激活的子代理 Session 若没有已保存译文，会保留原文并显示翻译失败；普通 Session 激活无法恢复子代理所有权。
+- 折叠的预览保留原文。已保存结果属于 Session；未来格式迁移以尽力而为的方式保留实验性记录。
+- 中国大陆的服务可达性需要在对应网络中验证。
+
+-----
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者细节 — 点击展开</summary>
+
+无。
+
+</details>