koishi-plugin-chatluna-studio 1.0.0

package/lib/evidence-kind.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 证据种类：模型请求证据的最细一档分类，以及它在两种排版语境下的展示标签。
+ *
+ * 分类与标签由本 module 独占。轨迹账本的种类列、证据种类过滤开关、请求组成图的图例与分段、
+ * 分析导航的分组标题全部从这里取值；任何一侧再自己列一张标签表，同一种证据就会在同屏出现两种说法。
+ *
+ * 本 module 是浏览器安全的纯 module：不依赖 Node、Koishi、Vue 或 DOM，
+ * 因此服务端轨迹派生与客户端视图共用同一实现，与共享模型证据投影同一形状。
+ * 它只描述「一条证据属于哪一类、这一类怎么显示」，不描述任何证据数据、DOM、排序或交互状态。
+ */
+/**
+ * 基础证据种类，取最细一档，与领域词汇表的证据词条一一对应。
+ *
+ * 请求边界不在其中：它是「一次模型请求从这里开始」的结构标记而不是证据，
+ * 隐藏全部证据种类后仍要能看出有哪些请求，因此它的标签留在轨迹账本这一侧。
+ */
+export type StudioEvidenceKind = 'system' | 'user' | 'assistant' | 'variable' | 'tool-definition' | 'tool-call' | 'tool-result' | 'response';
+/**
+ * 具名聚合：多档粒度都从基础种类派生。
+ *
+ * - `tool-interaction`：请求组成图使用。它按字符占比统计，而工具调用与工具结果在请求消息里成对出现，合并统计才有意义。
+ * - `tool`：分析导航使用。分组标题下要挂多个条目，因此三种工具证据收在一个分组里。
+ */
+export type StudioEvidenceAggregateId = 'tool-interaction' | 'tool';
+/** 展示标签的两个变体，按排版语境区分，成对声明因此不会各自漂移。 */
+export interface StudioEvidenceLabels {
+    /** 徽标语境：有背景色、内边距与固定高度的种类标记，全大写。 */
+    badge: string;
+    /** 标题与图例语境：分组标题、轨道图例，词首大写。 */
+    title: string;
+}
+declare const EVIDENCE_AGGREGATE_MEMBERS: {
+    'tool-interaction': readonly ["tool-call", "tool-result"];
+    tool: readonly ["tool-definition", "tool-call", "tool-result"];
+};
+/** 基础证据种类的全集，按视图里从上到下、从左到右的既有阅读顺序声明。 */
+export declare const STUDIO_EVIDENCE_KINDS: readonly StudioEvidenceKind[];
+export declare const STUDIO_EVIDENCE_AGGREGATE_IDS: readonly StudioEvidenceAggregateId[];
+/** 某个聚合的成员种类，用于让「取子集还是取聚合」在类型上也是显式选择。 */
+export type StudioEvidenceAggregateMemberKind<Id extends StudioEvidenceAggregateId> = typeof EVIDENCE_AGGREGATE_MEMBERS[Id][number];
+export interface StudioEvidenceAggregate<Id extends StudioEvidenceAggregateId = StudioEvidenceAggregateId> {
+    id: Id;
+    members: readonly StudioEvidenceAggregateMemberKind<Id>[];
+    labels: StudioEvidenceLabels;
+}
+/**
+ * 取展示标签。基础种类与聚合走同一个入口，因此视图不必自己判断某个取值是不是聚合，
+ * 取标签也只需要一个参数。
+ */
+export declare function studioEvidenceLabels(id: StudioEvidenceKind | StudioEvidenceAggregateId): StudioEvidenceLabels;
+/** 取具名聚合。成员显式声明，因此「组成图把工具调用与工具结果算作一类」是可断言的事实。 */
+export declare function studioEvidenceAggregate<Id extends StudioEvidenceAggregateId>(id: Id): StudioEvidenceAggregate<Id>;
+export declare function isStudioEvidenceAggregateMember<Id extends StudioEvidenceAggregateId>(aggregate: Id, kind: StudioEvidenceKind): kind is StudioEvidenceAggregateMemberKind<Id>;
+/**
+ * 请求组成图的种类：四种基础证据种类加工具交互聚合。
+ *
+ * 工具定义不参与聚合——它是请求前缀里的能力目录，按字符占比独立成轨；
+ * 模型请求变量投影到 User 轨道，模型响应不进请求体统计，因此两者都不在这一档里。
+ */
+export type StudioEvidenceCompositionKind = Exclude<StudioEvidenceKind, 'variable' | 'response' | StudioEvidenceAggregateMemberKind<'tool-interaction'>> | 'tool-interaction';
+export {};

package/lib/evidence-preview-text.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 证据预览文本的空白归一化。
+ *
+ * 轨迹账本行和分析导航条目都只显示一两百字的预览，但它们的输入是原始请求消息，
+ * 单条动辄几十 KB。对整段文本跑一次 `\s+` 归一化，是这两条读取路径里最贵的一步，
+ * 而结果的 99% 会被立刻丢掉。
+ *
+ * 这里只归一化足够产出预览的前缀，并在空白折叠让前缀不够长时继续扩大扫描范围。
+ * 空白折叠是就地、保序的变换，因此前缀的归一化结果一定是整段归一化结果的前缀：
+ * 返回值长度超过 `minLength` 时，它与整段归一化结果的前 `minLength` 个字符一致；
+ * 没超过时两者完全相同。调用方按自己的规则截断。
+ */
+export declare function normalizeEvidencePreviewText(value: string, minLength: number): string;

package/lib/index.d.ts

@@ -0,0 +1,42 @@
+import { Context, Schema } from 'koishi';
+import type { StudioAppearance, StudioPersistenceMode } from './types';
+export * from './console';
+export * from './console-contract';
+export * from './chatluna/error';
+export * from './chatluna/session-tracker';
+export * from './chatluna/usage';
+export * from './evidence-kind';
+export * from './model-evidence';
+export * from './model-request';
+export * from './model-request-collector';
+export * from './model-request-trajectory';
+export * from './model-request-variables';
+export * from './persistence';
+export * from './presets';
+export * from './record-store';
+export * from './types';
+export declare const name = "chatluna-studio";
+export declare const usage = "\n\u5728 Koishi \u63A7\u5236\u53F0\u91CC\u67E5\u770B ChatLuna \u7684\u771F\u5B9E\u6A21\u578B\u8BF7\u6C42\uFF0C\u5E76\u76F4\u63A5\u7F16\u8F91 ChatLuna \u4E0E chatluna-character \u7684\u9884\u8BBE\u6587\u4EF6\u3002\n\n- \u6A21\u578B\u8BF7\u6C42\u9875\u9762\u8BB0\u5F55\u6BCF\u6B21\u771F\u5B9E\u5BF9\u8BDD\u89E6\u53D1\u7684\u6A21\u578B\u8C03\u7528\uFF1A\u8BF7\u6C42\u4F53\u3001\u54CD\u5E94\u539F\u6587\u3001\u7528\u91CF\u3001\u8F68\u8FF9\u4E0E\u9884\u8BBE\u53D8\u91CF\u5C55\u5F00\u3002\n- \u9884\u8BBE\u9875\u9762\u76F4\u63A5\u8BFB\u5199`data/chathub/presets`\u4E0E`data/chathub/character/presets`\u4E0B\u7684 YAML \u6587\u4EF6\uFF0C\u4FDD\u5B58\u540E\u7531 ChatLuna \u81EA\u5DF1\u70ED\u91CD\u8F7D\u3002\n- \u70B9\u51FB\u9884\u8BBE\u91CC\u7684\u8868\u8FBE\u5F0F\u53EF\u4EE5\u8DF3\u5230\u5B83\u5728\u771F\u5B9E\u6A21\u578B\u8BF7\u6C42\u4E2D\u7684\u5C55\u5F00\u4F4D\u7F6E\uFF0C\u9700\u8981\u5148\u6709\u4E00\u6B21\u7528\u5230\u8BE5\u9884\u8BBE\u7684\u6210\u529F\u8BF7\u6C42\u3002\n\n\u6A21\u578B\u8BF7\u6C42\u7684\u91C7\u96C6\u5728 ChatLuna \u7684 fetch \u8FB9\u754C\u5B8C\u6210\uFF0C\u56E0\u6B64\u9700\u8981\u4E0E ChatLuna \u88C5\u5728\u540C\u4E00\u4E2A Koishi \u5B9E\u4F8B\u91CC\u3002\n";
+/**
+ * `chatluna_usage` 刻意不出现在这里。
+ *
+ * chatluna-usage 的用量服务是 Console `DataService`，Cordis 里的真实服务名是
+ * `console.services.chatluna_usage`，根上下文永远没有 `chatluna_usage`。把它写进 `inject.optional`
+ * 或 `koishi.service.optional`，只会让插件配置页一直显示「可选服务: chatluna_usage (未加载)」——即使
+ * 用量插件已启用、用量也读得到。用量按服务名现取（见 `findChatLunaUsage`），不进 `inject`。
+ */
+export declare const inject: {
+    required: string[];
+    optional: string[];
+};
+export interface Config extends StudioAppearance {
+    persistenceMode: StudioPersistenceMode;
+    modelRequestRecordLimit: number;
+}
+export declare const Config: Schema<Config>;
+declare module 'koishi' {
+    interface Events {
+        'chatluna/model-usage'(payload: import('./chatluna/usage').ChatLunaModelUsageEvent): void;
+    }
+}
+export declare function apply(ctx: Context, config: Config): void;