dsh-code 0.9.1 → 1.0.1

package/README.md

@@ -2,163 +2,192 @@
 
 [English](README.en.md) | 中文
 
-<p align="center"><img src="docs/pictures/1.png" width="95%" alt="带斜杠命令补全的 DSH-Code 终端"></p>
+<p align="center"><img src="docs/pictures/dsh-1.png" width="95%" alt="DSH-Code 欢迎界面与模型状态"></p>
 
 <p align="center"><img alt="Typing SVG" src="https://readme-typing-svg.herokuapp.com?font=JetBrains+Mono&amp;weight=500&amp;size=22&amp;duration=4000&amp;pause=700&amp;color=4176E6&amp;center=true&amp;vCenter=true&amp;width=680&amp;lines=DeepSeek+Harness+Code;DSH+%E5%86%85%E6%A0%B8%E7%9A%84%E7%BB%88%E7%AB%AF%E7%BC%96%E7%A0%81%E7%95%8C%E9%9D%A2"></p>
 <p align="center">
   <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek-Harness-4176E6?style=for-the-badge&amp;logo=deepseek&amp;logoColor=white&amp;labelColor=1c1917"></a>
+  <a href="https://www.npmjs.com/package/@deepseek-ai/dsh"><img alt="dsh version" src="https://img.shields.io/badge/dsh-0.1.1--rc.2-4176E6?style=for-the-badge&amp;logo=deepseek&amp;logoColor=white&amp;labelColor=1c1917"></a>
   <a href="https://github.com/UNLINEARITY/dsh-code/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/UNLINEARITY/dsh-code?label=Stars&amp;style=for-the-badge&amp;logo=github&amp;logoColor=white&amp;color=4176E6&amp;labelColor=1c1917"></a>
   <a href="https://www.npmjs.com/package/dsh-code"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-code?label=npm&amp;style=for-the-badge&amp;logo=npm&amp;color=cb3837&amp;labelColor=1c1917"></a>
   <a href="https://github.com/UNLINEARITY/dsh-code/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/UNLINEARITY/dsh-code?label=License&amp;style=for-the-badge&amp;logo=opensourceinitiative&amp;color=4176E6&amp;labelColor=1c1917"></a>
 </p>
 
-**DSH-Code 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）的终端编码界面。** 它以树外 bundle 的形式组合在官方 `@deepseek-ai/dsh-base` 之上，与 Harness Web UI 使用同一套 Agent、Session、工具、命令、技能、权限、sandbox、上下文压缩与插件服务。
-
-DSH-Code 没有另外实现一套 Agent loop，而是在 DSH 运行时上增加面向编码工作的 TUI。会话处理参考 [Codex CLI](https://github.com/openai/codex)，终端交互参考 [Claude Code](https://code.claude.com/docs/en/overview)。
-
 ---
 
 ## 一、项目概览
 
-DeepSeek Harness 将模型、工具、存储、策略和界面作为插件，通过 Cordis 注册。持久化会话事件记录恢复对话与运行状态所需的信息。
+**DSH-Code 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）的终端编码界面。** 它以树外 bundle 的形式组合在官方 `@deepseek-ai/dsh-base` 之上，与 Harness Web UI 使用同一套 Agent、Session、工具、命令、技能、权限、sandbox、上下文压缩与插件服务。
 
-DSH-Code 保留这套结构，并补充适合编码任务的终端工作流。
+DeepSeek Harness 将模型、工具、存储、策略和界面作为插件，通过 Cordis 注册。持久化会话事件记录恢复对话与运行状态所需的信息。DSH-Code 保留这套结构，并补充适合编码任务的终端工作流。界面采用开发者熟悉的终端操作方式，运行行为仍由 DSH 服务和配置决定。
 
-| 参考项目 | DSH-Code 使用的机制 |
-| --- | --- |
-| **DeepSeek Harness** | 插件组合、作用域服务、Agent Preset、持久会话、工具、技能、策略、sandbox 与委派 |
-| **Codex CLI** | 会话导航、有界浮层、历史检查、稳定底部布局与缩放处理 |
-| **Claude Code** | 斜杠命令发现、思考折叠、审批、提问与 turn steering |
+## 二、快速开始
 
-界面采用开发者熟悉的终端操作方式，运行行为仍由 DSH 服务和配置决定。
+需要 Node `^22.19 || >=24` 和预览版 `dsh` CLI（当前版本线：`@deepseek-ai/dsh@0.1.1-rc.2`）。未配置模型时仍可进入 TUI、查看会话和使用非模型功能；在 `/model` 中按 `a` 可管理 API key、OAuth 与设备码登录。
 
-## 二、快速开始
+### 1. 安装与更新
 
-需要 Node `^22.19 || >=24` 和预览版 `dsh` CLI。`DEEPSEEK_API_KEY` 不是启动前置条件：未配置时仍可进入 TUI、查看会话和使用非模型功能；在 `/model` 中按 `a` 可通过 Harness credentials 服务添加 API key。
+初次安装和更新使用同一组指令：
 
 ```sh
-npm install -g @deepseek-ai/dsh dsh-code
+npm install -g @deepseek-ai/dsh@0.1.1-rc.2 dsh-code@1.0.1
 npm install -g pnpm
-dsh plugin --profile cli add dsh-code@0.9.1
+dsh plugin --profile cli add dsh-code@1.0.1
 ```
 
-> 提示：pnpm 会忽略发布不足 24 小时的包，因此发布首日请使用精确版本 `dsh-code@0.9.1`；24 小时后可省略版本号。npm 安装不受此限制。
+> 提示：pnpm 会忽略发布不足 24 小时的包，因此发布首日请使用精确版本 `dsh-code@1.0.1`；24 小时后可省略版本号。npm 安装不受此限制。
+>
+> 版本对齐：dsh-code 1.0.1 面向 dsh `0.1.1-rc.2` 构建，全部 Harness 依赖均精确锁定为 `0.1.1-rc.2`。请保持全局 dsh 与 dsh-code 同步，避免宿主与插件混用候选版本。rc.2 已删除旧的 DeepSeek 配置项 `maxRequestImageBytes`。
 
-### 更新版本
-
-```sh
-npm install -g dsh-code@0.9.1
-dsh plugin --profile cli add dsh-code@0.9.1
-```
+### 2. 启动指令
 
 可用的启动指令：
 ```sh
-deepseek
 dsh --profile cli
+deepseek
 dsh-code
 ```
 
 `dsh --profile cli`、`deepseek` 与 `dsh-code` 是并列的启动命令。`deepseek` 与 `dsh-code` 都是 `dsh --profile cli` 的全局别名，后续参数会原样转发，例如 `deepseek --resume abc123`。
 
+
 > DeepSeek Harness 目前仍处于 developer preview，可能出现破坏兼容性的变化；DSH-Code 会持续跟随其插件接口演进。
 
 安装、原生模块和插件加载问题，请查看[常见问题与排障](docs/problems.md)。
 
-## 三、终端交互
+## 三、核心功能与使用方式
+
+DSH-Code 的重点是让 DSH 的 Agent、模型、工具和持久会话可以直接在终端中使用，并覆盖从编写代码到审查修改的完整工作流。
 
-### 基础
+### 1. 会话管理
 
-DSH-Code 在整个进程中只保留一个 Ink owner。`/new` 和 `/resume` 替换的是活动 Agent，而不是终端本身。若 Agent 忙碌，切换会等待当前 turn 自然结束；最新请求优先，目标加载失败也不会破坏当前会话。
+- 使用 `/new` 新建会话，或通过 `/resume`、`--continue` 恢复已有会话
+- 使用 `/fork` 从历史节点创建新的工作分支，同时保留原会话
+- 按当前目录、更新时间和会话范围搜索历史记录
+- 使用 Up/Down 召回输入历史，或通过 `/history` 搜索过去的提示词
+- 支持持久标题、Markdown 导出、上下文占用、token、缓存、TTFT 和耗时统计
+- 恢复会话时同步恢复该会话使用的 Agent Preset 和模型选择
 
-所有动态内容都受到明确的视口约束。流式输出、思考过程、审批、问题、`/help`、`/model`、`/mode`、`/resume`、`/plugin` 与 Ctrl+O 使用统一的终端预算。输入框始终紧贴状态栏上方；终端宽度稳定后，界面会根据保存的会话记录重新绘制一次。
+<p align="center"><img src="docs/pictures/dsh-3.png" width="95%" alt="可搜索的会话恢复选择器"></p>
 
-在第一次 turn 之前使用 `/mode`，查看或选择当前会话的 Agent Preset。
+<p align="center"><img src="docs/pictures/dsh-4.png" width="95%" alt="可搜索的提示词历史选择器"></p>
 
-<p align="center"><img src="docs/pictures/2.png" width="95%" alt="每会话 Agent Preset 选择器"></p>
+### 2. Agent、模型与扩展
 
-使用 `/resume` 搜索持久会话，无需重新启动 TUI。
+- 每个会话可以选择独立的 Agent Preset，用于组合工具、提示词、技能、上下文压缩、plan mode 和 subagent 能力
+- 使用 `/mode` 选择 `standard`、`code`、`minimal`、`cordis` 或用户自定义 Preset
+- 使用 `/model` 切换模型，管理 provider、API key、OAuth/设备码登录、endpoint、可用模型和上下文窗口
+- 在 `/model` 的 provider 列表中，Enter 管理手动 API key，`l` 发起登录，`o` 经确认后退出登录
+- 自动加载 DSH 中可用的命令与技能；使用 `/help` 查看入口，使用 `/plugin` 检查扩展状态
+- 支持 plan、goal、todo、权限、sandbox、subagent 和运行中的补充指令
 
-<p align="center"><img src="docs/pictures/3.png" width="95%" alt="可搜索的会话恢复选择器"></p>
+<p align="center"><img src="docs/pictures/dsh-2.png" width="95%" alt="每会话 Agent Preset 选择器"></p>
 
-### 常用命令
+### 3. 模型切换动画
+
+模型或 reasoning effort 发生以下变化时，输入框会播放 Wave、Aurora 或 Pulse：
+
+| 使用场景 | 触发条件 | 动画文字 | 效果档位 |
+| --- | --- | --- | --- |
+| 官方 DeepSeek 模型 | 切换到该模型，或修改该模型的 reasoning effort | `deepseek` | Flash 使用单波段档位，其他 DeepSeek 模型使用多波段档位 |
+| 其他模型 | 切换模型或 reasoning effort 后，实际生效的强度严格高于 `high` | `Into the Unknown` | 使用与非 Flash DeepSeek 模型相同的多波段档位 |
+
+高于 `high` 的等级包括 `xhigh`、`x-high`、`very-high`、`max`、`maximum` 和 `ultra`；`high`、`medium`、`low` 与 `off` 不会为非 DeepSeek 模型触发动画。
+
+| 样式 | Flash | 其他 DeepSeek / `Into the Unknown` |
+| --- | --- | --- |
+| Wave | 一个蓝色波峰从左向右扫过，约 1.2 秒 | 两个错开的蓝色波峰依次扫过，并带有 `· ✦ ✧` 尾部星光，约 1.5 秒 |
+| Aurora | 两条蓝色光带交错漂移，约 1.5 秒 | 三条不同色调的光带交错漂移，约 1.8 秒 |
+| Pulse | 一个圆环从输入框中心向外扩散，约 1.1 秒 | 两个圆环先后向外扩散，约 1.45 秒 |
+
+### 4. 编码工作流
+
+- 使用 `@` 引用工作区文件或已有会话；选择 PNG、JPEG、WebP、GIF 时会自动作为真实图片附件
+- 支持启动 prompt、多个 `--image` 参数，以及从终端拖入一张或多张图片
+- 使用 `/diff` 按文件检查改动，使用 `/review` 发起只读代码审查
+- 使用 `/copy` 复制最近一条完整回复，使用 Ctrl+O 查看完整历史和工具详情
+- 支持工具审批、结构化提问、plan review、多选和自定义答案
+- 使用权限 Preset 和 sandbox 控制 Agent 可以执行的操作；任务运行中仍可补充指令或中断
+
+### 5. 命令与快捷键
+
+启动 TUI：
 
 ```sh
 dsh --profile cli                    # 新建 standard 会话
-dsh --profile cli --mode code        # 使用 Agent Preset 启动
+dsh --profile cli --mode code        # 使用指定 Agent Preset 启动
 dsh --profile cli --continue         # 恢复当前目录最新会话
-dsh --profile cli --resume abc123    # 按 id 或唯一前缀恢复持久会话
+dsh --profile cli --resume abc123    # 按 id 或唯一前缀恢复会话
 dsh --profile cli --session my-id    # 使用指定 id 新建会话
 ```
 
-进入 TUI 后：
+进入 TUI 后，可以使用以下内置命令。当前 profile 提供的其他 Harness 命令和用户技能会随安装内容变化，完整列表以 `/help` 显示为准。
 
-| 操作 | 用途 |
+#### 会话与记录
+
+| 命令 | 用途 |
 | --- | --- |
-| `/new [preset]` | 不重启终端，创建并进入另一个会话 |
-| `/resume [id\|前缀]` | 搜索根会话或全部对话，并按 cwd、排序和密度筛选 |
-| `/mode [preset]` | 检查或选择空会话的 Agent 组合 |
-| `/model` | 在实时 LLM 注册表提供的模型间切换；按 `a` 管理 provider 与 API key |
-| `/plugin [query]` | 检查 loader 条目、启用状态、模块身份和 fiber 阶段 |
-| `/permission <name>` | 切换权限预设；Shift+Tab 可循环切换 |
-| `/help` | 浏览本地命令、Harness 命令、技能和快捷键 |
-| `Ctrl+O` | 打开独占历史详情视图，切换条目并滚动完整内容 |
-| `Ctrl+R` | 折叠或展开模型思考过程 |
-| `@` | 引用工作区文件或持久会话的有界快照 |
-| `Esc` / `Ctrl+C` | 关闭最上层界面或中断当前 turn |
-
-`/model` 的 provider 面板只读取 credential 的已配置状态、来源和可写性；输入内容始终遮蔽并直接交给 Harness 持久化。由启动环境提供的 key 会标记为只读，不能在 TUI 中覆盖或移除。
-
-## 四、功能
-
-### 1. Agent 与扩展
-
-- 每会话 Agent Preset：组合工具、提示词、技能、上下文压缩、plan mode 与委派能力
-- 从共享 Harness 注册表实时发现斜杠命令和用户技能
-- 通过 `/plugin` 只读诊断 Cordis loader
-- 从实时 LLM 注册表路由模型，并按持久会话恢复选择；`/model` 可添加或轮换 key、移除可写 key，以及删除用户添加的 provider profile
-- 支持 plan、goal、todo、权限、sandbox、subagent 与运行中 steering
-
-### 2. 会话与上下文
-
-- `/new`、`/resume`、`--continue` 与显式 session id，且无需重新挂载 Ink
-- Codex 风格可搜索恢复面板，支持根/全部对话、cwd、排序和密度筛选
-- 裸启动延迟到首次真实输入才创建会话，未输入即退出零残留
-- 全局输入历史：Up/Down 跨会话召回，`/history` 搜索面板回填输入框
-- 标题快照按需折叠，完整转录仅在显式请求时加载并支持全量滚动
-- subagent 对话只读检查，以及通过 `@` 注入有界会话引用
-- Markdown 导出、持久标题、上下文占用、缓存、token、TTFT 与耗时指标
-
-### 3. 审批与交互
-
-- sandbox 升级与 hook `ask` 决策的一次性工具审批条
-- 结构化 `ask_user_question` 与 plan review 菜单，支持多选和自定义答案
-- 在下一个 step 边界进行 turn steering，并提供明确的中断语义
-- Agent mode、plan、权限 preset、goal 与 sandbox 状态相互独立
-
-### 4. 终端渲染
-
-- 已落定历史只追加，流式可变区域严格有界
-- 思考折叠、终端 Markdown、紧凑工具摘要与完整结构化详情
-- 双行状态栏：mode 与 context 在第二行，context 为蓝色进度条，全蓝强调
-- 运行中提交即时显示为普通提示词行，Delete 取消排队消息，busy 使用 web StateDot 八点追逐动画
-- 回复与输入框光标对齐，欢迎头显示已安装版本与双语 slogan“Into the Unknown  探索未至之境”
-- Ctrl+O 独占历史检查，支持切换条目与完整纵向滚动
-- CJK/控制字符宽度安全、短终端主动降级、缩放防抖重放
-- 固定底部顺序：内容或面板 → notice → 输入框 → 状态栏
-
-#### DeepSeek 模型切换动画
-
-切换到 DeepSeek 路由，或在同一路由切换 reasoning effort 时，输入框会随机播放 Wave、Aurora 或 Pulse；相邻两次不会重复同一种样式。Flash 模型使用单波段档位，其他 DeepSeek 模型使用更丰富的多波段档位。
-
-| 样式 | Flash | DeepSeek |
-| --- | --- | --- |
-| Wave | 单个蓝色波峰从左向右扫过，1.2s | 两个错开的波峰，1.5s |
-| Aurora | 两条蓝色光带正弦漂移，1.5s | 三条不同色调光带，1.8s |
-| Pulse | 一个圆环从输入框中心扩散，1.1s | 两个先后扩散的圆环，1.45s |
+| `/new [preset]` | 创建新会话，可同时指定 Agent Preset |
+| `/resume [id\|前缀]` | 搜索或恢复已有会话 |
+| `/resume cancel` | 取消正在等待的会话切换 |
+| `/fork [event-seq]` | 从最近完成的 turn 或指定事件位置创建分支会话 |
+| `/delete [id\|前缀]` | 删除指定会话及其 subagent 会话 |
+| `/title <text>` | 修改当前会话标题 |
+| `/export [path]` | 将当前会话导出为 Markdown |
+| `/history` | 搜索并复用过去提交的提示词 |
+| `/clear` | 清空当前终端显示，不删除持久会话 |
+
+#### Agent、模型与权限
+
+| 命令 | 用途 |
+| --- | --- |
+| `/mode [preset]` | 查看或选择当前会话的 Agent Preset |
+| `/model` | 切换模型，管理 provider、API key、网页登录、endpoint 和可用模型 |
+| `/effort` | 调整当前模型的 reasoning effort |
+| `/permission [preset]` | 查看或切换权限 Preset |
+| `/subagent` | 选择 subagent 执行任务时使用的模型 |
 
-动画以约 30 FPS 在输入框局部运行；结束后背景和边框恢复静态，DeepSeek 档位提示符继续保留。
+#### 编码、任务与后台工作
 
-## 五、DSH-Code 如何接入 DSH
+| 命令 | 用途 |
+| --- | --- |
+| `/diff [--staged\|ref]` | 按文件查看工作区、暂存区或指定 ref 的 Git diff |
+| `/review [--staged\|ref]` | 使用只读权限审查 Git 改动 |
+| `/todos` | 查看当前会话的完整 todo 列表 |
+| `/agents` | 查看当前会话创建的 subagent 会话 |
+| `/jobs` | 查看后台任务及其运行状态 |
+| `/copy` | 复制最近一条完整助手回复 |
+
+#### 扩展、显示与退出
+
+| 命令 | 用途 |
+| --- | --- |
+| `/plugin [query]` | 查看已加载扩展及其状态 |
+| `/statusline` | 选择状态栏显示的项目 |
+| `/theme` | 切换终端配色主题 |
+| `/help` | 查看快捷键、内置命令、Harness 命令和用户技能 |
+| `/quit` | 退出 DSH-Code |
+
+#### 输入与快捷键
+
+| 操作 | 用途 |
+| --- | --- |
+| `Enter` | 提交当前输入 |
+| `Up` / `Down` | 召回上一条或下一条输入记录 |
+| `Tab` | 补全命令、技能或 `@` 引用 |
+| `@` | 引用工作区文件或已有会话；图片文件自动作为附件发送 |
+| `Ctrl+O` | 查看完整历史与工具详情 |
+| `Ctrl+R` | 折叠或展开思考过程 |
+| `Shift+Tab` | 循环切换权限 Preset |
+| `Delete` | 输入框为空时，取消最新一条排队消息 |
+| `Ctrl+K` | 删除光标到行尾的内容 |
+| `Ctrl+U` | 清空当前输入行 |
+| `Ctrl+A` / `Ctrl+E` | 移动到当前行开头或结尾 |
+| `Esc` | 关闭当前菜单或中断正在运行的 turn |
+| `Ctrl+C` | 依次用于取消任务、清空输入或退出 |
+| `Ctrl+D` | 退出 DSH-Code |
+
+## 四、DSH-Code 如何接入 DSH
 
 ### 1. 运行时组合
 
@@ -194,7 +223,7 @@ dsh profile
                          └→ 有界面板 → 输入框 → 状态栏
 ```
 
-## 六、开发
+## 五、开发
 
 ```sh
 pnpm install

package/bin/deepseek.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { spawn } from 'node:child_process'
+import { spawn, spawnSync } from 'node:child_process'
 import { existsSync, readFileSync, realpathSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import { homedir } from 'node:os'
@@ -8,10 +8,23 @@ import { join, resolve } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 
 const packageRequire = createRequire(import.meta.url)
+const packageVersion = packageRequire('../package.json').version
 
 /** Arguments required to boot DSH-Code's conventional profile. */
 export const profileArgs = (args = []) => ['--profile', 'cli', ...args]
 
+export const OPERATION_COMMANDS = ['setup', 'doctor', 'completion', 'update']
+
+/** Exact first-day package spec used by setup (pnpm delays an unpinned release). */
+export const setupBundle = (args = []) => args.includes('--local')
+  ? fileURLToPath(new URL('..', import.meta.url))
+  : `dsh-code@${packageVersion}`
+
+/** Wrapper-owned operation, or undefined when arguments belong to the TUI. */
+export function operationName(args = process.argv.slice(2)) {
+  return OPERATION_COMMANDS.includes(args[0]) ? args[0] : undefined
+}
+
 /** The conventional cli profile directory under the DSH home. */
 export function cliProfileDir(home = homedir()) {
   return join(home, '.dsh', 'profiles', 'cli')
@@ -46,20 +59,20 @@ export function globalDshRoots() {
 }
 
 /** Resolve the DSH entrypoint without passing user arguments through a Windows shell. */
-export function dshCommand(args, {
+export function rawDshCommand(args, {
   platform = process.platform,
   moduleUrl = import.meta.url,
   fileExists = existsSync,
   roots = globalDshRoots(),
   resolvePackage = packageRequire.resolve,
 } = {}) {
-  if (platform !== 'win32') return { command: 'dsh', args: profileArgs(args) }
+  if (platform !== 'win32') return { command: 'dsh', args }
   const adjacentEntrypoint = fileURLToPath(new URL('../../@deepseek-ai/dsh/lib/bin.js', moduleUrl))
-  if (fileExists(adjacentEntrypoint)) return { command: process.execPath, args: [adjacentEntrypoint, ...profileArgs(args)] }
+  if (fileExists(adjacentEntrypoint)) return { command: process.execPath, args: [adjacentEntrypoint, ...args] }
   for (const root of roots) {
     try {
       const entrypoint = resolvePackage('@deepseek-ai/dsh/lib/bin.js', { paths: [root] })
-      return { command: process.execPath, args: [entrypoint, ...profileArgs(args)] }
+      return { command: process.execPath, args: [entrypoint, ...args] }
     } catch {
       // The next configured global prefix may own DSH instead.
     }
@@ -67,6 +80,86 @@ export function dshCommand(args, {
   return undefined
 }
 
+/** Resolve the normal TUI boot command. */
+export function dshCommand(args, options = {}) {
+  return rawDshCommand(profileArgs(args), options)
+}
+
+/** Static shell completion for wrapper commands and the TUI's local flags. */
+export function completionScript(shell) {
+  const words = 'setup doctor completion update --help --version --resume --continue --session --mode --theme --image'
+  if (shell === 'bash') return `_deepseek_complete() { COMPREPLY=( $(compgen -W "${words}" -- "\${COMP_WORDS[COMP_CWORD]}") ); }\ncomplete -F _deepseek_complete deepseek dsh-code`
+  if (shell === 'zsh') return `#compdef deepseek dsh-code\n_arguments '1:command:(${words})'`
+  if (shell === 'powershell' || shell === 'pwsh') return `Register-ArgumentCompleter -Native -CommandName deepseek,dsh-code -ScriptBlock { param($wordToComplete) '${words}'.Split(' ') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) } }`
+  throw new Error('completion needs one shell: bash, zsh, or powershell')
+}
+
+function printDoctor(resolveCommand = rawDshCommand, spawnCommand = spawnSync) {
+  const checks = []
+  const [major, minor] = process.versions.node.split('.').map(Number)
+  checks.push({ ok: major > 22 || (major === 22 && minor >= 19), label: `Node ${process.versions.node}`, detail: 'requires ^22.19 or >=24' })
+  const command = resolveCommand(['--profile', 'cli', '--dump-config'])
+  checks.push({ ok: command !== undefined, label: '@deepseek-ai/dsh', detail: command === undefined ? 'not found beside dsh-code' : 'entrypoint resolved' })
+  checks.push({ ok: profileHasDshCode(), label: 'cli profile', detail: cliProfileDir() })
+  if (command !== undefined && profileHasDshCode()) {
+    const probe = spawnCommand(command.command, command.args, { encoding: 'utf8', windowsHide: true })
+    const output = String(probe.stdout ?? '')
+    checks.push({ ok: probe.status === 0 && output.includes('dsh-code'), label: 'composition', detail: probe.status === 0 ? 'dump-config contains dsh-code' : String(probe.stderr ?? '').trim() })
+  }
+  for (const check of checks) console.log(`${check.ok ? 'ok  ' : 'fail'} ${check.label} - ${check.detail}`)
+  process.exitCode = checks.every(check => check.ok) ? 0 : 1
+}
+
+function launchChild(command, args) {
+  const child = spawn(command, args, { stdio: 'inherit' })
+  child.once('error', error => {
+    console.error(`dsh-code: command failed: ${error.message}`)
+    process.exitCode = 1
+  })
+  child.once('exit', (code, signal) => { process.exitCode = code ?? (signal === null ? 0 : 1) })
+  return child
+}
+
+/** Run one wrapper-owned operational command. */
+export function launchOperation(args = process.argv.slice(2)) {
+  const operation = operationName(args)
+  if (operation === undefined) return undefined
+  if (operation === 'completion') {
+    try {
+      console.log(completionScript(args[1]))
+    } catch (error) {
+      console.error(`dsh-code: ${error.message}`)
+      process.exitCode = 1
+    }
+    return true
+  }
+  if (operation === 'doctor') {
+    printDoctor()
+    return true
+  }
+  if (operation === 'setup') {
+    // pnpm deliberately delays unpinned packages during their first 24 hours.
+    // Setup must mount the exact globally installed release on launch day.
+    const command = rawDshCommand(['plugin', '--profile', 'cli', 'add', setupBundle(args)])
+    if (command === undefined) {
+      console.error('dsh-code: @deepseek-ai/dsh is not installed; run: npm install -g @deepseek-ai/dsh dsh-code')
+      process.exitCode = 1
+      return true
+    }
+    return launchChild(command.command, command.args)
+  }
+  if (args.includes('--apply')) {
+    return launchChild(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '-g', '@deepseek-ai/dsh', 'dsh-code'])
+  }
+  const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm'
+  for (const name of ['@deepseek-ai/dsh', 'dsh-code']) {
+    const result = spawnSync(npm, ['view', name, 'version'], { encoding: 'utf8', windowsHide: true })
+    console.log(`${name}: ${result.status === 0 ? String(result.stdout).trim() : 'version check failed'}`)
+  }
+  console.log('Run `deepseek update --apply` to install the latest versions.')
+  return true
+}
+
 /** Launch the installed DSH CLI while preserving its exit status and stdio. */
 export function launchDsh(
   args = process.argv.slice(2),
@@ -101,5 +194,6 @@ export function launchDsh(
 
 const entrypoint = process.argv[1]
 if (entrypoint !== undefined && pathToFileURL(realpathSync(resolve(entrypoint))).href === import.meta.url) {
-  launchDsh()
+  if (operationName() === undefined) launchDsh()
+  else launchOperation()
 }

package/cordis.patch.yml

@@ -69,7 +69,14 @@
 - id: tool-todo
   disabled: true
 - id: tool-web
-  disabled: true
+  config:
+    # web_fetch is a core TUI capability, not an opt-in: the fetch provider
+    # (web-fetch-http below) needs no API key. The per-preset tool-web rows
+    # keep `fetch: false` on the agent plane; through the scope-layered tool
+    # registry the preset's web_search shadows the host's same-name tool while
+    # the host's web_fetch stays visible, so every model still sees both.
+    fetch: true
+    searchTimeoutMs: 60000
 
 - insert:
     # Code Mode is a core execution capability, not a Web component.
@@ -82,6 +89,13 @@
     - id: session-reference
       name: '@deepseek-ai/dsh-session-reference'
 
+    # Workspace @file mention discovery: a bounded per-agent fuzzy index over
+    # the session cwd (directory listing, symlink guards, tool/result
+    # invalidation). The TUI's @ completion consumes ctx.fileReferences
+    # instead of running its own workspace scan.
+    - id: file-reference-local
+      name: '@deepseek-ai/dsh-file-reference-local'
+
     # The launcher supplies the shipped preset root beside its own config and
     # the service also discovers the user's local preset root.
     - id: agent-presets
@@ -89,6 +103,27 @@
       config:
         default: standard
 
+    # Cordis self-inspection (the shipped `cordis` agent preset's toolset):
+    # the host runner publishes the `dynamicCordisRunner`/`cordisInspect`
+    # services `tool-cordis` injects. Without this host row the preset mount
+    # fails ("1 row(s) did not activate: tool-cordis"), because models write
+    # composition through the agent plane but the runner is a host singleton.
+    - id: cordis-host-runner
+      name: '@deepseek-ai/dsh-cordis-host-runner'
+
+    # Anonymous public HTTP(S) fetch provider for web_fetch (no key): the web
+    # service and its search provider stay on the host plane (dsh-base), and
+    # this row is what makes fetching real URLs work out of the box.
+    - id: web-fetch-http
+      name: '@deepseek-ai/dsh-web-fetch-http'
+
+    # Interactive provider authorization. The base bundle supplies the
+    # credential store; mounting the neutral authorization seam wakes the
+    # login flows already registered by llm-pi-ai without coupling the TUI to
+    # any provider's OAuth or device-code protocol.
+    - id: authorization
+      name: '@deepseek-ai/dsh-authorization'
+
     - id: tui-startup
       name: 'dsh-code/startup'