dsh-text-open-source

DSH 插件「文字开源」枢纽 —— 不存代码，只存"可以复刻插件"的文字描述（提示词）。 每个描述文件 = 一个插件的完整说明书：功能、技术路线、结构、关键实现、复刻验收标准。 把描述粘贴进你的 DSH 会话，AI 就能复刻出功能相同的插件；你也能读懂原理，按需微调。

---

为什么是"文字开源"？

我们把 DSH 插件代码在 GitHub 上开源后，发现代码开源 ≠ 能力开源：

• 代码黑箱：光看源码，很难完整掌握插件的功能边界、技术架构和设计取舍；别人拿到代码也未必敢改。
• 分发受限：一部分功能依赖宿主内部改动或与特定 DSH 版本强耦合，难以用独立仓库干净分发。
• 理解成本高：代码是写给机器读的，人要从几千行源码里提炼"它到底做了什么、怎么做到的"非常费力。

所以我们换一种方式开源：让 AI 通读源码，把插件"翻译"成一份自包含的文字描述。这份描述就是"提示词"，也是插件的"数字孪生说明书"：

优势	说明
跨版本兼容最好	文字不绑定某个 DSH 版本的构建产物，描述里的思路、接口、结构可以迁移到任何版本复现
人类可读、可微调	描述按"功能 → 技术 → 结构 → 细节"组织，人读一遍就懂；想改需求，直接改描述再让 AI 重做
保存量极小	一个插件描述只有几 KB，而代码仓库动辄几 MB；整个生态的文字开源可以收敛到这一个仓库
AI 时代原生	描述即程序——粘贴即复刻，且复刻过程本身就带着"为什么这样做"的完整上下文

一句话：代码会过时，描述会进化。 本仓库与各插件源码仓库互为镜像——代码是"实现"，这里是"理解"。

怎么用

1. 在下方索引表找到你要的插件，打开它的描述文件；
2. 全文复制描述文件的内容；
3. 粘贴到你自己的 DSH 会话，告诉 AI："请按以下描述为我复刻这个插件"；
4. AI 产出插件文件后，按描述第 6 节「集成与安装」接入你的 DSH，按第 8 节「复刻验收标准」逐项验收。

插件索引（枢纽 ↔ 源码 ↔ 描述）

每个插件在下方同时给出文字开源描述（本仓库）与源码仓库（独立仓库），两处互相链接：

插件	文字开源描述	源码仓库	形态	一句话简介
dsh-intercom	plugins/dsh-intercom.md	dsh-intercom	Cordis 双半	顶层对话间通信中心：聊天面板 + intercom_* 工具（求助/协作/唤醒休眠会话）
dsh-usage-balance	plugins/dsh-usage-balance.md	dsh-usage-balance	Cordis Client 半	侧边栏「用量 / 余额」标签行 + 悬停详情卡
dsh-careful-full-access	plugins/dsh-careful-full-access.md	dsh-careful-full-access	插件 + 宿主补丁	命令守卫：静态分级 + WhatIf 预演 + model-check 复核，把误删挡在执行前
dsh-restart-plugin	plugins/dsh-restart-plugin.md	dsh-restart-plugin	Cordis Client 半	设置页一键「关闭后台服务 / 刷新前端」，刷新保留热插件
dsh-plugin-suite	plugins/dsh-plugin-suite.md	dsh-plugin-suite	改动切片套件	定制插件套件（局部 fork）：只带改动切片 + 累计补丁，收纳需动宿主的插件
dsh-user-plugins-manager	plugins/dsh-user-plugins-manager.md	dsh-user-plugins-manager	Cordis 双半	设置→插件 新增「用户插件」页：统一管理散件 / npm 包 / 运行树插件
dsh-attention-notifier	plugins/dsh-attention-notifier.md	dsh-attention-notifier	Cordis 宿主半	微信式任务栏提醒（判定端），配合 dsh-shell 呈现
dsh-shell	plugins/dsh-shell.md	dsh-shell	Electron 桌面壳	把 DSH Web UI 装进原生窗口，只注入窗口边框层，不碰页面 UI

双向链接

本仓库是生态的枢纽：向上连接各插件源码仓库（见索引表），向下连接每个插件的文字描述。

• 仓库 → 枢纽：每个插件源码仓库的 README 均带有「📖 文字开源描述」段落，指向本仓库对应描述文件（见各仓库 README）。
• 枢纽 → 仓库：本 README 索引表给出每个插件的源码链接，描述文件头部也标注对应源码与 commit。
• 修改任一插件的功能后，请同步更新其描述文件（描述基于的 commit 见文件头部）。

如何为你的插件添加文字开源描述

1. 复制 docs/template.md 作为模板；
2. 通读插件源码（README、源码、配置文件），完整理解功能 / 技术路线 / 结构 / 关键实现；
3. 让 AI 按模板 8 节结构撰写描述，写入 plugins/<插件名>.md；
4. 头部标注对应源码 commit，按第 8 节验收复刻效果；
5. 在下方索引表登记一行，并在插件源码仓库 README 中添加指向本仓库的链接。

许可证

MIT © 2026 zdjmrq —— 描述文件与代码同样开放，可自由使用、修改、再分发。