dsh-theme-customizer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lxxz1918
+
+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/PATCH-CORDIS-BUTTON.md

@@ -0,0 +1,67 @@
+# 官方 Cordis 按钮常驻补丁说明（dsh-client-ui-cordis）
+
+> 验证通过（2026-08-19，临时静态测试插件 v3 确认：无插件活动时按钮常驻、开关即时显隐、刷新持久）。
+> **推荐直接用随包脚本一键安装**：`node apply-patch.cjs`（自动备份 / `--check` 查状态 / `--undo` 撤销）。本文档记录补丁内容与手动重打方法。
+
+## 为什么需要补丁
+
+官方 `CordisPanel` 在**没有任何动态插件活动**时 `return null`（按钮隐藏）。
+需求：侧边栏底部的官方 Cordis 按钮**常驻**（无插件时也显示），并由主题插件开关控制。
+
+## 补丁文件
+
+```
+<home>\.dsh\profiles\node_modules\@deepseek-ai\dsh-client-ui-cordis\lib\client.js
+```
+
+原始备份：同目录 `client.js.bak-theme-customizer`
+⚠️ DSH 升级会覆盖此文件 → 需按下面内容重打（或重跑 `node apply-patch.cjs`）。
+
+## 补丁内容（两处）
+
+### 1. 常驻条件（原约 712 行，组件内）
+
+**原代码**：
+```js
+if (all.length === 0) return null;
+```
+
+**补丁后**：
+```js
+if (all.length === 0 && window.__TCZ_HIDE_OFFICIAL_CORDIS) return null; /* [dsh-theme-customizer] Cordis按钮常驻补丁 */
+```
+
+⚠️ 千万不要加 `!`！历史上写反过一次（`!window.__TCZ_HIDE_OFFICIAL_CORDIS`），
+导致 flag=false（常驻）时反而隐藏。语义：
+- `window.__TCZ_HIDE_OFFICIAL_CORDIS = false` → 常驻（无插件也显示）
+- `window.__TCZ_HIDE_OFFICIAL_CORDIS = true` → 官方原逻辑（无插件隐藏）
+
+### 2. 即时响应 hook（原约 688 行后，组件顶部 hooks 区，必须在条件 return 之前）
+
+在 `}, [onRefresh, open]);` 之后、`const byPlugin = ...` 之前插入：
+
+```js
+const [, tczForce] = (0, react.useState)(0);
+(0, react.useEffect)(() => {
+    const tczFn = () => tczForce((n) => n + 1);
+    window.addEventListener('tcz:cordis-visibility', tczFn);
+    return () => window.removeEventListener('tcz:cordis-visibility', tczFn);
+}, []);
+```
+
+效果：切换开关后按钮**立即**显隐（无需刷新页面）。
+
+## 触发端约定
+
+设置 flag 的插件（动态 thmcz-1 / 静态 dsh-theme-customizer 的 `applyCordisEntryFlag`）：
+```js
+window.__TCZ_HIDE_OFFICIAL_CORDIS = !cordisEntry;
+window.dispatchEvent(new Event('tcz:cordis-visibility'));
+```
+
+## 验证记录
+
+- 2026-08-19：临时静态插件 `dsh-theme-customizer-test`（plugin-test/，v3 非受控 checkbox）验证通过。
+- 教训：受控 checkbox + React force 重渲染在静态插件环境不可靠（第二次切换后 UI 不更新），
+  测试插件改用**非受控 checkbox + 手动 DOM 同步**后完全正常。
+- ✅ 2026-08-19 已清理：`plugin-test/` 目录、junction、`web/package.json` 两行均已移除（设置里"主题测试"入口随重启消失）。

package/README.en.md

@@ -0,0 +1,89 @@
+# dsh-theme-customizer
+
+[![npm version](https://img.shields.io/npm/v/dsh-theme-customizer?style=flat-square)](https://www.npmjs.com/package/dsh-theme-customizer)
+[![license](https://img.shields.io/github/license/lxxz1918/dsh-theme-customizer?style=flat-square)](LICENSE)
+[![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0969da?style=flat-square)](https://github.com/topics/dsh-plugin)
+[![stars](https://img.shields.io/github/stars/lxxz1918/dsh-theme-customizer?style=flat-square)](https://github.com/lxxz1918/dsh-theme-customizer/stargazers)
+
+**English** | [中文](README.md)
+
+> A theme customizer plugin for the DeepSeek Harness (DSH) web UI. Backgrounds, text colors, borders and details — all adjustable visually, persisted across restarts.
+> Config is stored in localStorage; presets can be exported as `.tczp` files (images included) and shared with any machine.
+
+## Features
+
+- **Interface module (7 background areas)**: Main / Sidebar / Conversation / Composer / Settings panel / Floating panel / Cordis panel
+  - Each area: None / Solid color / Image (with crop & selection) + opacity (**larger value = more transparent**) + base color (independent layer)
+  - Main background supports "include sidebar / exclude sidebar" display area toggle
+  - Sidebar image fades out directly via mask — never covers the top UI or the settings panel
+- **Borders module**: color + opacity for all default UI borders/dividers, independently for 5 areas (Main incl. sidebar / Cordis / Composer / Settings / Floating panel)
+- **Text colors module**: 5 categories (Body / Process / Auxiliary / Faded / Accent), shared across light & dark themes, restorable to official defaults
+- **Brand color**: color + opacity for the top-left DeepSeek Harness logo; the "Harness" wordmark can be tinted separately
+- **Conversation details**: user bubble / inline code / code block background / code block scrollbar / conversation scrollbar / todo panel collapsed & expanded / "scroll to bottom" button background
+- **Composer**: background, fixed input height (1–10 rows), stats line takeover (9 independent toggles + full expand), command button & menu backgrounds
+- **New session button**: None/Solid/Image style + show text/icon toggles + independent icon/text colors + base color
+- **Layout**: draggable settings panel (drag its header; position persisted; one-click reset)
+- **Floating panel**: a draggable mini settings panel (choose which modules to show), always on top
+- **Presets**: save/apply/rename/delete/export/import (`.tczp`, images included, up to 10) + drag-to-reorder
+- **Global reset**: one click to restore all defaults (3-step confirm to prevent accidents)
+
+## Installation
+
+```bash
+# Option 1: npm (published package)
+npm install -g dsh-theme-customizer
+dsh plugin --profile web add dsh-theme-customizer
+
+# Option 2: local directory (after cloning this repo)
+dsh plugin --profile web add <path-to-this-repo>
+```
+
+Then **restart dsh web** for it to take effect. Verify: Settings → Theme should appear.
+
+## Usage
+
+1. Open **Settings → Theme** and adjust by module; changes apply instantly and save automatically (the bottom of the page shows "last saved" time)
+2. For quick tweaks, click "↗ Open float panel" at the top right — the panel is draggable
+3. To verify the conversation-area options, use the test text in [对话区测试指令.md](对话区测试指令.md)
+
+## Persistent Cordis button (optional)
+
+The "Cordis button always visible" toggle in Theme settings **requires a patch to the official dsh-client-ui-cordis package**; without the patch the toggle has no effect. One-click install:
+
+```bash
+node apply-patch.cjs           # apply patch (auto backup)
+node apply-patch.cjs --check   # check status
+node apply-patch.cjs --undo    # revert
+```
+
+⚠️ **DSH upgrades overwrite the official package** — re-run `apply-patch.cjs` after upgrading. Details in [PATCH-CORDIS-BUTTON.md](PATCH-CORDIS-BUTTON.md).
+
+## Build from source (developers)
+
+```bash
+# 1. Concatenate source fragments (optimized/src/ → optimized/dist/, with syntax check + line map/symbols)
+node optimized\build.cjs
+
+# 2. Generate the static client bundle (dist/p3_2_client.js → lib/client.js)
+node build_static.cjs optimized\dist\p3_2_client.js lib\client.js
+
+# 3. Syntax check + install for testing
+node --check lib\client.js
+dsh plugin --profile web add <path-to-this-repo>
+```
+
+Source layout: `optimized/src/` contains 16 fragments (`00_*`~`15_*` + `host.js`) concatenated in filename order into the plugin function body. Look up features in `optimized/INDEX.md`.
+
+## Preset files (.tczp)
+
+Presets panel → "📥 Import preset" and pick a `.tczp` file to restore a whole config (images included — no original files needed). Export each preset via "📤 Export" in the same panel.
+
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-theme-customizer
+```
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,89 @@
+# dsh-theme-customizer
+
+[![npm version](https://img.shields.io/npm/v/dsh-theme-customizer?style=flat-square)](https://www.npmjs.com/package/dsh-theme-customizer)
+[![license](https://img.shields.io/github/license/lxxz1918/dsh-theme-customizer?style=flat-square)](LICENSE)
+[![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0969da?style=flat-square)](https://github.com/topics/dsh-plugin)
+[![stars](https://img.shields.io/github/stars/lxxz1918/dsh-theme-customizer?style=flat-square)](https://github.com/lxxz1918/dsh-theme-customizer/stargazers)
+
+**中文** | [English](README.en.md)
+
+> DeepSeek Harness（DSH）Web 界面自定义主题插件：背景、文字、框线、细节全部可视化设置，刷新/重启不丢。
+> 配置存 localStorage，预设可导出 `.tczp` 文件（含图片）分享到任意电脑。
+
+## 功能一览
+
+- **界面板块（7 区域背景）**：主界面 / 侧边栏 / 对话区 / 输入区 / 设置界面 / 浮窗面板 / Cordis 插件界面
+  - 每区域：无 / 纯色 / 图片（选区裁剪）+ 透明度（**数值越大越透明**）+ 底色（独立层）
+  - 主界面支持「包含侧边栏 / 不包含侧边栏」显示区域切换
+  - 侧边栏图片用 mask 直接淡出，不盖顶部 UI、不挡设置面板
+- **框线板块**：所有界面默认边框/分隔线颜色 + 透明度，主界面（含侧边栏）/ Cordis / 输入区 / 设置界面 / 浮窗 5 区域独立
+- **字体颜色板块**：正文 / 过程 / 辅助 / 弱化 / 强调 5 类文字颜色（亮暗主题共用，可恢复官方默认）
+- **标志调色**：左上角 DeepSeek Harness 标志颜色 + 透明度；「Harness」文字部分可单独调色
+- **对话区细节**：用户发言气泡 / 行内代码 / 代码块背景 / 代码块滚动条 / 对话区滚动条 / 任务栏收起展开 / 「一键到底」按钮背景
+- **输入区**：背景、输入框固定高度（1~10 行）、统计条接管渲染（9 项独立开关 + 完全展开）、命令按钮/菜单背景
+- **新会话按钮**：无/纯色/图片样式 + 显示文本/图标开关 + 图标/文本颜色独立设置 + 底色
+- **布局调整**：设置界面面板可拖动（拖 header 移动 + 位置持久化 + 一键复位）
+- **浮动主题面板**：可拖动的迷你设置面板（勾选显示内容），顶层不遮挡
+- **预设**：保存/应用/重命名/删除/导出/导入（`.tczp` 含图，最多 10 个）+ 拖拽排序
+- **全局恢复默认**：一键重置所有设置（三级确认防误触）
+
+## 安装
+
+```bash
+# 方式一：npm 安装（发布包）
+npm install -g dsh-theme-customizer
+dsh plugin --profile web add dsh-theme-customizer
+
+# 方式二：本地目录安装（GitHub clone 后）
+dsh plugin --profile web add <本仓库路径>
+```
+
+装完**重启 dsh web** 生效。验证：设置 → 主题 出现即可。
+
+## 使用
+
+1. 打开 **设置 → 主题**，按板块调整；改动即时生效、自动保存（页面底部显示「最近保存」时间）
+2. 需要快速调整时可点右上「↗ 打开浮窗」，浮窗可拖动
+3. 装完想验证对话区各选项效果，可用 [对话区测试指令.md](对话区测试指令.md) 里的测试文本
+
+## Cordis 按钮常驻（可选）
+
+主题设置里「Cordis 按钮常驻」开关**依赖官方 dsh-client-ui-cordis 补丁**，未打补丁时开关不生效。一键安装：
+
+```bash
+node apply-patch.cjs           # 打补丁（自动备份）
+node apply-patch.cjs --check   # 查看状态
+node apply-patch.cjs --undo    # 撤销
+```
+
+⚠️ **DSH 升级会覆盖官方包**，升级后需重跑 `apply-patch.cjs`。细节见 [PATCH-CORDIS-BUTTON.md](PATCH-CORDIS-BUTTON.md)。
+
+## 从源码构建（开发者）
+
+```bash
+# 1. 拼接源码片段（optimized/src/ → optimized/dist/，自动语法校验 + 行号映射/符号表）
+node optimized\build.cjs
+
+# 2. 生成静态 client bundle（dist/p3_2_client.js → lib/client.js）
+node build_static.cjs optimized\dist\p3_2_client.js lib\client.js
+
+# 3. 语法校验 + 安装测试
+node --check lib\client.js
+dsh plugin --profile web add <本仓库路径>
+```
+
+源码结构：`optimized/src/` 16 个片段（`00_*`~`15_*` + `host.js`）按文件名拼接为插件函数体，功能定位查 `optimized/INDEX.md`。
+
+## 预设文件（.tczp）
+
+预设面板 → 「📥 导入预设」选择 `.tczp` 文件即可恢复整套配置（含图片，无需原图）。导出同样在预设面板逐条「📤 导出」。
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-theme-customizer
+```
+
+## License
+
+[MIT](LICENSE)

package/apply-patch.cjs

@@ -0,0 +1,102 @@
+// apply-patch.cjs —— 官方 Cordis 按钮常驻补丁一键安装/撤销（dsh-theme-customizer 随包脚本）
+// 背景：官方 dsh-client-ui-cordis 在"没有任何动态插件活动"时 return null（按钮隐藏）。
+//       本补丁让按钮显隐受 window.__TCZ_HIDE_OFFICIAL_CORDIS 控制（主题插件「Cordis 按钮常驻」开关使用）。
+// ⚠️  DSH 升级会覆盖官方包 → 升级后需重跑本脚本。
+//
+// 用法（任意目录）：
+//   node apply-patch.cjs             # 打补丁（首次自动备份 client.js.bak-theme-customizer）
+//   node apply-patch.cjs --check     # 只检查补丁状态，不修改任何文件
+//   node apply-patch.cjs --undo      # 撤销：从备份恢复官方原文件
+//
+// 细节与验证记录见 PATCH-CORDIS-BUTTON.md
+const fs = require('fs')
+const path = require('path')
+
+const MARK = '[dsh-theme-customizer] Cordis按钮常驻补丁'
+const BAK = 'client.js.bak-theme-customizer'
+
+// ── 定位官方包 client.js ──
+function findTarget() {
+  const bases = []
+  if (process.env.APPDATA) bases.push(path.join(process.env.APPDATA, '.dsh'))
+  if (process.env.USERPROFILE) bases.push(path.join(process.env.USERPROFILE, '.dsh'))
+  for (const base of bases) {
+    const p = path.join(base, 'profiles', 'node_modules', '@deepseek-ai', 'dsh-client-ui-cordis', 'lib', 'client.js')
+    if (fs.existsSync(p)) return p
+  }
+  return null
+}
+
+// ── 两处替换 ──
+function apply(content) {
+  // 1. 常驻条件：无插件活动时也渲染（flag=true 时恢复官方原逻辑）。
+  //    ⚠️ 语义（PATCH-CORDIS-BUTTON.md 历史教训，勿加 !）：
+  //    window.__TCZ_HIDE_OFFICIAL_CORDIS = false/未设置 → 常驻（无插件也显示）
+  //    window.__TCZ_HIDE_OFFICIAL_CORDIS = true → 官方原逻辑（无插件隐藏）
+  const re1 = /if\s*\(\s*all\.length\s*===\s*0\s*\)\s*return\s+null\s*;/
+  // 2. 即时响应 hook：监听 tcz:cordis-visibility 事件强制重渲染（切换开关立即显隐）
+  const re2 = /(\},\s*\[onRefresh,\s*open\]\);)/
+
+  if (!re1.test(content)) throw new Error('未找到锚点 1：`if (all.length === 0) return null;`（官方代码已变化？）')
+  if (!re2.test(content)) throw new Error('未找到锚点 2：`}, [onRefresh, open]);`（官方代码已变化？）')
+
+  const hook = [
+    'const [, tczForce] = (0, react.useState)(0); /* ' + MARK + ' */',
+    '(0, react.useEffect)(() => {',
+    '    const tczFn = () => tczForce((n) => n + 1);',
+    "    window.addEventListener('tcz:cordis-visibility', tczFn);",
+    "    return () => window.removeEventListener('tcz:cordis-visibility', tczFn);",
+    '}, []);',
+  ].join('\n')
+
+  return content
+    .replace(re1, 'if (all.length === 0 && window.__TCZ_HIDE_OFFICIAL_CORDIS) return null; /* ' + MARK + ' */')
+    .replace(re2, '$1\n' + hook)
+}
+
+const arg = process.argv[2] || ''
+const target = findTarget()
+if (!target) {
+  console.error('✗ 找不到官方包：<home>/.dsh/profiles/node_modules/@deepseek-ai/dsh-client-ui-cordis/lib/client.js')
+  console.error('  请确认 dsh 已安装且路径正确。')
+  process.exit(1)
+}
+console.log('目标文件: ' + target)
+
+const content = fs.readFileSync(target, 'utf8')
+const patched = content.includes(MARK)
+const bakPath = path.join(path.dirname(target), BAK)
+
+if (arg === '--check') {
+  console.log(patched
+    ? '✅ 已打补丁（' + MARK + ' 标记存在）'
+    : '⏹ 未打补丁')
+  console.log(fs.existsSync(bakPath) ? '备份存在: ' + BAK : '无备份')
+  process.exit(0)
+}
+
+if (arg === '--undo') {
+  if (!patched) { console.log('⏹ 未打补丁，无需撤销'); process.exit(0) }
+  if (!fs.existsSync(bakPath)) { console.error('✗ 没有备份文件，无法撤销（请手动恢复或重装官方包）'); process.exit(1) }
+  fs.copyFileSync(bakPath, target)
+  console.log('✅ 已从备份恢复官方原文件')
+  process.exit(0)
+}
+
+if (patched) {
+  console.log('⏹ 已经打过补丁（跳过）。撤销用: node apply-patch.cjs --undo')
+  process.exit(0)
+}
+
+// 首次打补丁前备份（已存在则不覆盖，保留最早的原版）
+if (!fs.existsSync(bakPath)) fs.copyFileSync(target, bakPath)
+try {
+  const next = apply(content)
+  fs.writeFileSync(target, next, 'utf8')
+} catch (e) {
+  console.error('✗ ' + e.message)
+  console.error('  官方包代码已变化，请参照 PATCH-CORDIS-BUTTON.md 手动处理。')
+  process.exit(1)
+}
+console.log('✅ 补丁完成（已备份 ' + BAK + '）')
+console.log('   生效方式：刷新/重启 dsh web。主题设置 → Cordis 插件界面 → 「Cordis 按钮常驻」开关即时显隐。')

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# dsh-theme-customizer bundle layer: applied automatically when the package
+# is installed (package.json declares dsh.bundle.patch). The insert row makes
+# the package a Cordis plugin row; because the package declares dsh.client,
+# the same row also enters the browser roster (window.__DSH_BOOT__) and its
+# ./client export is served as a client bundle.
+
+- insert:
+    - id: theme-customizer
+      name: dsh-theme-customizer