sidekick-chat 0.2.7 → 0.2.9

package/README.md

@@ -1,7 +1,7 @@
 # Sidekick 终端客户端
 
 在终端里和秘书说话。它只是 `chat` World 的又一个客户端,和手机 App、网页版共用同一批会话、未读和回复,
-不新增任何后端接口——所以手机上收到的、终端里发的,是同一份对话。
+所以手机上收到的、终端里发的,是同一份对话。
 
 ```
 $ npx sidekick-chat
@@ -17,10 +17,12 @@ Sidekick · 秘书 https://hkv4.cznorth.cn/chat
   记成明天 9:30,提前 10 分钟提醒。
 ```
 
-0.2.6 起，当前会话各 bot 的最后 LLM 调用时间和对应活动常驻显示在输入框上方，并实时更新；`/who` 查看全部 bot，`/conv` 也列出成员活动。纯文本交互在启动、切换会话及活动变化时输出。时间为调用开始时间，忙闲、消息和心跳不刷新它；没有记录时显示「尚无 LLM 活动记录」。
+0.2.9 起，当前会话各 bot 的最后 LLM 调用时间、对应活动、上下文用量和忙碌状态显示在输入框下方，并实时更新；输入框上方只显示对话内容，底部不再常驻操作提示。`/who` 查看全部 bot，`/conv` 也列出成员活动。纯文本交互在启动、切换会话及活动变化时输出。时间为调用开始时间，忙闲、消息和心跳不刷新它；没有记录时显示「尚无 LLM 活动记录」。
 
 ## 安装
 
+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.9",
   "description": "Sidekick 终端客户端:在终端里和秘书对话",
   "type": "module",
   "license": "PolyForm-Noncommercial-1.0.0",
@@ -27,8 +27,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Cznorth/sidekick.git",
-    "directory": "cli"
+    "url": "git+https://github.com/Cznorth/sidekick-chat.git"
   },
   "dependencies": {
     "@earendil-works/pi-tui": "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 }));

package/src/tui.mjs

@@ -32,12 +32,11 @@ export function createChatUI({ color, onSubmit, onQuit, onInput, onPasteImage, h
   });
   tui.addChild(transcript);
   tui.addChild(live);
+  tui.addChild(editor);
   tui.addChild(activity);
   tui.addChild(status);
-  tui.addChild(editor);
   const attachments = new Text('', 1, 0);
   tui.addChild(attachments);
-  tui.addChild(new Text(paint(color, 'gray', 'Enter 发送 · Ctrl+V 图片 · /paste · /image 路径 · /help · Ctrl+C 退出'), 1, 0));
   tui.setFocus(editor);
   tui.addInputListener((data) => {
     // 任何一个按键都算「人在终端前面」:调用方据此决定要不要把新消息标成已读。