dsh-nexus

dsh plugin --profile web add dsh-nexus

Nexus for DSH

Nexus — 你的个人编码助理。

基于 DeepSeek Harness（DSH），在桌面端、微信和飞书中安排、跟进与验收本机编码任务。你可以交代目标，让本机 Codex 或 Claude Code 执行，查看进度、回答关键问题，再根据验证结果继续修改。

Nexus 是第三方插件，通过公开接口接入 DSH 的模型、原生会话、后台任务、审批和恢复服务。目前源码插件版本为 0.2.62，兼容 DSH 0.2.1-rc.2 与 0.2.0-rc.2，从 0.2.51 起正式发布。本机 DSH 和编码工具需要保持运行；手机渠道用于远程交互。

插件列表的名称与简介随 DSH 界面语言显示中文或英文：中文名为“Nexus 个人编码助理”，英文名为“Nexus for DSH”。安装预览提供中英双语简介。DSH 同时展示技术标识 dsh-nexus，以及 dsh-nexus/memory 等组件入口；从 0.2.32 起，安装包名和 GitHub 仓库名统一为 dsh-nexus；已有 nexus-next 安装需按[迁移说明](RENAME.md)替换旧包。组件 ID 与数据存储标识保持不变。

现有能力

• 交代目标：记录需求、共同约束和验收项，按步骤安排编码任务与依赖。
• 跟进执行：连接本机 Codex 或 Claude Code，通过任务卡片和过程侧栏查看进度，在所属会话中处理提问、审批和继续修改。
• 检查结果：执行指定的独立验证命令，汇总改动与验收项；区分“编码工具报告完成”“检查通过”和“用户确认业务效果”。
• 继续工作：支持任务续接与失败步骤恢复，通过原生存储保留记录；渠道投递恢复与编码任务执行分开处理。
• 手机协作：微信扫码、飞书用户配对、企业微信机器人，均绑定明确的消息所有者。文件通过支持交付的渠道发送，限于明确选择并通过权限检查的文件。

插件也包含记忆、邮箱、日历与待办，0.2.40 起新安装默认启用，均可在 插件 → Nexus → 组件 中按需关闭；DSH 原生定时提醒在任务页管理。新记忆按原生会话的项目目录和身份隔离，旧版记忆需由用户明确归类。

本版适配 DSH 0.2.1-rc.2：插件清单改用 DSH 版本范围，更新检查按语义化版本判断兼容性，并同步新版原生接口，同时保留对 0.2.0-rc.2 的兼容。逐项验收对应实际检查和声明文件，交付时复核文件变化；无进展重试累计 5 分钟提醒、10 分钟暂停，续接保留原任务与审批记录。详见 [版本记录](CHANGELOG.md)。

先完成一个编码任务

安装后可以先在 DSH 本地会话使用，渠道连接不是前置条件：

1. 打开 设置 → 编码工具，选择默认工具，检查安装、凭据和平台状态。Codex 的系统安装可以沿用本机配置；Claude Code 使用 Nexus 专用配置，按页面指引登录或填写凭据。

2. 在 DSH 原生工作区入口选择项目并新建会话。编码任务默认使用当前会话工作区；需要时可在「编码工具 → 通用 → 限制可用的工作目录」中添加额外限制，留空即可跟随会话。已有任务和续接保持原权限。

3. 确认「工具状态检查」显示默认工具配置已准备，再在项目会话中交代需求，例如：

> 在 D:/Projects/demo 中修复搜索结果重复的问题。保持现有接口，补充必要的回归检查，运行项目测试。结束后告诉我改了哪些文件、哪些检查通过，以及还需要我确认什么。

4. 当前会话的运行中任务卡片固定在输入框上方，多任务可展开；原渠道派发、身份与工作目录相同的历史任务放在默认折叠的“历史任务”中，注明来源且不计入当前任务数。电脑在旧会话新建的任务只显示在原会话。任务结束并关联原生完成通知后即从底部移除；展开或加载对应的“后台任务状态更新”时显示结果卡片。尚未关联完成通知的结果保留在底部，可手动收起。在任务卡片点 查看过程，或在设置页的「最近任务」点 查看任务与验收。详情显示目标、检查结果和验收状态；需要回答或继续修改时点 回到所属会话。任务结束后可以点 刷新结果 查看更新后的验收记录。

5. 需要手机协作时，配置微信、飞书或企业微信，并在绑定的渠道会话中发起需要远程跟进的任务。渠道会话也会保留在 DSH 中。

连接渠道不会自动接管已有的桌面会话；工作目录相同也不代表会话相同。请在任务所属会话中继续操作。

「配置已准备」只表示本机配置检查通过，没有发起真实模型任务。指定检查通过也只说明这些检查通过；未执行的测试和需要人工确认的效果不能视为已经验收。

安装到桌面端

1. 从 DSH 官网 安装桌面端，确认版本为 0.2.1-rc.2，并先完成模型配置。本版也兼容 0.2.0-rc.2；界面提示插件版本不受支持时，先升级到本插件版本，而不是用 dsh plugin allow-version 绕过检查。

2. 在 插件 → 添加插件 中填写 npm 包名 dsh-nexus，也可填写下面的固定地址。安装完成后点击 立即启用。如果提示重启，从托盘完全退出后重新打开。

   https://github.com/yuqiguang/dsh-nexus/releases/download/install/dsh-nexus.tgz

3. 先打开 设置 → 编码工具 完成上面的首次任务，再按需配置 渠道连接 和其他扩展。

4. 需要提醒功能时，在 插件 → 官方 启用 自动化任务。DSH 0.2.1 起该能力已内置在桌面端，旧版的 @deepseek-ai/dsh-experimental-schedule-bundle 会被自动移除，无需再单独启用。

npm 从 0.2.41 起提供安装包，推荐入口为 dsh-nexus，默认获取 latest 正式版（next 暂同步兼容旧安装入口），或填写 dsh-nexus@0.2.51 固定版本。npm 和 GitHub 分发相同安装包；npm 镜像可能延迟同步，新版暂时找不到时可选择 npm 官方源，或使用上面的 GitHub 地址。通过 DSH 添加才能注册插件，普通 npm install 不会自动完成这一步。

固定地址及 npm 的 latest 标签随正式版发布更新，不需要改版本号；已安装插件从 0.2.39 起可选择空闲自动安装，见下方“插件更新”。当前固定地址指向的版本及兼容性说明见 固定安装入口。旧包 nexus-next 用户请先阅读[迁移说明](RENAME.md)，避免同时加载两个包。

也可以从 版本 Releases 下载指定版本的 .tgz 和 SHA256SUMS，核对后填写本机绝对路径。Windows 示例：C:\Users\<user>\Downloads\dsh-nexus-0.2.51.tgz；不要填写 WSL 路径。桌面端自带安装所需的 CLI 和 pnpm。需要固定历史版本时，使用对应版本的下载链接。

编码工具现在支持「推荐版本」或「指定版本」。默认推荐 Codex 0.155.1、Claude Agent SDK 0.3.273；指定时填写完整版本号，可带预发布后缀，不支持 latest、版本范围或下载地址。先保存设置，再点击安装；保存、切回推荐或更新插件均不会自动替换现有工具。页面分别显示已安装版本、待安装版本与本次安装版本。Claude 的选择指 Agent SDK 及配套程序，与 Claude Code 命令显示的版本号不同。自定义版本尚未通过本插件兼容性验证，遇到问题可切回推荐版本重新安装。编码任务或沙箱配置进行中不能替换托管程序。

点击编码工具中的「安装托管版本」后，按钮旁会显示当前阶段、耗时和最近日志，可展开查看脱敏后的日志尾部。状态自动刷新；关闭设置页后安装仍继续，请保持 DSH 运行。主包与平台包显示实时下载速度和已下载量；下载源提供总大小时显示单包百分比，否则显示总大小未知。缓存读取单独标注；断流最多整包尝试三次，未完成的包不支持跨安装续传。安装总等待上限为 60 分钟，长时间无数据会提前失败；失败或超时会给出原因并允许重试。安装完成后仍需按页面检查凭据与运行状态。公开 npm 仓库显示域名和标准包路径，认证信息、查询参数与不确定的自定义路径会隐藏；两个工具共用安装目录，一次只安装一个，另一工具需等安装结束后手动点击，不会自动排队。

插件更新

从 0.2.39 起，Windows 桌面端提供 插件 → Nexus → 插件详情 → Nexus 更新：

• 自动检查更新默认开启，DSH 运行期间每六小时检查一次 GitHub 发布版本并校验新包。
• 空闲时自动安装（重启后生效）默认关闭，按需开启。任务、消息投递和数据恢复结束，且连续两分钟没有会话活动后才安装；也可以手动检查、排队安装或取消。
• 立即更新（0.2.43 起）：检查到新版后可手动触发；无阻塞时立即开始安装，有运行任务、待投递消息、工具安装或数据恢复时显示具体等待原因，并可取消排队。自动更新等待期间也可手动触发，手动操作无需额外等待两分钟。旧版仍通过“空闲时安装”升级，重启后显示新按钮。
• 安装前核对 SHA256、包结构、构建身份和 DSH 兼容性，并取得与当前运行构建一致的回退包。通过官方插件管理器更新，保留配置、原生数据和组件开关，不自动批准新的依赖脚本。
• 安装成功后分别显示正在运行和已经安装的版本。待任务完成，从托盘完全退出并重新打开 DSH 才生效，不强制重启。
• 安装失败时尝试恢复旧版文件，保留中断状态和重试回退入口；缺少可靠回退包时不安装，失败版本不会自动反复尝试。如果新版在重启后完全无法加载，需从对应 Release 下载旧包，通过 DSH 插件页恢复。

0.2.38 及更早版本需先手动升级一次：按官方插件页流程卸载旧插件，再添加新版安装包。卸载保留原生会话和渠道凭据。固定地址在新版发布后指向最新包，无需随版本修改。源码 Web 继续使用源码服务更新器；已卸载的插件不会被更新器重新安装。

组件开关

0.2.40 起，新安装的日历与待办、邮箱、长期记忆三个组件均默认启用，在 插件 → Nexus → 组件 中独立启停。已有显式关闭记录继续保留；邮箱仍需配置并启用账号后才连接。设置页显示实际运行状态；宿主提示需要重启时，等待任务结束后完全退出并重新打开 DSH。

一个安装包包含以下四个原生组件：

组件 · 包内入口 · 默认状态

Nexus 核心 · dsh-nexus · 启用

长期记忆 · dsh-nexus/memory · 启用

邮箱 · dsh-nexus/mail · 启用

日历与待办 · dsh-nexus/agenda · 启用

“Nexus 扩展”设置页和旧开关接口已移除。旧版模块开关不再生效，也不会重新启用已关闭的组件；原有配置和数据保留。需要继续使用时，请在原生组件列表中启用对应能力。

编码任务、验证、验收、文件交付和数据入口保留。渠道逐个连接；原生定时提醒仍在 DSH 任务页管理，本页不会取消已有提醒。静默时段、每日简报与语音配置仍在“助理”中管理。

文档使用官方能力

DSH 0.2.1-rc.2 桌面端提供 Word、Excel、PPT 技能及随附运行环境，支持常规读写编辑、结构检查、预览、PDF 导出和表格重算。Nexus 按当前会话实际可见的技能处理，不把导出成功当作排版验收通过。Web 部署需自行配置相应技能与依赖。

从 0.2.19 及更早版本升级： 自带文档兼容组件、设置页及 doc_read、doc_create、doc_edit、doc_convert 已移除，不再提供旧格式、Pandoc 转换和 PDF 文本提取的兼容路径。用户已有文档与本机已安装的软件保留。旧组件启停覆盖不会恢复已移除的能力；开发 profile 在初始化时清理对应旧插入项。

文件接收、查找、原生呈现、支持渠道的文件发送和编码成果打包继续保留，不依赖 Nexus 自带文档引擎。

邮箱组件

邮箱组件从 0.2.40 起新安装默认启用；曾关闭组件时先在 插件 → Nexus → 组件 中重新启用，再到 设置 → 邮箱与日程 配置和启用账号。组件提供收件查询、邮件搜索与阅读、发送确认、免确认收件人和收件提醒；邮件正文仍作为外部数据处理，附件必须位于当前会话工作区。

从 0.2.17 及更早版本升级： 旧版邮箱扩展开关不再生效，需要在组件页重新启用。账号配置、原生凭据、收件进度和提醒规则保留；组件关闭时仍可编辑账号、清除密码和删除规则。连接测试只在组件启用时可用，测试成功不表示持续连接已建立。

停用组件或切换账号后，旧审批和仍在读取附件、原邮件的请求不能继续发送；重新启用也不会恢复这些旧请求。已经提交给 SMTP 的发送会等待结果，停用无法撤回，也不会自动重试。切换账号会使用新邮箱的收件进度，不把其中的历史邮件作为新提醒重放。

设置页面由核心组件提供，关闭可选组件后仍可管理原有数据。

日历与待办组件

日历与待办组件从 0.2.40 起新安装默认启用；保持组件开启即可使用 calendar、todo 工具、到期提醒，以及每日简

…(truncated)