dsh-nexus

文档使用官方能力

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

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

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

配置渠道和工作目录

项目通过 DSH 原生工作区和新建会话入口选择，编码工具设置不再保存另一份项目选择。新项目可放在 C:\Users\\Documents\deepseek-harness\projects 下，每个项目独立一个子目录；已有 Git 仓库保留原位置即可。编码任务省略 cwd 即使用当前会话工作区，新项目可指定工作区内子目录；派发结果显示实际目录。编码工具的目录设置只作附加限制，不能扩大会话工作区。渠道收件目录可使用同级的 nexus，DSH 的 .dsh 留作应用数据。

Codex 与 Claude Code 共用托管安装目录，一次安装一个工具。npm 会检查已成功安装的另一工具的依赖；此前失败、没有完成标记的另一工具不会被顺带重试。两种工具仍分别记录安装完成状态和登录凭据。

三个渠道默认关闭。首次启用需要完成各自的认证和用户绑定：

渠道	配置方式
微信	扫码并确认授权，绑定确认扫码的账号
飞书	填写 App ID 和 App Secret，在私聊发送配对码，再回到设置页确认绑定
企业微信	填写智能机器人的 Bot ID、Secret 和允许的用户 userid

飞书应用需要启用机器人、长连接消息事件及相应权限，并对目标用户开放。

三个渠道能做的事不一样，按需选择：

能力	微信	飞书	企业微信
单聊文本	支持	支持	支持
入站图片、文件、语音	支持	不支持，仅文本	不支持，仅文本
回传本机文件	支持	支持	支持
待投递恢复（重启后补发未送达回复）	支持	支持	支持

入站附件目前只有微信具备。飞书和企业微信只处理单聊文本：发送图片、文件或语音不会进入会话，也不会收到“不支持”的提示。三个渠道均支持待投递恢复；飞书、企业微信遇到不确定回执时需在设置页手动重试，并可能重复上一分片。需要接收附件或语音时使用微信。

渠道收件和一般助理操作可以使用独立目录，例如 Windows 下的 C:\Users\\Documents\deepseek-harness\nexus。代码项目继续使用自己的仓库目录及开发指令，任务始终跟随所属会话工作区；如果配置了附加目录限制，需同时包含目标项目。

这些目录不必与 DSH 的数据目录放在一起，也不必把现有项目搬进 Nexus 工作区。目录位置本身不授予额外文件权限。目前首次保存渠道工作区需要先建立该渠道的连接配置；本地编码项目由 DSH 原生工作区入口选择，编码工具设置中的目录限制只作附加约束。

插件没有工作区覆盖配置时使用 $DSH_HOME/nexus-workspace，未设置 DSH_HOME 时为 ~/.dsh/nexus-workspace。也可以在宿主 profile 的 cordis.patch.yml 设置插件默认目录，例如：

- id: nexus-channels
  config:
    workspaceRoot: C:/Users//Documents/deepseek-harness/nexus

修改渠道工作目录后，下一条用户消息会在新目录建立会话。旧会话保留，工作文件不会自动搬迁。桌面端和源码运行的实例使用各自的数据与账号配置。