npm - @michengai/dsh-codex-ui - Versions diffs - 0.2.112 → 1.0.0 - Mend

@michengai/dsh-codex-ui 0.2.112 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -4,7 +4,54 @@
 This changelog records recent releases of DSH Codex UI and its one-click installer. Earlier changes remain available in the [Git history](https://github.com/MichengAI/dsh-codex-ui/commits/main).
-## Unreleased
+## 1.0.0 - 2026-09-08
+- Release 1.0.0, bringing project and conversation navigation, plugin entry points, and standalone settings together in a cohesive Codex-style experience.
+- Fix flashing when returning to the app or pressing Escape; let menus handle Escape first and preserve the current settings form while filtering navigation.
+- Upgrade notes: the standalone settings view requires the bundle patch that disables ui-settings-general. If an existing settings shell is detected, its entry is retained. Replacing client files alone is not a complete upgrade; reload DSH after upgrading. Existing business configuration and conversations require no migration.
+- Fix global settings search, onboarding and keyboard focus isolation, Escape handling for hidden dialogs, and configuration-file error feedback; retain the host settings shell when it is already active.
+- Replace the settings dialog with a Codex-style standalone view, category search, grouped preferences, and focus restoration when returning to the app.
+- Fix duplicate settings-shell registration, settings entry alignment and transitions, search focus, repeated headings, and content spacing.
+- Give the plugin marketplace and side cards distinct store and sidebar-layout icons instead of the generic box.
+- Preserve host configuration, onboarding, connection recovery, and installed plugin functionality; community plugin internal styling remains outside this change.
+## suite-installer-v0.1.31 - 2026-09-08
+Resolved and pinned the following member versions from the official npm registry:
+- `@michengai/dsh-archive-manager@0.1.32`
+- `@michengai/dsh-codex-ui@0.2.113`
+- `@michengai/dsh-skills-manager@0.1.43`
+- `@michengai/dsh-agency-agents@0.1.34`
+- `@michengai/dsh-im-connect@0.1.38`
+- `@michengai/dsh-automation@0.1.34`
+- `@michengai/dsh-btw@0.1.4`
+- `@michengai/dsh-simplify@0.1.2`
+The installer uses these exact versions for reproducible installation.
+## 0.2.113 - 2026-09-08
+### Fixed
+- Fixed Chinese text wrapping into vertical columns and misaligned menu and footer text while collapsing the sidebar.
+- Restored sidebar expand and collapse transitions when used alongside `dsh-better-sidebar`, while preserving right-panel animations.
+- Synchronized sidebar width and content fades, removed redundant width updates, and kept rapid toggling and dragging responsive.
+## suite-installer-v0.1.30 - 2026-09-08
+Resolved and pinned the following member versions from the official npm registry:
+- `@michengai/dsh-archive-manager@0.1.32`
+- `@michengai/dsh-codex-ui@0.2.112`
+- `@michengai/dsh-skills-manager@0.1.43`
+- `@michengai/dsh-agency-agents@0.1.34`
+- `@michengai/dsh-im-connect@0.1.38`
+- `@michengai/dsh-automation@0.1.34`
+- `@michengai/dsh-btw@0.1.4`
+- `@michengai/dsh-simplify@0.1.2`
+The installer uses these exact versions for reproducible installation.
 ## 0.2.112 - 2026-09-08

package/CHANGELOG.zh-CN.md CHANGED Viewed

@@ -4,7 +4,54 @@
 本日志记录 DSH Codex UI 及其一键安装器的最近发布；更早的变更可查看 [Git 提交历史](https://github.com/MichengAI/dsh-codex-ui/commits/main)。
-## 未发布
+## 1.0.0 - 2026-09-08
+- 发布 1.0.0：将项目与会话导航、插件入口和独立设置视图整合为完整的 Codex 风格体验。
+- 修复返回应用和 Escape 退出时的页面闪烁；菜单先处理 Escape，搜索筛选保留正在填写的正文。
+- 升级说明：独立设置页依赖 bundle patch 停用 ui-settings-general；检测到既有设置壳时保留宿主入口。单独替换客户端文件不等同于完整升级，升级后应重载 DSH。既有业务配置和会话无需迁移。
+- 修复全局搜索设置入口、引导与键盘焦点隔离、隐藏弹窗对 Escape 的影响及配置文件失败反馈；旧设置壳并存时保留宿主入口。
+- 设置改为 Codex 风格的独立页面，提供分类搜索、分组偏好、返回应用及焦点恢复。
+- 修复新旧设置壳重复注册、设置入口对齐与交互动画、搜索聚焦、重复标题及内容留白。
+- 为插件市场和侧边卡片分别使用商店与侧栏布局图标，避免与默认盒子图标混淆。
+- 保留宿主配置、引导和连接恢复接口，以及已安装插件原有功能；社区插件内部样式不在本次统一范围。
+## suite-installer-v0.1.31 - 2026-09-08
+从官方 npm 解析并锁定以下成员版本：
+- `@michengai/dsh-archive-manager@0.1.32`
+- `@michengai/dsh-codex-ui@0.2.113`
+- `@michengai/dsh-skills-manager@0.1.43`
+- `@michengai/dsh-agency-agents@0.1.34`
+- `@michengai/dsh-im-connect@0.1.38`
+- `@michengai/dsh-automation@0.1.34`
+- `@michengai/dsh-btw@0.1.4`
+- `@michengai/dsh-simplify@0.1.2`
+安装器使用这些精确版本执行安装，确保可复现。
+## 0.2.113 - 2026-09-08
+### 修复
+- 修复侧栏收缩时中文被挤成竖排、菜单与页脚文字错位的问题。
+- 修复与 `dsh-better-sidebar` 同时使用时，侧栏展开和收起缺少过渡动画的问题，并保留右侧面板动画。
+- 同步侧栏宽度与内容淡入淡出的节奏，消除重复宽度更新造成的额外开销；快速切换和拖拽保持正常响应。
+## suite-installer-v0.1.30 - 2026-09-08
+从官方 npm 解析并锁定以下成员版本：
+- `@michengai/dsh-archive-manager@0.1.32`
+- `@michengai/dsh-codex-ui@0.2.112`
+- `@michengai/dsh-skills-manager@0.1.43`
+- `@michengai/dsh-agency-agents@0.1.34`
+- `@michengai/dsh-im-connect@0.1.38`
+- `@michengai/dsh-automation@0.1.34`
+- `@michengai/dsh-btw@0.1.4`
+- `@michengai/dsh-simplify@0.1.2`
+安装器使用这些精确版本执行安装，确保可复现。
 ## 0.2.112 - 2026-09-08

package/README.md CHANGED Viewed

@@ -6,9 +6,9 @@
   # DSH Codex UI
-  **Rebuild the DeepSeek Harness Web sidebar, workspace tree, search, and turn navigation in a Codex-style layout**
+  **Organize projects, find conversations, and revisit long chats more easily in DSH Web**
-  [简体中文](README.zh-CN.md) · [项目交接](docs/00-交接入口/00-阅读导航.md) · [Changelog](CHANGELOG.md) · [Apache-2.0](LICENSE)
+  [简体中文](README.zh-CN.md) · [Changelog](CHANGELOG.md) · [Apache-2.0](LICENSE)
   [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-codex-ui.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-codex-ui)
@@ -18,18 +18,18 @@
 </div>
-> DSH Codex UI is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product. It uses public DSH slots only and does not modify host source code or conversation data.
+> DSH Codex UI is a community-maintained interface plugin for DeepSeek Harness (DSH), not an official DeepSeek AI product.
-## Features
+Working across several projects and conversations in DSH Web? DSH Codex UI helps you organize the sidebar, find tasks quickly, and jump back to earlier questions in long chats. It offers a Codex-style interface with light and dark themes.
-- Replace the default sidebar through the official `sidebar` slot and keep `sidebar.workspaces`, `sidebar.settings`, and `sidebar.footer.action`.
-- Provide a Codex-style header with brand wordmark, sidebar collapse, and global search.
-- List workspaces and conversations with expand/collapse, drag reorder, project pinning, unread dots, and running-state indicators.
-- Add project and conversation menus for rename, pin, unread, archive, fork, open folder, copy, and delete.
-- Restyle the conversation column and composer card, and add a compact turn navigator on the current session.
-- Recall submitted text with Up/Down from an empty composer, with workspace isolation and guards for drafts, IME, and candidate menus. BTW is not required.
-- Capture ordinary messages only from live events while the input extension is mounted. Opening or reloading conversations and loading older messages do not backfill history; input sent while the extension is unmounted is not imported.
-- Show companion-plugin status in **Settings → About**, and install the missing pieces from npm.
+## What you can do
+- **Organize projects and conversations**: expand or collapse projects, drag to reorder, pin frequently used projects, and see unread and running indicators.
+- **Find things quickly**: search for conversations, settings, and quick actions from the header.
+- **Manage everyday tasks**: rename, archive, or fork conversations, and open project folders from their menus.
+- **Revisit long chats**: select a turn marker to jump directly to the corresponding question.
+- **Reuse earlier input**: press Up/Down in an empty composer to recall text submitted in the current workspace.
+- **Add features as needed**: check companion plugins in **Settings → About** and install or update the ones you need.
 ## Screenshots
@@ -37,7 +37,7 @@ Light theme: Codex-style sidebar, workspace tree, and conversation column.
 ![Light theme conversation](assets/screenshots/conversation-light.png)
-Dark theme: the same layout with Codex dark tokens.
+Dark theme: for users who prefer a darker interface.
 ![Dark theme conversation](assets/screenshots/conversation.png)
@@ -53,37 +53,36 @@ Conversation menu: rename, pin, unread, archive, fork, copy, and delete.
 - A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
 - Examples use the `web` profile; replace it with the target profile.
-- Source installation and development require Node.js 22+ and pnpm. Installing from npm does not require running `pnpm install` in an arbitrary directory.
+- Node.js must satisfy `^22.19.0 || >=24.0.0`. Installing from source also requires pnpm.
 ## DSH product ecosystem
-Codex UI can be installed independently or used through the desktop app. They share the same DSH core but serve different ways of working:
+For a ready-to-use workbench, download [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). If you already use [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), install any of these eight plugins individually. The desktop app includes all eight.
-| Product | Relationship to Codex UI |
+| Plugin | What you can do |
 | --- | --- |
-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | The host runtime that provides models, sessions, tools, and the plugin system |
-| [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop) | A ready-to-install desktop product with Codex UI and the other five feature products built in |
-| Six feature products | [Codex UI](https://github.com/MichengAI/dsh-codex-ui) · [IM Connect](https://github.com/MichengAI/dsh-im-connect) · [Automation](https://github.com/MichengAI/dsh-automation) · [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) · [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) · [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organize projects and conversations, search tasks, and navigate chat turns |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Send tasks and receive replies through your usual messenger |
+| [Automation](https://github.com/MichengAI/dsh-automation) | Schedule tasks and review each run |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Find, enable, create, and import local skills |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Search, restore, or clean up archived conversations |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Choose and summon specialists for your task |
+| [BTW](https://github.com/MichengAI/dsh-btw) | Ask side questions without interrupting the main task |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | Use /simplify to improve code within your Git changes |
 ## Installation
-`dsh plugin add` forwards to `pnpm add` in the profile directory. Without a version and official registry, a local mirror or minimum-release-age policy can leave you on an older build.
+Choose agent-assisted or manual installation below. Both use the same command, requesting the latest version from the official npm registry.
-### Ask another agent to install Codex UI
+### Ask an agent to install it (recommended)
-Copy the sentence below into DSH, Codex, or WorkBuddy and let that agent install Codex UI into your local `web` profile.
+Send the prompt below to any agent that can run terminal commands on your computer. Replace `web` with your actual profile. Once installed, use the plugin in DSH.
 ```text
-Install the latest DSH plugin @michengai/dsh-codex-ui into my local web profile using the official npm registry: dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm codex-ui is mounted, and remind me to restart DSH Web and hard-refresh the browser.
+Install the DSH plugin @michengai/dsh-codex-ui into my local web profile by running: dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm the configuration includes codex-ui, and explain how to reload DSH and start using the plugin.
 ```
-| Product | How to use it |
-| --- | --- |
-| DSH | Send the sentence above to the current session. |
-| Codex | Send the sentence above to Codex and let it install locally. |
-| WorkBuddy | Send the sentence above to WorkBuddy. |
-### Install Codex UI only
+### Install manually
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -92,25 +91,7 @@ dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://r
 dsh --profile web --dump-config
 ```
-The plugin takes over the default sidebar through `cordis.patch.yml`. Uninstalling restores the default sidebar.
-### Install from source
-Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
-```powershell
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-$OutputEncoding = [System.Text.Encoding]::UTF8
-Set-Location D:\Repository\deepseek-harness-plugin
-git clone https://github.com/MichengAI/dsh-codex-ui.git
-Set-Location .\dsh-codex-ui
-pnpm install --frozen-lockfile
-pnpm build
-dsh plugin --profile web add .
-dsh --profile web --dump-config
-```
-Restart DSH Web and hard-refresh the browser. Do not copy `lib` manually; local installation reads both package metadata and `cordis.patch.yml`.
+Restart DSH Web and hard-refresh the browser (usually `Ctrl+Shift+R`). Once the new sidebar appears, you are ready to use it. Uninstalling the plugin restores the default sidebar.
 ## Usage
@@ -123,54 +104,67 @@ Open DSH Web. The left navigation is rendered by this plugin.
 | Collapse the sidebar | Use the header panel button. The expand control stays on the collapsed rail. |
 | Pin a workspace | Drag it into **Pinned**, or use **Pin project** in the project menu. |
 | Manage a conversation | Open the conversation menu to rename, pin, mark unread, archive, fork, copy, or delete. |
+| Reuse input | Press Up/Down in an empty composer to recall text submitted in the current workspace. |
 | Jump between turns | Use the turn marks on the left of the current conversation. |
 | Inspect connectors | Open **Settings → Connectors**. Addresses, commands, and credentials are never shown. |
 | Check companion plugins | Open **Settings → About** to install or update individual companion plugins. |
-Deleting a workspace registration does not delete its folder or conversation records. Pinned and unread state is stored only in the current browser.
+## FAQ
-## Persistence and safety limits
+### Do pinned projects and unread markers persist?
-| Data | Storage | Scope |
-| --- | --- | --- |
-| Pinned workspaces | Host profile file with a `localStorage` cache | Survives DSH restarts and Desktop tray reloads |
-| Unread conversations | `localStorage` key `dsh.session-unread.v1` | Current browser only |
-| Conversation records | DSH host services | Unchanged by this plugin |
+Pinned projects are saved in your DSH configuration and survive restarts. Unread markers are stored only in the current browser and do not sync across browsers.
-- The plugin uses only public DSH slots and services.
-- It does not modify host source code or the conversation data model.
-- Permanent deletion of archived conversations is provided by `@michengai/dsh-archive-manager`.
-- The Connectors directory never exposes addresses, commands, or credentials.
+### Why is my earlier input missing?
-## Secondary development
+Input history is stored in the current browser, separately for each workspace, with up to 200 entries per workspace. It records new input while the feature is active and does not import existing conversations. When browser storage is unavailable, history is kept temporarily in memory. The BTW plugin is not required.
-- [src\index.ts](src/index.ts): host entry and the non-sensitive Connectors directory endpoint.
-- [src\client\index.ts](src/client/index.ts): client entry for sidebar, workspace tree, turn navigation, and Settings sections.
-- [src\client\CodexSidebar.tsx](src/client/CodexSidebar.tsx): sidebar shell, search panel, and visual styles.
-- [src\client\CodexWorkspaceBrowser.tsx](src/client/CodexWorkspaceBrowser.tsx): workspace and conversation interactions.
-- `tests\*.assert.ts` and `tests\*.spec.ts`: interaction, visual, and runtime integration checks.
+### Does removing a project delete local files?
-After changing `src`, rebuild, test, and install from the local directory:
+Removing a workspace registration does not delete its folder or conversation records. Permanent deletion of archived conversations is provided by the companion Archive Manager plugin.
+### What if nothing changes after installation?
+Check that the installation profile matches the one running DSH Web, then restart DSH Web and hard-refresh the browser. Run `dsh --profile web --dump-config` to check that `codex-ui` is mounted.
+## Development and contributing
+### Install from source
+Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-codex-ui.git
+Set-Location .\dsh-codex-ui
+pnpm install --frozen-lockfile
 pnpm build
-pnpm test
 dsh plugin --profile web add .
+dsh --profile web --dump-config
 ```
-New features should reuse existing DSH slots and public services. Do not depend on private host DOM or write conversation records.
+Restart DSH Web and hard-refresh the browser. Do not copy `lib` manually; local installation reads both package metadata and `cordis.patch.yml`.
-## Verification
+- [src\index.ts](src/index.ts): host entry and the non-sensitive Connectors directory endpoint.
+- [src\client\index.ts](src/client/index.ts): client entry for sidebar, workspace tree, turn navigation, and Settings sections.
+- [src\client\CodexSidebar.tsx](src/client/CodexSidebar.tsx): sidebar shell, search panel, and visual styles.
+- [src\client\CodexWorkspaceBrowser.tsx](src/client/CodexWorkspaceBrowser.tsx): workspace and conversation interactions.
+- `tests\*.assert.ts` and `tests\*.spec.ts`: interaction, visual, and runtime integration checks.
+After changing `src`, rebuild, test, and install from the local directory:
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
 pnpm build
 pnpm test
+dsh plugin --profile web add .
 ```
+New features should reuse existing DSH slots and public services. Do not depend on private host DOM or write conversation records.
 ## License
-This project is licensed under [Apache License 2.0](LICENSE). Conversation-management workflow is informed by [Semidia/dsh-session-manager](https://github.com/Semidia/dsh-session-manager), but this plugin is implemented independently through public DSH slots and services.
+This project is licensed under [Apache License 2.0](LICENSE).

package/README.zh-CN.md CHANGED Viewed

@@ -6,7 +6,7 @@
   # DSH Codex UI
-  **为 DeepSeek Harness Web 重构 Codex 风格侧栏、工作区会话树、全局搜索和轮次导航**
+  **让 DSH Web 中的项目更好整理、会话更快找到、长对话更易回看**
   [English](README.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
@@ -18,29 +18,26 @@
 </div>
-> DSH Codex UI 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。它只使用 DSH 公开插槽，不修改宿主源码或会话数据。
+> DSH Codex UI 是社区维护的 DeepSeek Harness（DSH）界面增强插件，并非 DeepSeek AI 官方产品。
-## 功能概览
+在 DSH Web 中同时处理多个项目和会话时，DSH Codex UI 帮你整理左侧导航、快速找到任务，并在长对话中跳回之前的提问。它提供 Codex 风格的界面，支持浅色和深色主题。
-- 通过官方 `sidebar` 插槽替换默认侧栏，并保留 `sidebar.workspaces`、`sidebar.settings` 和 `sidebar.footer.action`。
-- 提供 Codex 风格顶栏：品牌标识、侧栏折叠和全局搜索。
-- 工作区与会话支持展开折叠、拖拽排序、项目置顶、未读圆点和运行状态。
-- 项目和会话菜单支持重命名、置顶、未读、归档、派生、打开目录、复制和删除。
-- 调整会话列与输入卡片视觉，并为当前会话提供紧凑轮次导航。
-- 空输入框按上下键召回已提交文本，按工作区隔离并保护草稿、输入法和候选菜单；无需安装 BTW。
-- 在「设置 → 关于」展示配套插件状态，并可从 npm 安装缺失项。
+## 你可以用它做什么
-## 界面预览
-输入历史保存在浏览器 `michengai.codex-ui.input-history.v1`，每工作区最多 200 条、最多 20 个工作区，总序列化长度最多 100 万字符。首次使用可导入旧 BTW 历史，保留旧键用于回退；关闭浏览器存储时使用内存。BTW 插件现在只负责旁问气泡。
+- **整理项目与会话**：展开或折叠项目、拖拽调整顺序、置顶常用项目，查看未读提醒和运行状态。
+- **快速找到内容**：通过顶部搜索查找会话、设置和快捷操作。
+- **管理日常任务**：在项目或会话菜单中重命名、归档、派生会话，或打开项目目录。
+- **回看长对话**：点击轮次导航，直接跳到对应提问。
+- **复用之前的输入**：输入框为空时，按上下方向键找回当前工作区中已提交的文本。
+- **按需扩展功能**：在「设置 → 关于」查看配套插件，安装或更新需要的功能。
-普通消息仅从输入扩展挂载后的实时追加事件采集；打开、重载会话和加载旧消息不会回填历史，扩展未挂载期间的输入也不补录。
+## 界面预览
 浅色主题：Codex 风格侧栏、工作区会话树和会话列。
 ![浅色主题会话页](assets/screenshots/conversation-light.png)
-深色主题：同一布局，使用 Codex 暗色令牌。
+深色主题：适合偏好暗色界面的用户。
 ![深色主题会话页](assets/screenshots/conversation.png)
@@ -56,37 +53,36 @@
 - 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
 - 以下示例使用 `web` profile；请替换为实际目标 profile。
-- 从源码安装或二次开发需要 Node.js 22+ 与 pnpm；仅从 npm 安装无需在任意目录执行 `pnpm install`。
+- 运行环境需满足 Node.js `^22.19.0 || >=24.0.0`；从源码安装还需要 pnpm。
 ## DSH 产品生态
-Codex UI 既可以独立安装，也可以随桌面端一起使用。它们共享同一个 DSH 核心，但面向不同的使用方式：
+想直接使用完整工作台，可下载 [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases)；已有 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 环境，可按需独立安装以下 8 个自研插件。桌面端已随附这些插件。
-| 产品 | 与 Codex UI 的关系 |
+| 插件 | 你可以用它做什么 |
 | --- | --- |
-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | Codex UI 的运行宿主，提供模型、会话、工具和插件系统 |
-| [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop) | 下载安装即用的桌面产品，已内置 Codex UI 和其他 5 个功能产品 |
-| 6 个功能产品 | [Codex UI](https://github.com/MichengAI/dsh-codex-ui) · [IM Connect](https://github.com/MichengAI/dsh-im-connect) · [Automation](https://github.com/MichengAI/dsh-automation) · [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) · [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) · [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话、搜索任务、跳转对话轮次 |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 从微信、飞书、钉钉等消息平台下任务、收回复 |
+| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务，查看每次运行的结果 |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 统一查找、启停、创建和导入本机技能 |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复或清理已归档会话 |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 按任务选择并召唤专业角色 |
+| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问，不打断主任务 |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | 用 /simplify 整理 Git 改动范围内的代码 |
 ## 安装
-`dsh plugin add` 会转发到 profile 目录里的 `pnpm add`。不写版本、不指定官方源时，本机镜像和最短发布间隔可能让你停在旧版。
+下面提供 Agent 代装和手动安装两种方式，使用同一条安装命令。示例指定最新版和官方 npm 源。
-### 交给其他 Agent 一句话安装 Codex UI
+### 让 Agent 帮你安装（推荐）
-把下面这句话复制到 DSH、Codex 或 WorkBuddy，让它代你安装到本机 `web` profile。
+把下面这段话发给任意能够执行本机终端命令的 Agent。将 `web` 替换为实际使用的 profile；安装完成后，在 DSH 中使用本插件。
 ```text
-请把 DSH 插件 @michengai/dsh-codex-ui 最新版装进本机 web profile，使用官方 npm 源执行：dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/。装完执行 dsh --profile web --dump-config，确认已挂载 codex-ui，并提醒我重启 DSH Web 后硬刷新浏览器。
+请将 DSH 插件 @michengai/dsh-codex-ui 安装到本机 web profile，执行：dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/。安装后执行 dsh --profile web --dump-config，确认配置包含 codex-ui，并告诉我如何重新加载 DSH 和开始使用。
 ```
-| 产品 | 怎么用 |
-| --- | --- |
-| DSH | 把上面这句话发给当前会话。 |
-| Codex | 把上面这句话发给 Codex，让它在本机执行安装。 |
-| WorkBuddy | 把上面这句话发给 WorkBuddy。 |
-### 只安装 Codex UI
+### 手动安装
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -95,25 +91,7 @@ dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://r
 dsh --profile web --dump-config
 ```
-插件会通过 `cordis.patch.yml` 接管默认侧栏；卸载后默认侧栏会恢复。
-### 从源码安装
-适用于调试或使用未发布改动。克隆后的目录会直接作为插件安装路径：
-```powershell
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-$OutputEncoding = [System.Text.Encoding]::UTF8
-Set-Location D:\Repository\deepseek-harness-plugin
-git clone https://github.com/MichengAI/dsh-codex-ui.git
-Set-Location .\dsh-codex-ui
-pnpm install --frozen-lockfile
-pnpm build
-dsh plugin --profile web add .
-dsh --profile web --dump-config
-```
-完成后重启 DSH Web 并硬刷新浏览器。不要手工复制 `lib`；本地目录安装会同时读取包信息和 `cordis.patch.yml`。
+安装后重启 DSH Web，并硬刷新浏览器（通常为 `Ctrl+Shift+R`）。看到新的侧栏后即可开始使用；卸载插件会恢复默认侧栏。
 ## 使用
@@ -126,54 +104,67 @@ dsh --profile web --dump-config
 | 折叠侧栏 | 使用顶栏面板按钮。折叠后展开入口保留在窄轨顶部。 |
 | 置顶项目 | 拖到「置顶」区域，或在项目菜单中选择「置顶项目」。 |
 | 管理会话 | 打开会话菜单，进行重命名、置顶、未读、归档、派生、复制或删除。 |
+| 复用输入 | 输入框为空时按上下方向键，召回当前工作区中之前提交的文本。 |
 | 跳转轮次 | 使用当前会话左侧的轮次刻度跳转到对应提问。 |
 | 查看连接器 | 打开「设置 → 连接器」。不会展示地址、命令或凭证。 |
 | 查看配套插件 | 打开「设置 → 关于」，安装或更新各个配套插件。 |
-删除项目注册不会删除项目目录或会话记录。置顶和未读状态只保存在当前浏览器。
+## 常见问题
-## 持久化与安全边界
+### 置顶和未读状态会保留吗？
-| 数据 | 存储位置 | 范围 |
-| --- | --- | --- |
-| 置顶项目 | Host Profile 文件，并使用 `localStorage` 缓存 | DSH 重启及 Desktop 托盘重新加载后仍保留 |
-| 未读会话 | `localStorage` 键 `dsh.session-unread.v1` | 仅当前浏览器 |
-| 会话记录 | DSH 宿主服务 | 本插件不改写 |
+置顶项目保存在 DSH 配置中，重启后仍保留。未读标记仅保存在当前浏览器，不会跨浏览器同步。
-- 本插件只使用 DSH 公开插槽和服务。
-- 不修改宿主源码或会话数据模型。
-- 归档会话的永久删除由 `@michengai/dsh-archive-manager` 提供。
-- 连接器目录不会展示地址、命令或凭证。
+### 为什么找不到以前的输入？
-## 二次开发
+输入历史按工作区分别保存在当前浏览器，每个工作区最多保留 200 条。它从功能启用后的新输入开始记录，不会从已有会话补录；浏览器存储不可用时，仅在内存中临时保留。无需额外安装 BTW 插件。
-- [src\index.ts](src/index.ts)：Host 入口，以及不含敏感信息的连接器目录接口。
-- [src\client\index.ts](src/client/index.ts)：客户端入口，注册侧栏、工作区树、轮次导航和设置分区。
-- [src\client\CodexSidebar.tsx](src/client/CodexSidebar.tsx)：侧栏壳、搜索面板和视觉样式。
-- [src\client\CodexWorkspaceBrowser.tsx](src/client/CodexWorkspaceBrowser.tsx)：工作区和会话交互。
-- `tests\*.assert.ts` 与 `tests\*.spec.ts`：交互、样式和运行时集成验证。
+### 移除项目会删除本地文件吗？
-修改 `src` 后重新构建、测试，并以本地目录安装验证：
+删除项目注册不会删除项目目录或会话记录。归档会话的永久删除功能由配套的 Archive Manager 插件提供。
+### 安装后没有看到变化怎么办？
+确认安装命令中的 profile 与正在运行的 DSH Web 一致，再重启 DSH Web 并硬刷新浏览器。可运行 `dsh --profile web --dump-config` 检查是否已挂载 `codex-ui`。
+## 开发与贡献
+### 从源码安装
+适用于调试或使用未发布改动。克隆后的目录会直接作为插件安装路径：
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-codex-ui.git
+Set-Location .\dsh-codex-ui
+pnpm install --frozen-lockfile
 pnpm build
-pnpm test
 dsh plugin --profile web add .
+dsh --profile web --dump-config
 ```
-新增功能应复用已有 DSH 插槽和公开服务；不要依赖宿主私有 DOM 或写入会话数据。
+完成后重启 DSH Web 并硬刷新浏览器。不要手工复制 `lib`；本地目录安装会同时读取包信息和 `cordis.patch.yml`。
-## 验证
+- [src\index.ts](src/index.ts)：Host 入口，以及不含敏感信息的连接器目录接口。
+- [src\client\index.ts](src/client/index.ts)：客户端入口，注册侧栏、工作区树、轮次导航和设置分区。
+- [src\client\CodexSidebar.tsx](src/client/CodexSidebar.tsx)：侧栏壳、搜索面板和视觉样式。
+- [src\client\CodexWorkspaceBrowser.tsx](src/client/CodexWorkspaceBrowser.tsx)：工作区和会话交互。
+- `tests\*.assert.ts` 与 `tests\*.spec.ts`：交互、样式和运行时集成验证。
+修改 `src` 后重新构建、测试，并以本地目录安装验证：
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
 pnpm build
 pnpm test
+dsh plugin --profile web add .
 ```
+新增功能应复用已有 DSH 插槽和公开服务；不要依赖宿主私有 DOM 或写入会话数据。
 ## 许可证
-本项目采用 [Apache License 2.0](LICENSE)。会话管理工作流参考 [Semidia/dsh-session-manager](https://github.com/Semidia/dsh-session-manager)，但本插件独立通过 DSH 公开插槽和服务实现。
+本项目采用 [Apache License 2.0](LICENSE)。

package/cordis.patch.yml CHANGED Viewed

@@ -1,6 +1,8 @@
-# 由本插件接管 sidebar 的子插槽声明，原设置面板仍通过 sidebar.settings 挂载。
+# 由本插件统一声明侧栏和设置子插槽，避免与原壳重复声明。
 - id: ui-sidebar
   disabled: true
+- id: ui-settings-general
+  disabled: true
 - insert:
     - id: codex-ui
       name: '@michengai/dsh-codex-ui'