English

dsh-suite

STARDUSTLC 插件全家桶：一条命令，装入 18 个 DSH 插件。

把办公流（含做梦记忆）、媒体工坊、DevOps、通知与预设五条产品线一次装进你的 DeepSeek Harness。本仓库提供组合补丁（18 行默认配置，与组件自带 cordis.patch.yml 一致）；组件本身经上方一条命令直装。

重新验证整套兼容性（对着任意构建好的 Harness 检出跑一遍，产出 JSON 报告）：

node scripts/verify-compat.mjs --harness-root <harness 检出>   # 或在套件源码里执行

兼容性

验证宿主：官方发布标签源码构建的 Harness 0.2.0-rc.2（commit 639ed01539）+ Windows / Node 24.16.0。18 个组件共同加载，注册 104 个工具、35 个插件技能，工具 schema 与健康检查契约通过。套件另有 11 项清单、锁文件与离线环境测试。0.2.12 同步 RSS 0.5.0，新增订阅管理面板、OPML 导入预览，并修复并发保存与损坏导入问题，见 RSS 验收记录。Email 保持 0.14.6，修复空端点覆盖手工服务器的问题，见 Email PR #18 验收记录。PPT 保持 0.6.0，支持图片排版、编辑与撤销、逐页质量报告、可编辑图表、场景提纲、品牌配置及可选 PNG/PDF 渲染。Windows 放映、导出和渲染范围见 PPT 验收记录，此前的 Calendar/RSS 和 Dream/Email/Slack 验收记录继续保留。

安装

安装套件会自动拉取已验证版本的 18 个组件；profile 只启用套件这一层，组件由套件统一加载：

dsh plugin --profile web add @stardustlc/dsh-suite

也可以从 GitHub 安装套件源码，组件仍从 npm 安装：

dsh plugin --profile web add github:STARDUSTLC666/dsh-suite

安装后重启 Web 服务。只想装个别组件？直接装对应仓库即可（如 github:STARDUSTLC666/dsh-rss），不需要本套件。

从旧版全家桶迁移

如果之前按旧命令把套件和全部组件一起直装，先执行上方命令升级套件到 0.1.3 或以上，再移除组件的直接安装记录。组件仍保留为套件依赖；这样可避免 duplicate loader entry id 启动错误：

dsh plugin --profile web remove @stardustlc/dsh-docker @stardustlc/dsh-dream dsh-calendar dsh-cite dsh-code-security dsh-codex-port dsh-dingtalk dsh-email dsh-ffmpeg dsh-flakefinder dsh-hyperframes dsh-minimal-ptc dsh-ppt dsh-remotion dsh-rss dsh-slack dsh-sql dsh-voice

保留自己 profile 的 cordis.patch.yml 配置覆盖，随后重启 Web 服务。

卸载

dsh plugin --profile web remove @stardustlc/dsh-suite

桶内 18 件

产品线	组件	能力
📨 办公流	dsh-email	IMAP/SMTP 十工具：收发/搜索/附件/增量新邮件监视/标记整理/回复转发，八大服务商预设 + 自定义预设，Outlook OAuth2 设备码登录（内置公共客户端，开箱即用），卡片式多账号设置页（中英双语），发信审批门
	dsh-calendar	CalDAV 日程查建改删搜（Google/iCloud/Nextcloud/自建）；设置页里带月/周/议程面板（记住上次视图、周视图从 07:00 起、拖动即可改期），连接配置在面板内填写并先测后存
	dsh-rss	RSS/Atom 订阅 + 跨订阅搜索 + 增量抓取；中英双语订阅管理面板、分类筛选、可用性检查与 OPML 导入预览/导出
	dsh-cite	Crossref 文献检索 + 四种引文格式 + BibTeX
	dsh-dream	会话回放 → 来源核验 → 经验审阅 → 项目规则预览、写入与回滚（含隐私脱敏）
🎬 媒体工坊	dsh-ffmpeg	探测/剪辑/拼接/转码/字幕/抽帧/GIF/调整（变速·音量·静音·旋转）十工具
	dsh-voice	edge-tts 合成 + ASR 转写 + 音色试听
	dsh-ppt	HTML 放映 + 可编辑 PPTX：11 页型（含图片与图表）、逐页编辑/撤销、质量报告、四种场景提纲、品牌配置与演讲者备注；可选官方 LibreOffice Kit 导出 PNG/PDF
	dsh-hyperframes	HyperFrames by HeyGen 官方视频技能（21 个上游技能）
	dsh-remotion	Remotion React 编程式视频技能
🔧 DevOps	dsh-docker	容器七工具（含 health 自检）+ exec 审批门（@stardustlc/dsh-docker）
	dsh-sql	SQLite/MySQL/PostgreSQL + 只读保护 + 审批门 + 统计/CSV
	dsh-flakefinder	flaky 测试识别 + 隔离清单
	dsh-code-security	40+ 规则代码安全审查 + SARIF
	dsh-codex-port	Codex 官方插件一键移植为 DSH 技能
💬 通知	dsh-dingtalk	钉钉群机器人（加签）
	dsh-slack	Slack 双向消息（Socket Mode）
🧠 预设	dsh-minimal-ptc	极简 PTC 模式 Agent 预设

16 个组件提供 *_health 自检工具；PPT 可先运行只读的 ppt_themes，minimal-ptc 则检查预设是否出现在选择器中。部分 health 会访问外部服务或调用本地 CLI。

配置

在 profile 的 cordis.patch.yml 里按组件 id 覆盖即可，例如：

- id: sql
  config:
    maxRows: 500
- id: slack
  config:
    token: ''   # 或走环境变量 DSH_SLACK_TOKEN

排错

• 启动失败：逐个运行组件的 *_health 定位；或临时在 profile 补丁里 disabled: true 关掉可疑组件；
• 依赖拉取慢：优先使用上方 npm 安装命令；网络不佳时配置代理后重试。

开发

pnpm install
pnpm test   # 套件清单、文档和离线执行环境的测试

本地 18 个组件仓库应与 dsh-suite 放在同一个父目录，组件开发依赖与 Harness 构建产物需预先就绪。验证器从 cordis.patch.yml 自动发现组件，通过本地 TypeScript 编译器重建，再运行各组件 test/ 下的单元测试；不执行安装命令。

node scripts/verify-local.mjs --harness-root C:/path/to/deepseek-harness --report ../.harness-validation/offline-report.json
node scripts/verify-local.mjs --harness-root C:/path/to/deepseek-harness --contracts-only --json
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/smoke-report.json
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --install-tarballs ../.harness-validation/tarballs.json --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/install-report.json
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --install-tarballs ../.harness-validation/tarballs.json --registry-components --registry-suite --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/registry-report.json

--workspace-root 可指定组件父目录；--report 保存 JSON，--json 让标准输出只包含 JSON。任何构建、测试或契约失败均返回非零退出码。--contracts-only 跳过重建与单元测试，检查当前 lib/ 产物。

发布前使用 --install-tarballs 验证真实安装：报告格式为 { "ok": true, "packages": [{ "name", "version", "tarball", "integrity" }] }，须包含套件和 18 个组件，integrity 为 sha512-...。验证器只在临时 profile 中将指定版本映射到本地 tarball，经官方 CLI 安装套件，要求组件为传递依赖且不重复启用 profile 层，再检查实际启动、完整目录和 PTC 挂载。开发依赖可能访问 npm；这个安装模式不属于离线测试。

契约检查使用指定 Harness 的真实 ToolRuntime 和 SkillRegistry：逐个校验服务注入声明、全部工具参数与输出 schema、技能注册和重名冲突，生成两种 PTC SDK，再通过宿主执行链运行 16 个 health 与 ppt_themes 输出样例。旧宿主兼容测试会校验旧目录预设；0.1.7 启动验收检查声明式预设注册与模块解析，启动验收还会创建真实 agent 挂载预设，确认模型入口为 run_code 且保留插件工具与 Shell。这里只覆盖这些只读样例的返回值；发信、合成、渲染等业务流程由组件测试中的模拟依赖验证。

HyperFrames 与 Remotion 另有真实注册表回归：卸载一个已注册技能，确认 health 报告异常，再恢复相同注册并确认 health 恢复正常。启动验收也会执行这两个 health，要求全部随包技能实际生效。

子进程只继承启动所需环境变量，HOME / DSH_HOME / CODEX_HOME 与临时目录位于工作区 .harness-validation/。测试入口预加载 Node 网络拦截器，允许 loopback 模拟服务器，拒绝外部 fetch / TCP / UDP；它用于防止可信测试意外联网，不是操作系统沙箱。integration / live / e2e 测试默认排除并在报告列出，语音真实合成须在对应仓库显式运行 pnpm test:integration。契约中的 Crossref 和版本探测使用固定模拟响应，health 的 fixtureOk 仅表示模拟配置结果，不代表真实外部服务状态。

验收目录和报告会保留以供复核；smoke-harness.mjs 负责真实 CLI、全插件同载、Web HTTP 与鉴权检查，并按 --contract-report 逐项核对工具与技能目录。可加 --extra-plugin C:/path/to/modlens 验证额外安装的 Modlens。开发脚本在源码仓库中使用，不随组合补丁的 npm 包分发。

License

MIT（各组件许可证以各自仓库为准，均为 MIT）。PPT 的可选 LibreOffice Kit 使用 MPL-2.0；启用或再分发该渲染器时请保留其许可证和第三方声明，详见 PPT 的集成说明。