sidekick-chat 0.2.7 → 0.2.8

package/README.md

@@ -1,7 +1,7 @@
 # Sidekick 终端客户端
 
 在终端里和秘书说话。它只是 `chat` World 的又一个客户端,和手机 App、网页版共用同一批会话、未读和回复,
-不新增任何后端接口——所以手机上收到的、终端里发的,是同一份对话。
+所以手机上收到的、终端里发的,是同一份对话。
 
 ```
 $ npx sidekick-chat
@@ -21,6 +21,8 @@ Sidekick · 秘书 https://hkv4.cznorth.cn/chat
 
 ## 安装
 
+0.2.8 起，输入框上方显示当前会话各助理的「上下文 ≈ 已用 / 预算 token · 百分比」，每 5 秒检查更新，交接和预算设置变化后自动刷新。`/context` 查看当前会话用量，`/who` 查看全部助理。数值是当前主 session 的估算，预算使用服务器配置（默认 200000 token），与 `/usage` 的订阅额度不同；旧服务器没有数据时显示「上下文用量未知」。
+
 ```bash
 npx sidekick-chat          # 不装直接用
 npm i -g sidekick-chat     # 或者装到全局,命令就是 sidekick

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sidekick-chat",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Sidekick 终端客户端:在终端里和秘书对话",
   "type": "module",
   "license": "PolyForm-Noncommercial-1.0.0",

package/src/context.mjs

@@ -0,0 +1,18 @@
+const count = (n) => Math.round(n).toLocaleString('en-US');
+
+export function formatContext(bot) {
+  const c = bot?.context;
+  if (!c || !Number.isFinite(c.estTokens) || c.estTokens < 0) return '上下文用量未知';
+  const used = count(c.estTokens);
+  if (!Number.isFinite(c.maxTokens) || c.maxTokens <= 0) return `上下文 ≈ ${used} token · 预算未知`;
+  return `上下文 ≈ ${used} / ${count(c.maxTokens)} token · ${Math.round(c.estTokens / c.maxTokens * 100)}%`;
+}
+
+export function applyContext(bots, frame) {
+  const bot = bots.find(b => b.id === frame?.bot);
+  if (!bot || !Number.isFinite(frame.at) || frame.at <= 0 || frame.at < (bot.context?.at || 0)
+    || !Number.isFinite(frame.maxTokens) || frame.maxTokens <= 0
+    || (frame.estTokens !== null && (!Number.isFinite(frame.estTokens) || frame.estTokens < 0))) return false;
+  bot.context = { at: frame.at, estTokens: frame.estTokens, maxTokens: frame.maxTokens };
+  return true;
+}

package/src/main.mjs

@@ -2,9 +2,10 @@
  * 终端客户端的主流程:`sidekick` 进交互对话,`sidekick login` 存凭据,`sidekick ask "…"` 一次性问一句。
  *
  * 它只是 chat World 的又一个客户端,和手机 App、网页版共用同一份会话和未读,
- * 不新增任何后端接口(见 packages/world-chat/src/world.ts 的 `startHub`)。
+ * 上下文用量随团队状态和 SSE 推流提供(见 packages/world-chat/src/world.ts 的 `startHub`)。
  */
 import { createInterface } from 'node:readline';
+import { applyContext, formatContext } from './context.mjs';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { AuthError, SidekickApi, loginWithPassword } from './api.mjs';
@@ -334,7 +335,7 @@ async function startChat(flags) {
 
   function drawActivity() {
     const members = convOf(convId)?.members || [];
-    const text = state.bots.filter(b => members.includes(b.id)).map(b => `${b.name}: ${formatActivity(b)}`).join('\n');
+    const text = state.bots.filter(b => members.includes(b.id)).map(b => `${b.name}: ${formatActivity(b)}\n${b.name}: ${formatContext(b)}`).join('\n');
     if (ui) ui.activity(text);
     else if (text) out(text);
   }
@@ -422,6 +423,9 @@ async function startChat(flags) {
         else if (event === 'activity' && applyActivity(state.bots, payload)) {
           if (convOf(convId)?.members.includes(payload.bot)) drawActivity();
         }
+        else if (event === 'context' && applyContext(state.bots, payload)) {
+          if (convOf(convId)?.members.includes(payload.bot)) drawActivity();
+        }
         else if (event === 'busy') typing(Boolean(payload.busy));
       },
     })
@@ -469,7 +473,8 @@ async function startChat(flags) {
           '/conv            列出会话',
           '/to <序号|名字>  切换会话',
           '/history [n]     重印最近 n 条(默认 20)',
-          '/who             名册和连接状态',
+          '/who             名册、连接状态和上下文用量',
+          '/context         当前会话各助理的上下文用量和预算',
           '/usage           查询额度，查看剩余比例和重置时间',
           '/paste           添加剪贴板图片（也可 Ctrl+V）',
           '/image <路径>    添加图片文件，最多 4 张、每张 6 MB',
@@ -509,10 +514,13 @@ async function startChat(flags) {
       case 'who':
         out(
           state.bots
-            .map((b) => `${b.primary ? '*' : ' '}${b.name}(${b.id}) ${b.status}${b.busy ? ' 正在忙' : ''} — ${b.role || '无专长'}\n    ${formatActivity(b)}`)
+            .map((b) => `${b.primary ? '*' : ' '}${b.name}(${b.id}) ${b.status}${b.busy ? ' 正在忙' : ''} — ${b.role || '无专长'}\n    ${formatActivity(b)}\n    ${formatContext(b)}`)
             .join('\n'),
         );
         return;
+      case 'context':
+        out(state.bots.filter(b => convOf(convId)?.members.includes(b.id)).map(b => `${b.name}: ${formatContext(b)}`).join('\n') || '当前会话没有助理');
+        return;
       case 'usage':
       case 'quota':
         out(formatQuota(await quotas.refresh(), { detail: true }));