Browse Source

release: v1.3.0 — 工作台 + 五层记忆 + MCP/Skill 接入

本轮新功能整理进使用手册并打版本:
- 今日工作台(AI 助手入口 + 意图路由 + 继续上次工作)
- 五层记忆(会话/情景/核心 + 待确认区,敏感信息双层拦截,全本地复用各智能体自身 provider)
- MCP 工具注册中心(json 权威源 + 文件锁、凭证仅存环境变量名、stdio allowlist、风险预分级)
- 能力插件 prompt skill(边界包裹 + 注入清洗 + 高风险工具不自动授予)
- 模型显示与切换、自动工作目录、示例知识库、pipeline human-gate resume、simple agent token 透传

版本号三处对齐:pyproject(agentpaas/lambdagent) + app.py(3 处)。
RELEASE_NOTES + DESKTOP_MANUAL_zh 更新到 v1.3.0。
回归全绿:agentpaas 334 passed / lambdagent 566 passed。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
kenny67nju 5 months ago
parent
commit
9b5f609f03

+ 47 - 0
RELEASE_NOTES.md

@@ -1,5 +1,52 @@
 # Release Notes
 
+## v1.3.0 — 2026-06-13
+
+**从「能跑」到「好用」的工作台升级** — 智能体有了记忆、有了统一入口、能接外部工具
+和能力插件。全程每块功能都经 codex 评审 + 测试 + live 验证 + CI 绿。
+848+ 测试通过(Python 3.10/3.11/3.12 矩阵 + webui 构建)。
+
+### Highlights
+
+- **今日工作台(首页重构)**:AI 助手输入框成为主入口 —— 自然语言描述任务,
+  一次轻量 LLM 意图分类自动分发给合适的智能体并预填,拿不准则回退手动选择
+  (永不卡死)。配「继续上次的工作」最近运行列表 + 常用场景卡片(点击直达,
+  无实例则从内置包自动创建)。统计降为页脚。
+
+- **五层记忆系统**(全本地、跨运行持久,按 codex 评审 20 条实现):
+  - **会话记忆**:同一对话线程自动注入前情(最近几轮 + 滚动摘要),连续追问
+    不用重复背景;前情带不可信边界包裹 + 注入清洗,失败轮不注入错误文本。
+  - **情景记忆**:跨会话按当前问题 CJK 语义召回相关历史(修了一个 `import json`
+    缺失导致 recall 一直返回空的隐藏 bug,外加 recall 跨 run 持久性修复)。
+  - **核心记忆**:run 后自动提炼用户事实/偏好进**待确认区**,人工确认才转正;
+    敏感信息(身份证/手机/成绩/健康)prompt + 正则双层拦截,绝不自动记录。
+  - 对话页「新会话 / 历史」管理线程;记忆面板「待确认」tab 逐条确认。
+
+- **MCP 工具注册中心**:「工具与连接」页接入外部 MCP 服务(http/sse/stdio)。
+  json 单一权威源 + 文件锁、凭证只存环境变量名(值不回显)、stdio 命令走
+  allowlist、工具风险预分级(删除/发送类升 HIGH 触发人工确认 —— 同时修了
+  ToolGateway 把 MCP 一律判 LOW 的老漏洞)、连接测试拉工具清单。
+
+- **能力插件(prompt skill)**:可复用的「提示词 + 工具依赖」,挂载到智能体即
+  扩充能力。系统规则永远优先于插件、含可疑指令的插件被拒、高风险工具不自动
+  授予。「工具与连接」页可视化管理。
+
+- **模型显示与切换**:模型页一览各智能体当前模型,下拉一键切换(新版本可回滚);
+  Ollama 选项实时探测本机已装模型。
+
+- **工作目录与产物**:创建智能体自动开辟 `Workspace/<名>/{data,workspace}` 标准
+  布局,产物不再藏进安装目录。包 zip 更新可让基于它创建的智能体自动跟进最新配置。
+
+- **产物 Gate 流水线 human-gate resume + simple agent token 透传**(P3 收尾):
+  「导师在环」可插进自动化流水线、打回只重跑单阶段;单轮智能体成本不再恒为 0。
+
+- **示例知识库**:桌面首启自动创建「示例知识库(数据结构课程)」,开箱即可
+  搜索/问答/挂接体验。
+
+- 文档:[Desktop 使用手册](docs/DESKTOP_MANUAL_zh.md) 更新到 v1.3.0(新增记忆系统、
+  工具与连接、工作台、模型切换等章节);记忆与 MCP/Skill 两份设计稿含完整
+  codex 评审修订记录。
+
 ## v1.2.0 — 2026-06-11
 
 **面向高校教师的完整工作台** — 内置包从 3 个扩到 10 个,知识库调用链修通,

+ 1 - 1
agentpaas/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentpaas"
-version = "1.2.0"
+version = "1.3.0"
 description = "Agent Platform as a Service — powered by lambdagent"
 readme = "README.md"
 license = "BUSL-1.1"

+ 3 - 3
agentpaas/src/agentpaas/api/app.py

@@ -29,7 +29,7 @@ async def _lifespan(_app: FastAPI):
 app = FastAPI(
     title="AgentPaaS",
     description="Agent Platform as a Service — powered by lambdagent",
-    version="1.2.0",
+    version="1.3.0",
     docs_url="/docs",
     redoc_url="/redoc",
     lifespan=_lifespan,
@@ -301,7 +301,7 @@ async def _on_startup():
 
 @app.get("/health")
 async def health():
-    return {"status": "ok", "version": "1.2.0"}
+    return {"status": "ok", "version": "1.3.0"}
 
 # Serve built Web UI static files when webui-dist/ exists.
 #
@@ -356,7 +356,7 @@ else:
     async def root():
         return {
             "service": "AgentPaaS",
-            "version": "1.2.0",
+            "version": "1.3.0",
             "docs": "/docs",
             "ui": "Run `cd webui && npm install && npm run build` to enable the Web UI.",
             "description": "Agent Platform as a Service — Every agent is a Lambda term.",

+ 81 - 18
docs/DESKTOP_MANUAL_zh.md

@@ -1,6 +1,6 @@
 # LambdAgent Desktop 安装与使用手册
 
-> 版本:v0.1.0 ・ 更新日期:2026-06-11
+> 版本:v1.3.0 ・ 更新日期:2026-06-13
 > 适用读者:科研人员、研究生、高校教师等**非技术背景用户**,以及需要本地部署的技术用户。
 
 ---
@@ -13,13 +13,15 @@
 4. [首次启动与设置向导](#4-首次启动与设置向导)
 5. [配置大模型(Provider)](#5-配置大模型provider)
 6. [核心概念速览](#6-核心概念速览)
-7. [Web 界面使用指南](#7-web-界面使用指南)
-8. [内置科研智能体包](#8-内置科研智能体包)
-9. [知识库:把你的文献变成可问答的资料库](#9-知识库把你的文献变成可问答的资料库)
-10. [命令行(CLI)速查](#10-命令行cli速查)
-11. [数据与隐私](#11-数据与隐私)
-12. [常见问题与故障排查](#12-常见问题与故障排查)
-13. [进阶配置](#13-进阶配置)
+7. [Web 界面使用指南(含工作台/对话/记忆面板/模型切换)](#7-web-界面使用指南)
+8. [记忆系统:让智能体记住上下文](#8-记忆系统让智能体记住上下文)
+9. [工具与连接:MCP 工具 + 能力插件](#9-工具与连接mcp-工具--能力插件)
+10. [内置科研智能体包](#10-内置科研智能体包)
+11. [知识库:把你的文献变成可问答的资料库](#11-知识库把你的文献变成可问答的资料库)
+12. [命令行(CLI)速查](#12-命令行cli速查)
+13. [数据与隐私](#13-数据与隐私)
+14. [常见问题与故障排查](#14-常见问题与故障排查)
+15. [进阶配置](#15-进阶配置)
 
 ---
 
@@ -100,7 +102,7 @@ Docker 模式下数据目录挂载到容器的 `/data`(由 `AGENTPAAS_DATA_DIR
 ```bash
 agentpaas serve --port 8000 &
 curl http://127.0.0.1:8000/health
-# 期望输出: {"status":"ok","version":"0.1.0"}
+# 期望输出: {"status":"ok","version":"1.3.0"}
 ```
 
 ---
@@ -118,7 +120,7 @@ agentpaas serve --port 8067
 桌面(desktop)模式是默认模式。首次启动时系统会自动完成初始化(auto-bootstrap):
 
 1. 创建你的本地租户和管理员 API Key,写入 `~/.agentpaas/config.json`;
-2. 自动安装 4 个内置科研智能体包(见 §8);
+2. 自动安装 10 个内置智能体包(见 §10);
 3. 清理上次异常退出遗留的运行记录。
 
 ### 4.2 打开 Web 界面
@@ -193,7 +195,16 @@ ollama serve                # 通常安装后已自动运行
 
 ## 7. Web 界面使用指南
 
-左侧导航:**仪表盘 / 智能体 / 知识库 / 智能体包 / 环境配置**。
+左侧导航:**今日工作 / 智能体 / 智能体包 / 资料库 / 模型与隐私 / 工具与连接**。
+
+### 7.0 今日工作台(首页)
+
+打开界面默认进入工作台,这是日常入口:
+
+- **AI 助手输入框(主角)**:直接用自然语言描述任务(例如「帮我审这篇论文 ~/Papers/draft.pdf,目标期刊 TSE」),系统用一次轻量分类自动判断该交给哪个智能体,命中后直达对话并预填好你的话;拿不准时弹出手动选择框(永远不会卡住)。
+- **继续上次的工作**:跨智能体的最近运行列表(运行中的排最前),一键回到对话。
+- **常用场景卡片**:审一篇论文 / 出一份试卷 / 写推荐信 / 设计一门课 —— 点击直达,没有对应智能体时自动从内置包创建。
+- 底部一行显示累计运行次数与 token 用量,点击进模型页看明细。
 
 ### 7.1 创建智能体
 
@@ -233,7 +244,11 @@ ollama serve                # 通常安装后已自动运行
   - `edit` — 指定某个子智能体定向修改;
   - `chat` — 只追问讨论,不动产物;
 - **工作目录浏览**:回复下方可直接浏览/下载本次运行产出的所有文件;
-- **记忆编辑**:查看与修改智能体的核心记忆和回忆日志。
+- **会话记忆**(顶部按钮):
+  - **新会话** — 开始一段干净对话(不带前情记忆),换话题时用;
+  - **历史** — 列出该智能体过往的对话线程,点击恢复历史气泡接着聊;
+  - 连续对话时第二句会自动带上前情,无需重复背景(详见 §8 记忆系统)。
+- **记忆面板**(右侧抽屉,点「智能体记忆」):核心记忆 / **待确认** / 近期对话三个标签。「待确认」里是系统自动提炼的、可能值得长期记住的事实,点「记住」纳入核心记忆、「忽略」丢弃。
 
 > 如果运行期间后端重启,界面会自动查询该次运行的最终状态并妥善收尾,不会永久转圈。
 
@@ -255,9 +270,57 @@ curl -X POST http://127.0.0.1:8000/api/v1/traces/<run_id>/confirm \
 
 「仪表盘」显示智能体数量、运行次数、成功率、平均时延、累计 token。每个智能体详情页可查看最近运行列表、健康分,点开单次运行可看完整 trace 与工具审计日志。
 
+### 7.6 模型显示与切换
+
+「模型与隐私」页顶部「使用中的模型」区块:列出每个智能体当前用的 provider/model,下拉一键切换。切换会生成新版本(旧配置在版本历史可回滚);Ollama 选项会实时探测你本机实际装好的模型。
+
+---
+
+## 8. 记忆系统:让智能体记住上下文
+
+智能体的记忆分五层,全部存在本机、跨运行持久:
+
+| 层 | 作用 | 你看到的效果 |
+|---|---|---|
+| **会话记忆** | 同一对话线程内自动带前情(最近几轮 + 滚动摘要) | 连续追问不用重复背景,第二句「简答题换两道」它知道指的是上一份试卷 |
+| **核心记忆** | 长期事实/偏好(学科、惯用格式、常用路径) | 你确认后长期生效;在记忆面板「待确认」里逐条确认 |
+| **情景记忆** | 跨会话按当前问题语义召回的相关历史 | 换个对话问相关话题,它能想起以前处理过的类似任务 |
+| **档案记忆** | 知识库(见 §10) | 挂接的文献库 |
+| **工作记忆** | 单次运行内的对话历史 | 一次 ReAct 多步推理内部 |
+
+**自动提炼,但不自动记**:每次对话后系统会提炼「可能值得长期记住的事实」放进**待确认区**,需要你在记忆面板点「记住」才转正。敏感信息(身份证、手机号、成绩、健康状况)有双层拦截,绝不会被自动记录。
+
+**隐私**:记忆压缩/提炼默认复用该智能体自己的模型 —— 用本地 Ollama 的智能体,对话内容不会被偷偷送到云端。
+
+操作入口:对话页顶部「新会话 / 历史」管理对话线程;右侧记忆面板管理核心记忆与待确认项。
+
+---
+
+## 9. 工具与连接:MCP 工具 + 能力插件
+
+侧栏「工具与连接」页,两个标签:
+
+### 9.1 MCP 工具(接入外部工具服务)
+
+把外部 MCP 服务(如 arXiv 检索、数据库查询)接进来供智能体调用:
+
+1. 「添加 MCP」→ 选连接方式(http / sse 端点,或 stdio 本机命令)→ 填地址,凭证填**环境变量名**(值写在 `~/.agentpaas/.env`,不直接存密钥);
+2. 点「测试」拉取工具清单,每个工具自动标注风险等级;
+3. 启停开关控制是否对智能体可用。
+
+**安全**:stdio 命令限 npx/node/python 等已知运行器;MCP 的删除/发送类工具默认标为高危,运行时需人工确认(见 §7.4)。
+
+### 9.2 能力插件(prompt skill)
+
+能力插件 = 一段提示词 + 工具依赖,挂载到智能体即扩充其能力,不用每个智能体重写提示词。例如一个「PDF 导出」插件,任何智能体挂上它就会用规范的中文字体导出 PDF。
+
+- 「新建能力插件」填名称/描述/提示词/依赖工具;
+- 在智能体配置里 `skills:` 引用即挂载;
+- **安全**:插件提示词始终在系统规则**之后**、优先级更低,含可疑指令(「忽略以上规则」等)的插件会被拒绝;高风险工具(Bash/写删类)不会被插件自动授予。
+
 ---
 
-## 8. 内置科研智能体包
+## 10. 内置科研智能体包
 
 桌面模式首次启动自动安装以下 10 个包(全部 local-first:工具层不联网、不可执行 shell),覆盖科研、教学、学术服务三类场景:
 
@@ -304,7 +367,7 @@ curl -X POST http://127.0.0.1:8000/api/v1/traces/<run_id>/confirm \
 
 ---
 
-## 9. 知识库:把你的文献变成可问答的资料库
+## 11. 知识库:把你的文献变成可问答的资料库
 
 1. 「知识库」页 → 「新建」→ 填名称和**根目录**(你的文献文件夹,支持 PDF/DOCX/TXT/MD/CSV/HTML);
 2. 「添加文件」选入需要索引的文档;
@@ -316,7 +379,7 @@ curl -X POST http://127.0.0.1:8000/api/v1/traces/<run_id>/confirm \
 
 ---
 
-## 10. 命令行(CLI)速查
+## 12. 命令行(CLI)速查
 
 ```bash
 # 服务
@@ -352,7 +415,7 @@ agentpaas xiaoyi start <agent_id>          # 华为小艺 ↔ Agent
 
 ---
 
-## 11. 数据与隐私
+## 13. 数据与隐私
 
 - **数据目录**(默认 `~/LambdAgentDesktop`):知识库索引、智能体实例、运行工作目录全部在本机;
 - **配置目录** `~/.agentpaas/`:`config.json`(登录凭证与数据目录选择)、`providers.json`(API Key)、`.env`(环境变量覆盖);
@@ -362,7 +425,7 @@ agentpaas xiaoyi start <agent_id>          # 华为小艺 ↔ Agent
 
 ---
 
-## 12. 常见问题与故障排查
+## 14. 常见问题与故障排查
 
 **Q1:启动后浏览器打不开界面?**
 确认服务在跑:`curl http://127.0.0.1:8000/health`。若改过端口,访问对应端口。前端白屏时检查仓库根目录是否存在 `webui-dist/`(源码安装需 `cd webui && npm install && npm run build` 编译一次)。
@@ -390,7 +453,7 @@ Provider Key 无效、欠费或超时。到「环境配置」页点「测试连
 
 ---
 
-## 13. 进阶配置
+## 15. 进阶配置
 
 环境变量写入 `~/.agentpaas/.env`(重启服务生效):
 

+ 1 - 1
lambdagent/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lambdagent"
-version = "1.2.0"
+version = "1.3.0"
 description = "A Lambda Calculus Agent DSL — every agent is a function, every composition is function composition, every loop is a Y combinator."
 readme = "README.md"
 license = "BUSL-1.1"