dsh-dialog-width 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-dialog-width 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.en.md

@@ -0,0 +1,66 @@
+# dsh-dialog-width
+
+> **Version requirement**: requires **DSH v0.1.2-alpha.5 or newer**.
+
+A [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) (DSH) web plugin that controls the conversation column width from the Settings panel.
+
+## Features
+
+- **Dialog width (default 748 px = DSH's stock column)** — in the Layout settings group, type a value (600–1600, step 20) or pick one of three presets (Default · 748 / Wide · 880 / Extra wide · 1024). The column width is applied to the message column, the composer card, and the stats line.
+  - **Plugin width control (default on)** — a master toggle in the same Layout group. **On**: the plugin's input/presets drive the column and **hide DSH's native drag handles**. **Off**: DSH's native handles own the column, and the plugin's width input becomes a **read-only mirror** of whatever the native handles produce. In both states the user's last px is written to the shared `localStorage` slot, so **toggling back and forth never loses the width**.
+
+- **Side margin** — blank width (px) on both sides of the conversation column. Visible when the sidebar opens and the column flex-shrinks. Minimum 32 px.
+
+```yaml
+dialog-width:
+  dialogWidth: 880        # defaults to 748; 600–1600
+  usePluginWidth: true    # defaults to true (plugin width control on); false uses DSH's native drag handles
+  sideMargin: 50          # defaults to 50; minimum 32. Side margin (px) on both sides of the column
+```
+
+Settings entry: **Settings → Dialog width**.
+
+## Install
+
+```bash
+# from npm (recommended, prebuilt)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-dialog-width
+
+# from GitHub (source; runs the self-contained prepare build)
+npx -y @deepseek-ai/dsh plugin --profile web add github:zhj9709/dsh-dialog-width
+```
+
+The package spec after `add` is forwarded to pnpm verbatim, so versions can be
+pinned — `@version` for the npm package, `#tag` for the GitHub source:
+
+```bash
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-dialog-width@0.0.1                    # pin the npm version
+npx -y @deepseek-ai/dsh plugin --profile web add github:zhj9709/dsh-dialog-width#v0.0.1     # pin a git tag
+```
+
+Restart DSH web once after installing (bundle plugins are scanned at process start).
+
+## Development
+
+```bash
+pnpm install
+pnpm build          # tsc (server) + tsc (client) + bundle lib/client.js
+pnpm typecheck
+```
+
+Load against a running DSH with an overlay, or install as a bundle:
+
+```bash
+npx -y @deepseek-ai/dsh web --patch ./cordis.patch.yml   # dev overlay
+npx -y @deepseek-ai/dsh plugin --profile web add .        # bundle install from this checkout
+```
+
+## How it works
+
+- **Server** (`src/index.ts`) registers the `dialog-width` settings namespace and mounts a same-origin route (`/_dsh/dialog-width/settings`).
+- **Browser** (`src/client/index.tsx`) reads/writes that route, renders the Settings section, and applies the column width live via a runtime `<style>` element.
+- **Width control styles** (`src/client/conversation-width.ts`) hides DSH's native drag handles, sets the CSS variable `--dsh-dialog-width-chat-width`, and persists to `localStorage['dsh.conversation.contentWidth']` when plugin width control is on.
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,65 @@
+# dsh-dialog-width
+
+> **版本要求**：需要 **DSH v0.1.2-alpha.5 及以上**。
+
+[DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)（DSH）Web UI 插件：从设置面板控制对话列宽。
+
+## 功能
+
+- **对话框宽度（默认 748 px，即 DSH 原生列宽）**：在设置的「布局」区用数值输入（600–1600，步进 20）或三个预设（默认 · 748 / 稍宽 · 880 / 更宽 · 1024）调整对话列宽。列宽会同步到输入框卡片与统计条。
+  - **插件宽度控制（默认开启）**：同一个「布局」区里有一个总开关。**开启时**，插件的数值/预设直接驱动列宽，并**隐藏 DSH 原生的拖拽手柄**；**关闭时**，DSH 原生手柄接管列宽，插件的数值输入改为**只读镜像**——实时显示原生手柄拖出来的值。无论开关状态，用户最后选择的 px 值都会写入共享的 `localStorage` 槽，所以**来回切换不会丢失宽度**。
+
+- **两侧边距**：对话列两侧的空白宽度（px），侧边栏打开、列宽自适应缩小时可见。最低 32 px。
+
+```yaml
+dialog-width:
+  dialogWidth: 880        # 默认 748；取值 600–1600
+  usePluginWidth: true    # 默认 true（插件宽度控制开启）；false 则使用 DSH 原生拖拽手柄
+  sideMargin: 50          # 默认 50；最低 32。对话列两侧边距（px）
+```
+
+设置入口：**设置 → 对话框宽度**。
+
+## 安装
+
+```bash
+# 方式一：从 npm 安装（推荐，预构建产物）
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-dialog-width
+
+# 方式二：从 GitHub 仓库安装（源码，会运行自包含的 prepare 构建）
+npx -y @deepseek-ai/dsh plugin --profile web add github:zhj9709/dsh-dialog-width
+```
+
+`add` 后面的包说明会**原样转发给 pnpm**，因此可以指定版本——npm 包用 `@版本号`，GitHub 源码用 `#tag`：
+
+```bash
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-dialog-width@0.0.1                    # 锁定 npm 版本
+npx -y @deepseek-ai/dsh plugin --profile web add github:zhj9709/dsh-dialog-width#v0.0.1     # 锁定 git tag
+```
+
+安装完成后**重启一次 `dsh web`**（bundle 插件在进程启动时扫描）。
+
+## 开发
+
+```bash
+pnpm install
+pnpm build          # tsc（服务端）+ tsc（客户端）+ 打包 lib/client.js
+pnpm typecheck
+```
+
+本地加载（覆盖层）或作为 bundle 安装：
+
+```bash
+npx -y @deepseek-ai/dsh web --patch ./cordis.patch.yml   # 开发覆盖层
+npx -y @deepseek-ai/dsh plugin --profile web add .        # 从本目录作为 bundle 安装
+```
+
+## 工作原理
+
+- **服务端**（`src/index.ts`）：注册 `dialog-width` 设置命名空间，并挂载同源路由 `/_dsh/dialog-width/settings`。
+- **浏览器端**（`src/client/index.tsx`）：读写该路由、渲染设置页，并通过运行时 `<style>` 元素实时应用列宽样式。
+- **宽度控制样式**（`src/client/conversation-width.ts`）：插件宽度控制开启时隐藏 DSH 原生拖拽手柄、设置 CSS 变量 `--dsh-dialog-width-chat-width`，并持久化到 `localStorage['dsh.conversation.contentWidth']`。
+
+## 协议
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-dialog-width bundle patch
+#
+# Declared by `dsh.bundle.patch` in package.json: when the plugin is installed
+# through the official CLI —
+#
+#   dsh plugin --profile <name> add dsh-dialog-width
+#
+# — the command appends `dsh-dialog-width` to the profile's bundle stack and this
+# patch mounts the server-side plugin row.
+- insert:
+    - id: dialog-width
+      name: 'dsh-dialog-width'