前言¶
DSH 的定位是「一切皆插件」，常见插件要么改工具链，要么接管某类资源。这个插件做的事很轻：在会话里敲 /qiyao，返回今天是七曜里的哪一天、这一天的传统象征，以及可以拿它做点什么。它不联网、不预测、不给吉凶判断，哪天断网都一样。
下面介绍 nanrener/dsh-plugin-qiyao 的定位、功能、安装方式和设计上的取舍。
这是什么¶
插件名 nanrener/dsh-plugin-qiyao，源码在 GitHub，目录页在 skillhub.cn，维护者 nanrener。package.json 里的 name 是 qiyao-calendar，当前版本 1.4.3，MIT 协议，零依赖，不联网。描述与简介一致：每天看一眼今天是什么日子，日、月、火、水、木、金、土，顺手给点安排灵感，不算吉凶。目录分类为「趣味换装」。
一句话概括：它把「今天是什么曜日、这天适合干什么」这个日历小事做成了一条本地命令。
核心功能¶
README 开头先写它不做什么，免得误会：
- 不算吉凶。七曜在传统历法里只管纪日，管吉凶的是六曜、建除、二十八宿值日那一套；
- 不联网。日期、文案、轮换全在本地算；
- 不预测。只给出这一天的传统象征，今天干什么自己判断。
它实际做四件事：
- 输入
/qiyao，返回当日信息：曜日、对应行星、象征含义，以及「今日首推」和「也适合」两段建议； - 支持查指定日期，如
/qiyao 2026-11-10，也认2026/11/10、2026年11月10日； - 顶栏有一个按钮，点开是同样的七曜信息浮层；
- 可以在「文档」文件夹放一个
七曜事项.txt，按曜日排自己的待办。
顶部按钮的数据是内联的，拆成两处实现：宿主侧 index.js 处理命令，client.js 是浏览器侧的生成物，数据副本由脚本塞进 client.js。
安装与启用¶
安装方式不涉及 dsh plugin add 命令。README 给的是图形化流程：打开 DSH 插件页 → 添加插件 → 填仓库地址：
https://github.com/nanrener/dsh-plugin-qiyao
本地开发也可以直接把仓库文件夹拖进来。装完要重启一次——/qiyao 命令热生效，但顶栏按钮属于客户端插件，客户端插件是启动时打包进页面的，刷新页面不会重新扫插件目录。
典型用法¶
装好后直接在会话里用：
/qiyao
输出形如：
📅 木曜日（♃ 木星）· 11 月 5 日
✨ 木星：扩张、机遇、增长、学习、远行
✅ 今日首推：把想学的东西开个头，哪怕只看二十分钟
📋 也适合：谈合作、约人喝咖啡、请教前辈、报名课程、出差、订机票
查别的日期：
/qiyao 2026-11-10
管自己的事：在「文档」文件夹建 七曜事项.txt，一行一条：
交周报
回客户邮件
周三|写方案初稿
周六|归档和备份
不带前缀的条目天天出现；带前缀的只在那一曜出现，没轮到就暂时收着。前缀三种写法都认：周三、星期三、水曜日。文件不存在时这几行不显示，不想用可以当没这功能。
适用场景与注意¶
适合想用一个轻量本地日历做日程心情参考、又不想让插件联网或读别的数据的人。需要留意两点：一是插件以当前 DSH 进程权限运行，行为等同于你授权的那段代码，安装前应检查源码和许可证（MIT）；二是顶部按钮不含你自己加的事项，浏览器端读不到本地文件，完整内容要看 /qiyao。
内容分三层，README 明确要求别混为一谈：
- 历法史实。日曜＝周日、月曜＝周一……土曜＝周六，这条可查证；七曜记日起源于巴比伦行星时制度，经印度《宿曜经》传入东亚，日本明治九年（1876）写进星期名并沿用至今。
- 行星象征。
theme、boundary两个字段来自西方占星的行星象征体系，是象征系统，不是知识。 - 现代转译。
picks（首推池）和fit（适配池）是作者把象征翻译成当代生活动作的结果，没有古籍出典，不要当成出典依据。
README「几个设计上的取舍」解释了三处细节：首推池固定 8 条、适配池固定 20 条（20 与 7 互质，配 14 会被 7 整除导致同一星期几永远同一条）；顶部按钮因读不到宿主数据文件，所以内联了数据副本，改文案后要跑 node scripts/build-client.mjs 重新生成；整张卡只用一个强调色，七曜传统色只出现在符号、首推块左侧色条和浅底。另外「踩过的坑」记录了 ctx.command(...) 是旧写法，官方用 ctx.commands.register({ name, description, input, handler })；package.json 带 BOM 会让 pnpm 报 Invalid JSON；浮层改用原生 popover 属性才不会被祖先 overflow: hidden 裁掉。
小结¶
如果你的需求只是「每天看一眼今天是什么日子」，这个插件够用，且因为不联网、零依赖，装和卸载都没有负担。目录页：https://www.skillhub.cn/plugins/nanrener/dsh-plugin-qiyao ，源码：https://github.com/nanrener/dsh-plugin-qiyao 。
