@koishi-ce/plugin-status 1.0.0

package/dist/index.css

@@ -0,0 +1,2 @@
+.status-light[data-v-ea7f6fce]{transition:var(--color-transition);border-radius:.625rem;width:.625rem;height:.625rem}.status-light.online[data-v-ea7f6fce]{background-color:var(--k-color-success)}.status-light.connect[data-v-ea7f6fce],.status-light.reconnect[data-v-ea7f6fce]{background-color:var(--k-color-warning)}.status-light.error[data-v-ea7f6fce]{background-color:var(--k-color-danger)!important}.status-light.offline[data-v-ea7f6fce]{background-color:var(--k-color-disabled)}.status-light+.status-light[data-v-ea7f6fce]{margin-left:4px}.bot-view[data-v-1cbf178f]{width:15rem;padding:.75rem 1rem;font-size:14px;transition:all .3s;display:flex}.bot-view+.bot-view[data-v-1cbf178f]{border-top:1px solid var(--k-color-divider)}.bot-view.active>div.avatar[data-v-1cbf178f]{border-color:var(--active)}.bot-view>div.avatar[data-v-1cbf178f]{box-sizing:content-box;border:1px solid var(--k-color-divider);background-repeat:no-repeat;background-size:100%;border-radius:100%;flex-shrink:0;width:4rem;height:4rem;transition:all .1s;position:relative}.bot-view>div.avatar .status-light[data-v-1cbf178f]{border:1px solid var(--k-color-divider);width:.875rem;height:.875rem;position:absolute;bottom:-1px;right:-1px}.bot-view>div.info[data-v-1cbf178f]{flex-direction:column;flex-grow:1;justify-content:space-around;margin-left:1.25rem;display:flex;overflow:hidden}.bot-view>div.info .k-icon[data-v-1cbf178f]{text-align:center;vertical-align:-2px;width:20px;margin-right:6px}.bot-view.has-link[data-v-1cbf178f]{cursor:pointer}.bot-view.has-link[data-v-1cbf178f]:hover{background-color:var(--bg1)}.k-status .k-icon[data-v-e9800c9a]{margin-right:4px}.k-status *+.k-icon[data-v-e9800c9a]{margin-left:6px}.k-status .count[data-v-e9800c9a]{letter-spacing:1px;margin:0 4px}.bots-container .bot-view[data-v-19020f78]{background-color:var(--bg0);border-radius:.5rem}p[data-v-184a36f6]{margin:8px;padding:0 6px;font-size:12px;line-height:1}.info[data-v-184a36f6]{padding-left:20px}.load-bar[data-v-c8d81760]{-webkit-user-select:none;user-select:none;align-items:center;margin:.5rem 0;font-size:.9em;display:flex}.load-bar .title[data-v-c8d81760]{min-width:3em}.load-bar .body[data-v-c8d81760]{background-color:var(--k-c-divisor);width:10rem;height:.8rem;transition:var(--color-transition);color:var(--fg1);border-radius:1rem;font-size:10px;display:inline;position:relative;overflow:hidden}.load-bar .bar[data-v-c8d81760]{float:left;white-space:pre;justify-content:center;align-items:center;height:100%;display:flex;position:relative}.load-bar .used[data-v-c8d81760]{background-color:var(--primary);color:#fff;transition:color .3s,background-color .3s}.load-bar .used[data-v-c8d81760]:hover{background-color:var(--primary-tint,var(--primary))}.load-bar .app[data-v-c8d81760]{background-color:var(--k-color-warning);transition:color .3s,background-color .3s}.load-bar .app[data-v-c8d81760]:hover{background-color:var(--k-color-warning-tint,var(--k-color-warning))}.load[data-v-8c7391c4]{padding:.25rem 1rem}.absolute{position:absolute}.relative{position:relative}.inline{display:inline}.hidden{display:none}.h2{height:.5rem}.flex{display:flex}.flex-shrink{flex-shrink:1}.flex-grow{flex-grow:1}.flex-wrap{flex-wrap:wrap}.gap-4{gap:1rem}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.border{border-width:1px}.transition{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke,opacity,box-shadow,transform,filter,-webkit-backdrop-filter,backdrop-filter;transition-duration:.15s;transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease{transition-timing-function:cubic-bezier(.4,0,.2,1)}
+/*$vite$:1*/

package/dist/index.js

@@ -0,0 +1,4 @@
+import{Schema as e,Universal as t,capitalize as n,icons as r,message as i,router as a,store as o,useConfig as ee,withProxy as s}from"@koishi-ce/client";import{Fragment as c,computed as l,createBlock as u,createCommentVNode as d,createElementBlock as f,createElementVNode as p,createTextVNode as m,createVNode as h,defineComponent as g,inject as _,normalizeClass as v,normalizeStyle as y,openBlock as b,renderList as x,resolveComponent as S,toDisplayString as C,unref as w,withCtx as T}from"vue";var te=g({__name:`analytics`,setup(e){let t=_(`component:analytic-number`),n=l(()=>Object.values(o.status.bots).reduce((e,t)=>e+t.messageReceived,0)/60),r=l(()=>Object.values(o.analytics.messageByDate).slice(-7).reduce((e,t)=>e+t.receive,0)/7/24/60/60);return(e,i)=>(b(),u(w(t),{icon:`analytic:pulse`,title:`当前 QPS`},{default:T(()=>[m(C(+n.value.toFixed(2)),1)]),"footer-left":T(()=>[...i[0]||=[m(`近期 QPS`,-1)]]),"footer-right":T(()=>[m(C(+r.value.toFixed(2)),1)]),_:1}))}}),E=(e,t)=>{let n=e.__vccOpts||e;for(let[e,r]of t)n[e]=r;return n},D={},O={class:`status-light`};function ne(e,t){return b(),f(`span`,O)}var k=E(D,[[`render`,ne],[`__scopeId`,`data-v-ea7f6fce`]]),A={OFFLINE:0,ONLINE:1,CONNECT:2,DISCONNECT:3,RECONNECT:4};function j(e){switch(e){case A.OFFLINE:return`offline`;case A.ONLINE:return`online`;case A.CONNECT:return`connect`;case A.DISCONNECT:return`disconnect`;case A.RECONNECT:return`reconnect`}}var M={class:`bot-view`},N={class:`info`},P=[`title`],F=[`title`],I={class:`truncate cur-frequency`},L={style:{"margin-right":`8px`}},R=E(g({__name:`preview`,props:{data:{}},setup(e){let n={[t.Status.ONLINE]:`运行中`,[t.Status.OFFLINE]:`离线`,[t.Status.CONNECT]:`正在连接`,[t.Status.RECONNECT]:`正在重连`,[t.Status.DISCONNECT]:`正在断开`};return(t,r)=>{let i=S(`el-tooltip`),a=S(`k-icon`);return b(),f(`section`,M,[p(`div`,{class:`avatar`,style:y({backgroundImage:`url(${w(s)(e.data.user.avatar)})`}),onClick:r[0]||=e=>t.$emit(`avatar-click`)},[h(i,{content:n[e.data.status],placement:`right`},{default:T(()=>[h(k,{class:v(w(j)(e.data.status))},null,8,[`class`])]),_:1},8,[`content`])],4),p(`div`,N,[p(`div`,{class:`truncate`,title:e.data.user.name},[h(a,{name:`robot`}),m(C(e.data.user.name),1)],8,P),p(`div`,{class:`truncate`,title:e.data.platform},[h(a,{name:`platform`}),m(C(e.data.platform),1)],8,F),p(`div`,I,[p(`span`,L,[h(a,{name:`arrow-up`}),p(`span`,null,C(e.data.messageSent)+`/min`,1)]),p(`span`,null,[h(a,{name:`arrow-down`}),p(`span`,null,C(e.data.messageReceived)+`/min`,1)])])])])}}}),[[`__scopeId`,`data-v-1cbf178f`]]),z={key:0,class:`el-popper__empty`},B={class:`count`},V=E(g({__name:`index`,setup(e){let t=ee(),n=l(()=>{let e={};for(let t of Object.values(o.status.bots)){let n=j(t.status);e[n]=(e[n]||0)+1}return Object.fromEntries(Object.entries(e).sort((e,t)=>e[0].localeCompare(t[0])))}),r=l(()=>Object.values(o.status.bots).reduce((e,t)=>e+t.messageSent,0)),i=l(()=>Object.values(o.status.bots).reduce((e,t)=>e+t.messageReceived,0));return(e,ee)=>{let s=S(`k-icon`),l=S(`k-status`);return w(o).status?(b(),u(l,{key:0},{tooltip:T(()=>[Object.values(w(o).status.bots).length?d(`v-if`,!0):(b(),f(`span`,z)),(b(!0),f(c,null,x(w(o).status.bots,(e,t)=>(b(),u(R,{key:t,data:e,class:v({"has-link":e.paths?.length}),onClick:t=>w(a).push(`/plugins/`+e.paths[0].replace(/\./,`/`))},null,8,[`data`,`class`,`onClick`]))),128))]),default:T(()=>[(b(!0),f(c,null,x(n.value,(e,n)=>(b(),f(c,{key:n},[e>(w(t).mergeThreshold??10)?(b(),f(c,{key:0},[h(k,{class:v(n)},null,8,[`class`]),p(`span`,B,`×`+C(e),1)],64)):(b(!0),f(c,{key:1},x(Array(e),(e,t)=>(b(),u(k,{key:t,class:v(n)},null,8,[`class`]))),128))],64))),128)),h(s,{name:`arrow-up`}),p(`span`,null,C(r.value)+`/min`,1),h(s,{name:`arrow-down`}),p(`span`,null,C(i.value)+`/min`,1)]),_:1})):d(`v-if`,!0)}}}),[[`__scopeId`,`data-v-e9800c9a`]]),H=e=>{e.slot({type:`status-right`,component:V})},U={class:`bots-container flex flex-wrap gap-4`},W=E(g({__name:`config`,setup(e){let t=_(`manager.settings.current`),n=l(()=>Object.values(o.status?.bots||{}).filter(e=>e.paths?.includes(t.value.path)));return(e,t)=>n.value?.length?(b(),f(c,{key:0},[t[0]||=p(`h2`,{class:`k-schema-header`},` 机器人 `,-1),p(`div`,U,[(b(!0),f(c,null,x(n.value,(e,t)=>(b(),u(R,{key:t,data:e},null,8,[`data`]))),128))])],64)):d(`v-if`,!0)}}),[[`__scopeId`,`data-v-19020f78`]]);async function G(e){try{return navigator.clipboard.writeText(e)}catch{let t=document.createElement(`textarea`),n=document.activeElement;t.value=e,t.setAttribute(`readonly`,``),t.style.contain=`strict`,t.style.position=`absolute`,t.style.left=`-9999px`,t.style.fontSize=`12pt`;let r=document.getSelection(),i=r?r.rangeCount>0&&r.getRangeAt(0):null;document.body.appendChild(t),t.select(),t.selectionStart=0,t.selectionEnd=e.length,document.execCommand(`copy`),document.body.removeChild(t),i&&r&&(r.removeAllRanges(),r.addRange(i)),n&&n.focus()}}var K={class:`title`},q=E(g({__name:`envinfo`,setup(e){async function t(){await G(Object.entries(o.envinfo).map(([e,t])=>`${n(e)}:\n`+Object.entries(t).map(([e,t])=>`    ${e}: ${t}`).join(`
+`)).join(`
+
+`)),i.success(`已复制环境信息！`)}return(e,r)=>{let i=S(`k-status`);return w(o).envinfo?(b(),u(i,{key:0,class:`version`,onClick:t},{tooltip:T(()=>[(b(!0),f(c,null,x(w(o).envinfo,(e,t)=>(b(),f(`div`,{class:`section`,key:t},[p(`p`,K,C(w(n)(t))+`:`,1),(b(!0),f(c,null,x(e,(e,t)=>(b(),f(`p`,{class:`info`,key:t},C(t)+`: `+C(e),1))),128))]))),128))]),default:T(()=>[m(` Koishi v`+C(w(o).envinfo.koishi.Core)+` `,1)]),_:1})):d(`v-if`,!0)}}}),[[`__scopeId`,`data-v-184a36f6`]]),J={class:`load-bar`},Y={class:`title`},X={class:`body`},Z=E(g({__name:`load-bar`,props:{rate:{},title:{}},setup(e){let t=e;function n(e,t=1){return`${+(e*100).toFixed(t)}%`}let r=[`used`,`app`,`free`],i=l(()=>[t.rate[1]-t.rate[0],t.rate[0],1-t.rate[1]]),a=l(()=>i.value.findIndex(e=>e>=.5)),o=l(()=>`${n(t.rate[0],1)} / ${n(t.rate[1],1)}`);return(t,ee)=>(b(),f(`div`,J,[p(`span`,Y,C(e.title),1),p(`span`,X,[(b(),f(c,null,x(r,(e,t)=>p(`span`,{key:e,class:v([e,`bar`]),style:y({width:n(i.value[t])})},[t===a.value?(b(),f(c,{key:0},[m(C(o.value),1)],64)):a.value===-1&&i.value[t]>=.2?(b(),f(c,{key:1},[m(C(n(i.value[t])),1)],64)):d(`v-if`,!0)],6)),64))])]))}}),[[`__scopeId`,`data-v-c8d81760`]]);function Q(e,t=3){return`${(e*100).toFixed(t)}%`}var re={class:`load`},ie=E(g({__name:`index`,setup(e){return(e,t)=>{let n=S(`k-status`);return w(o).status?(b(),u(n,{key:0},{tooltip:T(()=>[p(`div`,re,[h(Z,{title:`CPU`,rate:w(o).status.cpu},null,8,[`rate`]),h(Z,{title:`内存`,rate:w(o).status.memory},null,8,[`rate`])])]),default:T(()=>[m(` CPU: `+C(w(Q)(w(o).status.cpu[1],0))+` 内存: `+C(w(Q)(w(o).status.memory[1],0)),1)]),_:1})):d(`v-if`,!0)}}}),[[`__scopeId`,`data-v-8c7391c4`]]),ae=e=>{e.slot({type:`status-right`,component:ie})},oe={},se={class:`k-icon`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 384 512`};function ce(e,t){return b(),f(`svg`,se,[...t[0]||=[p(`path`,{fill:`currentColor`,d:`M377.4 296.6l-168 176C204.8 477.3 198.6 480 192 480s-12.84-2.688-17.38-7.438l-168-176C-2.5 286.1-2.156 271.8 7.438 262.6c9.5-9.156 24.75-8.812 33.94 .8125L168 396.1V56.02c0-13.25 10.75-24.01 23.1-24.01S216 42.77 216 56.02v340.1l126.6-132.7c9.156-9.625 24.41-9.969 33.94-.8125C386.2 271.8 386.5 286.1 377.4 296.6z`},null,-1)]])}var le=E(oe,[[`render`,ce]]),ue={},de={class:`k-icon`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 384 512`};function fe(e,t){return b(),f(`svg`,de,[...t[0]||=[p(`path`,{fill:`currentColor`,d:`M6.625 215.5l168-176C179.2 34.7 185.4 32.02 192 32.02s12.84 2.688 17.38 7.438l168 176c9.125 9.594 8.781 24.78-.8125 33.94c-9.5 9.156-24.75 8.812-33.94-.8125L216 115.9V456c0 13.25-10.75 23.1-23.1 23.1S168 469.3 168 456V115.9l-126.6 132.7C32.22 258.2 16.97 258.5 7.438 249.4C-2.156 240.2-2.5 225 6.625 215.5z`},null,-1)]])}var pe=E(ue,[[`render`,fe]]),me={},he={class:`k-icon`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 512 512`};function ge(e,t){return b(),f(`svg`,he,[...t[0]||=[p(`path`,{fill:`currentColor`,d:`M12.41 148.02l232.94 105.67c6.8 3.09 14.49 3.09 21.29 0l232.94-105.67c16.55-7.51 16.55-32.52 0-40.03L266.65 2.31a25.607 25.607 0 0 0-21.29 0L12.41 107.98c-16.55 7.51-16.55 32.53 0 40.04zm487.18 88.28l-58.09-26.33-161.64 73.27c-7.56 3.43-15.59 5.17-23.86 5.17s-16.29-1.74-23.86-5.17L70.51 209.97l-58.1 26.33c-16.55 7.5-16.55 32.5 0 40l232.94 105.59c6.8 3.08 14.49 3.08 21.29 0L499.59 276.3c16.55-7.5 16.55-32.5 0-40zm0 127.8l-57.87-26.23-161.86 73.37c-7.56 3.43-15.59 5.17-23.86 5.17s-16.29-1.74-23.86-5.17L70.29 337.87 12.41 364.1c-16.55 7.5-16.55 32.5 0 40l232.94 105.59c6.8 3.08 14.49 3.08 21.29 0L499.59 404.1c16.55-7.5 16.55-32.5 0-40z`},null,-1)]])}var _e=E(me,[[`render`,ge]]),ve={},ye={class:`k-icon`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 640 512`};function be(e,t){return b(),f(`svg`,ye,[...t[0]||=[p(`path`,{fill:`currentColor`,d:`M640 240C640 248.8 632.8 256 624 256h-133.1l-60 150c-2.625 6.375-8.375 10.25-16 9.1C408 415.5 402.1 410.6 400.5 403.9l-78.75-315l-82 410.3C238.3 506.5 231.9 511.8 224.4 512H224c-7.25 0-13.75-5-15.5-12.12L147.5 256H16C7.201 256 0 248.8 0 240s7.201-15.1 16-15.1H160c7.375 0 13.75 4.993 15.5 12.12l46.75 187l82-410.3C305.8 5.5 312 .25 319.5 0c8.125 .125 14.25 4.875 16 12.12l84 336l45.63-114.1C467.5 228 473.5 224 480 224h144C632.8 224 640 231.2 640 240z`},null,-1)]])}var $=E(ve,[[`render`,be]]),xe={},Se={class:`k-icon`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 640 512`};function Ce(e,t){return b(),f(`svg`,Se,[...t[0]||=[p(`path`,{fill:`currentColor`,d:`M32,224H64V416H32A31.96166,31.96166,0,0,1,0,384V256A31.96166,31.96166,0,0,1,32,224Zm512-48V448a64.06328,64.06328,0,0,1-64,64H160a64.06328,64.06328,0,0,1-64-64V176a79.974,79.974,0,0,1,80-80H288V32a32,32,0,0,1,64,0V96H464A79.974,79.974,0,0,1,544,176ZM264,256a40,40,0,1,0-40,40A39.997,39.997,0,0,0,264,256Zm-8,128H192v32h64Zm96,0H288v32h64ZM456,256a40,40,0,1,0-40,40A39.997,39.997,0,0,0,456,256Zm-8,128H384v32h64ZM640,256V384a31.96166,31.96166,0,0,1-32,32H576V224h32A31.96166,31.96166,0,0,1,640,256Z`},null,-1)]])}var we=E(xe,[[`render`,Ce]]);r.register(`arrow-up`,pe),r.register(`arrow-down`,le),r.register(`platform`,_e),r.register(`analytic:pulse`,$),r.register(`robot`,we);var Te=t=>{t.plugin(H),t.plugin(ae),t.slot({type:`status-left`,component:q}),t.slot({type:`analytic-number`,component:te}),t.slot({type:`plugin-details`,component:W,order:-500}),t.settings({id:`status`,schema:e.object({mergeThreshold:e.number().default(10).description(`当机器人的数量超过这个值时将合并显示状态指示灯。`)}).description(`机器人设置`)})};export{Te as default};

package/lib/assets/zh-CN-BHjPKRmW.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 查看运行状态
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>[{platform}] {user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/lib/index.d.ts

@@ -0,0 +1,115 @@
+import { Bot, Context, Dict, Schema, Universal } from "@koishi-ce/koishi";
+import { DataService } from "@koishi-ce/console";
+//#region src/envinfo.d.ts
+declare class EnvInfoProvider extends DataService<Dict<Dict<string>>> {
+  /** 采集任务的缓存：get() 首次调用时创建，之后始终复用同一 Promise。 */
+  private task;
+  config: EnvInfoProvider.Config;
+  constructor(ctx: Context, config: EnvInfoProvider.Config);
+  /** 执行一次实际采集：系统信息、运行时版本、Koishi 生态版本。 */
+  _get(): Promise<Dict<Dict<string>>>;
+  /** 首次调用时发起采集并缓存 Promise，后续调用直接返回同一结果。 */
+  get(): Promise<Dict<Dict<string>>>;
+  static Config: Schema<EnvInfoProvider.Config>;
+}
+declare namespace EnvInfoProvider {
+  type Config = Record<never, never>;
+}
+//#endregion
+//#region src/profile.d.ts
+declare module "@koishi-ce/koishi" {
+  interface Bot {
+    _messageSent: TickCounter;
+    _messageReceived: TickCounter;
+  }
+}
+/**
+ * 滑动窗口计数器：以 60 个槽位统计最近一分钟内的事件次数。
+ *
+ * 每秒执行一次 tick，队头插入 0 并丢弃队尾，窗口随时间向前滑动；
+ * add() 累加到当前秒所在的队头槽位，get() 求整个窗口的和。
+ * 每个 bot 挂载两个实例（_messageSent / _messageReceived）分别统计收发消息。
+ */
+declare class TickCounter {
+  /** 停止内部定时器（随上下文销毁由调用方触发）。 */
+  stop: () => void;
+  /** 60 个槽位的环形数据，data[0] 恒为当前秒的计数。 */
+  private data;
+  private tick;
+  constructor(ctx: Context);
+  /** 在当前秒的槽位上累加计数。 */
+  add(value?: number): void;
+  /** 返回最近一分钟内的总计数。 */
+  get(): any;
+  /** 为指定 bot 初始化收/发两个计数器。 */
+  static initialize(bot: Bot, ctx: Context): void;
+}
+/** 负载率二元组：[app, total]，app 为本进程占比，total 为整机占比，取值 0~1。 */
+type LoadRate = [app: number, total: number];
+/**
+ * 性能数据服务：以 DataService 形式向前端广播 Payload，
+ * 前端经 store.status 读取（键名即服务名 "status"）。
+ */
+declare class ProfileProvider extends DataService<ProfileProvider.Payload> {
+  cached: ProfileProvider.Payload | undefined;
+  config: ProfileProvider.Config;
+  constructor(ctx: Context, config: ProfileProvider.Config);
+  /**
+   * 采集一帧性能数据：CPU 占用率、内存占用率与各机器人收发速率。
+   *
+   * @param forced 为 true 时跳过缓存强制重算（refresh 链路会传入）
+   */
+  get(forced?: boolean): Promise<ProfileProvider.Payload>;
+  static Config: Schema<ProfileProvider.Config>;
+}
+declare namespace ProfileProvider {
+  interface Config {
+    /** 采集与推送性能数据的时间间隔（毫秒），默认 5 秒。 */
+    tickInterval?: number;
+  }
+  /** 推送给前端的单个机器人数据：登录信息 + 错误消息 + 配置路径 + 收发速率。 */
+  interface BotData extends Universal.Login {
+    error?: string;
+    paths?: string[];
+    messageSent: number;
+    messageReceived: number;
+  }
+  /** 每次采集推送给前端的完整负载：内存 / CPU 负载率与机器人数据字典。 */
+  interface Payload {
+    memory: LoadRate;
+    cpu: LoadRate;
+    bots: Dict<BotData>;
+  }
+}
+//#endregion
+//#region src/index.d.ts
+/** 频道活跃度记录：键为小时数（0~23），值为该小时内触发频道的次数。 */
+type Activity = Record<number, number>;
+declare module "@koishi-ce/koishi" {
+  interface Channel {
+    name: string;
+    activity: Activity;
+  }
+}
+declare module "@koishi-ce/console" {
+  namespace Console {
+    interface Services {
+      envinfo: EnvInfoProvider;
+      status: ProfileProvider;
+    }
+  }
+}
+declare const name = "status";
+declare const inject: string[];
+interface Config extends ProfileProvider.Config, EnvInfoProvider.Config {}
+declare const Config: Schema<Config>;
+/**
+ * 插件入口：注册控制台前端资源（dev 指向 client 源码，prod 指向构建产物），
+ * 再将环境信息与性能采集两个服务作为子插件挂载，共享同一份配置。
+ *
+ * @param ctx 应用上下文
+ * @param config 插件配置（两个子服务配置的交集合并）
+ */
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Activity, Config, EnvInfoProvider, LoadRate, ProfileProvider, apply, inject, name };

package/lib/index.mjs

@@ -0,0 +1,260 @@
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { Schema, Time, version } from "@koishi-ce/koishi";
+import { readFile } from "node:fs/promises";
+import { DataService } from "@koishi-ce/console";
+import { helpers } from "envinfo";
+import { cpus, freemem, totalmem } from "node:os";
+import zhCN from "./assets/zh-CN-BHjPKRmW.yml";
+//#region \0rolldown/runtime.js
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
+//#endregion
+//#region src/envinfo.ts
+/**
+* 运行环境信息服务（服务名 "envinfo"）。
+*
+* 一次性采集系统与运行时版本信息，整理为 { system, binaries, koishi }
+* 三组分节字符串字典，供控制台前端在状态栏展示与一键复制。
+* 环境信息在进程生命周期内不会变化，因此采集结果以 Promise 形式永久缓存。
+*/
+const whichPMRuns = createRequire(import.meta.url)("which-pm-runs");
+var EnvInfoProvider = class extends DataService {
+	/** 采集任务的缓存：get() 首次调用时创建，之后始终复用同一 Promise。 */
+	task;
+	config;
+	constructor(ctx, config) {
+		super(ctx, "envinfo");
+		this.config = config;
+	}
+	/** 执行一次实际采集：系统信息、运行时版本、Koishi 生态版本。 */
+	async _get() {
+		const [[, Os = ""], [, Cpu = ""]] = await Promise.all([helpers.getOSInfo(), helpers.getCPUInfo()]);
+		const agent = whichPMRuns();
+		const system = {
+			OS: Os,
+			CPU: Cpu
+		};
+		const binaries = { Node: process.versions.node };
+		if (agent) {
+			if (agent.name === "yarn") agent.name = "Yarn";
+			binaries[agent.name] = agent.version;
+		}
+		const metapath = __require.resolve("@koishi-ce/console/package.json");
+		const meta = await readFile(metapath, "utf8").then(JSON.parse);
+		const koishi = {
+			Core: version,
+			Console: meta.version
+		};
+		if (process.env["KOISHI_AGENT"]) {
+			const [name, agentVersion] = process.env["KOISHI_AGENT"].split("/");
+			if (name && agentVersion) koishi[name] = agentVersion;
+		}
+		return {
+			system,
+			binaries,
+			koishi
+		};
+	}
+	/** 首次调用时发起采集并缓存 Promise，后续调用直接返回同一结果。 */
+	async get() {
+		if (!this.task) this.task = this._get();
+		return this.task;
+	}
+	static Config = Schema.object({});
+};
+//#endregion
+//#region src/profile.ts
+/**
+* 性能数据采集服务（服务名 "status"）。
+*
+* 周期性采集三类指标并推送给控制台前端：
+* - CPU：进程占用率与整机占用率（基于两次采样差值计算）；
+* - 内存：进程 RSS 占比与整机已用占比；
+* - 机器人：每个 bot 最近一分钟的消息收发量（TickCounter 滑动窗口）。
+*
+* 另提供 `status` 指令，在聊天环境内以文本形式输出各机器人状态摘要。
+*/
+/**
+* 滑动窗口计数器：以 60 个槽位统计最近一分钟内的事件次数。
+*
+* 每秒执行一次 tick，队头插入 0 并丢弃队尾，窗口随时间向前滑动；
+* add() 累加到当前秒所在的队头槽位，get() 求整个窗口的和。
+* 每个 bot 挂载两个实例（_messageSent / _messageReceived）分别统计收发消息。
+*/
+var TickCounter = class TickCounter {
+	/** 停止内部定时器（随上下文销毁由调用方触发）。 */
+	stop;
+	/** 60 个槽位的环形数据，data[0] 恒为当前秒的计数。 */
+	data = new Array(60).fill(0);
+	tick = () => {
+		this.data.unshift(0);
+		this.data.splice(-1, 1);
+	};
+	constructor(ctx) {
+		this.stop = ctx.setInterval(() => this.tick(), Time.second);
+	}
+	/** 在当前秒的槽位上累加计数。 */
+	add(value = 1) {
+		this.data[0] += value;
+	}
+	/** 返回最近一分钟内的总计数。 */
+	get() {
+		return this.data.reduce((prev, curr) => prev + curr, 0);
+	}
+	/** 为指定 bot 初始化收/发两个计数器。 */
+	static initialize(bot, ctx) {
+		bot._messageSent = new TickCounter(ctx);
+		bot._messageReceived = new TickCounter(ctx);
+	}
+};
+let usage = getCpuUsage();
+let appRate;
+let usedRate;
+/** 采集内存负载率：[进程 RSS / 总内存, 1 - 空闲内存 / 总内存]。 */
+async function memoryRate() {
+	const total = totalmem();
+	return [process.memoryUsage().rss / total, 1 - freemem() / total];
+}
+/**
+* 读取一次 CPU 累计时间快照。
+*
+* - app：进程用户态 CPU 时间（cpuUsage().user，毫秒）；
+* - used：所有核心的 累计时间 - 空闲时间（毫秒）；
+* - total：所有核心的累计时间总和（毫秒）。
+* 单次快照只是累计值，需经 updateCpuUsage() 做差才能得到占用率。
+*/
+function getCpuUsage() {
+	let totalIdle = 0, totalTick = 0;
+	const cpuInfo = cpus();
+	const usage = process.cpuUsage().user;
+	for (const cpu of cpuInfo) {
+		for (const time of Object.values(cpu.times)) totalTick += time;
+		totalIdle += cpu.times.idle;
+	}
+	return {
+		app: usage / 1e3,
+		used: totalTick - totalIdle,
+		total: totalTick
+	};
+}
+/**
+* 用新快照与上次快照的差值计算 CPU 占用率并缓存到模块级变量：
+* appRate = 本进程增量时间 / 全机总增量时间，usedRate 同理（整机口径）。
+*/
+function updateCpuUsage() {
+	const newUsage = getCpuUsage();
+	const totalDifference = newUsage.total - usage.total;
+	appRate = (newUsage.app - usage.app) / totalDifference;
+	usedRate = (newUsage.used - usage.used) / totalDifference;
+	usage = newUsage;
+}
+/**
+* 性能数据服务：以 DataService 形式向前端广播 Payload，
+* 前端经 store.status 读取（键名即服务名 "status"）。
+*/
+var ProfileProvider = class extends DataService {
+	config;
+	constructor(ctx, config) {
+		super(ctx, "status");
+		this.config = config;
+		ctx.i18n.define("zh-CN", zhCN);
+		const { tickInterval } = config;
+		ctx.on("ready", () => {
+			ctx.setInterval(() => {
+				updateCpuUsage();
+				this.refresh();
+			}, tickInterval ?? Time.second * 5);
+		});
+		ctx.any().before("send", (session) => {
+			session.bot._messageSent?.add(1);
+		});
+		ctx.any().on("message", (session) => {
+			session.bot._messageReceived?.add(1);
+		});
+		ctx.bots.forEach((bot) => {
+			TickCounter.initialize(bot, ctx);
+		});
+		const update = ctx.debounce(() => this.refresh(), 0);
+		ctx.on("login-added", ({ bot }) => {
+			TickCounter.initialize(bot, ctx);
+			update();
+		});
+		ctx.on("login-removed", ({ bot }) => {
+			bot._messageSent.stop();
+			bot._messageReceived.stop();
+			update();
+		});
+		ctx.on("login-updated", () => {
+			update();
+		});
+		ctx.command("status").action(async ({ session }) => {
+			if (!session) return;
+			const data = await this.get();
+			const output = Object.values(data.bots).map((bot) => {
+				return session.text(".bot", bot);
+			});
+			output.push(session.text(".epilog", data));
+			return output.join("\n");
+		});
+	}
+	/**
+	* 采集一帧性能数据：CPU 占用率、内存占用率与各机器人收发速率。
+	*
+	* @param forced 为 true 时跳过缓存强制重算（refresh 链路会传入）
+	*/
+	async get(forced = false) {
+		if (this.cached && !forced) return this.cached;
+		const memory = await memoryRate();
+		const cpu = [appRate, usedRate];
+		const bots = {};
+		for (const bot of this.ctx.bots) {
+			if (bot.hidden) continue;
+			const paths = this.ctx.get("loader")?.paths(bot.ctx.scope);
+			bots[bot.sid] = {
+				...bot.toJSON(),
+				error: bot.error?.message,
+				messageSent: bot._messageSent.get(),
+				messageReceived: bot._messageReceived.get(),
+				...paths ? { paths } : {}
+			};
+		}
+		return {
+			memory,
+			cpu,
+			bots
+		};
+	}
+	static Config = Schema.object({ tickInterval: Schema.natural().role("ms").description("性能数据推送的时间间隔。").default(Time.second * 5) });
+};
+//#endregion
+//#region src/index.ts
+/**
+* status 插件（node 侧）入口。
+*
+* 插件本体拆分为两个 DataService 子服务：
+* - EnvInfoProvider（envinfo）：一次性采集运行环境信息（OS / CPU / Node / 包管理器等）；
+* - ProfileProvider（profile）：周期性采集性能数据（CPU / 内存 / 各机器人收发消息速率）。
+*
+* 本文件负责注册控制台前端资源入口、以子插件形式挂载上述两个服务，
+* 并合并两者的 Config Schema 作为插件整体配置。
+*/
+const name = "status";
+const inject = ["console"];
+const Config = Schema.intersect([EnvInfoProvider.Config, ProfileProvider.Config]);
+/**
+* 插件入口：注册控制台前端资源（dev 指向 client 源码，prod 指向构建产物），
+* 再将环境信息与性能采集两个服务作为子插件挂载，共享同一份配置。
+*
+* @param ctx 应用上下文
+* @param config 插件配置（两个子服务配置的交集合并）
+*/
+function apply(ctx, config) {
+	ctx.console.addEntry({
+		dev: resolve(__dirname, "../client/index.ts"),
+		prod: resolve(__dirname, "../dist")
+	});
+	ctx.plugin(EnvInfoProvider, config);
+	ctx.plugin(ProfileProvider, config);
+}
+//#endregion
+export { Config, EnvInfoProvider, ProfileProvider, apply, inject, name };

package/locales/de-DE.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 查看运行状态
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>{user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/locales/en-US.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: Display the status
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>{user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/locales/fr-FR.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 查看运行状态
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>{user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/locales/ja-JP.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 実行状態を確認する
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>{user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/locales/ru-RU.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 查看运行状态
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>{user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/locales/zh-CN.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 查看运行状态
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>[{platform}] {user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        内存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/locales/zh-TW.yml

@@ -0,0 +1,15 @@
+commands:
+  status:
+    description: 查看運行狀態
+    messages:
+      status:
+        1: 运行中
+        0: 离线
+        2: 正在连接
+        4: 正在重连
+        3: 正在断开
+      bot: <p>{user.name}：<i18n path={"commands.status.messages.status." + status}/></p>
+      epilog: |-
+        ==========
+        CPU 使用率：{ (cpu[0] * 100).toFixed() }% / { (cpu[1] * 100).toFixed() }%
+        內存使用率：{ (memory[0] * 100).toFixed() }% / { (memory[1] * 100).toFixed() }%

package/package.json

@@ -0,0 +1,72 @@
+{
+    "name": "@koishi-ce/plugin-status",
+    "description": "Status view for Koishi",
+    "version": "1.0.0",
+    "type": "module",
+    "main": "lib/index.mjs",
+    "typings": "lib/index.d.ts",
+    "files": [
+        "lib",
+        "dist",
+        "src",
+        "locales"
+    ],
+    "contributors": [
+        "Shigma <shigma10826@gmail.com>",
+        "Oppenheymu <oppenheymu@gmail.com>"
+    ],
+    "license": "AGPL-3.0",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Koishi-CE/koishi.git",
+        "directory": "plugins/webui/status"
+    },
+    "bugs": {
+        "url": "https://github.com/Koishi-CE/koishi/issues"
+    },
+    "homepage": "https://koishi.chat/plugins/console/status.html",
+    "keywords": [
+        "bot",
+        "chatbot",
+        "koishi",
+        "plugin",
+        "status",
+        "environment",
+        "information"
+    ],
+    "koishi": {
+        "description": {
+            "en": "Display running status and environment information in the console",
+            "zh": "在控制台中显示运行状态和环境信息"
+        },
+        "service": {
+            "required": [
+                "console"
+            ]
+        }
+    },
+    "peerDependencies": {
+        "@koishijs/plugin-console": "^5.30.11",
+        "koishi": "^4.18.11"
+    },
+    "devDependencies": {
+        "@koishi-ce/client": "^1.0.0",
+        "@koishi-ce/koishi": "^1.0.0",
+        "@koishi-ce/plugin-analytics": "^1.0.0",
+        "@koishi-ce/plugin-config": "^1.0.0",
+        "@types/envinfo": "^7.8.3"
+    },
+    "dependencies": {
+        "@koishi-ce/console": "^1.0.0",
+        "envinfo": "^7.21.0",
+        "which-pm-runs": "^1.1.0"
+    },
+    "exports": {
+        ".": {
+            "source": "./src/index.ts",
+            "types": "./lib/index.d.ts",
+            "import": "./lib/index.mjs",
+            "default": "./lib/index.mjs"
+        }
+    }
+}

package/src/envinfo.ts

@@ -0,0 +1,87 @@
+/**
+ * 运行环境信息服务（服务名 "envinfo"）。
+ *
+ * 一次性采集系统与运行时版本信息，整理为 { system, binaries, koishi }
+ * 三组分节字符串字典，供控制台前端在状态栏展示与一键复制。
+ * 环境信息在进程生命周期内不会变化，因此采集结果以 Promise 形式永久缓存。
+ */
+
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { DataService } from "@koishi-ce/console";
+import { type Context, type Dict, Schema, version } from "@koishi-ce/koishi";
+import { helpers } from "envinfo";
+
+// 经 createRequire 加载 CJS 包并就地断言签名：不走 ESM 导入互操作，
+// 规避多包合并类型检查（大一统 tsconfig）下 export = 交织失效问题
+// （此前具名导入在 Bun 运行时下本就拿不到具名导出，属顺带修复）
+const whichPMRuns = createRequire(import.meta.url)("which-pm-runs") as () =>
+	| undefined
+	| { name: string; version: string };
+
+class EnvInfoProvider extends DataService<Dict<Dict<string>>> {
+	/** 采集任务的缓存：get() 首次调用时创建，之后始终复用同一 Promise。 */
+	private task!: Promise<Dict<Dict<string>>>;
+
+	// 基类链（cordis Service）上已有 config 成员，故需 override
+	override config: EnvInfoProvider.Config;
+
+	constructor(ctx: Context, config: EnvInfoProvider.Config) {
+		super(ctx, "envinfo");
+		this.config = config;
+	}
+
+	/** 执行一次实际采集：系统信息、运行时版本、Koishi 生态版本。 */
+	async _get(): Promise<Dict<Dict<string>>> {
+		// @types/envinfo 把各 helper 声明为 Promise<string>，运行时实际返回
+		// [标题, 值] 二元组；解构默认值仅用于收窄类型，正常路径不会触发
+		const [[, Os = ""], [, Cpu = ""]] = await Promise.all([
+			helpers.getOSInfo(),
+			helpers.getCPUInfo(),
+		]);
+		const agent = whichPMRuns();
+		const system: Dict<string> = { OS: Os, CPU: Cpu };
+		const binaries: Dict<string> = {
+			Node: process.versions.node,
+		};
+		if (agent) {
+			// yarn 的名称归一为首字母大写，与 Node 等键的展示风格一致
+			if (agent.name === "yarn") {
+				agent.name = "Yarn";
+			}
+			binaries[agent.name] = agent.version;
+		}
+		// 不直接 require package.json 是为了避免其被模块缓存固定住，
+		// 热更新后读取到的仍是旧版本号
+		const metapath = require.resolve("@koishi-ce/console/package.json");
+		const meta = await readFile(metapath, "utf8").then(JSON.parse);
+		const koishi: Dict<string> = {
+			Core: version,
+			Console: meta.version,
+		};
+		// 宿主代理（如 koishi-plugin-browser）可通过该环境变量上报自身名称与版本
+		if (process.env["KOISHI_AGENT"]) {
+			const [name, agentVersion] = process.env["KOISHI_AGENT"].split("/");
+			if (name && agentVersion) {
+				koishi[name] = agentVersion;
+			}
+		}
+		return { system, binaries, koishi };
+	}
+
+	/** 首次调用时发起采集并缓存 Promise，后续调用直接返回同一结果。 */
+	override async get() {
+		if (!this.task) this.task = this._get();
+		return this.task;
+	}
+
+	// erasableSyntaxOnly 禁止含运行时值的 namespace，
+	// 原 namespace 内的 Config 常量移到此处的静态字段，对外形状不变
+	static Config: Schema<EnvInfoProvider.Config> = Schema.object({});
+}
+
+namespace EnvInfoProvider {
+	export type Config = Record<never, never>;
+}
+
+export default EnvInfoProvider;

package/src/index.ts

@@ -0,0 +1,68 @@
+/**
+ * status 插件（node 侧）入口。
+ *
+ * 插件本体拆分为两个 DataService 子服务：
+ * - EnvInfoProvider（envinfo）：一次性采集运行环境信息（OS / CPU / Node / 包管理器等）；
+ * - ProfileProvider（profile）：周期性采集性能数据（CPU / 内存 / 各机器人收发消息速率）。
+ *
+ * 本文件负责注册控制台前端资源入口、以子插件形式挂载上述两个服务，
+ * 并合并两者的 Config Schema 作为插件整体配置。
+ */
+
+import { resolve } from "node:path";
+import type {} from "@koishi-ce/console";
+import { type Context, Schema } from "@koishi-ce/koishi";
+import EnvInfoProvider from "./envinfo.ts";
+import ProfileProvider from "./profile.ts";
+
+/** 频道活跃度记录：键为小时数（0~23），值为该小时内触发频道的次数。 */
+export type Activity = Record<number, number>;
+
+declare module "@koishi-ce/koishi" {
+	interface Channel {
+		name: string;
+		activity: Activity;
+	}
+}
+
+declare module "@koishi-ce/console" {
+	namespace Console {
+		interface Services {
+			envinfo: EnvInfoProvider;
+			status: ProfileProvider;
+		}
+	}
+}
+
+export * from "./envinfo.ts";
+export * from "./profile.ts";
+export { EnvInfoProvider, ProfileProvider };
+
+export const name = "status";
+export const inject = ["console"];
+
+export interface Config
+	extends ProfileProvider.Config,
+		EnvInfoProvider.Config {}
+
+export const Config: Schema<Config> = Schema.intersect([
+	EnvInfoProvider.Config,
+	ProfileProvider.Config,
+]);
+
+/**
+ * 插件入口：注册控制台前端资源（dev 指向 client 源码，prod 指向构建产物），
+ * 再将环境信息与性能采集两个服务作为子插件挂载，共享同一份配置。
+ *
+ * @param ctx 应用上下文
+ * @param config 插件配置（两个子服务配置的交集合并）
+ */
+export function apply(ctx: Context, config: Config) {
+	ctx.console.addEntry({
+		dev: resolve(__dirname, "../client/index.ts"),
+		prod: resolve(__dirname, "../dist"),
+	});
+
+	ctx.plugin(EnvInfoProvider, config);
+	ctx.plugin(ProfileProvider, config);
+}

package/src/profile.ts

@@ -0,0 +1,257 @@
+/**
+ * 性能数据采集服务（服务名 "status"）。
+ *
+ * 周期性采集三类指标并推送给控制台前端：
+ * - CPU：进程占用率与整机占用率（基于两次采样差值计算）；
+ * - 内存：进程 RSS 占比与整机已用占比；
+ * - 机器人：每个 bot 最近一分钟的消息收发量（TickCounter 滑动窗口）。
+ *
+ * 另提供 `status` 指令，在聊天环境内以文本形式输出各机器人状态摘要。
+ */
+
+import { cpus, freemem, totalmem } from "node:os";
+import { DataService } from "@koishi-ce/console";
+import {
+	type Bot,
+	type Context,
+	type Dict,
+	Schema,
+	Time,
+	type Universal,
+} from "@koishi-ce/koishi";
+import zhCN from "../locales/zh-CN.yml";
+
+declare module "@koishi-ce/koishi" {
+	interface Bot {
+		_messageSent: TickCounter;
+		_messageReceived: TickCounter;
+	}
+}
+
+/**
+ * 滑动窗口计数器：以 60 个槽位统计最近一分钟内的事件次数。
+ *
+ * 每秒执行一次 tick，队头插入 0 并丢弃队尾，窗口随时间向前滑动；
+ * add() 累加到当前秒所在的队头槽位，get() 求整个窗口的和。
+ * 每个 bot 挂载两个实例（_messageSent / _messageReceived）分别统计收发消息。
+ */
+class TickCounter {
+	/** 停止内部定时器（随上下文销毁由调用方触发）。 */
+	public stop: () => void;
+
+	/** 60 个槽位的环形数据，data[0] 恒为当前秒的计数。 */
+	private data = new Array(60).fill(0);
+
+	private tick = () => {
+		this.data.unshift(0);
+		this.data.splice(-1, 1);
+	};
+
+	constructor(ctx: Context) {
+		this.stop = ctx.setInterval(() => this.tick(), Time.second);
+	}
+
+	/** 在当前秒的槽位上累加计数。 */
+	public add(value = 1) {
+		this.data[0] += value;
+	}
+
+	/** 返回最近一分钟内的总计数。 */
+	public get() {
+		return this.data.reduce((prev, curr) => prev + curr, 0);
+	}
+
+	/** 为指定 bot 初始化收/发两个计数器。 */
+	static initialize(bot: Bot, ctx: Context) {
+		bot._messageSent = new TickCounter(ctx);
+		bot._messageReceived = new TickCounter(ctx);
+	}
+}
+
+/** 负载率二元组：[app, total]，app 为本进程占比，total 为整机占比，取值 0~1。 */
+export type LoadRate = [app: number, total: number];
+
+// 模块级 CPU 采样状态：usage 保存上一次采样值，appRate / usedRate 为最近一次差值计算结果
+let usage = getCpuUsage();
+let appRate: number;
+let usedRate: number;
+
+/** 采集内存负载率：[进程 RSS / 总内存, 1 - 空闲内存 / 总内存]。 */
+async function memoryRate(): Promise<LoadRate> {
+	const total = totalmem();
+	return [process.memoryUsage().rss / total, 1 - freemem() / total];
+}
+
+/**
+ * 读取一次 CPU 累计时间快照。
+ *
+ * - app：进程用户态 CPU 时间（cpuUsage().user，毫秒）；
+ * - used：所有核心的 累计时间 - 空闲时间（毫秒）；
+ * - total：所有核心的累计时间总和（毫秒）。
+ * 单次快照只是累计值，需经 updateCpuUsage() 做差才能得到占用率。
+ */
+function getCpuUsage() {
+	let totalIdle = 0,
+		totalTick = 0;
+	const cpuInfo = cpus();
+	const usage = process.cpuUsage().user;
+
+	for (const cpu of cpuInfo) {
+		for (const time of Object.values(cpu.times)) {
+			totalTick += time;
+		}
+		totalIdle += cpu.times.idle;
+	}
+
+	return {
+		// process.cpuUsage() 返回微秒，除以 1000 归一到毫秒
+		app: usage / 1000,
+		used: totalTick - totalIdle,
+		total: totalTick,
+	};
+}
+
+/**
+ * 用新快照与上次快照的差值计算 CPU 占用率并缓存到模块级变量：
+ * appRate = 本进程增量时间 / 全机总增量时间，usedRate 同理（整机口径）。
+ */
+function updateCpuUsage() {
+	const newUsage = getCpuUsage();
+	const totalDifference = newUsage.total - usage.total;
+	appRate = (newUsage.app - usage.app) / totalDifference;
+	usedRate = (newUsage.used - usage.used) / totalDifference;
+	usage = newUsage;
+}
+
+/**
+ * 性能数据服务：以 DataService 形式向前端广播 Payload，
+ * 前端经 store.status 读取（键名即服务名 "status"）。
+ */
+class ProfileProvider extends DataService<ProfileProvider.Payload> {
+	// 仅在 get() 内作读取判断，本类从不写入（恒为 undefined），
+	// 用 declare + 显式 undefined 如实反映运行时形状，不产生字段初始化
+	declare cached: ProfileProvider.Payload | undefined;
+
+	// 基类链（cordis Service）上已有 config 成员，故需 override
+	override config: ProfileProvider.Config;
+
+	constructor(ctx: Context, config: ProfileProvider.Config) {
+		super(ctx, "status");
+
+		this.config = config;
+
+		ctx.i18n.define("zh-CN", zhCN);
+
+		// 就绪后按配置间隔刷新 CPU 占用率并推送性能数据
+		const { tickInterval } = config;
+		ctx.on("ready", () => {
+			ctx.setInterval(
+				() => {
+					updateCpuUsage();
+					this.refresh();
+				},
+				tickInterval ?? Time.second * 5,
+			);
+		});
+
+		// 消息收发事件分别计入对应 bot 的滑动窗口计数器
+		ctx.any().before("send", (session) => {
+			session.bot._messageSent?.add(1);
+		});
+
+		ctx.any().on("message", (session) => {
+			session.bot._messageReceived?.add(1);
+		});
+
+		ctx.bots.forEach((bot) => {
+			TickCounter.initialize(bot, ctx);
+		});
+
+		// bot 列表变化时防抖刷新（同帧内多次事件只触发一次推送）
+		const update = ctx.debounce(() => this.refresh(), 0);
+
+		ctx.on("login-added", ({ bot }) => {
+			TickCounter.initialize(bot, ctx);
+			update();
+		});
+
+		ctx.on("login-removed", ({ bot }) => {
+			bot._messageSent.stop();
+			bot._messageReceived.stop();
+			update();
+		});
+
+		ctx.on("login-updated", () => {
+			update();
+		});
+
+		// 聊天侧指令：逐个输出机器人状态，末尾附加整体性能摘要
+		ctx.command("status").action(async ({ session }) => {
+			if (!session) return;
+			const data = await this.get();
+			const output = Object.values(data.bots).map((bot) => {
+				return session.text(".bot", bot);
+			});
+			output.push(session.text(".epilog", data));
+			return output.join("\n");
+		});
+	}
+
+	/**
+	 * 采集一帧性能数据：CPU 占用率、内存占用率与各机器人收发速率。
+	 *
+	 * @param forced 为 true 时跳过缓存强制重算（refresh 链路会传入）
+	 */
+	override async get(forced = false) {
+		if (this.cached && !forced) return this.cached;
+		const memory = await memoryRate();
+		const cpu: LoadRate = [appRate, usedRate];
+		const bots: Dict<ProfileProvider.BotData> = {};
+		for (const bot of this.ctx.bots) {
+			if (bot.hidden) continue;
+			const paths = this.ctx.get("loader")?.paths(bot.ctx.scope);
+			bots[bot.sid] = {
+				...bot.toJSON(),
+				error: bot.error?.message,
+				messageSent: bot._messageSent.get(),
+				messageReceived: bot._messageReceived.get(),
+				// exactOptionalPropertyTypes：paths 可选属性不在 undefined 时展开
+				...(paths ? { paths } : {}),
+			};
+		}
+		return { memory, cpu, bots };
+	}
+
+	// erasableSyntaxOnly 禁止含运行时值的 namespace，
+	// 原 namespace 内的 Config 常量移到此处的静态字段，对外形状不变
+	static Config: Schema<ProfileProvider.Config> = Schema.object({
+		tickInterval: Schema.natural()
+			.role("ms")
+			.description("性能数据推送的时间间隔。")
+			.default(Time.second * 5),
+	});
+}
+
+namespace ProfileProvider {
+	export interface Config {
+		/** 采集与推送性能数据的时间间隔（毫秒），默认 5 秒。 */
+		tickInterval?: number;
+	}
+
+	/** 推送给前端的单个机器人数据：登录信息 + 错误消息 + 配置路径 + 收发速率。 */
+	export interface BotData extends Universal.Login {
+		error?: string;
+		paths?: string[];
+		messageSent: number;
+		messageReceived: number;
+	}
+
+	/** 每次采集推送给前端的完整负载：内存 / CPU 负载率与机器人数据字典。 */
+	export interface Payload {
+		memory: LoadRate;
+		cpu: LoadRate;
+		bots: Dict<BotData>;
+	}
+}
+
+export default ProfileProvider;

package/src/which-pm-runs.d.ts

@@ -0,0 +1,12 @@
+// which-pm-runs 没有官方类型声明，npm 上也不存在 @types/which-pm-runs。
+// 以下按其 1.1.0 源码（index.js）手写形状：
+// 未检测到 npm_config_user_agent 环境变量时返回 undefined，
+// 否则返回包管理器的名称（npminstall 会归一化为 cnpm）与版本。
+declare module "which-pm-runs" {
+	export interface PackageManager {
+		name: string;
+		version: string;
+	}
+
+	export function whichPMRuns(): PackageManager | undefined;
+}