@xmanrui/dsh-im 0.1.0

package/plugin-src/client/channels/feishu/styles.js

@@ -0,0 +1,505 @@
+export const FEISHU_STYLE_ID = "beihuixinghe-dsh-feishu-settings";
+
+const CSS = String.raw`
+.bxf-page {
+  --bxf-accent: var(--dsw-alias-state-business-primary, #3370ff);
+  --bxf-success: var(--dsw-alias-state-success-primary, #20a162);
+  --bxf-warning: var(--dsw-alias-state-warning-primary, #d97706);
+  --bxf-error: var(--dsw-alias-state-error-primary, #d54941);
+  box-sizing: border-box;
+  width: 100%;
+  max-width: 860px;
+  color: var(--dsw-alias-label-primary, #1f2329);
+  display: flex;
+  flex-direction: column;
+  container-type: inline-size;
+  gap: 18px;
+  padding: 2px 0 24px;
+}
+
+.bxf-page *, .bxf-page *::before, .bxf-page *::after { box-sizing: border-box; }
+
+.bxf-heading {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 20px;
+}
+
+.bxf-headingCopy { min-width: 0; }
+.bxf-heading h2, .bxf-heading p, .bxf-card h3, .bxf-card p { margin: 0; }
+
+.bxf-eyebrow {
+  color: var(--dsw-alias-label-tertiary, #8f959e);
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 18px;
+  letter-spacing: .08em;
+  text-transform: uppercase;
+  margin-bottom: 3px;
+}
+
+.bxf-heading h2 {
+  font-size: 20px;
+  line-height: 28px;
+  font-weight: 650;
+  letter-spacing: -.015em;
+}
+
+.bxf-heading p {
+  max-width: 540px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+  font-size: 13px;
+  line-height: 20px;
+  margin-top: 5px;
+  white-space: nowrap;
+}
+
+.bxf-headingTools {
+  width: 100%;
+  flex: none;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: nowrap;
+  gap: 8px;
+}
+
+.bxf-totalBadge {
+  min-height: 28px;
+  display: inline-flex;
+  align-items: baseline;
+  gap: 3px;
+  border-radius: 999px;
+  padding: 4px 10px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+  background: var(--dsw-alias-bg-module-platform, #f2f3f5);
+  font-size: 11px;
+  line-height: 16px;
+  white-space: nowrap;
+}
+
+.bxf-totalBadge strong { color: var(--bxf-success); font-size: 13px; }
+
+.bxf-card {
+  position: relative;
+  overflow: hidden;
+  border: 1px solid var(--dsw-alias-border-l2, #dee0e3);
+  border-radius: 14px;
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  box-shadow: var(--dsw-shadow-lv1, 0 3px 12px rgba(31, 35, 41, .05));
+}
+
+.bxf-card::before {
+  content: "";
+  pointer-events: none;
+  position: absolute;
+  inset: 0 0 auto;
+  height: 88px;
+  background:
+    radial-gradient(circle at 86% -35%, color-mix(in srgb, var(--bxf-accent) 18%, transparent), transparent 68%);
+  opacity: .85;
+}
+
+.bxf-cardBody { position: relative; padding: 24px; }
+
+.bxf-intro {
+  min-height: 250px;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) 172px;
+  gap: 32px;
+  align-items: center;
+}
+
+.bxf-introCopy { max-width: 500px; }
+
+.bxf-stateLabel {
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 18px;
+  margin-bottom: 13px;
+}
+
+.bxf-dot {
+  width: 7px;
+  height: 7px;
+  border-radius: 50%;
+  background: var(--dsw-alias-label-tertiary, #8f959e);
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--dsw-alias-label-tertiary, #8f959e) 12%, transparent);
+}
+
+.bxf-dot[data-tone="success"] {
+  background: var(--bxf-success);
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--bxf-success) 13%, transparent);
+}
+
+.bxf-dot[data-tone="warning"] {
+  background: var(--bxf-warning);
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--bxf-warning) 13%, transparent);
+}
+
+.bxf-dot[data-tone="error"] {
+  background: var(--bxf-error);
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--bxf-error) 13%, transparent);
+}
+
+.bxf-intro h3 {
+  font-size: 24px;
+  line-height: 34px;
+  font-weight: 650;
+  letter-spacing: -.02em;
+}
+
+.bxf-introCopy > p {
+  max-width: 490px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+  font-size: 14px;
+  line-height: 23px;
+  margin-top: 8px;
+}
+
+.bxf-note {
+  display: flex;
+  gap: 8px;
+  align-items: flex-start;
+  color: var(--dsw-alias-label-tertiary, #8f959e);
+  font-size: 12px;
+  line-height: 18px;
+  margin-top: 16px;
+}
+
+.bxf-note svg { flex: none; margin-top: 1px; }
+
+.bxf-actions {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 10px;
+  margin-top: 22px;
+}
+
+.bxf-button {
+  appearance: none;
+  min-height: 36px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 7px;
+  border: 1px solid var(--dsw-alias-border-l2, #dee0e3);
+  border-radius: 8px;
+  padding: 7px 13px;
+  color: var(--dsw-alias-label-primary, #1f2329);
+  background: var(--dsw-alias-bg-layer-1, #fff);
+  font: inherit;
+  font-size: 13px;
+  font-weight: 550;
+  line-height: 20px;
+  text-decoration: none;
+  cursor: pointer;
+  transition: background .15s var(--ds-ease-in-out, ease), border-color .15s var(--ds-ease-in-out, ease), transform .15s var(--ds-ease-in-out, ease);
+}
+
+.bxf-button:hover:not(:disabled) {
+  background: var(--dsw-alias-interactive-bg-hover, #f2f3f5);
+  border-color: var(--dsw-alias-border-l1, #c9cdd4);
+}
+
+.bxf-button:active:not(:disabled) { transform: translateY(1px); }
+
+.bxf-button:focus-visible, .bxf-link:focus-visible {
+  outline: 2px solid var(--bxf-accent);
+  outline-offset: 2px;
+}
+
+.bxf-button:disabled { cursor: not-allowed; opacity: .55; }
+
+.bxf-button[data-kind="primary"] {
+  border-color: var(--bxf-accent);
+  color: #fff;
+  background: var(--bxf-accent);
+  box-shadow: 0 4px 12px color-mix(in srgb, var(--bxf-accent) 24%, transparent);
+}
+
+.bxf-button[data-kind="primary"]:hover:not(:disabled) {
+  border-color: color-mix(in srgb, var(--bxf-accent) 86%, #000);
+  background: color-mix(in srgb, var(--bxf-accent) 90%, #000);
+}
+
+.bxf-button[data-kind="danger"] { color: var(--bxf-error); }
+.bxf-button[data-size="small"] { min-height: 32px; padding: 5px 10px; font-size: 12px; }
+.bxf-bindButton { flex: none; white-space: nowrap; }
+
+.bxf-provisionCard {
+  border-color: color-mix(in srgb, var(--bxf-accent) 32%, var(--dsw-alias-border-l2, #dee0e3));
+}
+
+.bxf-markStage {
+  position: relative;
+  width: 156px;
+  height: 156px;
+  display: grid;
+  place-items: center;
+  justify-self: end;
+}
+
+.bxf-markStage::before, .bxf-markStage::after {
+  content: "";
+  position: absolute;
+  border-radius: 50%;
+}
+
+.bxf-markStage::before {
+  inset: 12px;
+  border: 1px solid color-mix(in srgb, var(--bxf-accent) 18%, var(--dsw-alias-border-l2, #dee0e3));
+  background: color-mix(in srgb, var(--bxf-accent) 4%, var(--dsw-alias-bg-layer-1, #fff));
+}
+
+.bxf-markStage::after {
+  inset: 0;
+  border: 1px dashed color-mix(in srgb, var(--bxf-accent) 16%, transparent);
+  animation: bxf-rotate 18s linear infinite;
+}
+
+.bxf-brandMark {
+  position: relative;
+  z-index: 1;
+  width: 68px;
+  height: 68px;
+  display: grid;
+  place-items: center;
+  border-radius: 20px;
+  color: #fff;
+  background: var(--bxf-accent);
+  box-shadow: 0 12px 28px color-mix(in srgb, var(--bxf-accent) 28%, transparent);
+}
+
+.bxf-qrLayout {
+  display: grid;
+  grid-template-columns: 236px minmax(0, 1fr);
+  align-items: center;
+  gap: 32px;
+}
+
+.bxf-qrColumn { min-width: 0; }
+
+.bxf-qrFrame {
+  position: relative;
+  width: 222px;
+  height: 222px;
+  display: grid;
+  place-items: center;
+  border: 1px solid var(--dsw-alias-border-l2, #dee0e3);
+  border-radius: 14px;
+  padding: 13px;
+  background: #fff;
+  box-shadow: 0 8px 24px rgba(31, 35, 41, .07);
+}
+
+.bxf-qrFrame::before, .bxf-qrFrame::after {
+  content: "";
+  position: absolute;
+  width: 24px;
+  height: 24px;
+  border-color: var(--bxf-accent);
+  border-style: solid;
+}
+
+.bxf-qrFrame::before { inset: -3px auto auto -3px; border-width: 2px 0 0 2px; border-radius: 5px 0 0; }
+.bxf-qrFrame::after { inset: auto -3px -3px auto; border-width: 0 2px 2px 0; border-radius: 0 0 5px; }
+.bxf-qrFrame img { width: 100%; height: 100%; display: block; object-fit: contain; }
+
+.bxf-qrFallback {
+  width: 100%;
+  height: 100%;
+  display: grid;
+  place-items: center;
+  border-radius: 8px;
+  color: var(--bxf-accent);
+  background: #f7f9ff;
+  text-align: center;
+  padding: 20px;
+}
+
+.bxf-qrFallback span { display: block; color: #646a73; font-size: 12px; line-height: 18px; margin-top: 8px; }
+
+.bxf-expiredOverlay {
+  position: absolute;
+  inset: 10px;
+  display: grid;
+  place-items: center;
+  border-radius: 9px;
+  color: #1f2329;
+  background: rgba(255, 255, 255, .94);
+  backdrop-filter: blur(3px);
+  font-size: 13px;
+  font-weight: 600;
+  text-align: center;
+}
+
+.bxf-countdown {
+  width: 222px;
+  color: var(--dsw-alias-label-tertiary, #8f959e);
+  font-variant-numeric: tabular-nums;
+  font-size: 11px;
+  line-height: 17px;
+  margin-top: 11px;
+}
+
+.bxf-countdownTop { display: flex; align-items: center; justify-content: space-between; gap: 10px; }
+.bxf-progress { height: 3px; overflow: hidden; border-radius: 99px; background: var(--dsw-alias-bg-module-platform, #f2f3f5); margin-top: 6px; }
+.bxf-progress > span { display: block; width: var(--bxf-progress, 100%); height: 100%; border-radius: inherit; background: var(--bxf-accent); transition: width 1s linear; }
+
+.bxf-qrCopy h3 { font-size: 20px; line-height: 29px; font-weight: 650; }
+.bxf-qrCopy > p { color: var(--dsw-alias-label-secondary, #646a73); font-size: 13px; line-height: 21px; margin-top: 7px; }
+
+.bxf-steps { counter-reset: bxf-step; display: flex; flex-direction: column; gap: 11px; margin: 20px 0 0; padding: 0; list-style: none; }
+.bxf-steps li { counter-increment: bxf-step; display: grid; grid-template-columns: 23px minmax(0, 1fr); align-items: start; gap: 9px; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 19px; }
+.bxf-steps li::before { content: counter(bxf-step); width: 21px; height: 21px; display: grid; place-items: center; border: 1px solid var(--dsw-alias-border-l2, #dee0e3); border-radius: 50%; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-1, #fff); font-size: 10px; font-weight: 650; }
+
+.bxf-connecting { min-height: 292px; display: grid; place-items: center; text-align: center; padding: 36px 24px; }
+.bxf-connectingCopy { max-width: 430px; }
+.bxf-orbit { position: relative; width: 86px; height: 86px; display: grid; place-items: center; margin: 0 auto 22px; }
+.bxf-orbit::before, .bxf-orbit::after { content: ""; position: absolute; border-radius: 50%; }
+.bxf-orbit::before { inset: 3px; border: 1px solid color-mix(in srgb, var(--bxf-accent) 24%, transparent); animation: bxf-pulse 1.8s var(--ds-ease-in-out, ease) infinite; }
+.bxf-orbit::after { inset: 0; border: 2px solid transparent; border-top-color: var(--bxf-accent); animation: bxf-rotate 1.2s linear infinite; }
+.bxf-orbitCore { width: 50px; height: 50px; display: grid; place-items: center; border-radius: 16px; color: var(--bxf-accent); background: color-mix(in srgb, var(--bxf-accent) 9%, var(--dsw-alias-bg-layer-1, #fff)); }
+.bxf-connecting h3 { font-size: 20px; line-height: 29px; }
+.bxf-connecting p { color: var(--dsw-alias-label-secondary, #646a73); font-size: 13px; line-height: 21px; margin-top: 7px; }
+.bxf-connectingCompact { min-height: 248px; }
+
+.bxf-inlineError {
+  min-height: 190px;
+  display: grid;
+  grid-template-columns: 44px minmax(0, 1fr);
+  align-content: center;
+  gap: 15px;
+  padding: 28px;
+}
+
+.bxf-inlineError h3 { font-size: 17px; line-height: 25px; margin: 0; }
+.bxf-inlineError p { color: var(--dsw-alias-label-secondary, #646a73); font-size: 13px; line-height: 21px; margin-top: 5px; overflow-wrap: anywhere; }
+
+.bxf-listSection { display: flex; flex-direction: column; gap: 10px; }
+.bxf-listHeading { min-height: 28px; display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 0 2px; }
+.bxf-listHeading h3 { font-size: 14px; line-height: 22px; font-weight: 650; margin: 0; }
+.bxf-botList { display: flex; flex-direction: column; gap: 12px; margin: 0; padding: 0; list-style: none; }
+.bxf-botList > li { min-width: 0; }
+.bxf-botCard:focus { outline: none; }
+.bxf-botCard:focus-visible { outline: 2px solid var(--bxf-accent); outline-offset: 2px; }
+
+.bxf-connectedTop { display: flex; align-items: center; justify-content: space-between; gap: 20px; }
+.bxf-botIdentity { min-width: 0; display: flex; align-items: center; gap: 13px; }
+.bxf-avatar { flex: none; width: 48px; height: 48px; display: grid; place-items: center; overflow: hidden; border: 1px solid var(--dsw-alias-line-border, #e5e6eb); border-radius: 14px; background: var(--dsw-alias-bg-layer-1, #fff); box-shadow: 0 1px 3px rgb(31 35 41 / 7%); }
+.bxf-botName { min-width: 0; }
+.bxf-botName h3 { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 17px; line-height: 24px; font-weight: 650; }
+.bxf-botName p { overflow: hidden; color: var(--dsw-alias-label-tertiary, #8f959e); font-family: var(--ds-font-family-code, monospace); font-size: 12px; line-height: 18px; text-overflow: ellipsis; white-space: nowrap; margin-top: 2px; }
+
+.bxf-healthPill { flex: none; display: inline-flex; align-items: center; gap: 7px; min-height: 28px; border-radius: 999px; padding: 4px 10px; color: var(--bxf-success); background: color-mix(in srgb, var(--bxf-success) 10%, transparent); font-size: 12px; font-weight: 600; line-height: 18px; }
+.bxf-healthPill[data-health="degraded"], .bxf-healthPill[data-health="checking"], .bxf-healthPill[data-health="connecting"] { color: var(--bxf-warning); background: color-mix(in srgb, var(--bxf-warning) 10%, transparent); }
+.bxf-healthPill[data-health="offline"], .bxf-healthPill[data-health="error"] { color: var(--bxf-error); background: color-mix(in srgb, var(--bxf-error) 10%, transparent); }
+
+.bxf-statusGrid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; margin-top: 22px; }
+.bxf-metric { min-width: 0; border: 1px solid var(--dsw-alias-border-l2, #dee0e3); border-radius: 9px; padding: 12px 13px; background: var(--dsw-alias-bg-module-platform, #f7f8fa); }
+.bxf-metric dt { color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; line-height: 17px; }
+.bxf-metric dd { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--dsw-alias-label-primary, #1f2329); font-size: 12px; line-height: 18px; font-weight: 550; margin: 3px 0 0; }
+
+.bxf-connectedFooter { display: flex; align-items: center; justify-content: space-between; gap: 15px; margin-top: 20px; padding-top: 16px; border-top: 1px solid var(--dsw-alias-line-divider, #eef0f3); }
+.bxf-healthSummary { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 18px; }
+.bxf-healthSummary[data-error="true"] { color: var(--bxf-error); }
+.bxf-botActions { flex: none; flex-wrap: nowrap; gap: 8px; margin-top: 0; justify-content: flex-end; }
+.bxf-botActions .bxf-button { flex: none; white-space: nowrap; }
+
+.bxf-confirm {
+  border-top: 1px solid var(--dsw-alias-border-l2, #dee0e3);
+  background: color-mix(in srgb, var(--bxf-error) 4%, var(--dsw-alias-bg-module-platform, #f7f8fa));
+  padding: 17px 24px 20px;
+}
+.bxf-confirm:focus { outline: none; }
+.bxf-confirm h4 { font-size: 13px; line-height: 20px; margin: 0; }
+.bxf-confirm p { color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 19px; margin: 4px 0 0; }
+.bxf-confirm .bxf-actions { margin-top: 12px; }
+
+.bxf-error { min-height: 252px; display: grid; grid-template-columns: 44px minmax(0, 1fr); align-content: center; gap: 15px; padding: 30px; }
+.bxf-errorIcon { width: 44px; height: 44px; display: grid; place-items: center; border-radius: 13px; color: var(--bxf-error); background: color-mix(in srgb, var(--bxf-error) 9%, transparent); }
+.bxf-error h3 { font-size: 17px; line-height: 25px; }
+.bxf-error p { color: var(--dsw-alias-label-secondary, #646a73); font-size: 13px; line-height: 21px; margin-top: 5px; overflow-wrap: anywhere; }
+.bxf-errorCode { display: inline-block; color: var(--dsw-alias-label-tertiary, #8f959e); font-family: var(--ds-font-family-code, monospace); font-size: 11px; margin-top: 7px; }
+
+.bxf-statusNotice {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  border: 1px solid color-mix(in srgb, var(--bxf-warning) 28%, var(--dsw-alias-border-l2, #dee0e3));
+  border-radius: 10px;
+  padding: 9px 11px;
+  color: var(--dsw-alias-label-secondary, #646a73);
+  background: color-mix(in srgb, var(--bxf-warning) 5%, var(--dsw-alias-bg-layer-1, #fff));
+  font-size: 12px;
+  line-height: 18px;
+}
+.bxf-statusNotice > svg { flex: none; color: var(--bxf-warning); }
+.bxf-statusNotice > span { min-width: 0; flex: 1; overflow-wrap: anywhere; }
+
+.bxf-skeleton { min-height: 260px; padding: 28px; }
+.bxf-skeletonLine { height: 12px; border-radius: 999px; background: linear-gradient(90deg, var(--dsw-alias-bg-module-platform, #f2f3f5), color-mix(in srgb, var(--dsw-alias-label-tertiary, #8f959e) 10%, transparent), var(--dsw-alias-bg-module-platform, #f2f3f5)); background-size: 220% 100%; animation: bxf-shimmer 1.5s linear infinite; }
+.bxf-skeletonLine:nth-child(1) { width: 92px; }
+.bxf-skeletonLine:nth-child(2) { width: 44%; height: 22px; margin-top: 23px; }
+.bxf-skeletonLine:nth-child(3) { width: 72%; margin-top: 14px; }
+.bxf-skeletonLine:nth-child(4) { width: 58%; margin-top: 9px; }
+.bxf-skeletonBox { width: 138px; height: 38px; border-radius: 8px; background: var(--dsw-alias-bg-module-platform, #f2f3f5); margin-top: 28px; }
+
+.bxf-visuallyHidden { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; border: 0; }
+
+@keyframes bxf-rotate { to { transform: rotate(360deg); } }
+@keyframes bxf-pulse { 0%, 100% { transform: scale(.9); opacity: .45; } 50% { transform: scale(1.08); opacity: 1; } }
+@keyframes bxf-shimmer { to { background-position: -220% 0; } }
+
+@container (max-width: 620px) {
+  .bxf-headingTools { gap: 6px; }
+  .bxf-headingTools .bxf-totalBadge { padding-inline: 8px; }
+  .bxf-headingTools .bxf-bindButton { padding-inline: 10px; }
+}
+
+@media (max-width: 680px) {
+  .bxf-intro { grid-template-columns: minmax(0, 1fr); }
+  .bxf-markStage { display: none; }
+  .bxf-qrLayout { grid-template-columns: minmax(0, 1fr); justify-items: center; }
+  .bxf-qrCopy { width: 100%; }
+  .bxf-statusGrid { grid-template-columns: minmax(0, 1fr); }
+  .bxf-connectedTop { align-items: flex-start; flex-direction: column; }
+  .bxf-inlineError { grid-template-columns: minmax(0, 1fr); padding: 20px; }
+  .bxf-statusNotice { align-items: flex-start; flex-wrap: wrap; }
+  .bxf-cardBody { padding: 20px; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .bxf-page *, .bxf-page *::before, .bxf-page *::after { animation-duration: .01ms !important; animation-iteration-count: 1 !important; scroll-behavior: auto !important; transition-duration: .01ms !important; }
+}
+`;
+
+export function installFeishuStyles() {
+  if (typeof document === "undefined") {
+    return () => {};
+  }
+
+  const existing = document.querySelector(
+    `style[data-plugin-css="${FEISHU_STYLE_ID}"]`,
+  );
+  if (existing) {
+    return () => {};
+  }
+
+  const style = document.createElement("style");
+  style.dataset.plugin = "@xmanrui/dsh-feishu";
+  style.dataset.pluginCss = FEISHU_STYLE_ID;
+  style.textContent = CSS;
+  document.head.appendChild(style);
+
+  return () => {
+    style.remove();
+  };
+}

package/plugin-src/client/channels/qq/api.js

@@ -0,0 +1,119 @@
+export const QQ_RPC_CHANNEL = '/qq';
+
+export const QQ_ENDPOINTS = Object.freeze({
+  status: 'connection.status',
+  beginProvisioning: 'provision.begin',
+  pollProvisioning: 'provision.poll',
+  cancelProvisioning: 'provision.cancel',
+  bindCredentials: 'bot.bind-credentials',
+  reconnectBot: 'bot.reconnect',
+  deleteBot: 'bot.delete',
+});
+
+const PROVISION_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting', 'connected', 'failed', 'cancelled']);
+const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
+const QR_DATA_URL = /^data:image\/(?:png|webp);base64,[a-z\d+/]+={0,2}$/i;
+
+function isRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function text(value, fallback, max = 240) {
+  return typeof value === 'string' && value.trim() ? value.trim().slice(0, max) : fallback;
+}
+
+function id(value) {
+  const result = text(value, '', 128);
+  return /^[a-z\d_-]+$/i.test(result) ? result : undefined;
+}
+
+function timestamp(value) {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  const parsed = typeof value === 'string' ? Date.parse(value) : Number.NaN;
+  return Number.isNaN(parsed) ? undefined : parsed;
+}
+
+export function unwrapRpcResult(result) {
+  if (!isRecord(result) || typeof result.ok !== 'boolean') throw new Error('QQ 服务返回了无法识别的响应');
+  if (!result.ok) {
+    const error = new Error(text(result.error?.message, 'QQ 操作失败'));
+    error.code = text(result.error?.code, 'QQ_RPC_ERROR', 80);
+    throw error;
+  }
+  return result.value;
+}
+
+export function safeQrSource(value) {
+  return typeof value === 'string' && value.length <= 2 * 1024 * 1024 && QR_DATA_URL.test(value)
+    ? value : undefined;
+}
+
+export function normalizeProvisioning(value, now = Date.now()) {
+  const source = isRecord(value?.provisioning) ? value.provisioning : value;
+  if (!isRecord(source)) throw new Error('QQ 服务没有返回扫码绑定进度');
+  const attemptId = id(source.attemptId);
+  if (!attemptId) throw new Error('QQ 扫码服务没有返回有效的绑定任务');
+  const reported = text(source.status, 'failed', 32);
+  const result = {
+    attemptId,
+    status: PROVISION_STATES.has(reported) ? reported : 'failed',
+    expiresAt: timestamp(source.expiresAt) ?? now + 5 * 60_000,
+    pollIntervalMs: Math.min(10_000, Math.max(500, Number(source.pollIntervalMs) || 1_000)),
+    qrRevision: Number.isSafeInteger(source.qrRevision) ? source.qrRevision : 0,
+  };
+  const qrCodeDataUrl = safeQrSource(source.qrCodeDataUrl);
+  if (qrCodeDataUrl) result.qrCodeDataUrl = qrCodeDataUrl;
+  if (id(source.botId)) result.botId = id(source.botId);
+  if (isRecord(source.error)) result.error = {
+    code: text(source.error.code, 'QQ_PROVISION_FAILED', 80),
+    message: text(source.error.message, 'QQ 机器人没有接入完成'),
+  };
+  return result;
+}
+
+function normalizeBot(value) {
+  if (!isRecord(value) || !id(value.botId)) return undefined;
+  const connected = value.connected === true;
+  const state = ACCOUNT_STATES.has(value.state) ? value.state : 'offline';
+  return {
+    botId: id(value.botId),
+    connected,
+    state: connected ? 'connected' : state,
+    bot: {
+      name: text(value.bot?.name, 'QQ机器人', 100),
+      appIdMasked: text(value.bot?.appIdMasked, '应用标识已安全保存', 140),
+    },
+    health: {
+      summary: text(value.health?.summary, connected ? 'QQ WebSocket 长连接运行正常' : 'QQ 连接尚未就绪'),
+      lastCheckedAt: timestamp(value.health?.lastCheckedAt),
+    },
+    error: isRecord(value.error) ? {
+      code: text(value.error.code, 'QQ_ACCOUNT_ERROR', 80),
+      message: text(value.error.message, 'QQ 连接尚未就绪'),
+    } : null,
+  };
+}
+
+export function normalizeSnapshot(value) {
+  const source = isRecord(value?.snapshot) ? value.snapshot : value;
+  if (!isRecord(source) || !Array.isArray(source.bots)) throw new Error('QQ 服务没有返回有效的机器人列表');
+  const bots = source.bots.map(normalizeBot).filter(Boolean);
+  return {
+    revision: Number.isSafeInteger(source.revision) ? source.revision : 0,
+    bots,
+    totals: { configured: bots.length, connected: bots.filter((bot) => bot.connected).length },
+    provisioning: source.provisioning ? normalizeProvisioning(source.provisioning) : null,
+  };
+}
+
+export function presentError(error) {
+  return {
+    code: text(error?.code, 'QQ_ERROR', 80),
+    message: text(error?.message, 'QQ 操作失败，请稍后重试'),
+  };
+}
+
+export function formatRemaining(milliseconds) {
+  const seconds = Math.max(0, Math.ceil(Number(milliseconds) / 1_000) || 0);
+  return `${String(Math.floor(seconds / 60)).padStart(2, '0')}:${String(seconds % 60).padStart(2, '0')}`;
+}