YLingHao/dsh-codeui

dsh-codeui（代码 UI）

DeepSeek Harness 代码审阅工作台：每一轮对话结束都会生成一份可点击的 Review 卡片；右侧 Review 面板按轮查看文件差异，右侧轮次轨道负责对话跳转，像看 GitHub PR 一样审阅 AI 修改的代码。

一个用于 DeepSeek Harness 的代码审阅工作台：每一轮结束时都会生成一张可点击的 Review 卡片，右侧 Review 面板显示每轮的差异，轮次轨道可跳回确切的对话——像审阅 GitHub PR 一样审阅 AI 代码变更。

中文

项目简介

dsh-codeui（内部名 codeui）是 DeepSeek Harness 的 Cordis UI 插件，当前以静态 npm 包为主要安装与维护形态。它不重做主对话窗口，而是补齐代码审阅场景的完整链路：

- 工作区资源管理器：文件树 + 只读 Git 状态标记（M / A / D / R / U / !）、分支、领先/落后信息。
- 右侧 Review 面板：默认单栏（统一）diff，双栏保留；统一视图默认只显示修改块和前后 3 行上下文，点击“统一”可切换完整文件；支持改前 / 改后 / 当前三种视图、累计 patch 导出；面板左边界可拖动，宽度范围 20%–60%（默认 42%），右边界紧贴窗口右缘。
- 接近 IDE 的代码显示：Review 使用完整文件行号，统一视图只有一列行号；新增 / 删除行使用 Codex 风格的绿色 / 红色背景和左侧深色竖条，并提供 VS Code 风格的常用语法高亮。
- Review 内编辑：点击“编辑”可直接修改当前磁盘文件；编辑器保留行号和语法高亮，600ms 自动保存，失焦保存，支持 Ctrl+S / Cmd+S 立即保存。保存请求绑定当前工作区，并使用版本令牌防止覆盖其他程序或 AI 的并发修改。
- 每轮结尾 Review 卡片：位于每轮产物列表下方，显示 Edited N files、总增删行数、文件路径和每个文件的 +/-；默认展开两行文件，可悬停滚动查看全部；点击文件直接打开对应 Review 面板。
- 右侧轮次轨道：细/粗横线交替表示轮次；悬停提问行弹出该轮文件详情卡（轮次、状态、文件详情、文件数量、任务时长，默认显示 3 个文件并带滚动条）；点击文件打开 Review 面板；点击轮次则跳转对话。对话跳转只由轨道触发，Review 面板中的轮次选择不会滚动对话。

功能亮点

- 捕获 write、edit、str_replace_editor（create / str_replace / insert）。
- Host 会扫描完整持久化会话日志，为未加载的历史轮次也提供文件修改详情。
- 历史轮次使用完整操作集合重建改前 / 改后快照；大段删除再生成的内容会用稳定锚点对齐，减少虚假的整段 +/-。
- 卡片和 Review 面板使用同一份重建结果统计增删行数；没有实际变更的文件不会再显示为 +0 -0。
- 点击未加载轮次时自动向上滚动对话、自动点击“加载更早”，直到目标轮次进入当前窗口后定位高亮。
- Review 面板与轨道共享全量轮次历史；轮次选择器始终显示所有轮次。
- 设置项持久化到 localStorage：资源管理器、Review 面板、Git 标记、插件语言。
- 全部 Git 操作只读：不写入、不提交、不切换分支。
- 编辑写入只允许当前工作区范围；工作区外路径会被拒绝，文件版本过期时要求重新载入。

安装（静态插件，推荐）

本仓库按 npm 包规范组织，包名为 dsh-codeui。以下命令直接从 GitHub 安装，无需先注册或发布 npm；只有希望用户执行 npm install dsh-codeui（短名安装）时才需要发布到 npm registry。

第 1 步：安装包

dsh plugin --profile web add github:YLingHao/dsh-codeui

或手动安装：

cd "$DSH_HOME/profiles/web"
pnpm add github:YLingHao/dsh-codeui

第 2 步：注册插件（二选一）

方式 A：作为 bundle 注册（本仓库自带 cordis.patch.yml）

编辑 $DSH_HOME/profiles/web/package.json，在 dsh.profile.bundles 末尾加入 dsh-codeui：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-codeui"
]
}
}
}

方式 B：写入 patch 层

编辑 $DSH_HOME/profiles/web/cordis.patch.yml（或全局 $DSH_HOME/cordis.patch.yml）：

- insert:
- id: codeui
name: 'dsh-codeui'

第 3 步：重启

dsh web

浏览器打开后建议 Ctrl+F5 强刷。已安装 dsh-market 的用户，可在 GitHub 仓库添加 dsh-plugin Topic 后从市场搜索安装。

安装（动态 Cordis 插件）

动态安装保留为兼容方式，适合不能使用 npm 包的环境：

1. 在 DeepSeek Harness 中使用 cordis_define 新建插件：kind: "new"，idPrefix: "codeui"。
2. code.host 填入 host.js，code.client 填入 client.js。
3. 在界面批准运行（单勾 = 本次版本，双勾 = 未来版本自动放行）。

注意：本项目当前以静态插件为主要维护线；动态版保留可用，但最新 UI 细节以静态版 lib/ 为准。

使用

- 左下角 📁 切换资源管理器。
- 每轮对话结束后，在产物列表下方查看 Review 卡片；点击文件或 Review 打开右侧面板。
- Review 面板默认统一视图；“统一”按钮在分段控件最左侧；切换轮次只更新面板，不跳转对话。
- 统一视图默认是 Codex 风格简略 diff（修改块前后各 3 行上下文）；再次点击“统一”在简略和完整文件之间切换。点击“编辑”进入当前文件编辑模式，修改后会自动保存。
- 编辑器出现“文件已被其他程序或智能体修改”时，请点击“重新载入”后再继续；出现工作区范围错误时，请先在当前会话选择正确的工作区。
- 右侧轨道悬停提问行查看文件详情卡；点击轮次跳转对话。
- 设置 → Code UI：资源管理器、Review 面板、Git 标记、插件语言；设置自动保存。

Git 权限说明

git rev-parse --show-toplevel
git -c core.quotepath=false -c diff.renames=false status --porcelain=v1 -z --branch
git -c core.quotepath=false diff --no-ext-diff --unified=3 HEAD -- .

Git 不可用时自动降级：隐藏 Git 标记，patch 导出显示提示。

文件结构

dsh-codeui/
├── package.json        # npm 包清单（dsh.client / dsh.bundle.patch）
├── cordis.patch.yml    # bundle 自注册 patch
├── index.js            # 动态插件包清单
├── host.js             # 动态 Host 半边（function body）
├── client.js           # 动态 Client 半边（function body）
├── lib/
│   ├── index.js        # 静态 Host：/codeui/api/* + 全量轮次/文件历史
│   └── client.js       # 静态 Client bundle
├── README.md
└── LICENSE

设计边界

- 主对话窗口、工具调用与批准日志由 harness 提供，插件不重复实现。
- 每轮快照优先由会话日志中的编辑工具参数重建；Host 的全量历史统计保证未加载轮次也有文件详情。
- 全量 Git 快照、代码标记/留言、AI 辅助审查属于后续计划。

English

Introduction

dsh-codeui (plugin id codeui) is a Cordis UI plugin for DeepSeek Harness, maintained primarily as a static npm package. It keeps the native chat untouched and adds a complete code-review loop:

- Workspace explorer — file tree with read-only Git badges, branch and ahead/behind info.
- Right-side Review panel — unified diff by default with split view available; unified view starts in a Codex-style compact mode showing changed blocks plus three context lines, and clicking Unified toggles the complete file. It also provides before / after / current modes, cumulative patch export, and a draggable left edge (20%–60%, default 42%) flush with the window's right edge.
- IDE-like code rendering — full-file line numbers are preserved, unified view uses one gutter, and added/deleted rows use Codex-style green/red backgrounds with a darker leading bar. Common source formats receive VS Code-style syntax coloring.
- In-panel editing — click Edit to modify the current disk file directly. The editor keeps line numbers and syntax coloring, autosaves after 600ms, saves on blur, and supports Ctrl+S / Cmd+S. Writes are bound to the active workspace and guarded by a file-version token so an external IDE or agent change cannot be overwritten silently.
- Turn-end Review card — rendered under each turn's produced-files list with Edited N files, total +/- lines, file paths and per-file stats; scroll inside the card to browse all files, click one to open the Review panel.
- 右转轨 — 每轮交替显示细/粗条；悬停在问题行上会打开文件详情卡片（轮次、状态、文件、文件数、时长，并带有可见的滚动条）；点击某一轮次会跳转到对话。只有该轨会跳转对话——Review 面板的轮次选择器从不滚动聊天。

亮点

- 捕获 write、edit 和 str_replace_editor（create / str_replace / insert）。
- 宿主会扫描完整的持久化会话日志，因此即使是未加载的较早轮次也拥有文件变更详情。
- 历史轮次会根据完整的有序操作集重建；稳定锚点可减少当代理用大部分相同的内容替换大段内容时出现的误报“全部删除/全部添加”块。
- 卡片和 Review 面板共享相同的重建快照和行统计信息，没有实际变更的文件会被省略，而不是显示 +0 -0。
- 点击未加载的轮次会自动滚动聊天，自动点击“加载更早”，然后跳转并高亮目标问题。
- 完整轮次历史在 Review 面板和该轨之间共享。
- 设置持久化在 localStorage 中：资源管理器、Review 面板、Git 徽章和语言。
- Git 访问严格为只读。
- 文件编辑仅限于选定的工作区；外部路径会被拒绝，过期的文件版本需要重新加载后才能保存。

安装（静态包，推荐）

此仓库组织为一个名为 dsh-codeui 的 npm 包。以下命令直接从 GitHub 安装它——无需发布到 npm。只有在使用短名称 npm install dsh-codeui 时才需要发布。

第 1 步：安装

dsh plugin --profile web add github:YLingHao/dsh-codeui

或者：

cd "$DSH_HOME/profiles/web"
pnpm add github:YLingHao/dsh-codeui

第 2 步：注册（任选其一）

选项 A：bundle（使用此仓库的 cordis.patch.yml）

将 dsh-codeui 添加到 $DSH_HOME/profiles/web/package.json 中的 dsh.profile.bundles：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-codeui"
]
}
}
}

选项 B：patch 层

编辑 $DSH_HOME/profiles/web/cordis.patch.yml（或全局的 $DSH_HOME/cordis.patch.yml）：

- insert:
- id: codeui
name: 'dsh-codeui'

第 3 步：重启

dsh web

硬刷新浏览器（Ctrl+F5）。安装 dsh-market 后，添加 GitHub 主题 dsh-plugin 以便在市场中显示。

安装（动态 Cordis 插件）

为兼容性保留：

1. 在 DeepSeek Harness 中，使用 cordis_define 创建插件：kind: "new"，idPrefix: "codeui"。
2. 将 code.host 设置为 host.js，将 code.client 设置为 client.js。
3. 在 UI 中批准运行。

静态包是主要维护线；动态分发仍可使用，但可能落后于最新的 lib/ UI。

用法

- 使用 📁 按钮切换资源管理器。
- 每轮结束后，使用生成文件列表下方的 Review 卡片；点击文件或 Review 打开右侧面板。
- Review 面板默认使用统一视图（“Unified”是第一个分段按钮）；切换轮次只会更新面板。
- 统一视图初始为紧凑模式，显示每处更改及三行未更改的上下文。再次点击 Unified 可在紧凑模式和全文件模式之间切换。点击 Edit 可修改当前文件并自动保存。
- 如果编辑器报告文件已在其他地方更改，请先点击 Reload 再继续。如果报告工作区边界错误，请为当前会话选择正确的工作区。
- 将鼠标悬停在侧边栏的问题行上可查看该轮的文件；点击该轮可跳转到对话中的对应位置。
- Settings → Code UI：资源管理器、Review 面板、Git 徽章和语言。更改会自动保存。

Git 命令（只读）

git rev-parse --show-toplevel
git -c core.quotepath=false -c diff.renames=false status --porcelain=v1 -z --branch
git -c core.quotepath=false diff --no-ext-diff --unified=3 HEAD -- .

当 Git 不可用时，该插件会静默降级。

仓库布局

dsh-codeui/
├── package.json        # npm manifest (dsh.client / dsh.bundle.patch)
├── cordis.patch.yml    # bundle self-registration patch
├── index.js            # dynamic plugin package manifest
├── host.js             # dynamic host half (function body)
├── client.js           # dynamic client half (function body)
├── lib/
│   ├── index.js        # static host: /codeui/api/* + full turn/file history
│   └── client.js       # static client bundle
├── README.md
└── LICENSE

范围

原生对话、工具调用日志和审批 UI 保留在 harness 中。轮次快照根据编辑工具参数重建，并针对未加载的轮次在宿主侧提供完整历史摘要。完整的 Git 级快照、行内评论和 AI 辅助审查属于未来工作。

许可证

MIT