Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,7 @@ The code is the developer documentation. Releases follow the [release guide](REL
| [@klarkxy/dsh-secret-manager](plugins/dsh-secret-manager/README.en.md) | Published (`published`) | Published on npm; subsequent versions follow the normal update workflow. |
| [@klarkxy/dsh-session-manager](plugins/dsh-session-manager/README.en.md) | Published (`published`) | Published on npm; fixes, testing and version updates keep the Published lifecycle. |
| [@klarkxy/dsh-shortcuts](plugins/dsh-shortcuts/README.en.md) | Draft (`draft`) | New shortcut manager and extensible command palette; awaiting first-release acceptance. |
| [@klarkxy/dsh-sidebar-layout](plugins/dsh-sidebar-layout/README.en.md) | Draft (`draft`) | New right-sidebar layout switcher (push, drawer, body); awaiting first-release acceptance. |
| [@klarkxy/dsh-unrestricted](plugins/dsh-unrestricted/README.en.md) | Published (`published`) | Published on npm; fixes, testing and version updates keep the Published lifecycle. |
| [@klarkxy/dsh-update](plugins/dsh-update/README.en.md) | Published (`published`) | Published on npm; subsequent versions follow the normal update workflow. |
| [@klarkxy/dsh-web-search-manager](plugins/dsh-web-search-manager/README.en.md) | Published (`published`) | Published on npm; fixes, testing and version updates keep the Published lifecycle. |
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,7 @@ pnpm check
| [@klarkxy/dsh-secret-manager](plugins/dsh-secret-manager/README.md) | 已发布 (`published`) | 已有 npm 发布记录;后续版本按正常更新流程维护。 |
| [@klarkxy/dsh-session-manager](plugins/dsh-session-manager/README.md) | 已发布 (`published`) | 已有 npm 发布记录;后续修复、测试和版本更新保持已发布。 |
| [@klarkxy/dsh-shortcuts](plugins/dsh-shortcuts/README.md) | 草稿 (`draft`) | 新增快捷键管理与可扩展命令面板,待完成首次发布验收。 |
| [@klarkxy/dsh-sidebar-layout](plugins/dsh-sidebar-layout/README.md) | 草稿 (`draft`) | 新增右侧边栏布局切换(常规、抽屉、正文),待完成首次发布验收。 |
| [@klarkxy/dsh-unrestricted](plugins/dsh-unrestricted/README.md) | 已发布 (`published`) | 已有 npm 发布记录;后续修复、测试和版本更新保持已发布。 |
| [@klarkxy/dsh-update](plugins/dsh-update/README.md) | 已发布 (`published`) | 已有 npm 发布记录;后续版本按正常更新流程维护。 |
| [@klarkxy/dsh-web-search-manager](plugins/dsh-web-search-manager/README.md) | 已发布 (`published`) | 已有 npm 发布记录;后续修复、测试和版本更新保持已发布。 |
Expand Down
1 change: 1 addition & 0 deletions plugins/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@

| 席位 | id / order |
| --- | --- |
| `settings.general.item` | `sidebar-layout`/40 |
| `settings.models.footer` | `magpie`/100 |
| `settings.section` | `font`/5 |
| 共享栏目「会话管理」 | `auxiliary-model`/55、`session-manager.composer`/60、`session-manager.auto-continue`/62、`session-manager.return`/64、`session-manager.handoff`/66、`session-manager.agent-actions`/68、`current-title`/70、`safe-auto`/80 |
Expand Down
5 changes: 5 additions & 0 deletions plugins/dsh-plugin-kit/src/official-ui.spec.ts
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,15 @@ const pluginsRoot = join(repoRoot, 'plugins')
* without the theme ever declaring them.
*/
const STRUCTURAL_TOKENS = new Set([
'--ds-transition-duration-slow',
'--dsh-dockkit-strip-inline-start',
'--dsh-frame-leading-clearance',
'--dsh-menu-anchor',
'--dsh-segment-count',
'--dsh-segment-index',
'--dsh-sidebar-width',
'--dsh-toast-hold',
'--dsh-windows-content-radius',
])

const ALLOWED = new Set([...OFFICIAL_THEME_TOKEN_NAMES, ...STRUCTURAL_TOKENS])
Expand Down
42 changes: 42 additions & 0 deletions plugins/dsh-sidebar-layout/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
The Star And Thank Author License (SATA)
Version 2.1, September 2026

Copyright © 2026 Klarkxy(278370456@qq.com)

Project Url: https://github.com/klarkxy/dsh-editor
https://github.com/klarkxy/sata-license
https://github.com/klarkxy/dsh-plugins

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.

And wait, one more thing — an invitation, not a condition: it would be best if
you star/+1/like the project(s) in the project url section above, and thank the
author(s) in the Copyright section. You may, and arguably you should — but the
permissions above hold either way, star or no star.

Here are some suggested ways:

- Email the authors a thank-you letter, and make friends with him/her/them.
- Report bugs or issues.
- Tell friends what a wonderful project this is.
- And, sure, you can just express thanks in your mind without telling the world.

Contributors of this project by forking have the option to add his/her name and
forked project url at copyright and project url sections, but shall not delete
or modify anything else in these two sections.

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.
36 changes: 36 additions & 0 deletions plugins/dsh-sidebar-layout/README.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Sidebar Layout

<!-- release-state-note -->

[简体中文](README.md) / English

Switch the DeepSeek Harness right Sidebar between three presentations:

- **Push**: the native default — the open panel squeezes the conversation column.
- **Drawer**: the panel floats over the conversation, which keeps its full width; a dim mask covers the conversation while the panel is open, and clicking the mask closes the panel.
- **Body**: the panel moves into the centre column as the main body and the conversation moves to the right (IDE style); the host's right-edge drag handle then resizes the conversation column.

## Install

```sh
dsh plugin --profile web add @klarkxy/dsh-sidebar-layout
```

Replace `web` with your profile name and restart the profile when DSH asks. The plugin is enabled after installation and can be turned off in the plugin list.

## Use

The layout is a global setting; all three entry points drive the same state:

- **Session header button**: the “Sidebar layout” icon in the session header's utility strip opens a menu with Push / Drawer / Body; the active mode is checked. Choosing Drawer or Body while the panel is collapsed expands it.
- **Settings row**: the “Sidebar layout” row under Settings → General offers the same three options in a select.
- **Shortcut**: `Ctrl/Cmd + Alt + Shift + B` cycles Push → Drawer → Body → Push (the web build on Linux ships no default binding — assign one in the Shortcuts settings).

The choice is stored in the current browser and restored on the next visit.

## Limitations

- The panel's fullscreen mode is untouched and keeps native host behaviour in all three layouts.
- The host still auto-collapses the panel when there is not enough room for a normal-width track — in drawer mode too.
- The plugin works alongside `dsh-better-sidebar`; neither affects the other.
- Disabling or uninstalling the plugin returns the sidebar to the native Push behaviour.
36 changes: 36 additions & 0 deletions plugins/dsh-sidebar-layout/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# 侧栏布局

<!-- release-state-note -->

简体中文 / [English](README.en.md)

让 DeepSeek Harness 的右侧边栏在三种呈现方式之间切换:

- **常规**:宿主默认行为,展开面板时挤压对话区域。
- **抽屉**:面板悬浮覆盖在对话之上,对话保持完整宽度;面板打开时对话区域出现一层遮罩,点击遮罩即可收起面板。
- **正文**:面板移入中间列作为正文,对话移到右侧(IDE 式布局),原有的右侧拖拽手柄此时调整的是对话列的宽度。

## 安装

```sh
dsh plugin --profile web add @klarkxy/dsh-sidebar-layout
```

把 `web` 换成你的 profile 名,DSH 提示时重启 profile。安装后默认启用,可在插件列表中关闭。

## 使用

布局是全局设置,三处入口改的是同一份状态:

- **会话头部按钮**:会话头部右侧工具条上的「侧栏布局」图标按钮,点击弹出菜单选择常规 / 抽屉 / 正文,当前方式有勾选标记。选择抽屉或正文时若面板处于收起状态会自动展开。
- **设置项**:「设置 → 通用」中的「侧栏布局」一行,下拉选择同一种方式。
- **快捷键**:`Ctrl/Cmd + Alt + Shift + B` 按「常规 → 抽屉 → 正文 → 常规」循环切换(网页版 Linux 不预置该快捷键,可在快捷键设置中自行绑定)。

选择会被保存在当前浏览器中,重新打开时恢复。

## 主要限制

- 面板的全屏模式不受本插件影响,三种布局下都保持宿主原样。
- 宿主在空间不足以容纳正常宽度的面板轨道时仍会自动收起面板,抽屉模式下同样如此。
- 本插件与 `dsh-better-sidebar` 可以同时使用,互不影响。
- 停用或卸载本插件后,侧栏恢复宿主默认的「常规」行为。
5 changes: 5 additions & 0 deletions plugins/dsh-sidebar-layout/cordis.patch.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Enabled when installed. Purely additive; touches no built-in row.
- insert:
- id: sidebar-layout
name: '@klarkxy/dsh-sidebar-layout'
disabled: false
13 changes: 13 additions & 0 deletions plugins/dsh-sidebar-layout/icon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 6 additions & 0 deletions plugins/dsh-sidebar-layout/locale/en.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"meta": {
"title": "Sidebar Layout",
"description": "Switch the right Sidebar between push, drawer overlay and body-swap layouts."
}
}
6 changes: 6 additions & 0 deletions plugins/dsh-sidebar-layout/locale/zh.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"meta": {
"title": "侧栏布局",
"description": "切换右侧边栏的呈现方式:常规挤压、抽屉覆盖与正文互换三种布局。"
}
}
129 changes: 129 additions & 0 deletions plugins/dsh-sidebar-layout/package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,129 @@
{
"name": "@klarkxy/dsh-sidebar-layout",
"version": "0.1.0",
"description": "Sidebar Layout: switch the right Sidebar between push, drawer overlay and body-swap layouts in the DeepSeek Harness Web GUI.",
"icon": "./icon.svg",
"license": "SEE LICENSE IN LICENSE",
"type": "module",
"engines": {
"node": ">=22",
"dsh": ">=0.2.2-rc.5"
},
"main": "./lib/index.js",
"types": "./lib/index.d.ts",
"exports": {
".": {
"types": "./lib/index.d.ts",
"import": "./lib/index.js",
"default": "./lib/index.js"
},
"./contracts": {
"types": "./lib/contracts.d.ts",
"import": "./lib/contracts.js",
"default": "./lib/contracts.js"
},
"./client": {
"default": "./lib/client.js"
},
"./package.json": "./package.json",
"./locale/*.json": "./locale/*.json"
},
"files": [
"icon.svg",
"locale/*.json",
"lib",
"cordis.patch.yml",
"README.md",
"README.en.md",
"LICENSE"
],
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
},
"client": {
"platform": "web",
"inject": [
"@deepseek-ai/dsh-client-locale",
"@deepseek-ai/dsh-client-ui-slots",
"@deepseek-ai/dsh-client-ui-layout",
"@deepseek-ai/dsh-client-ui-sidebar-right",
"@deepseek-ai/dsh-client-shortcuts",
"@deepseek-ai/dsh-client-ui-primitives"
]
}
},
"scripts": {
"build": "tsdown && node ../../scripts/editor-plugins/wrap-client.mjs @klarkxy/dsh-sidebar-layout",
"typecheck": "tsc --noEmit -p tsconfig.json",
"test": "vitest run --root ../.. --config vitest.editor-plugins.config.ts --maxWorkers=2 plugins/dsh-sidebar-layout/src"
},
"peerDependencies": {
"@deepseek-ai/cordis": ">=4.0.4",
"@deepseek-ai/dsh-client-shortcuts": ">=0.2.2-rc.5",
"@deepseek-ai/dsh-client-locale": ">=0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-layout": ">=0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-sidebar-right": ">=0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-slots": ">=0.2.2-rc.5"
},
"devDependencies": {
"@klarkxy/dsh-plugin-kit": "workspace:*",
"@deepseek-ai/cordis": "4.1.0",
"@deepseek-ai/dsh-client-shortcuts": "0.2.2-rc.5",
"@deepseek-ai/dsh-client-locale": "0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-layout": "0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-slots": "0.2.2-rc.5",
"@deepseek-ai/dsh-client-ui-primitives": "0.2.2-rc.5",
"react": "^18.2.0",
"@types/react": "18.3.31",
"react-dom": "^18.2.0",
"@types/react-dom": "^18.3.1",
"jsdom": "29.1.1",
"@types/jsdom": "28.0.3"
},
"keywords": [
"dsh",
"dsh-plugin",
"dsh-plugins",
"deepseek-harness",
"deepseek-harness-plugin",
"drawer",
"layout",
"sidebar",
"ui-customization"
],
"repository": {
"type": "git",
"url": "git+https://github.com/klarkxy/dsh-plugins.git",
"directory": "plugins/dsh-sidebar-layout"
},
"bugs": {
"url": "https://github.com/klarkxy/dsh-plugins/issues"
},
"publishConfig": {
"access": "public",
"registry": "https://registry.npmjs.org/"
},
"homepage": "https://klarkxy.github.io/dsh-plugins/plugins/sidebar-layout/",
"peerDependenciesMeta": {
"@deepseek-ai/cordis": {
"optional": true
},
"@deepseek-ai/dsh-client-shortcuts": {
"optional": true
},
"@deepseek-ai/dsh-client-locale": {
"optional": true
},
"@deepseek-ai/dsh-client-ui-layout": {
"optional": true
},
"@deepseek-ai/dsh-client-ui-sidebar-right": {
"optional": true
},
"@deepseek-ai/dsh-client-ui-slots": {
"optional": true
}
}
}
Loading
Loading