cortico 0.1.0

package/src/worlds/qq/console/roster.ts

@@ -0,0 +1,203 @@
+import type {
+  ConsolePanelContext,
+  ConsolePanel,
+} from '../../../web/shared/client-panel.ts';
+import {
+  autoload,
+  errText,
+  type QQConvNames,
+  type QQRoster,
+  type QQRosterEntry,
+} from './client.ts';
+
+type Kind = 'group' | 'private';
+
+interface RosterView {
+  roster: QQRoster;
+  names: QQConvNames;
+}
+
+const NO_NAMES: QQConvNames = { groups: [], privates: [] };
+
+const WORDS = {
+  group: { label: '监听群号', num: '群号', empty: '还没有监听任何群', add: '新群号' },
+  private: { label: '监听私聊 QQ 号', num: 'QQ号', empty: '还没有监听任何私聊', add: '新QQ号' },
+} as const;
+
+export const rosterPanel: ConsolePanel = {
+  mount(ctx: ConsolePanelContext) {
+    autoload<RosterView>(ctx, {
+      loading: '加载监听名单…',
+      failed: '监听名单不可用(QQ 接入没开启时读不到)',
+      load: async () => ({
+        roster: await ctx.invoke<QQRoster>('get'),
+        names: await ctx.invoke<QQConvNames>('names').catch(() => NO_NAMES),
+      }),
+      render: (view, reload) => [sheet(ctx, view, reload)],
+    });
+  },
+};
+
+function sheet(ctx: ConsolePanelContext, view: RosterView, reload: () => void): HTMLElement {
+  const { ui } = ctx;
+  const card = ui.sheet({
+    title: '监听名单',
+    en: '群号 + 私聊 QQ 号',
+    desc: '改动立即生效并写入 config.json。加入或移出监听的会话会通知 bot。',
+  });
+
+  const save = (action: string): void => {
+    void ctx
+      .invoke('set', [view.roster.groups, view.roster.privates])
+      .then(
+        () => { ui.toast(`${action}已保存`); },
+        (err: unknown) => { ui.toast(`${action}失败: ${errText(err)}`, 'bad'); },
+      )
+      .then(() => {
+        reload();
+        void ctx.refresh();
+      });
+  };
+
+  for (const kind of ['group', 'private'] as const) {
+    card.body.append(ui.section(WORDS[kind].label), list(ctx, view, kind, save));
+  }
+  return card.el;
+}
+
+function list(
+  ctx: ConsolePanelContext,
+  view: RosterView,
+  kind: Kind,
+  save: (action: string) => void,
+): HTMLElement {
+  const { ui } = ctx;
+  const box = ui.h('div', 'qq-rosterlist');
+  const entries = entriesOf(view.roster, kind);
+  if (!entries.length) box.appendChild(ui.placeholder(WORDS[kind].empty));
+  for (const entry of entries) box.appendChild(card(ctx, view, kind, entry, save));
+  box.appendChild(addRow(ctx, view, kind, save));
+  return box;
+}
+
+function entriesOf(roster: QQRoster, kind: Kind): QQRosterEntry[] {
+  return kind === 'group' ? roster.groups : roster.privates;
+}
+
+/** 号码在这份名单里已知的显示名;没有就返回 null(渲染成"等连上/等消息补全")。 */
+function nameOf(view: RosterView, kind: Kind, id: number): string | null {
+  if (kind === 'group') {
+    const g = view.names.groups.find((x) => x.id === id);
+    return g ? `${g.name}${g.card ? `(我的群昵称「${g.card}」)` : ''}` : null;
+  }
+  const p = view.names.privates.find((x) => x.id === id);
+  return p && p.name ? p.name : null;
+}
+
+function card(
+  ctx: ConsolePanelContext,
+  view: RosterView,
+  kind: Kind,
+  entry: QQRosterEntry,
+  save: (action: string) => void,
+): HTMLElement {
+  const { ui } = ctx;
+  const row = ui.h('div', entry.enabled ? 'qq-rcard' : 'qq-rcard off');
+
+  const toggle = ui.button(entry.enabled ? '监听中' : '已停用', {
+    size: 'sm',
+    variant: entry.enabled ? 'primary' : 'plain',
+    onClick: () => {
+      entry.enabled = !entry.enabled;
+      save(entry.enabled ? '开启监听' : '停用');
+    },
+  });
+  toggle.title = entry.enabled ? '点击停用(号码仍保留,可再开)' : '点击开启监听';
+
+  const idInput = ui.input({ value: String(entry.id), cls: 'mono', placeholder: WORDS[kind].num });
+  idInput.inputMode = 'numeric';
+  idInput.addEventListener('change', () => {
+    const n = Number(idInput.value.trim());
+    const list = entriesOf(view.roster, kind);
+    if (!Number.isInteger(n) || n <= 0) { idInput.value = String(entry.id); return; }
+    if (n === entry.id) return;
+    if (list.some((e) => e !== entry && e.id === n)) {
+      ui.toast('这个号码已经在名单里了', 'bad');
+      idInput.value = String(entry.id);
+      return;
+    }
+    entry.id = n;
+    save('修改号码');
+  }, { signal: ctx.signal });
+  idInput.addEventListener('keydown', (ev: KeyboardEvent) => {
+    if (ev.key === 'Enter') idInput.blur();
+  }, { signal: ctx.signal });
+
+  const known = nameOf(view, kind, entry.id);
+  const name = ui.h(
+    'span',
+    'qq-rc-name',
+    known ?? (kind === 'group' ? '(群信息未知,连上后自动补全)' : '(等消息到达后自动补名)'),
+  );
+  name.title = name.textContent ?? '';
+
+  const del = ui.button('✕', {
+    size: 'sm',
+    variant: 'danger',
+    onClick: () => { void remove(ctx, view, kind, entry, save); },
+  });
+  del.title = '删除(不只是停用)';
+
+  row.append(toggle, idInput, name, del);
+  return row;
+}
+
+async function remove(
+  ctx: ConsolePanelContext,
+  view: RosterView,
+  kind: Kind,
+  entry: QQRosterEntry,
+  save: (action: string) => void,
+): Promise<void> {
+  const ok = await ctx.ui.confirm({
+    title: `${kind === 'group' ? '删除群' : '删除私聊'} ${entry.id}?`,
+    body: '整条从名单里去掉。只是想暂时不听的话,用"停用"。',
+    danger: true,
+  });
+  if (!ok) return;
+  const list = entriesOf(view.roster, kind);
+  const i = list.indexOf(entry);
+  if (i >= 0) list.splice(i, 1);
+  save('删除');
+}
+
+function addRow(
+  ctx: ConsolePanelContext,
+  view: RosterView,
+  kind: Kind,
+  save: (action: string) => void,
+): HTMLElement {
+  const { ui } = ctx;
+  const row = ui.h('div', 'qq-rcadd');
+  const field = ui.input({ cls: 'mono', placeholder: WORDS[kind].add });
+  const doAdd = (): void => {
+    const n = Number(field.value.trim());
+    if (!Number.isInteger(n) || n <= 0) {
+      ui.toast(`请输入有效的${WORDS[kind].num}`, 'bad');
+      return;
+    }
+    const list = entriesOf(view.roster, kind);
+    if (list.some((e) => e.id === n)) {
+      ui.toast('这个号码已经在名单里了', 'bad');
+      return;
+    }
+    list.push({ id: n, enabled: true });
+    field.value = '';
+    save('添加');
+  };
+  field.addEventListener('keydown', (ev: KeyboardEvent) => {
+    if (ev.key === 'Enter') doAdd();
+  }, { signal: ctx.signal });
+  row.append(ui.h('span'), field, ui.button('＋ 添加', { size: 'sm', variant: 'primary', onClick: doAdd }));
+  return row;
+}

package/src/worlds/qq/console/style.css

@@ -0,0 +1,65 @@
+/*
+ * QQ 面板的专有样式。
+ *
+ * 只放 `ctx.ui` 没有对应原语的监听名单卡片网格。
+ * 其余一律用原语(sheet / rowbar / btn / field / pill / table / placeholder),
+ * 那些 class 归控制台管,这里一个字都不覆盖。
+ *
+ * 两条自律:
+ *
+ * 1. **类名一律 `qq-` 前缀。** 这份样式表跟着 provider 的 bundle 注入到同一个
+ *    文档里,不加前缀就是往全局命名空间里丢东西——别的 provider 撞上了没处说理。
+ * 2. **颜色/字体只用控制台的主题变量。** 写死色值的话,主题一换这块就成了补丁。
+ */
+
+/* ---- 监听名单:细长的配置项卡片 ---- */
+.qq-rosterlist {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  margin: 6px 0 14px;
+}
+
+.qq-rcard {
+  display: grid;
+  grid-template-columns: 76px 128px 1fr 34px;
+  gap: 10px;
+  align-items: center;
+  background: var(--sheet-2);
+  border: 1px solid var(--line);
+  border-radius: 9px;
+  padding: 7px 10px;
+  transition: opacity .12s, border-color .12s;
+}
+
+/* 停用的条目仍在名单里,只是退到背景去 */
+.qq-rcard.off { opacity: .55; }
+
+.qq-rcard input.field { width: 100%; }
+
+.qq-rc-name {
+  font-size: 12px;
+  color: var(--ink-soft);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* 新增行:第一格留空,与卡片的开关列对齐 */
+.qq-rcadd {
+  display: grid;
+  grid-template-columns: 76px 128px 1fr;
+  gap: 10px;
+  align-items: center;
+  padding: 3px 10px 2px;
+}
+
+.qq-rcadd input.field { width: 100%; }
+
+@container console-content (max-width: 560px) {
+  .qq-rcard { grid-template-columns: 76px 1fr 34px; }
+  .qq-rcard > .qq-rc-name { grid-column: 1 / -1; grid-row: 2; }
+  .qq-rcard > .btn:last-child { grid-column: 3; grid-row: 1; }
+  .qq-rcadd { grid-template-columns: 1fr auto; }
+  .qq-rcadd > span:first-child { display: none; }
+}

package/src/worlds/qq/conversation.ts

@@ -0,0 +1,28 @@
+import type { EventEnvelope } from '../../core/types.ts';
+
+export interface Conv {
+  kind: 'group' | 'private';
+  id: number;
+}
+
+export function parseConversationAddress(raw: unknown): Conv | null {
+  if (typeof raw !== 'string') return null;
+  const match = /^(group|private):(\d+)$/i.exec(raw.trim());
+  if (!match) return null;
+  return {
+    kind: match[1].toLowerCase() as Conv['kind'],
+    id: Number(match[2]),
+  };
+}
+
+export function sameConversation(left: Conv, right: Conv): boolean {
+  return left.kind === right.kind && Number(left.id) === Number(right.id);
+}
+
+export function eventInConversation(event: EventEnvelope, conversation: Conv): boolean {
+  const value = event.meta?.conv as Partial<Conv> | undefined;
+  return (
+    value?.kind === conversation.kind &&
+    Number(value.id) === conversation.id
+  );
+}

package/src/worlds/qq/definition.ts

@@ -0,0 +1,62 @@
+import type { WorldDefinition } from '../../world.ts';
+import { type QQConfigSection, QQ_DEFAULTS, QQ_SECRETS, type QQRosterEntry } from './config.ts';
+import { QQWorld, enabledRosterIds } from './world.ts';
+import { VISION_DEFAULTS, VisionService, type VisionConfig } from './vision.ts';
+import { OpenRouterVLMClient } from './vlm.ts';
+
+export const QQ: WorldDefinition<QQConfigSection> = {
+  id: 'qq',
+  label: 'QQ',
+  defaults: () => ({ ...QQ_DEFAULTS, groups: [], privates: [], vision: { ...VISION_DEFAULTS } }),
+  create: (ctx) => {
+    const { cfg } = ctx;
+    // 辅助视觉只在开关打开且有 OPENROUTER_API_KEY 时存在;否则图片以占位符进入上下文。
+    const openrouterKey = ctx.secret(QQ_SECRETS.vision);
+    const vision = cfg.vision.enabled && openrouterKey
+      ? new VisionService({
+          vlm: new OpenRouterVLMClient(openrouterKey, {
+            baseUrl: cfg.vision.baseUrl,
+            model: cfg.vision.model,
+            maxTokens: cfg.vision.maxTokens,
+            timeoutMs: cfg.vision.timeoutMs,
+          }),
+          cfg: cfg.vision,
+          dataDir: ctx.dataDir,
+          timezone: ctx.timezone,
+        })
+      : undefined;
+    const module = new QQWorld(
+      {
+        wsUrl: cfg.wsUrl,
+        groups: enabledRosterIds(cfg.groups),
+        privates: enabledRosterIds(cfg.privates),
+        token: cfg.token,
+        timezone: ctx.timezone,
+      },
+      {
+        vision,
+        gate: {
+          enabled: () => cfg.enabled,
+          wsUrl: () => cfg.wsUrl,
+          tokenSet: () => !!cfg.token,
+          roster: () => ({ groups: cfg.groups, privates: cfg.privates }),
+          setRoster: (groups, privates) => {
+            // The running module receives only enabled entries; the full roster is persisted.
+            module.setWatched(enabledRosterIds(groups), enabledRosterIds(privates));
+            ctx.persist({ groups, privates });
+            const gOn = groups.filter((e) => e.enabled).length;
+            const pOn = privates.filter((e) => e.enabled).length;
+            return `监听名单已更新:群${groups.length}个(启用${gOn})、私聊${privates.length}个(启用${pOn}),已写回config.json`;
+          },
+          setEnabled: (enabled) => ctx.persist({ enabled }),
+          setConnection: (wsUrl, token) => {
+            // 空串 = 保持原 token 不动
+            ctx.persist(token === '' ? { wsUrl } : { wsUrl, token });
+          },
+          restart: () => { void ctx.restart(); },
+        },
+      },
+    );
+    return module;
+  },
+};