mira_active

DSH PLUGIN工具与能力

仓库 Stella-Mira/mira_active

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 自我激活插件(闹钟):一条配置=一个闹钟,单次/每日/间隔/随机 + 条目级静默时段、失败退避,到点用 steer 插话唤醒会话

一句话选型结论

按资料字段整理

mira_active 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-29 创建于 2026-10-29
README 14.0 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Stella-Mira/mira_active
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注

上游标签

deepseek-harnessdshdsh-pluginlive2d

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
mira_active当前 L5 · 运行验证通过 低风险 0 未标注 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Stella-Mira仓库 mira_active · 默认分支 main
分类工具与能力agent-workflow
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-29 · 2026-10-29最后推送 2026-10-29
本站收录2026-10-30首次进入本站目录的时间

README 全文

14.0 KB
作者原文,中文版优先;只做安全转义,不改内容

mira_active

让会话拥有自我激活的能力 —— 本质是闹钟:到点往某个会话里插话注入一条用户消息,
让它自己跑一轮。

> 0.3.0 起数据模型改成「一条配置 = 一个闹钟」(alarmId 为键,条目里带 sessionId),
> 投递方式从 followup(排队)改成 steer(插话)。旧版的单文件状态用
> 重构插件/migrate/active.mjs 转换,见「迁移」。
>
> 纯 Node 内置能力(fs / path / crypto),link: 装入 profile 即可用,无第三方依赖。

落盘:$DSH_HOME/mira_config/mira_active/alarms.json   (schemaVersion 2)
$DSH_HOME 缺省 ~/.dsh → 例如 `~/.dsh/mira_config/mira_active/`

> 状态文件是内存镜像,不是开关。 插件运行时以内存为准,alarms.json 只是它写出去的副本;
> 运行时删除或手改该文件,会在下一次落盘时被写回或覆盖(工具调用、卸载、定时器处理到点条目
> 都会触发落盘)。删掉状态文件来清空激活列表,仅在插件未运行时有效。 运行中要清空请用
> mira_active_remove / mira_active_disable;只想看状态用 mira_active_status(只读,返回文件
> 路径、条目数、启用数,不改任何东西)。插件也不会自动重读外部改动:手改文件后要重载插件才生效。

投递语义(任务书【定】)

会话状态 行为
空闲 立刻开始一轮
正在跑 把消息插到最近一步(steer)

绝不排队等下一轮:followup 要等这一整轮结束才轮到,会把「到点叫醒」变成「这一轮结束后才叫」。
所以本插件只调 agent.steer(),代码里没有 followup 路径。

数据模型

{
"schemaVersion": 2,
"alarms": {
"a-1f2e3d4c5b": {
"id": "a-1f2e3d4c5b",
"sessionId": "会话 id(必填,空 → 拒绝保存并报 config/missing,不猜)",
"enabled": true,
"note": "备注,只用于状态显示",
"schedule": { "type": "daily", "times": ["09:00", "21:00"] },
"prompt": { "mode": "single", "text": "该起来了", "order": "random" },
"quiet": { "enabled": true, "ranges": [{ "from": "01:00", "to": "07:00" }] },
"delivery": "steer",
"limits": { "maxPerDay": 0, "minGapMinutes": 0, "failBackoffMinutes": 10, "maxFailures": 5 },
"stats": { "createdAt": "…", "lastFiredAt": null, "fireCount": 0, "failCount": 0, "missedCount": 0,
"consecutiveFailures": 0, "dayKey": "2026-10-27", "dayFired": 0, "rangeKey": "", "rangeFired": 0 },
"nextAt": null,
"backoffUntil": 0
}
}
}

同一会话可以有多条闹钟;多条同时到期时按 nextAt 升序依次投递。

schedule(定时方式)

type 字段 说明
once at(ISO8601)或 afterMinutes 一次性。afterMinutes 在保存时折算成绝对时刻;拒绝过去时刻(要立刻响用 mira_active_fire_now)。触发后 enabled 自动置 false,条目保留便于复查
daily times: ["09:00","21:00"] 每天固定时刻,可多个;取最近的将来时刻
interval intervalMinutes 每 N 分钟;基准是上次触发时刻
random perDay 或 range: [min,max] 按天给期望次数。按平均间隔采样(±40% 抖动),不是「固定 k 次均匀铺开」 —— 均匀铺开会把随机变成机械

prompt(提示词)

  • mode:"single" + text,或 mode:"list" + texts[] + order:"random"|"seq"(顺序循环)
  • 变量:{{time}} {{date}} {{sessionId}} {{alarmId}} {{count}}(该条目累计触发次数,1 起)
  • 未知的 {{xxx}} 原样保留,不会被静默吞掉

quiet(静默时段)

  • 条目级、可多段、可跨午夜(22:00 → 02:00)、可按星期(days:[0..6],0=周日;省略=每天)
  • 跨午夜时 days 指窗口开始那天:周一 22:00 开的窗口,周二 01:00 仍算周一那段
  • 命中 → 本次不触发、不补、missedCount+1 并打一行 info
  • 不推迟到窗口结束后立刻响 —— 那会让人一觉醒来被一串闹钟炸掉(任务书点名的坑)

limits

字段 默认 说明
maxPerDay 0 每天最多触发几次(0=不限),按本地日期跨天重置
minGapMinutes 0 两次触发之间至少隔多少分钟
failBackoffMinutes 10 投递失败后等多久再试
maxFailures 5 连续失败多少次后自动 enabled=false 并打 warn(不无限重试烧 token)

扩展字段(任务书 v2 数据模型里没有,r70 已上线,PLAN §3.2 定为条目级可选)

字段 说明
workRanges 正向开工时段:只在窗口内触发;窗口外不记错过,直接预约到下一个窗口开始
maxPerRange 单个开工时段内的触发上限;到顶等下一个班次(跨午夜的窗口过了 00:00 也不清零)

不写这两个字段 = 不启用,行为与任务书模型完全一致。配了 workRanges 时注入的消息会带一行
[班次 22:00-01:30,本班次第 2/3 次] 作为上下文。

工具

工具 行为
mira_active_enable 装闹钟。不给 alarmId 时按当前会话:复用该会话的 default 条目,没有就新建(默认 random perDay=6,可用 config.defaultSchedule 改)。create:true 强制新建一条(同会话要多条时用)。带 alarmId 且显式给不同的 sessionId = 改绑到新会话(stats 与 nextAt 原样保留,返回 rebound:{from,to};不显式给 sessionId 则不会改绑)
mira_active_disable 给 alarmId 只停那一条;不给则停掉当前会话全部闹钟并在返回里列出关掉的 id。条目保留不删
mira_active_list 条目清单:id/sessionId/enabled/schedule/nextAt(ISO + 还有多少分钟)/stats/quiet/limits,可按会话过滤
mira_active_fire_now 立刻触发一次,不改 schedule(例外:once 触发后自动停用,投递失败按 failBackoffMinutes 改 nextAt)。只跳过时间判断:静默仍然生效(返回 fired:false, reason:"quiet",missedCount+1)
mira_active_pause 临时停/恢复一条,不动其他配置
mira_active_remove 删除一条(连统计)。只是想别响请用 pause/disable
mira_active_status 只读:条目数/启用数/涉及几个会话/最近触发/失败与错过/定时器在跑吗/上次错误/加载告警/致命错误详情

「当前会话」优先取工具上下文的 exec.agent.session.id(会话日志的权威 id;resume / 克隆 / rekey 后
exec.agent.id 可能还是旧 id),没有再回退 exec.agent.id。所以必须在会话里调用;两者都拿不到
又没给 sessionId 时返回 config/missing,不会猜。

配置(profile 的 cordis patch)

键 默认 说明
enabled true false = 不注册工具、不起定时器
defaultSchedule { "type": "random", "perDay": 6 } mira_active_enable 不带 schedule 时用它
defaultPrompt 内置一句话 enable 不带 prompt 时用它({mode:"single"|"list", …})
defaultQuiet 不静默 enable 不带 quiet 时用它({enabled, ranges})
defaultLimits 见上表 enable 不带 limits 时用它
defaultWorkRanges 不设限 扩展字段的条目级默认值
defaultMaxPerRange 0 扩展字段的条目级默认值

旧版配置键(0.2.0)怎么映射

0.2.0 的配置是「每会话一条 + 全局节奏」,这些键在 0.3.0 里没有同名对应物。
为了不让升级变成「静默行为变化」(最糟的一种:静默时段消失、凌晨照响),插件会把它们
映射成新建闹钟的默认值,并在日志和 mira_active_status.warnings / legacyConfigKeys 里点名:

旧键 映射到 换算
intervalMinMinutes / intervalMaxMinutes defaultSchedule: {type:"random", range:[…]} range[0]=ceil(1440/max)、range[1]=floor(1440/min);30–90 分钟 → [16, 48]
quietRanges defaultQuiet.ranges 原样
prompts defaultPrompt 1 条 → single,多条 → list
maxPerDay defaultLimits.maxPerDay 原样
sameSessionGapMinutes defaultLimits.minGapMinutes 原样
workRanges / maxPerRange defaultWorkRanges / defaultMaxPerRange 原样
tickMs / statePath —(忽略,会点名) 定时器改成睡到最近 nextAt;状态文件路径由目录约定取代

这不是静默兼容:旧键只做兜底默认值,且一定会被 warn 点名。请把 profile 里的这些键删掉、
改成上面的新结构(defaultQuiet 等)。映射只影响新建的闹钟;已存在的条目保持自己的配置。

定时器怎么跑

不是固定节拍轮询,而是睡到最近一条 nextAt(下限 1 秒、上限 60 秒,避免睡死或空转)。
醒来后把到点的条目按 nextAt 升序逐条处理,本次到点的条目处理完后回写一次文件。
不会重读状态文件或配置:外部改动要重载插件才生效(见上面「状态文件是内存镜像」)。

五种结果分开计数(mira_active_status.counters 里能区分,否则分不清「用户设了静默」和「会话没了」):

结果 计数键 是否记 missed
静默命中 fire.missed.quiet 是(missedCount+1)
不在开工时段 fire.skipped.work 否(预约到窗口开始)
撞 maxPerDay fire.skipped.maxPerDay 否
撞 maxPerRange fire.skipped.maxPerRange 否(等下一个班次)
距上次太近 fire.skipped.minGap 否
投递失败 fire.fail 否(走退避)
停机期间错过 — 是(加载时每条只记 1 次,不补发)

已知取舍

  1. 随机是「期望次数」不是「固定次数」:perDay:6 按下平均 4 小时的间隔采样,实际落在
    2.4–5.6 小时。真正「每天恰好 6 次均匀分布」需要预生成当天时刻表,那是另一种产品口径;
    任务书写的是「期望次数或区间」,这里按期望实现。单日硬上限仍由 limits.maxPerDay 兜。
  2. 静默命中后落到「下一个排定时刻」,不是「下一个不被静默的时刻」。daily 08:30 配静默
    08:00–09:00:08:30 那次被记为错过,下一次是明天 08:30;今天 09:00 不会补响。
    若排定时刻本身就在静默里(如每天 02:00 配静默 01:00–07:00),它会每天记一次 misses ——
    这是「不推迟」的必然代价,配置时请让两者错开。
  3. disable 不带 alarmId = 关掉该会话全部闹钟,并把 id 列出来。任务书只说「按当前会话」,
    一闹钟一条之后「关哪条」必须定口径:全关 + 明确回报比「关最近一条」可预测。
  4. enable 不带 alarmId 默认复用,要新增第二条必须显式 create:true。否则重复调用会
    不断堆条目,而这正是旧版「幂等 enable」的语义。
  5. once 拒绝过去时刻。过去时刻如果被接受,重启后会立刻触发一堆历史闹钟(功能点11 要
    避免的正是这个)。要手动补一次用 mira_active_fire_now。
  6. fire_now 仍然受静默约束(PLAN B8)。手动触发是「不等时间」,不是「忽略用户的静默设置」。
  7. 热重载不丢状态:卸载时先摘工具 → 停定时器并落盘 → 释放单实例认领,新实例随后 load
    拿到的是最新文件。旧实例不会用旧内存覆盖新落盘(约定9 的踩坑点)。
  8. alarms.json 坏了/版本不符 → 拒绝使用且拒绝写盘。宁可插件报错,也不拿空表覆盖用户的
    闹钟。mira_active_status.fatalError 里有 code/message/hint。手改文件里个别条目坏掉
    (比如 schedule 非法)只跳过那一条并 warn,不影响其他条目。

迁移(0.2.0 → 0.3.0)

旧版把状态写在 /mira_active.json(每会话一条 + 全局 intervalMin/MaxMinutes)。
新版是一闹钟一条。转换脚本:

# 1. 先看计划(默认 dry-run)
node 重构插件/migrate/active.mjs --interval-min 30 --interval-max 90 \
--quiet 01:00-07:00 --prompt "该起来了" --max-per-day 8

# 2. 确认后写入(写前备份旧文件,写完把旧文件改名成 .bak.<时间戳>)
node 重构插件/migrate/active.mjs … --write

换算口径(脚本会把算式打出来,自己核对):

旧:两次激活相隔 [intervalMin, intervalMax] 分钟
新:perDay 是每天期望次数,平均间隔 = 1440/perDay
range[0] = ceil(1440 / intervalMax)    ← 最长间隔对应最少次数
range[1] = floor(1440 / intervalMin)   ← 最短间隔对应最多次数
例:30–90 分钟  →  每天 16–48 次

intervalMin/MaxMinutes、quietRanges、prompts、maxPerDay 原本在 profile 的 cordis patch 里,
脚本用命令行参数接(它读不到你的 profile);profile 里这几项在新版不再生效,
请在迁移后从 patch 里删掉,避免误以为还在用。

语义差异要自己确认:sameSessionGapMinutes 会映射成条目级 limits.minGapMinutes ——
多条闹钟挂同一会话时,间隔不再跨条目生效;tickMs 没有对应物(定时器改成睡到最近 nextAt)。
旧版「带 workRanges 时写的 day/dayCount/rangeDay/rangeCount」只影响统计,迁移脚本按
count 换算 fireCount,其余归零。

自检

cd mira_active && node test/smoke.mjs       # 期望末行:==== ALL PASS(148 项断言)====,退出码 0
node ../重构插件/tools/check-zero-dep.mjs   # 只许 node: 与相对 import
node ../重构插件/tools/check-kit.mjs        # lib/kit.mjs 与规范源逐字节一致

smoke 用注入时钟(new ActiveEngine({ now }))与假投递器,在临时 DSH_HOME 里跑,
不依赖 DSH 运行时、不碰真实配置,也不等待真实时间。覆盖 PLAN §1.2 的 B2–B17。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
mira_active 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Stella-Mira/mira_active` 即可。

mira_active 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

mira_active 安全吗?

低风险。

mira_active 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

mira_active 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

Stella-Mira 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。