Oh My DSH 使用与开发指南#

文档目录 · 首次使用 · 安装 · 更新与卸载 · 设置 · 排障 · 开发与验证

当前 0.2.1-alpha.1.omd.0.5.2 适配 DSH 0.2.1-alpha.1，内置 OpenCU 1.2.1。旧宿主 DSH 0.1.6-alpha.2 请继续使用 OMD 1.6.1。本页保留安装、操作、配置与使用边界的详细说明。GitHub 项目名为 oh-my-dsh；插件 ID trisoul_x、Agent preset trisoul-x 和原数据目录保持兼容。

本项目通过 gulagala001/oh-my-dsh 的 GitHub 来源或发行包安装。安装来源核对。

自己安装可选官方桌面版：下载与完整安装步骤或Web 安装。也可将 AI 安装手册的网址 发给能操作电脑或终端的 AI，说明要安装桌面版还是 Web 版，让它按手册完成安装／升级。

从旧版 DSH Web 切换到桌面并保留数据时，按迁移专节接入实际数据目录、安装插件并核对 profile 配置；安装 OMD 不会自动完成整套环境搬迁。

安装到现有 DSH（推荐）#

首次安装桌面应用请先看桌面版完整教程。 新版官方桌面包尚待发布，桌面用户继续使用 rc.2 的固定配对版本；下列命令适用于 DSH 0.2.1-alpha.1 的 Web／源码环境。桌面与 Web 共享实际 DSH_HOME 中的产品数据，但插件属于各自 profile；单独安装的 npm/npx CLI 不能管理保留的 desktop profile。本版验证范围。

桌面安装、更新、启用或停用后，先等任务结束，再完整退出应用并重新打开；有「重启应用与 Host」菜单时也可使用。仅关闭窗口会留在后台，仅刷新页面不能完成切换。

本预览版和源码运行均使用 DSH 0.2.1-alpha.1。以下 Web／源码安装需要 Node.js ≥22.19、pnpm 11.23.0 和 Git。Windows 使用 PowerShell 7（pwsh），无需 WSL；Python 验证文件需要另有 Python，.sh 文件需要 Bash。

已有环境先等待任务结束，停止当前 DSH Web 并完整备份实际 DSH_HOME。确认继续使用原数据目录、profile 和端口，再运行：

npx --yes @deepseek-ai/dsh@0.2.1-alpha.1 plugin --profile web add github:gulagala001/oh-my-dsh#v0.2.1-alpha.1.omd.0.5.2

然后按原来的方式重新启动 DSH，例如：

npx --yes @deepseek-ai/dsh@0.2.1-alpha.1 --profile web

打开这次启动打印的登录链接，继续使用原来的 3080（或自己配置的端口）。输入区会出现 工作台 和 电脑 入口，右侧工作台集中显示任务、上下文、摘要、电脑与监控；新建会话选择 Oh My DSH（Agent preset ID：trisoul-x）。已有模型和凭据沿用宿主配置，已有会话保持各自的 Agent preset。

如果原服务用了自定义 profile，把命令中的 web 替换为其名称；如果设置了 DSH_HOME，安装时必须使用同一个值。无需克隆仓库、手动构建或另外运行 pnpm start。

插件会将该 profile 的默认 Agent preset 设为 trisoul-x，并应用完整文件/命令访问、关闭执行审批的运行配置；profile 自己的覆盖配置优先于插件。

npx --yes @deepseek-ai/dsh@0.2.1-alpha.1 plugin --profile web remove trisoul_x

本地开发或独立试用#

需要 Node.js ≥22.19、Git 和 pnpm 11.23.0。推荐使用 Node.js 24。尚未安装 pnpm 时，可运行 npm install -g pnpm@11.23.0。

git clone https://github.com/gulagala001/oh-my-dsh.git
cd oh-my-dsh
pnpm install --frozen-lockfile
pnpm build
pnpm start

1. 首次启动会创建独立的 trisoul-x profile，并安装本地插件。
2. 打开终端打印的完整登录链接。默认端口为 3083。
3. 在 DSH 的模型设置中添加自己的提供方、模型和凭据，在对话中选好模型。
4. 创建会话并选择工作目录；首次发送消息前，在输入区工具行选择记忆范围。
5. 通过“设置 → Oh My DSH”调整后台模型与工作频率。

模型需要支持原生工具调用。仓库不附带模型账号、密钥、私人会话或记忆数据。模型的上下文窗口、输出上限和思考选项应按对应提供方的实际能力配置。

提供独立 omd-ptc 预设。新建会话时选择它，即可保留 OMD 的主提示词、记忆与压缩、任务验证、CodeGraph、电脑操控、技能和子代理，同时通过 run_code 使用工具。两个 OMD 预设共用设置，按原记忆范围规则共享项目资料；任务和会话记录仍各自独立。默认预设保持 Oh My DSH，宿主自带的 PTC 模式也保留。

开发时只修改 presets/trisoul-x/agent.cordis.yml 的通用能力清单；pnpm build 会生成 omd-ptc 的组合文件并追加 PTC 展示插件。

omd-ptc 的工具 SDK 跟随实际运行时生成，按声明读取结构化返回值，并显式输出下一步需要的信息；原生工具说明、计划提交与程序内调用方式分别适配。Computer Use 自己的 JavaScript 环境与外层 PTC 程序相互独立。

前台启动后，按 Ctrl+C 停止。macOS/Linux 可通过环境变量改变端口或数据目录：

PORT=3090 pnpm start
DSH_HOME=/absolute/path/to/x-data pnpm start

Windows PowerShell 可用 $env:PORT = '3090' 或 $env:DSH_HOME = 'C:\x-data' 设置环境变量，再运行 pnpm start。

dsh plugin --profile YOUR_PROFILE add link:/absolute/path/to/oh-my-dsh

node scripts/launch-macos.mjs

界面与入口#

采用 DSH 与 Codex 的融合风格：中性色界面、蓝色强调、紧凑工具栏，统一浅色／深色主题和窄窗布局。保留 DSH 的会话、项目、模型与文件功能，Oh My DSH 的常用入口集中在输入区下方。

设置 → 推荐插件 展示第三方插件的用途、作者与项目链接。支持标准 DSH 插件包的项目可直接安装、更新和卸载；操作由当前 profile 的宿主插件管理器执行，页面显示版本、进度、失败原因和待重启状态。

自动更新默认关闭。开启后，DSH 运行期间约每 6 小时在会话空闲时检查，只更新推荐列表中已安装且启用、支持标准安装的核验发行包；源码快照需手动更新。不会自动安装其他推荐插件，也不会自行重启 DSH。关闭开关会停止后续自动检查，已经开始的包操作会继续完成。脚本授权沿用宿主管理器规则，不会自动批准。

推荐页的「提交插件 / 申请适配」只需仓库地址和一句用途，作者或普通用户均可投稿。AI 按需批量处理、维护者一次确认；投稿与兼容说明。已核验条目固定安装核验版本，未经复核的旧推荐保留手动安装，但不自动更新。

当前推荐 dsh-status-rotator、DSH × Blender 与小鲸鱼记账挂件。小鲸鱼使用 DSH Web 产品线的 npm 包 dsh-whale-widget。Blender 项目当前使用开发注入方式，尚未声明标准插件包安装清单，需按其项目说明配置 Blender 与连接插件；推荐页会明确标注这一限制。

鲸鱼图标保留 DSH 的原有轮廓，加入冰蓝渐变与玻璃高光。悬停时摆尾，当前会话运行时显示旋转光轨，结束或切换到空闲会话后静止。动效复用宿主会话状态，不增加模型或后台请求；系统启用“减少动态效果”时保留静态图标与状态提示。

工作台的五个页面复用同一个侧栏标签，切换时保留未保存的编辑。连续 Computer Use 操作默认折叠，截图按需展开；详细用量默认收起。上下文记录展开后可查看来源和原文，完整执行过程也可在「轨迹」中查看。

本版调整了右侧工作台的导航、标题与内容间距：任务状态和完成数集中在页头，窄栏仍显示全部五个入口。「记忆」中的长内容可展开、收起，使用页面的主滚动区阅读，避免在卡片内外来回滚动。Codex 外观下，右栏使用标题栏下方的可用高度，减少底部留空造成的额外滚动。查看记忆来源时进入独立阅读区，顶部可返回，Escape 逐层返回并保留阅读位置；错误保持可见，迟到结果不会抢走对话输入焦点。

状态、后台任务与阻塞处理#

在 设置 → Oh My DSH → 实验性功能 中配置“向模型提供运行状态”或“优化后台任务与等待”。运行状态和预算提示默认关闭，后台优化默认开启；同页的 CoT 前置默认开启，CFR 默认关闭。保存后从下一次模型请求生效，已有会话也可使用。Todo 遇到阻塞可暂停本回合催促，不会误勾选任务；新回合恢复检查。完整说明与调用示例。

日常使用#

提示词优化#

输入框星星默认显示；“设置 → 提示词优化”可隐藏入口。悬浮星星或点击旁边的展开按钮打开抽屉，选择轻润色、结构化或步骤规划，首次优化前即可在“额外要求”填写条件，或选择已保存的要求预设，再点击“开始优化”回填当前草稿。额外要求也用于后续优化与自动轻润色；留空保持原行为。版本列表支持撤销、重做和恢复原稿，补充要求后可继续优化。

点击星星或开启“每次发送前自动润色”后，星星使用当前主题的强调色点亮。点击发送或使用宿主的 Enter 发送快捷键时，先按固定最低档“轻润色”处理，再自动交给宿主发送；不受手动模式影响。再次点击星星关闭。该选项默认关闭，每次润色额外调用一次当前会话模型，使用现有模型凭据，用量在工作台监控中单独统计。

优化只处理当前草稿，不把优化过程写入对话，不读取附件内容或整段历史。附件由宿主管理，结构化引用保留身份。斜杠命令、纯附件发送沿用宿主原流程；排队与接管意图保持不变。若优化期间改动草稿或附件，结果保留在抽屉，等待手动应用；停止、错误、超时和切换会话均不自动发送。

填写额外要求和预设名称后点“保存预设”。选中预设后可编辑要求与名称并“保存修改”，也可换名称“另存为预设”或“删除预设”。“自定义”与各预设切换时保留已经编辑的要求；未点“保存修改”的编辑会暂存，切回后仍可继续编辑，删除预设后当前要求转为自定义。空要求或重名不能保存为预设。

偏好、额外要求、预设和暂存编辑保存在当前浏览器并同步到同源标签页，刷新后保留，不同会话复用；其他浏览器或设备不自动同步。每个会话独立保留最近至多 20 个草稿版本（含原稿）；发送或清空草稿后开始新的版本链。刷新后优化版本记录清空，当前未发送草稿仍由宿主保存。

本版修复了发送失败后的版本恢复：宿主未接纳消息时，原稿与优化版本仍可取回；如果你已经开始编辑另一份草稿，抽屉会单独显示“保留的草稿版本”。点击“查看这份原稿与版本”只载入版本列表，再自行选择恢复，不会立即替换正在编辑的文字。附件恢复仍由宿主负责。

本版还会在当前浏览器页面内保留切换会话前未发送的图片和文件引用，以及润色原稿、版本列表和继续优化要求，各会话的草稿相互独立。切换时尚未完成的优化会取消，返回后不会重放请求或自动发送。刷新或关闭页面不保留图片文件与优化版本；已交给宿主执行的斜杠命令不会随会话切换重新出现为待发送草稿。

本集成固定复用 Prompt Optimizer 提交 93c37090846dd7ba9619a0ebc152f205624df9f1 的 MIT 许可模板，保留原始源码、许可证和来源哈希。新版本上游使用不同许可，本集成不会自动拉取上游代码。模型调用、原意与引用保护、版本控制和界面由 Oh My DSH 实现。

侧栏导航#

默认侧栏将搜索放在独立的一行。按 Tab 进入项目与会话列表后，用上下方向键移动，Home / End 跳到首尾，Enter 或空格打开会话。左右方向键展开、收起项目或移动到父子层级；Shift+F10 打开当前行的原生菜单，Escape 返回。行内原有插件操作继续可用。

搜索时按下方向键进入结果，Enter 打开选中会话，Escape 返回搜索框并保留关键词。用键盘关闭菜单或完成置顶后，可以继续用方向键浏览。默认外观以浅蓝色区分新会话入口和当前会话，搜索、项目标题与辅助信息各有清楚的层级，兼顾明暗模式。

默认外观在窄窗口中使用覆盖式侧栏，不再挤窄对话。点击遮罩、选中会话或按 Escape 可收起；搜索框和菜单先处理各自的 Escape。切回宽窗口后，侧栏恢复常规布局并保留当前输入焦点。

右侧工作台中，上下文操作失败会显示可见的错误与重试入口。详细资料支持 Escape 返回；切换分区再回来仍能继续键盘阅读。监控分类支持左右方向键和 Home / End，点击调用轨迹会定位到对应记录。

人格预设与自定义身份#

默认身份为：You are an interactive zcode agent that helps users with software engineering tasks.

在 设置 → Oh My DSH → 模型与身份 → 人格预设 中选择 默认、硬邦邦、软乎乎、自定义或关闭人格，然后点击 保存设置。硬邦邦沿用原版完整人设；软乎乎是暖呼呼、毛茸茸的软件工程搭子，亲切有趣，同时认真完成工作和检查结果。

选择自定义可编辑完整身份提示词，留空移除身份描述。内置预设可预览原文，点击 复制到自定义 后修改；切换内置人格或关闭人格会保留已保存的自定义内容，点击 撤销 可放弃尚未保存的更改。升级保留现有身份设置，不自动切换到新预设。更改从下一次主模型请求生效，适用于已有和新建的 Oh My DSH 主对话；其他工作规则保持原样。

会话范围在首次发消息前选择。当前发行版提供会话隔离与项目共享：会话隔离不自动注入其他会话的摘要，项目共享可读取本项目摘要目录；开始后保持原有绑定，旧 full 配置按项目共享处理。需要其他会话的资料时，可明确要求回查。

本版增加 Dream 短记忆与全局范围：项目模式读取本项目短记忆；全局模式读取更精简的全局短记忆与分页项目目录。用户手填的全局背景仍由项目与全局模式读取。这些入口已包含在本版中，详见 Dream 记忆。

工作上下文先在后台按事件窗口生成摘要和详细文档。中枢读取用户消息和档案，选择保留、详细替换或简要替换。下一请求只应用已完成决定；手动操作也不现场等待摘要生成。原文保留在会话日志中，通过 recall 按编号读文档或按事件区间回查。

任务保留摘录、锚点和验证证据；todo_write 管理需求与完成状态，verify_link 负责证据关联、执行和撤销。

CoT 前置的开关与推理文本字符上限也集中在 实验性功能 页，保留已有设置值。已前置的推理不再从原位置重复发送给模型；正文和工具往返保留，原始日志仍可回查。

**任务约束前置（CFR）**位于 设置 → Oh My DSH → 实验性功能，默认关闭。开启后，系统提示词和 todo 工具提示词都会要求先提取任务中适用的范围、整数要求、单位、结构、答案格式等约束，在不解题的前提下推导其共同蕴含的进一步限制，将约束和推论保留在相关任务标题中，再执行并在主要步骤及标记完成前核对。保存后从下一次主模型请求生效，关闭后同样从下一次请求移除；适用于已有和新建的主会话。这是单次调用中的提示词适配，不另行调用模型。

**BT（Better Todo）**位于模型选择旁边，收纳两个独立的收尾提醒开关：待办完成提醒默认开启，验证完成提醒默认关闭。选择按会话保存，可随时更改；验证提醒包含缺少合格证据与文字证据复核。关闭提醒不影响任务清单和验证工具的使用。

开启第二项“验证完成提醒”后，会弹窗说明此选项有助于提高任务完成率，同时消耗更多时间和 token。点击“知道了”关闭提示；开关已正常开启，不需要再次确认。

当前发行版的摘要页面可浏览和回查已保存的摘要及原始资料。

记忆页面提供整理会话、整理项目、整理全局和自动整理设置四个入口，均使用 Dream 处理。默认只处理新增摘要；会话默认 7 天无活动后才分批补充原文。项目、会话和来源可逐层展开，目录支持搜索分页，返回上级保留搜索、页码和位置；“当前会话”快捷入口回到该会话所属项目，改名会同步显示。来源列表提供名称、版本或事件范围及短预览。运行中可停止并保留进度。自动 Dream 默认关闭，开启后默认每小时检查，手动与自动共用每日 200,000 token 上限。详见 Dream 记忆。旧自动记忆保留为只读历史；设置中的“全局背景”仍是用户手写固定文本。

监控页面展示模型调用、输入输出用量、缓存和耗时，以及上下文的组成和变化。点击调用轨迹可查看详情。后台调用也计入用量，调低更新频率可减少这部分开销。

上下文演变按完整请求采样，各行色块使用统一刻度显示记录的 Token 估算；下方细轨单独显示模型报告的实际输入与缓存读取量。记录估算不等于实际计费用量。

外观页面提供主题、配色和本地壁纸；高级设置可定制分区颜色、字体字号、圆角、边框与材质，并分别选择保留 DSH 原生 Logo／标题或自定义标识。详见高级外观设置。

设置与保存#

设置页面提供常用、基础组件、模型与身份、实验性功能、高级和全局背景。后台模型可跟随主模型、统一或分别配置。打开设置不改变现有参数；保存仅提交改动字段。基础组件页的开关立即保存。

全局背景由你手动维护，多窗口同时保存时会检查版本，避免覆盖另一窗口的修改。冲突时点击“读取最新版本”查看另一窗口的内容，再选择“保留草稿，继续编辑”进行合并，或“使用最新内容”。读取最新内容本身不会覆盖草稿；合并后仍需点击“保存全局背景”。如果其他窗口再次修改，保存时会重新提示冲突。

基础组件路径只提交编辑过的字段，并保留保存期间的新输入。这些后续修改仍需再次保存；离开页面前确认没有未保存提示。

频率按自上次成功触发以来的新事件累计，与待处理积压量分开。调用期间新到的事件留待下一次触发；空闲或手动触发也不会一次连续清空积压。中枢延迟重试不会启动预处理。

升级保留已有参数，不自动改写已保存的设置。原“较少”参数现在显示为“适中”；不匹配这五项预设的现有配置显示为自定义；档位不修改模型、会话范围或 Trace。高级设置保留窗口、输出上限、空闲冲刷与电脑连接选项。

替换时可前置最近一次提供方已公开的推理文本；没有该文本时不会生成。它可能有误，也可能影响前缀缓存。后台仍有输入输出成本；如果窗口耗尽且没有可用摘要，系统不会凭空续接或静默删去原文。

CodeGraph#

本版内置 colbymchenry/codegraph 1.6.0，按本页安装步骤即可使用。

CodeGraph 默认启用，运行时随依赖安装，不需要全局安装 CLI、运行 codegraph install 或配置其他 Agent。平台包覆盖 macOS、Linux、Windows 的 x64/arm64；平台运行时缺失时，会通过上游安装器将匹配版本自动补齐到应用数据目录。

建立索引与查询#

1. 打开 Oh My DSH 会话，选择要分析的项目工作目录。
2. 后台自动在该目录创建 .codegraph/ 并建立索引；已有索引增量同步。可在 设置 → Oh My DSH → 基础组件 查看准备状态。
3. 直接询问，例如“登录请求经过哪些函数？”或“修改这个函数会影响哪些调用方？”。助手可通过 mcp__codegraph__codegraph_explore 获取相关源码、调用关系及影响范围。

查询默认使用会话工作目录，并向上查找最近的 .codegraph/；手动初始化针对指定目录本身。要分析其他仓库，可在对话中给出其目录，助手通过 projectPath 指定；相对路径按会话工作目录解析。首次查询会等待必要的索引准备；准备失败时可在基础组件页重试，普通文件和搜索工具继续可用。工具只加入 OMD 和 OMD-PTC，不改变其他 preset 的工具集。

同步、停止与维护#

每个项目复用独立的 MCP 连接，连接存续期间监听源文件变化。同步有短暂延迟；如果结果提示索引未更新或监听不可用，应以实际文件内容为准。连接空闲一分钟后释放，下次查询重新连接并补齐变更。也可以说“更新当前项目的 CodeGraph 索引”，再次调用 codegraph_index 增量同步。

后台自动准备由组件管理；关闭基础组件页的 CodeGraph 开关会停止其进程。模型显式发起的索引也可用宿主停止操作取消；后续准备会继续初始化或同步已有索引。连接崩溃后，失败会显示在工具结果中，后续查询重新连接。关闭或卸载插件会关闭其拥有的进程，但保留项目 .codegraph/；不再需要索引时，可在停止服务后自行删除该目录。索引位于项目内，不在 DSH_HOME 的会话备份中，通常不需要提交到版本库。

内置实例关闭 CodeGraph 遥测。索引与查询在本机运行；查询返回的源码会作为工具结果进入对话，并发送给会话所配置的模型。CodeGraph 提供结构信息，不能替代编译、测试或运行验证。

Computer Use#

Computer Use 的实现与平台测试位于 OpenCU，Oh My DSH 固定版本集成，功能与工作台保持完整。

在 设置 → Oh My DSH → 基础组件 统一展示浏览器、桌面控制、日常 Chrome 的状态。默认启用并自动准备依赖，首次使用浏览器时启动浏览器进程；已有桌面助手会自动启动。失败可在原位重试，无需手动运行安装命令。系统编译工具仍需预先具备（macOS 为 Apple Command Line Tools，Windows 为 .NET 10 SDK）；权限授权和首次加载 Chrome 扩展按页面提示完成。自定义运行时保持原路径，修改高级路径后重启服务生效。

在同一段对话中，让助手操作网页或 Windows／Mac 应用，同时查看实时画面；也可以先分享窗口或批注页面，再让助手根据你的反馈继续工作。

图中为内置浏览器的 Forma 示例，可以在工作台中接手页面、搜索与检查资料。

开始使用#

1. 新建或打开会话，选择支持原生工具调用的模型；需要理解截图时选择支持图像输入的模型。
2. 点击输入区下方 电脑 → 运行环境与权限，检查所需浏览器连接或当前平台的桌面运行时。
3. 点击 打开浏览器，或在输入框中用 @ 选择浏览器／应用，说明要完成的任务。
4. 在页内预览或 工作台 → 电脑 查看进展。需要自己操作时接管或停止助手；操作完成后点击 恢复助手控制。

可以这样开始：

• 选择 @Browser 后：“打开这个表单，填写我提供的内容，完成后截图并保留页面。”
• 选择已连接的 Chrome 标签后：“导出当前页面，保存已加载的图片和样式，列出获取失败的素材。”
• 分享一个 Windows／Mac 窗口后：“根据这张窗口截图和文字，帮我梳理当前页面的信息。”
• 给网页元素添加批注后：“按照这份批注和预览效果修改项目源码，再打开页面验证。”

平台与运行条件#

Windows 原生操控需要解锁的交互桌面；提升权限窗口不在普通控制范围内。单屏 125%、150%、200% 属于支持范围，改变缩放后需重新观察；多屏混合缩放不在本版本支持范围。控件操作与富文本格式取决于目标应用，详见 Windows 使用说明。

工作方式#

插件以原始会话事件为来源，后台准备档案并决定后续请求的表示形式。摘要、详细文档和原文保留关联；任务验证与电脑操控继续使用原有工具。

数据与维护#

作为插件安装时，数据使用现有 DSH 的数据目录：默认 ~/.dsh/（Windows 为用户目录下的 .dsh），或服务已有的 DSH_HOME。Oh My DSH 的记录位于其中的 trisoul-x/。只有仓库的独立试用脚本默认使用 data/dsh/。

data/、环境文件与运行日志已加入 Git 忽略规则。备份时停止服务并保存整个数据目录。本地开发代码更新后，重新运行 pnpm install --frozen-lockfile 和 pnpm build，再启动服务。

遇到 dsh web authentication required 时，重新打开当前服务打印的完整登录链接。首次启动需要下载 DSH profile 依赖；如果失败，先查看终端中的安装错误。

开发与验证#

pnpm exec playwright install --with-deps chromium
pnpm build
pnpm test

首次运行浏览器测试前需要安装上述 Chromium 及其系统依赖。自动测试使用临时数据目录、本地模拟模型与真实 DSH profile，不需要模型密钥。覆盖提示词、任务锚点与证据、跨轮恢复、记忆范围与版本、分段预处理、中枢决定、替换恢复、隔离和原文回查；另有浏览器操控、批注、导出、停止与预览，以及工作台切换、编辑保留、主题和窄窗的回归。

原生桌面测试受运行系统、运行时连接及权限条件约束；跳过的测试不代表对应能力已通过。真实模型评估另行运行，不属于默认 pnpm test。

验证命令复用宿主原生命令工具，遵守当前会话的沙箱和工具权限；权限拒绝或取消保留此前的验证证据。Windows 使用 PowerShell，支持直接关联 .ps1 文件；macOS/Linux 使用 Bash。停止与超时由宿主管理测试进程。CI 在 Linux 和 Windows 上运行，包含 PowerShell 执行、失败结果与进程取消检查。

DSH CLI 仅作为本地开发依赖；宿主 SDK 声明为由 DSH 提供的 peer dependencies，避免安装插件时重复安装一套宿主及其原生依赖。

Computer Use 的完整浏览器、原生桌面及对话框专项测试在 OpenCU 源仓维护。本仓 test/computer-use-ui.test.mjs 验证 OMD／OMD-PTC 的工具传输、浏览器画面和设置接入；test/computer-use-native-ui.test.mjs 验证真实原生目标与工作台、停止后的观察链路。安装、预设切换、重启及卸载仍由宿主集成测试覆盖。

报告问题时，请提供 Node.js/DSH 版本、复现步骤和脱敏后的错误信息。

空闲预处理与图片预算#

设置 → Oh My DSH → 常用 → 空闲预处理 提供独立开关与等待秒数。默认关闭；已有配置即使保存过等待时间，升级后也不会自动开启。启用后默认等待 90 秒，仅在会话真正空闲且有待处理内容时执行。关闭会取消等待中的空闲任务，已开始的任务可正常结束；按新事件数量触发的预处理、正常中枢和手动操作不受影响。修改开关后保存即可生效，不需重启；仅重新开启开关不会唤醒无新活动的历史会话。

OMD 主会话使用 pi-ai 图片路由时，发送前按提供方的实际图片请求版本计算 Base64 总字节数。超过图片预算的 90% 时，批量卸载最旧图片，目标降至 60%，尽量留出约 40% 余量，避免每读几张图就再次改变历史前缀。优先保留最新一批及至少两张最近图片；最新图片本身过大时继续使用宿主硬上限处理。旧图片原文件和历史附件不会删除，需要时可以重新读取。批量卸载仍会使变化位置后的缓存重新建立，只是减少重复发生的次数；CoT 前置与原有上下文替换策略不变。

版本与更新提醒#

左上角品牌旁的 ⓘ 可查看当前版本、最新版本和更新说明，并手动检查更新。绿点表示有普通更新，红点表示尚未安装的版本中包含必要修复；查看通知不会消除更新标记，安装对应修复后才会变为绿点或消失。

检查到新版本后，该面板内会出现“更新”按钮。点击后由当前环境的 DSH 插件管理器安装对应的官方版本，面板显示下载、安装、失败重试和待重启状态；关闭面板不会中断安装，再次打开可继续查看。有任务运行时需等任务结束；不兼容的宿主版本、安装脚本授权等问题会显示具体原因。“查看新版说明”直接打开检测到的版本；“查看发布记录”始终打开完整发布列表。GitHub 同日可能按版本号排序，跨编号历史版本请以 Latest 标记和项目更新记录为准。

安装成功后，桌面版使用应用菜单中的“重启应用与 Host”，或完整退出应用再打开；Web 版按原方式重启服务并刷新页面。安装过程中保留当前运行版本，重启后核对“当前版本”确实变化。更新仅操作当前 profile 的 OMD 插件，宿主版本按发布说明另行升级。

客户端在页面可见时定期读取版本状态，服务端共享检查结果，正常情况下最多每 6 小时检查一次 GitHub。手动检查间隔至少 30 秒。网络失败会明确提示；同一服务进程中保留上次成功结果并标为过期，不把检查失败当作“已是最新版”。此功能仅检查公开发布信息，不调用模型、不发送会话内容、不自动安装或重启。

发布时同步更新 package.json 版本和 release-manifest.json，在清单头部添加该版本的 version、severity、title、notes，再更新 更新记录。普通更新使用 severity: "normal"；必须提醒用户安装的重要修复使用 severity: "required"。保留历史必要更新条目，避免后续普通版本掩盖仍未安装的必要修复。分级由维护者明确标记，不靠标题关键词猜测。版本判断支持数字预发布版本；正式版安装不提示升级到预览版。

DSH 0.1.7 升级说明#

完整步骤统一维护在升级与安装教程，包括 V4 会话迁移、自定义 profile、旧预设与插件处理，以及“远端最新版本”和“本地当前版本”的区别。

整个插件启用或停用时浏览器会刷新一次，已保存的文字草稿和会话保留，尚未发送的附件需重新添加；普通功能开关不刷新页面。电脑工具路径修改保存后仍需重启。

推荐插件页面显示#

在“设置 → Oh My DSH → 常用”调整“显示推荐插件页面”，点击“保存设置”后立即生效。默认开启；关闭仅隐藏该页面，不卸载已有插件，也不改变单独的自动更新设置。再次打开同一开关即可恢复入口。

可选需求理解组件#

“设置 → 推荐插件”里的“需求理解 · OMD UI 增强版”是独立插件，默认不安装。手动安装后，在“设置 → 需求理解”主动开启。默认先审查再发送，原话不改写；可随时停止或跳过。关闭后卸载其发送处理并取消尚未完成的优化，不改变 OMD 原有功能。它不附带 Bash，与原有草稿“提示词优化”独立；建议不要同时启用两个自动处理器。

侧问与回合回滚#

/btw 原作者为 JasonQQ，原项目是 dsh-btw-plugin；Turn Rewind 原作者为 Anionex，原项目是 dsh-turn-rewind。固定来源与许可集中见 第三方来源与许可。

/btw <问题> 默认接入 OMD，沿用原生 fork 和主会话已完成回合。 它不执行工具；若模型尝试工具调用，宿主正常记录 Error 结果后停止侧问。 /btw cancel 取消当前主会话正在运行的侧问，不停止主会话。 缓存读取统计来自渠道返回的 cacheReadTokens；缺少字段显示未知。 缓存前缀无法核对或发生变化时，侧问直接报错，不静默切换到新上下文。 宿主冷启动后需先完成主会话一轮，建立可核对的请求前缀；侧问不进入 Dream 项目或全局记忆。

回合回滚在设置的推荐插件页面中，默认不安装。点击安装后由原生插件管理器启用。 当前推荐固定为上游 0.3.9 源码快照；已在 Mac 隔离 Web 宿主验证安装、启用、卸载和临时工作区恢复。正式桌面 App 界面及 Windows 未同等实测。