dsh-thinkbar 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+Copyright (c) 2026 dsh-thinkbar contributors
+
+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.md

@@ -0,0 +1,112 @@
+# dsh-thinkbar
+
+English | [中文](README.zh.md)
+
+`dsh-thinkbar` is a Web UI plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). It fills the existing model selector while the visible assistant Step is streaming reasoning.
+
+The indicator starts at 8%, fills toward 100% over 20 seconds with an ease-out curve, and moves through Harness info blue, red, orange, and yellow. It drains in 240 ms when text, a Tool call, the final message, or the Step boundary ends reasoning. Session changes clear the previous indicator, and reduced-motion mode skips the drain and particle movement.
+
+## Requirements
+
+- DeepSeek Harness `0.1.1-rc.2`
+- The standard DSH `web` Profile with the official model-selection plugin
+- Node.js `^22.19.0` or `>=24.0.0`
+
+This release supports exactly `0.1.1-rc.2`. Harness is a developer preview, and later source revisions are not assumed to be binary-compatible.
+
+## Install
+
+After the package is published:
+
+```sh
+dsh plugin --profile web add dsh-thinkbar
+```
+
+To test a local release tarball instead:
+
+```sh
+dsh plugin --profile web add ./dsh-thinkbar-0.1.0.tgz
+```
+
+Restart the Web Profile after installation. Bundle changes are applied when the Profile starts. Verify the Bundle layer and Loader row with:
+
+```sh
+dsh --profile web --dump-config
+```
+
+The output must contain exactly one `dsh-thinkbar` row.
+
+## Upgrade and uninstall
+
+Install the desired version explicitly, then restart:
+
+```sh
+dsh plugin --profile web add dsh-thinkbar@0.1.0
+```
+
+Remove the plugin and restart the Profile:
+
+```sh
+dsh plugin --profile web remove dsh-thinkbar
+```
+
+## How it works
+
+The plugin derives `{ waitOrigin, streamTime, active, tailKind }` from the public Conversation event and view registries. A `step/start` records the clock without displaying anything; the first reasoning block activates the fill. Direct text and Tool-only responses never flash the indicator.
+
+The original Harness does not provide an additive child Slot inside the model selector. The plugin therefore registers a lifecycle anchor in the public `conversation.input.right` Slot, identifies the single following semantic `button[aria-haspopup="menu"]` inside `[data-composer-card]`, and portals one plugin-owned layer into it. It does not depend on generated class names, model labels, localization, React internals, or the button's child structure.
+
+If the model trigger cannot be identified uniquely, the plugin leaves the DOM unchanged and emits one browser-console compatibility warning:
+
+```text
+[dsh-thinkbar] Could not uniquely identify the DeepSeek Harness model selector; the indicator is disabled.
+```
+
+There are no settings. The plugin has no Host behavior and does not change prompts, messages, schemas, tools, provider requests, or KV-cache behavior. It sends no telemetry and uploads no data.
+
+## Troubleshooting
+
+- **Nothing changes after installation:** restart the Web Profile and confirm `dsh-thinkbar` appears in `dsh --profile web --dump-config`.
+- **The client bundle fails to load:** verify DSH is exactly `0.1.1-rc.2`, reinstall, restart, and inspect the browser console and Host stderr.
+- **A compatibility warning appears:** confirm the official model-selection plugin is enabled and no other plugin has added another menu trigger after `conversation.input.right`.
+- **No fill appears for a response:** the indicator activates only after the first reasoning event. Direct text or Tool-only output intentionally remains idle.
+- **Removal appears ineffective:** restart the Profile after `dsh plugin --profile web remove dsh-thinkbar`.
+
+## Development
+
+```sh
+pnpm install --frozen-lockfile
+pnpm verify
+pnpm pack
+```
+
+`pnpm verify` runs TypeScript checking, unit/component tests, the standalone DSH client build, tarball-contract checks, and `publint`.
+
+### Publishing
+
+Log in to npm once with `npm login`. Every release after that is a single command:
+
+```sh
+npm run publish
+```
+
+The release script verifies the npm identity, keeps the current version when it is still unpublished or increments the patch version when it already exists, runs the complete verification suite, packs one release tarball, writes its SHA-256 checksum, publishes that exact tarball, and verifies its registry integrity. Release files are written to `.smoke/release/`. It deliberately does not commit, tag, or push Git changes.
+
+Exercise the complete flow without publishing:
+
+```sh
+npm run publish -- --dry-run
+```
+
+The browser artifact is a DSH lazy-CJS factory, not an ordinary application module. Preserve its exact `window.__ModuleLoader__.load(...)` envelope.
+
+Contributor references:
+
+- [Upstream-compatible reasoning indicator research](docs/research/upstream-reasoning-indicator.md)
+- [DSH plugin publishing research](docs/research/dsh-plugin-publishing.md)
+
+Contributions should include focused tests, pass `pnpm verify`, and verify the packed tarball against a clean DSH `0.1.1-rc.2` Web Profile when changing event, Slot, DOM-adapter, or bundle behavior.
+
+## License and attribution
+
+MIT. The original reasoning indicator was extracted from DeepSeek Harness commit `6d7ae5aa57b4dedfc03b09de7cafb65c01338800`. DeepSeek Harness is Copyright (c) 2026 DeepSeek and distributed under the MIT License. Independent packaging and subsequent modifications are maintained by the `dsh-thinkbar` contributors.

package/README.zh.md

@@ -0,0 +1,112 @@
+# dsh-thinkbar
+
+[English](README.md) | 中文
+
+`dsh-thinkbar` 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web UI 插件。当前可见助手 Step 正在流式输出 reasoning 时，它会填充现有模型选择器作为思考指示器。
+
+指示器从 8% 起步，在 20 秒内按 ease-out 曲线填满，并沿 Harness info blue、红、橙、黄变化。reasoning 转为正文或 Tool call、助手消息完成或 Step 结束后，填充在 240ms 内抽空。切换会话会清除旧指示器；reduced-motion 模式会跳过抽空和粒子运动。
+
+## 运行要求
+
+- DeepSeek Harness `0.1.1-rc.2`
+- 启用官方模型选择插件的标准 DSH `web` Profile
+- Node.js `^22.19.0` 或 `>=24.0.0`
+
+首版只兼容 `0.1.1-rc.2`。Harness 仍处于 developer preview，不假定后续源码版本保持二进制兼容。
+
+## 安装
+
+发布后从 npm 安装：
+
+```sh
+dsh plugin --profile web add dsh-thinkbar
+```
+
+也可以安装本地 release tarball：
+
+```sh
+dsh plugin --profile web add ./dsh-thinkbar-0.1.0.tgz
+```
+
+安装后重启 Web Profile；Bundle 变更会在 Profile 启动时生效。验证 Bundle layer 和 Loader row：
+
+```sh
+dsh --profile web --dump-config
+```
+
+输出中必须恰好包含一个 `dsh-thinkbar` row。
+
+## 升级和卸载
+
+显式安装目标版本，然后重启：
+
+```sh
+dsh plugin --profile web add dsh-thinkbar@0.1.0
+```
+
+删除插件后重启 Profile：
+
+```sh
+dsh plugin --profile web remove dsh-thinkbar
+```
+
+## 工作原理
+
+插件通过公开的 Conversation event/view registry 推导 `{ waitOrigin, streamTime, active, tailKind }`。`step/start` 只记录时钟，不立即显示；首个 reasoning block 才激活填充。直接输出正文或仅输出 Tool 的响应不会闪现指示器。
+
+原版 Harness 没有模型选择器内部的 additive child Slot。因此插件在公开的 `conversation.input.right` Slot 注册生命周期锚点，在 `[data-composer-card]` 内识别锚点之后唯一的语义按钮 `button[aria-haspopup="menu"]`，并用 Portal 插入一个插件自有填充层。它不依赖生成的 class、模型文案、本地化、React 私有字段或按钮内部子结构。
+
+如果无法唯一识别模型按钮，插件不会修改 DOM，只在浏览器 console 输出一次兼容性告警：
+
+```text
+[dsh-thinkbar] Could not uniquely identify the DeepSeek Harness model selector; the indicator is disabled.
+```
+
+插件没有设置项和 Host 行为，不会改变 prompt、消息、schema、工具、模型请求或 KV Cache，不包含遥测，也不会上传数据。
+
+## 故障排查
+
+- **安装后没有变化：**重启 Web Profile，并确认 `dsh --profile web --dump-config` 中存在 `dsh-thinkbar`。
+- **client bundle 加载失败：**确认 DSH 精确为 `0.1.1-rc.2`，重新安装并重启，然后检查浏览器 console 和 Host stderr。
+- **出现兼容性告警：**确认已启用官方模型选择插件，并且没有其他插件在 `conversation.input.right` 后增加菜单按钮。
+- **响应期间没有填充：**指示器只在首个 reasoning 事件出现后激活；直接正文或仅 Tool 输出保持 idle。
+- **卸载后仍显示：**执行 `dsh plugin --profile web remove dsh-thinkbar` 后必须重启 Profile。
+
+## 本地开发
+
+```sh
+pnpm install --frozen-lockfile
+pnpm verify
+pnpm pack
+```
+
+`pnpm verify` 会执行 TypeScript 检查、单元与组件测试、独立 DSH client 构建、tarball 契约检查和 `publint`。
+
+### 发布
+
+首次使用前执行一次 `npm login`。之后每次发布只需：
+
+```sh
+npm run publish
+```
+
+发布脚本会检查 npm 身份；当前版本未发布时直接使用，已存在时自动递增 patch 版本；然后执行完整验证、生成唯一 release tarball 及 SHA-256 checksum、发布该 tarball，并回读 registry 校验完整性。产物位于 `.smoke/release/`。脚本不会自动提交、打 Git tag 或 push。
+
+不实际发布的完整演练：
+
+```sh
+npm run publish -- --dry-run
+```
+
+浏览器产物是 DSH lazy-CJS factory，不是普通应用模块；必须保留精确的 `window.__ModuleLoader__.load(...)` envelope。
+
+Contributor 参考资料：
+
+- [原版兼容思考指示器调研](docs/research/upstream-reasoning-indicator.md)
+- [DSH plugin 发布机制调研](docs/research/dsh-plugin-publishing.md)
+
+贡献代码应包含聚焦测试并通过 `pnpm verify`；修改事件、Slot、DOM Adapter 或 bundle 行为时，还需把最终 tarball 安装到干净的 DSH `0.1.1-rc.2` Web Profile 验证。
+
+## 许可与归属
+
+MIT。原始思考指示器从 DeepSeek Harness commit `6d7ae5aa57b4dedfc03b09de7cafb65c01338800` 抽离。DeepSeek Harness 为 Copyright (c) 2026 DeepSeek，并按 MIT License 分发；独立打包和后续修改由 `dsh-thinkbar` contributors 维护。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-thinkbar
+      name: dsh-thinkbar