【文字开源】dsh-

这是什么：本文件是「文字开源」描述，不是代码。把本文件全文粘贴给你 DSH 里的 AI 会话， AI 即可为你复刻出功能相同的插件；你也可以阅读本文件理解其原理，并自行微调需求。

对应源码：<源码仓库 URL>（描述基于 commit ）｜许可证：<MIT 等>

最近更新：

1. 插件概述

2~5 句：这个插件解决什么问题、核心价值、适用场景、与哪些其他 dsh-* 仓库配套。

2. 功能规格

用户可感知的行为清单（尽量穷举、可验收）：

• 功能 A：触发条件 → 行为 → 结果
• 功能 B：触发条件 → 行为 → 结果
• ...

3. 技术路线

• 插件形态：Host 半 / Client 半 / 双半；Cordis 插件；单文件还是多包
• 加载与集成方式：cordis.yml 行 / agent preset / 补丁层 cordis.patch.yml / 对宿主核心的 patch / npm 包
• 依赖的核心 Service / Event / Tool：名称 + 用途（可标注版本敏感点）
• 关键外部依赖：runtime、框架、npm 包、系统能力（如桌面通知、Electron）
• 与其他 dsh- 仓库的配套关系*

4. 结构设计

文件/目录布局表：路径 | 职责

路径	职责
...	...

关键模块的职责与相互调用关系（可画 ASCII 关系图）。

5. 关键实现细节

• 核心逻辑/算法：步骤化描述（伪代码或步骤列表）
• 重要边界处理与坑：踩过的雷、版本兼容处理
• 配置项/常量及含义：环境变量、配置文件字段、magic 数字
• 与 DSH 版本相关的耦合点：哪些地方改了宿主内部、哪些随版本漂移

6. 集成与安装

从拿到本描述到插件生效的完整步骤（粘贴给 AI → AI 产出什么 → 放到哪里 → 如何生效 → 如何验证）。

7. 已知边界与注意事项

局限、安全注意、未完成项、已知问题。

8. 复刻验收标准（给复刻 AI 的检查单）

• 功能 A 复刻后行为一致（如何验证）
• 功能 B 复刻后行为一致（如何验证）
• 结构/集成点与描述一致