tencent-edu-assistant-connector 0.3.0 → 0.3.1

package/dist/internal.js

@@ -62,7 +62,10 @@ const noArgs = z.object({});
 /** 工具白名单：名称 → 参数校验与调用 */
 const TOOL_BINDERS = new Map([
     ['getPageContext', bindTool(noArgs, (backend) => backend.getPageContext())],
-    ['getPendingTasks', bindTool(noArgs, (backend) => backend.getPendingTasks())],
+    [
+        'getPendingTasks',
+        bindTool(z.object({ requestId: z.string().min(1).max(128).optional() }), (backend, args) => backend.getPendingTasks(args.requestId)),
+    ],
     ['getActiveExpert', bindTool(noArgs, (backend) => backend.getActiveExpert())],
     [
         'getTopicDetail',
@@ -298,7 +301,7 @@ export function createForwardingToolBackend(options) {
     const deliverTimeoutMs = options.deliverTimeoutMs ?? DEFAULT_DELIVER_TIMEOUT_MS;
     return {
         getPageContext: async () => (await call('getPageContext', {}, timeoutMs)),
-        getPendingTasks: async () => (await call('getPendingTasks', {}, timeoutMs)),
+        getPendingTasks: async (requestId) => (await call('getPendingTasks', requestId === undefined ? {} : { requestId }, timeoutMs)),
         getActiveExpert: async () => (await call('getActiveExpert', {}, timeoutMs)),
         getTopicDetail: (topicId) => call('getTopicDetail', topicId === undefined ? {} : { topicId }, timeoutMs),
         listTopicMenu: () => call('listTopicMenu', {}, timeoutMs),

package/dist/stdio.js

@@ -130,7 +130,7 @@ function createUnavailableBackend(message) {
 function createDynamicBackend(current) {
     return {
         getPageContext: () => current().getPageContext(),
-        getPendingTasks: () => current().getPendingTasks(),
+        getPendingTasks: (requestId) => current().getPendingTasks(requestId),
         getActiveExpert: () => current().getActiveExpert(),
         getTopicDetail: (topicId) => current().getTopicDetail(topicId),
         listTopicMenu: () => current().listTopicMenu(),

package/dist/tools.js

@@ -323,10 +323,16 @@ export function createLocalToolBackend(deps = {}) {
     const resolved = resolveDeps(deps);
     return {
         getPageContext: async () => resolved.contextStore.getPublic(),
-        getPendingTasks: async () => {
+        getPendingTasks: async (requestId) => {
             const ctx = resolved.contextStore.getPublic();
             const store = resolved.generationStore;
             const tasks = [...(ctx ? store.listPending(ctx.topicId) : []), ...store.listPending(NEW_TOPIC_SCOPE)];
+            if (requestId !== undefined && !tasks.some((task) => task.requestId === requestId)) {
+                // 上下文 TTL（3 分钟）远短于任务 TTL（30 分钟）：页面心跳中断后任务仍有效，按 requestId 补回
+                const task = store.getByRequestId(requestId);
+                if (task && isUnfinishedStatus(task.status))
+                    tasks.push(task);
+            }
             return tasks.map(toPublicTask);
         },
         getActiveExpert: async () => {
@@ -417,7 +423,28 @@ async function runTool(tool, run) {
 function renderPageContext(ctx, tasks) {
     if (!ctx && tasks.length === 0)
         return noContextToolText('get_page_context');
-    return buildHookText({ context: ctx, pendingTasks: tasks, maxChars: Number.MAX_SAFE_INTEGER });
+    const text = buildHookText({ context: ctx, pendingTasks: tasks, maxChars: Number.MAX_SAFE_INTEGER });
+    const note = detachedTaskNote(ctx, tasks);
+    return note ? `${note}\n\n${text}` : text;
+}
+/**
+ * 「任务所属专题不是当前已连接专题」的提示：按 requestId 补回的任务读不到其专题资料，
+ * 防止模型凭空生成或误用其他专题的资料。无此类任务时返回空串。
+ * @param ctx 当前上下文；`null` 表示页面未连接
+ * @param tasks 待完成任务
+ */
+function detachedTaskNote(ctx, tasks) {
+    const detached = tasks.filter((task) => task.topicId !== NEW_TOPIC_SCOPE && task.topicId !== ctx?.topicId);
+    if (detached.length === 0)
+        return '';
+    const ids = detached.map((task) => oneLine(task.requestId)).join('、');
+    const reason = ctx ? '不是当前打开的专题' : '当前未连接（页面上下文已过期）';
+    return [
+        `[注意] 任务 ${ids} 所属的专题页面${reason}，读不到该专题的资料清单。`,
+        `若本会话此前已生成该任务的产物，直接按「交付要求」调用 ${DELIVER_TOOL_NAME} 补交；`,
+        '否则请用户回到该专题详情页（1~2 秒内自动重连）后再调用 get_page_context 获取资料，',
+        '不要在没有资料的情况下凭空生成，也不要使用其他专题的资料。',
+    ].join('');
 }
 /**
  * 渲染专家文本。
@@ -612,7 +639,7 @@ function registerContextTools(server, backend) {
         // 只影响该 requestId，未传时不改变任何状态（正常对话零影响）。
         if (requestId !== undefined)
             await backend.markPromptSent(requestId, extra?.sessionId).catch(() => false);
-        const [ctx, tasks] = await Promise.all([backend.getPageContext(), backend.getPendingTasks()]);
+        const [ctx, tasks] = await Promise.all([backend.getPageContext(), backend.getPendingTasks(requestId)]);
         return renderPageContext(ctx, tasks);
     }));
     server.registerTool('get_active_expert', {
@@ -642,7 +669,7 @@ function registerQueryTools(server, backend) {
     }, ({ topicId }) => runTool('get_topic_detail', async () => `专题详情：\n${formatJson(await backend.getTopicDetail(topicId))}`));
     server.registerTool('list_topic_menu', {
         title: '查询专题功能入口',
-        description: '查询专题详情页的功能入口列表（资料精读 / 视频学习 / AI 生课等），用于回答「这个专题能做什么」。' +
+        description: '查询当前专题详情页的功能入口列表（以本工具返回为准，不要自行补充入口名称），用于回答「这个专题能做什么」。' +
             `使用页面上报的登录态，${PAGE_REQUIRED_NOTE}`,
     }, () => runTool('list_topic_menu', async () => {
         const list = await backend.listTopicMenu();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencent-edu-assistant-connector",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "腾讯教育学习助手 · 专题 MCP Server：为 WorkBuddy 会话提供专题页面上下文、业务查询与产物落库能力",
   "bin": {

package/plugin/.codebuddy-plugin/marketplace.json

@@ -6,7 +6,7 @@
       "name": "tencent-edu-assistant",
       "source": "./plugins/tencent-edu-assistant",
       "description": "把学习空间专题页的专题 / 资料 / 阅读位置 / 专家上下文提供给 WorkBuddy 会话，并支持生成产物回填专题",
-      "version": "0.3.0"
+      "version": "0.3.1"
     }
   ]
 }

package/plugin/plugins/tencent-edu-assistant/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tencent-edu-assistant",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "把学习空间专题页的专题 / 资料 / 阅读位置 / 专家上下文提供给 WorkBuddy 会话，并支持生成产物回填专题",
   "author": {
     "name": "tencent"