前言¶
在 DeepSeek Harness（DSH）里做多模型协作时，常见做法是手动切换 preset、自己写 prompt 约定「谁规划、谁写代码、谁审查」。步骤一多，规范容易漂移，审查结论也未必和可测验收标准对齐。社区插件 dsh-plugin-nexus-sdlc（Nexus SDLC / Nexus 规范研发）把「澄清规范 → 规划 → 实现与测试 → 审查 → 沉淀知识」写成一套声明式 agent preset，通过四个静态委派工具在 Claude Code 与 Codex 之间分工，主会话仍保留 shell、文件系统、搜索、job、/goal 与官方隔离规划控制器。下面介绍它是什么、如何安装，以及使用时需要接受的边界。
这是什么¶
dsh-plugin-nexus-sdlc 是面向 DSH 的 spec-driven development 预设包：包名 dsh-plugin-nexus-sdlc，Preset ID 为 nexus-sdlc，在客户端里显示为 Nexus 规范研发。维护者为 Fnckerpoi；源码与说明见 GitHub 仓库，社区目录页为 SkillHub 条目。分类为工作流；当前 npm 版本 1.0.0，许可证 MIT。README 明确说明：这是独立撰写的配置组合，不是 DeepSeek 官方产品；也不附带自定义 Host 代码或浏览器 UI。
与「在对话里临时口头分工」相比，本插件用中文 persona 与固定委派工具把角色边界写进 preset，并在 Provider 层为 Codex / Claude 使用独立行与权限模式，尽量在不绕过 DSH 审批与沙箱的前提下完成规范研发闭环。
兼容性与前置条件¶
安装前请对照 README 与 package.json 中的 peerDependencies：
- 当前文档写明已在 DSH core 0.2.0-rc.2 上做过检查；Desktop shell 版本号不等于 DSH core 版本，其他 core 版本未声明兼容。
- 目标 Profile 需具备官方 filesystem、subprocess、job、command、agent、preset 等服务；Shell 工具面向 macOS/Linux，Windows 未验证。
- 目标 Profile 中须已安装两个官方 provider 包，且本机 Claude Code / Codex 的配置与认证可用：
@deepseek-ai/dsh-subagent-codex@0.2.0-rc.2@deepseek-ai/dsh-subagent-claude-code@0.2.0-rc.2- Node 引擎要求：
>=22.19.0。 - 若环境中有
dsh-taskboard，preset 会给出看板相关指引；本包不安装看板、不开启其 auto-sync、也不改其设置。没有看板时应如实报告缺失，不要虚构任务操作。
peer 依赖在 npm 解析里标为 optional，仅为避免自动再装一套 harness/runtime；运行本组合仍需要这些能力，DSH 仍会校验声明的版本。
核心功能与工作流¶
README 将协作定义为 prompt 引导的协调，不是自动有限状态机：没有实时执行看板，不保证审查者不能写代码，不保证外部模型调用一定成功，也不把审查话术当作测试证据。委派仅在用户授权时发生；所需 provider 不可用时应报告失败，而不是假装某角色已执行。
推荐流程如下：
- 澄清 Spec 与可测试的验收标准。
- 调用
subagent_claude_plan：由 Claude Code 做规划。 - 调用
subagent_codex_dev：由 Codex 做实现、测试与针对性修复。 - 调用
subagent_claude_review：基于证据的审查；必要时再审查。 - 调用
subagent_claude_distill：仅在审查通过且用户接受后，沉淀可长期保留的知识。
主会话除上述四个静态委派工具外，还可使用 shell / 文件系统 / 搜索 / job、/goal、goal 工具及官方隔离 planning controller。/feedback 属于 Host，本 bundle 不重复提供。
Provider 与安全基线¶
本插件注册独立 Provider 行：
| 用途 | Provider 行 ID | 注册名 | permissionMode |
|---|---|---|---|
| Codex | nexus-sdlc-provider-codex |
nexus-sdlc-codex |
never |
| Claude | nexus-sdlc-provider-claude-code |
nexus-sdlc-claude-code |
plan |
这是在本地 preset 安全基线上的分工，不绕过审批或沙箱；原生限制仍可能阻止实现或沉淀步骤。包内不携带个人路径、网关、模型别名、凭证或 CLI 状态；唯一显式环境变量为 Electron 启动用的 ELECTRON_RUN_AS_NODE=1（不是凭证）。模型与认证仍由你本机配置或 Profile 覆盖决定。
需要自定义时，只覆盖上述独立 Provider 行的 config.model、config.env 等受支持字段；不要改共享的 codex / claude-code Provider，以免误伤其他会话权限。插件安装作用于整个 Profile，建议先在隔离 Profile 验证。
安装与启用¶
将下面命令里的 desktop 换成你的 Profile 名。若 CLI 不在 PATH，可在 Desktop 中使用插件管理器。先装缺失的前置插件，再装本包：
dsh plugin --profile desktop add @deepseek-ai/dsh-subagent-codex@0.2.0-rc.2
dsh plugin --profile desktop add @deepseek-ai/dsh-subagent-claude-code@0.2.0-rc.2
dsh plugin --profile desktop add dsh-plugin-nexus-sdlc
按客户端要求刷新或重启后，在新对话中选择 Nexus 规范研发（nexus-sdlc）。安装不会改变你的默认 preset。
若本地仍保留旧目录包 nexus-sdlc-0-1-7-rc-2，可与本公开包并存：新包使用稳定 ID 与独立 Provider 名，不覆盖旧版或 PTC；旧会话不会自动迁移，新会话请选新版并在确认后按需卸载旧版。不要同时重复安装本包的本地副本与 npm 副本。
典型用法说明¶
本插件不提供单独的可执行 demo 仓库；「典型用法」即在新会话中选定 preset 后，按工作流步骤推进任务：
- 与用户一起把需求写成 Spec 和可验证的 acceptance criteria。
- 在用户同意委派后，依次使用四个
subagent_*工具完成规划、开发、审查与沉淀。 - 实现与审查阶段应保留真实测试与命令输出作为证据；审查步骤不能替代跑测试。
- 主会话如需拆目标或长程规划，可配合
/goal与官方 plan mode，与委派步骤并行使用。
维护者在仓库中提供了 schema 与兼容性相关的自测命令（面向开发者验证包内容，不是最终用户的必做步骤）：
npm ci
npm test
# 可选：对照本机已安装的 DSH schema 做兼容性门控
DSH_APP_DIR="/path/to/dsh/installation" DSH_PROFILE_DIR="/path/to/profile" npm run test:host
npm pack --dry-run
单元测试覆盖稳定标识、无个人数据、角色绑定、权限默认值、peer 版本边界与文件范围；host checker 使用已安装 schema 做官方兼容性匹配，不发起模型调用、不修改 Profile。完整外部 provider 执行与 GUI 行为不在 schema 检查范围内。细节见仓库 verification notes。
适用场景与注意事项¶
适合谁： 已在 DSH 0.2.0-rc.2 生态中使用 Claude Code 与 Codex，希望用固定工作流做规范驱动研发、并愿意在主会话里逐步授权委派的开发者。
不适合当作什么： 不是一键全自动 SDLC 平台；不能替代本机测试与 CI；不能保证每次外部调用成功；SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系，安装前仍应自行阅读 源码 与 MIT 许可证。
权限与安全： 插件以当前 DSH 进程与 Profile 的权限运行；安装即影响同 Profile 下会话。勿在公开包或仓库中提交密钥；若后端需要 env 覆盖，请在私有 Profile 配置。
结尾¶
dsh-plugin-nexus-sdlc 把 Nexus 规范研发流程收敛为一个可选的 DSH preset：四个委派工具对应规划、实现、审查与知识沉淀，Provider 权限与官方 subagent 包对齐，便于在单一中文主会话里做 spec-driven 协作。选用前确认 core 与两个 subagent 插件版本，在新对话中选择 Nexus 规范研发 即可开始。
