From 5494a296d9d71985ea44380e9a52fdd50c6009c3 Mon Sep 17 00:00:00 2001
From: titor <foolsecret@163.com>
Date: Sun, 3 May 2026 02:45:22 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?=E8=AE=B0=E5=BD=95=20v0.2.7=20=E5=8D=87=E7=BA=A7=E5=92=8C=20/co?=
 =?UTF-8?q?ntext=20=E5=91=BD=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- agents.md: 添加上下文监控功能说明和输出示例
- changelog.md: 新增 v0.3.1 版本记录
- 更新目前进度列表
---
 agents.md    | 48 +++++++++++++++++++++---------------------------
 changelog.md | 16 ++++++++++++++++
 2 files changed, 37 insertions(+), 27 deletions(-)

diff --git a/agents.md b/agents.md
index 4d5823b..f83bdf1 100644
--- a/agents.md
+++ b/agents.md
@@ -53,33 +53,6 @@
 
 ## 实现进度
 
-### v0.2.0 已完成功能
-
-1. **TTS 语音朗读**
-   - 集成 mimo-tts client（TCP 连接）
-   - 配置文件开关（tts.enabled）
-   - 命令行切换（/tts on/off/status）
-   - 临时 TTS 前缀（`T 消息`）
-   - 动态提示符显示状态（👀 🔊）
-   - 静默失败处理（网络异常时仅记录日志）
-
-2. **流式输出（新流程）**
-   - 等待 AI 返回完整响应
-   - Markdown 转译
-   - 模拟流式输出（从配置读取速度）
-   - 效果更好，无残留问题
-
-3. **Markdown 渲染**
-   - 使用 glamour 库渲染 Markdown
-   - 支持多种主题（dark, light, dracula, tokyo-night 等）
-   - 通过 project.config.yml 配置主题
-
-4. **项目配置**
-   - 通过 project.config.yml 统一管理配置项
-   - 支持流式速度、渲染主题、Logo、TTS 等配置
-
----
-
 ### v0.3.0 进度
 
 1. **数据库层**
@@ -117,6 +90,11 @@
    - 退出时自动导出
    - 手动导出
 
+8. **上下文监控**
+   - 新增 `/context` 命令
+   - 显示会话 token 使用情况
+   - 显示压缩阈值和剩余空间
+
 ---
 
 ## 项目配置
@@ -210,6 +188,22 @@ tts:
 | `/tts status` | 显示 TTS 状态 |
 | `T 消息` | 临时开启 TTS 并发送消息 |
 
+### 上下文监控
+
+| 输入 | 行为 |
+|------|------|
+| `/context` | 显示当前会话 token 使用情况 |
+
+输出示例：
+```
+上下文使用情况
+消息数: 2
+已用: ~5663 / 131072 tokens (5%)
+压缩阈值: 98304 tokens
+压缩进度: 5%
+剩余: ~92641 tokens
+```
+
 ### 动态提示符
 
 - 关闭：`👀 `
diff --git a/changelog.md b/changelog.md
index eb30fce..69956ff 100644
--- a/changelog.md
+++ b/changelog.md
@@ -2,6 +2,20 @@
 
 ## 版本记录
 
+### v0.3.1 (2026-05-03)
+
+- **升级 picoclaw 至 v0.2.7**
+  - 配置版本从 v2 升级至 v3
+  - 适配配置结构变更（Bindings → Dispatch, channels → channel_list）
+  - 同步更新相关间接依赖
+
+- **新增 `/context` 命令**
+  - 显示当前会话上下文窗口使用情况
+  - 包含消息数、token 使用量、压缩阈值和剩余空间
+  - 在 interactiveMode 和 simpleInteractiveMode 中均支持
+
+---
+
 ### v0.3.0 (2026-04-27)
 
 - **Session 创建逻辑优化**
@@ -153,6 +167,8 @@
 - [x] UI 状态合并显示
 - [x] LLM 生成摘要（文言文风格）
 - [x] Session 自动创建逻辑
+- [x] 升级 picoclaw 至 v0.2.7
+- [x] 实现 `/context` 命令
 
 ---