@xinxing1708/dsh-codex-style

dsh plugin --profile web add @xinxing1708/dsh-codex-style

DSH Codex Style

为 DeepSeek Harness（DSH） 提供 Codex 桌面端风格的深浅色主题。在 DSH 外观设置选择浅色或深色即可切换；选择跟随系统时，主题也跟随系统变化。

当前版本 0.2.5。兼容范围为 >=0.2.1-rc.2 <0.3.0-0：0.2.1-rc.2 起、0.3.0 之前的全部 0.2.x（含预发布）允许安装和加载；0.3.0 及更高版本拒绝。

范围内允许加载，不等于该版本的原生界面已经实测：新的 0.2.x 仍可能带来界面变化，升级后如遇布局或控件异常，按「更新与恢复」处理。本版在 DSH 0.2.2-rc.1 宿主资源下完成相关自动检查与原生组件隔离验证，新增主题及边角已安装到作者本机试用确认；其他 0.2.x 未逐版实机复测。

功能

0.2.5 新增随 DSH 浅色、深色和系统设置切换的主题，图片批注 UI 同步适配；更新新版 Codex 深色配色、输入框等待环及外框圆角，并修复回合收起后过程自述残留。正文效果、顶部重绘现并入主界面，取消这两个独立开关；旧版保存的关闭状态不再控制它们，其余可选子模块的默认值和已有选择保留。

• 主题界面（主模块）：Codex 风格的导航、可收起侧栏和输入区，支持项目/会话搜索与管理、模型和权限选择、思考强度滑条与 MAX 动效、会话运行/完成提示，以及齿轮菜单中宿主公开第三方入口（如 Remote）的独立分组呈现。浅色采用白色主区、输入框和浮层，权限保留暖色，白色思考滑块加蓝边；深色保留现有配色。图片批注界面同步切换，图片与手绘颜色保持原色。自研插件检查/下载/安装已退役，插件版本更新改用 DSH 原生插件市场/插件页；DSH 有新版时，左下角齿轮上方仍显示蓝色本体更新按钮，悬停可看下载进度，下载和安装由 DSH 完成。保留 DSH 原生编辑器、附件、工具调用与审批流程。

• Codex 风格工作规范（可选子模块，默认关闭）：额外加入工作规范提示词，引导模型明确任务边界、减少额外改动、区分审查与执行、持续中文沟通并按证据交付。用户原有的 AGENTS.md 继续生效，不会被替换或改写；实际效果取决于模型遵循。

开关支持热生效，作用于后续模型请求；如 DSH 提示需要重启，请重启后使用。关闭不会撤回已发送到模型的提示词，也不会回滚同一对话已产生的内容；正在进行的请求不受影响，切换后建议新建对话。

• Codex 正文效果（主模块内置）：显示每轮顶部「已处理」耗时和分割线，增加操作流光、步骤展开动效及铅笔、终端和图像图标；展开箭头悬停时显示。正文流式输出按段落顺序平滑揭示，不再整段突然出现，流结束时按固定速率补齐；引用、复杂列表和含行内标记的段落改为整块淡入。思考不显示前导图标，实时思考内容隐藏，完成后仍可展开查看。成功完成的回合收起时，过程自述随工具和思考一起隐藏，最终回答保留，展开后恢复。随主模块启停，无独立开关。

• Codex 顶部重绘（主模块内置）：会话顶部采用标题与右侧工具在上、模式/智能体/后台任务与视图切换在下的布局；「对话 / 轨迹」以及宿主 conversation.view 注册的第三方视图共用白色滑块胶囊。胶囊按 header 可用宽度自然增减，放不下的固定项进入宿主「更多会话视图」，长标签省略；窄窗时胶囊可独立一行，不覆盖左侧按钮。保留宿主的注册、排序、固定/取消固定、选中与卸载语义，更多视图使用四格图标。随主模块启停，无独立开关。第三方接入说明见仓库开发文档 codex-style/docs/conversation-view-integration.md。

• 页面前进后退（可选子模块，默认开启）：在窗口左上角增加后退、前进按钮，按本次运行的内存历史切换最近打开的会话与全局面板，支持 Ctrl+[ / Ctrl+]。这不是 DSH 原生能力：历史只在本次运行内存中，重启后清空，不恢复设置弹窗、页面内部状态或滚动位置。与顶部重绘、正文效果独立，需同时开启主模块；关闭后移除按钮与快捷键，原有侧栏切换按钮恢复原位。

• 图片批注（可选子模块，默认开启）：点击待发或正文图片打开大预览，支持点评论、编辑/删除和手绘标注。「完成批注」保存并返回正文；图片旁的「N 条批注 ×」胶囊可重开或清除本图评论。批注随图片进入模型请求，坐标文本不占用正文或编辑器；历史图片批注加入下一次草稿，不自动发送。需同时开启主模块，关闭后恢复原生图片界面。

• 技能页（自定义 → 技能，主模块内）：只读展示当前会话作用范围下的 DSH 技能，按来源分组，支持搜索、刷新、展开全部和详情正文预览；可打开技能文件、在资源管理器中显示或复制 Markdown。 「立即试用」会新建对话并填入 /技能名 草稿，不自动发送；没有真实文件路径的技能不显示打开/定位项，也不提供技能启停、卸载或在线安装。

在「自定义 → 插件 → 本插件详情 → 包含的组件」可分别管理工作规范、页面前进后退和图片批注；正文效果与顶部重绘不再列为独立组件。可选子模块的默认开关以本包 cordis.patch.yml 为准，升级时保留用户已经保存的选择。旧 /body、/header 空入口仅作兼容保留，不再控制呈现。

安装

在 DSH「自定义 → 插件 → 添加插件」中输入 @xinxing1708/dsh-codex-style；也可从 发行页面 下载 Windows ZIP，退出 DSH 后运行 install.cmd（需要 Node.js 20+），完成后重新启动 DSH。

版本准入与宿主同语义、不同实现：宿主用 semver.satisfies(version, engines.dsh, { includePrerelease: true }) 判定，而安装器运行在用户机器上，拿不到宿主 app.asar 里的 semver，因此内置一个只覆盖本插件声明所需写法的严格范围比较器（>= 下界、< 上界、|| 精确列表）。遇到 ^、~、<=、>、* 等未支持写法会直接报错，不会静默放行。自动测试会用宿主 app.asar 内的真实 semver 逐版本对照安装器判定，避免两套逻辑漂移。

插件版本更新改用 DSH 原生插件市场/插件页；当前 link: 安装不显示宿主原生版本区，日常 profile 不迁移，由用户后续按市场「换用线上版本」流程处理。源码构建运行 npm run build，版本变更见 [更新记录](CHANGELOG.md)。

检测到 DSH Desktop 社区版时，install.cmd 会说明它不是 DeepSeek 官方版、效果可能一般；真实 runtime 符合支持版本时可在警告后继续安装，版本准入不放宽。安装记录仅保存宿主路径和版本等环境信息，用于区分实际运行的官方版与社区版。社区版中主插件每次激活会在右下角提醒一次，6 秒后自动消失；官方版不提醒，子组件开关不单独提醒。社区版的完整界面兼容性尚未实机验证。

更新与恢复

已用 registry 规格安装（profile 里记录版本号，如 0.2.4）：插件即使被宿主判为不兼容而暂时禁用，仍可在「自定义 → 插件 → 本插件详情」用宿主自带的检查/安装入口升级。前提是已经存在兼容当前 DSH 的新版本——发布方把当前 DSH 版本纳入 engines.dsh 并发布。这条路径不依赖插件自己的界面。

当前是 link: 本地安装（开发工作区或本机链接安装）：在插件市场「已安装」列表里找到该条目，打开 ··· 菜单 →「换用线上版本」。注意这是更换安装来源（把本地链接换成 npm 版本），不是普通版本更新：安装前先备份 profile 的 package.json 与 pnpm-lock.yaml，~/.dsh/dsh-codex-style/ 下的旧版本目录保留，便于回滚。

自研「检查更新 / 立即安装」已退役：插件更新统一走 DSH 原生插件市场/插件页，宿主是否加载本插件客户端不影响更新入口；DSH 本体更新仍由齿轮上方蓝圆入口转交宿主。

安装失败后，宿主只保证 profile 的 package.json、锁文件等文件层面回到可用状态，不保证 node_modules 完整回滚。回滚后请核对插件是否仍为原版本、能否正常加载，再决定重试。

效果预览

新对话首页效果<img width="1911" height="1224" alt="image" src="https://github.com/user-attachments/assets/690fd8cb-3973-46f5-a3a8-46d516b98379" />

搭配提示词注入后的deepseek v4.1 flash 1017任务过程效果<img width="1918" height="1222" alt="image" src="https://github.com/user-attachments/assets/23d6e604-c6ef-4c00-b2d5-d81b1995bbfb" />

codex正文风格打开后样式<img width="1910" height="1222" alt="image" src="https://github.com/user-attachments/assets/0f40145d-87f9-4e9b-8317-e56caa4d7561" />

侧边栏收起后鼠标悬停在导航栏图标时悬浮卡片效果<img width="1905" height="1224" alt="image" src="https://github.com/user-attachments/assets/86a2e1a6-2e4b-4cd3-ab8a-68791cf1d16c" />

模型思考强度选择效果<img width="1909" height="1215" alt="image" src="https://github.com/user-attachments/assets/191614b4-3716-4213-bb94-1c18ae919b5f" />

<img width="1899" height="1222" alt="image" src="https://github.com/user-attachments/assets/d70dd2c6-d8a5-4838-854a-87e5a72bc247" />

可选的图片批注功能，打开后，在聊天框内复制粘贴图片后，单击图片，可以发送批注<img width="1903" height="1216" alt="image" src="https://github.com/user-attachments/assets/25d7205a-87e7-493c-8f43-599358a4c028" />

<img width="1905" height="1214" alt="image" src="https://github.com/user-attachments/assets/41ea7c4f-0dea-4d09-a2ef-dcafb9b5908e" />

开发验证

首次检出运行 npm ci，修改源码后执行 npm run build，再运行 npm test。测试使用临时 profile 检查安装、更新和回退，不改日常 DSH 配置。

发布前检查

• 确认 npm latest 的 engines.dsh 覆盖当前主推的 DSH 版本。
• 范围内（0.2.x，含预发布）新增版本不需要逐版改 engines 重发；0.3 线属于范围外，先在开发树核对适配、把上限调整到新的 0.3.x 范围并重发，再让用户升级到该大版本。
• 范围只表示「允许加载」，不表示每个版本都已实测；实际界面行为按 DSH 版本验证后记录到 [更新记录](CHANGELOG.md)。

许可与致谢

自研代码使用 [MIT License](LICENSE)。感谢项目贡献者及 yuehuawu416-cmyk 的修复，品牌素材说明见 [第三方说明](THIRD_PARTY_NOTICES.md)。

本项目为社区独立插件，与 OpenAI 或 DeepSeek 无关联，未获其赞助或背书。