@oh-my-student/plugin-presets 0.0.0-stage → 0.1.1

package/COPYRIGHT

@@ -0,0 +1,5 @@
+Copyright (c) 2026 Notara contributors. All rights reserved.
+
+No open-source license is granted for first-party Notara code or assets.
+Publication does not grant permission to modify or redistribute them.
+Third-party components remain governed by their respective licenses.

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# @oh-my-student/plugin-presets
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+教学预设、提示词、学习技能和原生会话委派工具。
+
+建议通过 `@oh-my-student/dsh-bundle@0.1.1` 安装完整插件组。要求 Node 24+、DSH 0.2.1-rc.4。保留版权，见 COPYRIGHT；第三方署名见 THIRD_PARTY_NOTICES.md。
+
+配置与宿主适配说明：https://github.com/TongZi2003/Notara-Desktop/tree/main/notara-core/plugins/bundle

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,3 @@
+# Third-party notices
+
+This package does not bundle third-party runtime code. Dependencies keep their own licenses. First-party Notara code is proprietary; see COPYRIGHT.

package/canvas-tool.js

@@ -0,0 +1,56 @@
+import { createHash } from 'node:crypto';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import {drawingMathElement} from '@oh-my-student/plugin-vault-sqlite/math-reference';
+import {parseDrawingDocument} from '@oh-my-student/plugin-vault-sqlite/drawing-files';
+
+const hash=value=>createHash('sha256').update(value).digest('hex');
+export async function executeCanvas(ctx,preset,args,exec){
+  const [{parseCanvasDocument},{appendCanvasBlock,updateCanvasBlock}]=await Promise.all([import('@oh-my-student/plugin-vault-sqlite/drawing-files'),import('@oh-my-student/plugin-vault-sqlite/canvas-flow')]);
+  const agent=exec.agent;
+  if(!agent||ctx.agentPresets.composedPreset(agent.ctx)!==preset)throw Error('需要当前课堂身份');
+  const workspace=await ctx.workspaceRegistry.resolveByPath(agent.session.header.cwd);
+  if(!workspace)throw Error('当前课堂未绑定工作区');
+  if(typeof args.path!=='string'||!args.path.endsWith('.canvas'))throw Error('请选择当前工作区内的 .canvas 文件');
+  if(!['read','append','update'].includes(args.action))throw Error('canvas_action_invalid');
+  exec.signal.throwIfAborted();
+  let record;
+  try{record=await ctx.notaraVault.read({workspaceId:workspace.id,path:args.path});}
+  catch(error){if(error.code!=='ENOENT'&&!String(error.message).includes('ENOENT'))throw error;record={content:'{"nodes":[],"edges":[]}',revision:null};}
+  let doc=parseCanvasDocument(record.content);
+  const summary=()=>({path:args.path,revision:record.revision,continuationAnchor:doc.nodes.some(n=>n.id===doc.notaraCanvas?.lastNodeId)?doc.notaraCanvas.lastNodeId:null,nodes:doc.nodes.map(n=>({id:n.id,title:(n.text?.split('\n')[0]??n.label??n.file??n.id).replace(/^#+\s*/,''),type:n.type,file:n.file,subpath:n.subpath,x:n.x,y:n.y,width:n.width,height:n.height,pinned:!n.notaraFlow||!!n.notaraFlow.pinned})),...(args.action==='read'?{}:{nodeId:args.action==='append'?id:args.nodeId})});
+  const id='board-'+hash(`${agent.id}:${exec.callId}`).slice(0,24),requestHash=hash(JSON.stringify(args));
+  if(args.action==='read')return summary();
+  const prior=args.action==='append'&&doc.nodes.find(n=>n.id===id);
+  if(prior){if(prior.notaraFlow?.requestHash!==requestHash)throw Error('canvas_request_conflict');return {...summary(),alreadyApplied:true};}
+  if(args.expectedRevision!==record.revision)throw Error('板书已更新或缺少版本；请先 canvas read，再基于最新锚点和 revision 操作。');
+  if(args.action==='append'){
+    if(doc.nodes.length&&!args.after)throw Error('已有板书必须指定 after：从 canvas read 的结果选择目标块或分组 ID。');
+    if(args.file!==undefined){const source=await ctx.notaraVault.read({workspaceId:workspace.id,path:args.file});if(args.mathElementId!==undefined)drawingMathElement(parseDrawingDocument(source.content),args.mathElementId);}
+    doc=appendCanvasBlock(doc,{id,title:args.title,body:args.body,file:args.file,mathElementId:args.mathElementId,after:args.after,placement:args.placement,size:args.size,operationId:exec.callId});
+    doc.nodes.find(n=>n.id===id).notaraFlow.requestHash=requestHash;
+  }else doc=updateCanvasBlock(doc,args);
+  exec.signal.throwIfAborted();
+  const result=await ctx.notaraVault.save({workspaceId:workspace.id,path:args.path,content:JSON.stringify(doc,null,2)+'\n',expectedRevision:record.revision});
+  record={...record,revision:result.revision};
+  const node=doc.nodes.find(n=>n.id===(args.action==='append'?id:args.nodeId));
+  const anchor=doc.nodes.find(n=>n.id===args.after);
+  return {...summary(),position:{x:node.x,y:node.y,width:node.width,height:node.height},...(anchor?{anchorId:anchor.id,placement:args.placement??'below',avoidedObstacles:node.y!==(anchor.y+(args.placement==='beside'?0:anchor.height+28))}:{}),note:'已保存；页面会同步。学生翻看旧内容时不会强制跳转。'};
+}
+
+export function registerCanvasTool(ctx,preset){
+  ctx.tools.register(defineTool({
+    name:'canvas',description:'连续课堂板书：先 read 查看稳定节点 ID 与版本，再 append 新块或 update 原块。已有板书追加必须以 after 指定目标块/分组；below 接其底边，beside 接其右边。系统避让已有容器，保留学生位置。纠错用 update，禁止整文件重写。只负责板书，不代表学生掌握。',
+    parameters:{
+      action:{type:'string',enum:['read','append','update'],required:true},path:{type:'string',required:true,description:'当前工作区内的 .canvas 路径。'},
+      expectedRevision:{oneOf:[{type:'string'},{type:'null'}],description:'上次 read 返回的 revision；新建为 null。写入时必须提供。'},
+      title:{type:'string',description:'追加或修改的块标题。'},body:{type:'string',description:'Markdown 正文，可含 figure 和现有互动组件。'},
+      file:{type:'string',description:'append 可引用已存在的工作区资料文件，例如 .excalidraw；与 body 二选一，生成真实 file 节点。'},
+      mathElementId:{type:'string',description:'append引用数学对象时可用：先excalidraw read，选择具有math字段的真实元素ID，配合file引用该.excalidraw中的单张可交互数学图。共享同一源对象，不能编造ID。省略则展示整个文件。'},
+      after:{type:'string',description:'append 的锚点 ID，必须来自 read 结果；空画布首块省略。'},
+      placement:{type:'string',enum:['below','beside'],description:'相对 after 的方位，默认 below。'},size:{type:'string',enum:['normal','wide']},
+      nodeId:{type:'string',description:'update 的目标 ID，来自 read；保留该块身份、位置和其他字段。'},
+    },
+    output:{schema:{type:'object',additionalProperties:false,properties:{result:{type:'string',required:true}}},render:(_args,value)=>[{type:'text',text:value.result}]},
+    async execute(args,exec){return {result:JSON.stringify(await executeCanvas(ctx,preset,args,exec))};},
+  }));
+}

package/catalog.js

@@ -0,0 +1,34 @@
+import { resource } from './resources.js';
+import { BLIND_PRESET_ID, BLIND_SYSTEM_PROMPT } from './isolation.js';
+
+export const SKILL_NAMES = Object.freeze([
+  'notara-quest-orchestrator', 'notara-pdf-learning-set', 'notara-quest-tutor',
+  'notara-examiner-analysis', 'notara-review-brainstorm',
+]);
+
+const roles = [
+  { id: 'notara-coordinator', name: '首页学习助手', description: '倾听、查阅、规划，并将具体学习交接给专题课堂。', kind: 'coordinator', prompt: resource('coordinator.md') },
+  { id: 'notara-teacher', name: '专题课堂老师', description: '围绕真实材料引导研讨、练习和整理。', kind: 'teacher', prompt: resource('base.md') },
+  ...[
+    ['deepseek', '大肥鱼', '费曼听讲与橡皮鸭调试。'],
+    ['claude', '大小姐', '梳理结构，寻找简洁路径。'],
+    ['gemini', '多动鬼', '图像直觉与跨领域类比。'],
+    ['gpt', '后桌', '检查前提、边界与反例。'],
+  ].map(([id, name, description]) => ({ id: `companion-${id}`, name, description, kind: 'companion', prompt: resource(`companions/${id}.md`) })),
+  { id: BLIND_PRESET_ID, name: '大肥鱼（不看解析）', description: '只接收原始题面与学生本次讲解，禁用工具与父会话历史。', kind: 'blind', prompt: BLIND_SYSTEM_PROMPT },
+  ...[
+    ['problem', '题目研究员', '独立推演与 Python/SymPy 验算。'],
+    ['review', '核验员', '检查逻辑、依据和遗漏条件。'],
+    ['exercise', '出题员', '设计并核验变式与铺垫题。'],
+    ['general', '资料研究员', '检索本地材料与公开来源。'],
+    ['lesson', '备课员', '梳理学习路径与备课草案。'],
+  ].map(([id, name, description]) => ({ id: `worker-${id}`, name, description, kind: 'worker', prompt: `${resource('workers/base.md')}\n\n${resource(`workers/${id}.md`)}` })),
+];
+
+export const ROLES = Object.freeze(roles.map(Object.freeze));
+export const PRESET_IDS = Object.freeze(ROLES.map(role => role.id));
+export function roleById(id) {
+  const role = ROLES.find(role => role.id === id);
+  if (!role) throw new TypeError(`Unknown Notara preset: ${id}`);
+  return role;
+}

package/drawing-tool.js

@@ -0,0 +1,109 @@
+import {createHash} from 'node:crypto';
+import {defineTool} from '@deepseek-ai/dsh-tools';
+import {createLibraryDrawing,searchDrawingLibrary} from '@oh-my-student/plugin-vault-sqlite/drawing-library';
+import {PLANAR_CONSTRUCTION_SYNTAX} from '@oh-my-student/plugin-graph-and-blocks/drawing-math';
+const hash=text=>createHash('sha256').update(text).digest('hex');
+export async function executeDrawing(ctx,preset,args,exec){
+  const [{parseDrawingDocument,EMPTY_DRAWING},{makeDrawingElements,drawingBounds,validateDrawing}]=await Promise.all([import('@oh-my-student/plugin-vault-sqlite/drawing-files'),import('@oh-my-student/plugin-vault-sqlite/drawing-sync')]);
+  const agent=exec.agent;if(!agent||ctx.agentPresets.composedPreset(agent.ctx)!==preset)throw Error('需要当前课堂身份');
+  const workspace=await ctx.workspaceRegistry.resolveByPath(agent.session.header.cwd);if(!workspace)throw Error('当前课堂未绑定工作区');
+  if(args.action==='library')return {result:JSON.stringify({source:'ExcaliMath',items:searchDrawingLibrary(args.query).map(({id,name,english,category})=>({id,name,english,category})),note:'现成示意素材；draw 使用 kind=library、libraryId 和局部 x/y。不是约束几何或三维构造。'})};
+  if(typeof args.path!=='string'||!args.path.endsWith('.excalidraw'))throw Error('drawing_path_invalid: 请指定 .excalidraw 文件');
+  if(!['read','draw','update','delete','show'].includes(args.action))throw Error('drawing_action_invalid');
+  exec.signal.throwIfAborted();let record;
+  try{record=await ctx.notaraVault.read({workspaceId:workspace.id,path:args.path});}catch(e){if(e.code!=='ENOENT'&&!String(e.message).includes('ENOENT'))throw e;record={content:EMPTY_DRAWING,revision:null};}
+  let doc=parseDrawingDocument(record.content),elements=doc.elements.filter(e=>!e.isDeleted);
+  const presentation=(content,revision)=>{
+    const scene=parseDrawingDocument(content);delete scene.notaraDrawing;
+    const snapshot=JSON.stringify(scene);if(snapshot.length>4*1024*1024)return {};
+    return {snapshot:{version:1,sourceSessionId:agent.id,workspaceId:workspace.id,path:args.path,revision,content:snapshot}};
+  };
+  const embed=()=>`\`\`\`drawing\n${exec.callId}\n\`\`\``;
+  if(args.action==='show'){
+    const shown=presentation(record.content,record.revision);if(!shown.snapshot)throw Error('drawing_snapshot_too_large: 请拆分白板后展示');
+    return {result:JSON.stringify({path:args.path,revision:record.revision,embed:embed(),note:'在回复正文中原样放入 embed，即展示这一版本的白板。'}),...shown};
+  }
+  const groups=[...new Set(elements.flatMap(e=>e.groupIds??[]))].map(id=>({id,title:elements.find(e=>e.groupIds?.includes(id))?.customData?.notaraTitle??'图形组',...drawingBounds(elements.filter(e=>e.groupIds?.includes(id)))}));
+  if(args.action==='read'){
+    const preview=await ctx.notaraVault.drawingPreview({workspaceId:workspace.id,path:args.path});
+    const selected=args.elementIds?.length?elements.filter(e=>args.elementIds.includes(e.id)||e.groupIds?.some(id=>args.elementIds.includes(id))):elements;
+    const result={path:args.path,revision:record.revision,groups,busyIds:preview.busyIds,elements:selected.slice(0,300).map(e=>({id:e.id,type:e.type,text:e.text,x:e.x,y:e.y,width:e.width,height:e.height,angle:e.angle,groupIds:e.groupIds,version:e.version,...(e.customData?.notaraMath?{math:e.customData.notaraMath}:{})})),truncated:selected.length>300};
+    let image;
+    if(preview.png&&preview.revision===record.revision&&ctx.get('attachments')){
+      const routed=agent.session.requestHeader?.()?.config??agent.options;
+      const model=routed?.provider&&routed?.model&&await ctx.get('llm')?.resolveModelInfo(routed.provider,routed.model,exec.signal);
+      if(model?.inputModalities?.includes('image'))image=await ctx.get('attachments').saveImage({data:Buffer.from(preview.png,'base64'),mediaType:'image/png',name:'当前画布.png'});
+      else result.preview='当前模型不支持图片；手写内容不能只凭元素坐标推断，请切换支持图片的模型。';
+    }else result.preview='当前版本的图片预览尚未就绪；打开画布后会生成。不能声称看过手写内容。';
+    return {result:JSON.stringify(result),...(image?{image}: {})};
+  }
+  const operationId=hash(`${agent.id}:${exec.callId}`),requestHash=hash(JSON.stringify(args));
+  if(doc.notaraDrawing?.receipts?.[operationId]){if(doc.notaraDrawing.receipts[operationId]!==requestHash)throw Error('drawing_request_conflict');return {result:JSON.stringify({path:args.path,revision:record.revision,alreadyApplied:true})};}
+  if(args.expectedRevision!==record.revision)throw Error('drawing_revision_conflict: 请先 read，使用最新 revision 和目标 ID。');
+  const before=record.content;doc=structuredClone(doc);let affected=[];
+  if(args.action==='draw'){
+    if(!Array.isArray(args.shapes)||!args.shapes.length||args.shapes.length>100)throw Error('drawing_shapes_invalid: 需要1–100个图形');
+    const expanded=[];
+    for(const shape of args.shapes){
+      if(shape.kind==='math'){const {mathDefinition}=await import('@oh-my-student/plugin-graph-and-blocks/drawing-math');expanded.push({...shape,math:mathDefinition(shape.source).data});continue;}
+      if(shape.kind!=='function'){expanded.push(shape);continue;}
+      const {compileExpression}=await import('@oh-my-student/plugin-graph-and-blocks/math-expression');
+      const [xmin,xmax]=shape.xRange??[],[ymin,ymax]=shape.yRange??[];
+      if(![xmin,xmax,ymin,ymax,shape.x,shape.y,shape.width,shape.height].every(Number.isFinite)||xmin>=xmax||ymin>=ymax||shape.width<=0||shape.height<=0)throw Error('drawing_function_range_invalid');
+      const f=compileExpression(shape.expression,['x']);let points=[];
+      const flush=()=>{if(points.length>=2)expanded.push({kind:'line',x:shape.x,y:shape.y,points,color:shape.color});points=[];};
+      for(let i=0;i<=160;i++){const x=xmin+(xmax-xmin)*i/160;let y;try{y=f.evaluate({x});}catch{y=NaN;}
+        if(!Number.isFinite(y)||y<ymin||y>ymax){flush();continue;}
+        const point=[(x-xmin)/(xmax-xmin)*shape.width,(ymax-y)/(ymax-ymin)*shape.height];
+        if(points.length&&Math.abs(point[1]-points.at(-1)[1])>shape.height/2)flush();points.push(point);
+      }flush();
+    }
+    let serial=0;const nextId=()=>`${operationId.slice(0,22)}-${serial++}`;
+    const created=expanded.flatMap(shape=>{
+      if(shape.kind!=='library')return makeDrawingElements([shape],nextId);
+      if(!Number.isFinite(shape.x)||!Number.isFinite(shape.y))throw Error('drawing_position_invalid');
+      const inserted=createLibraryDrawing(shape.libraryId,nextId);Object.assign(doc.files??={},inserted.files);
+      return inserted.elements.map(e=>({...e,x:e.x+shape.x,y:e.y+shape.y}));
+    }),groupId=`group-${operationId.slice(0,22)}`;
+    const placement=args.placement??'below';if(!['below','beside','overlay'].includes(placement))throw Error('drawing_placement_invalid');
+    const target=elements.find(e=>e.id===args.after),anchor=target?drawingBounds([target]):groups.find(g=>g.id===args.after);
+    if(elements.length&&!anchor)throw Error('drawing_anchor_missing: 非空画布需要 after 指定 read 返回的元素或组 ID');
+    const bounds=drawingBounds(created);let x=anchor?anchor.x+(placement==='beside'?anchor.width+32:0):0,y=anchor?anchor.y+(placement==='below'?anchor.height+32:0):0;
+    if(placement!=='overlay'){
+      const obstacles=[...groups,...elements.filter(e=>!e.groupIds?.length)].map(e=>drawingBounds(e.type?[e]:[{...e,angle:0}]));let obstacle;
+      while((obstacle=obstacles.find(o=>x<o.x+o.width+32&&x+bounds.width+32>o.x&&y<o.y+o.height+32&&y+bounds.height+32>o.y)))y=obstacle.y+obstacle.height+32;
+    }
+    for(const e of created){e.x+=x-bounds.x;e.y+=y-bounds.y;e.groupIds=[groupId];e.customData={...e.customData,notaraAuthor:'teacher',notaraTitle:String(args.title??'板书').slice(0,160)};}
+    doc.elements.push(...created);affected=created.map(e=>e.id);
+  }else{
+    const updates=args.action==='delete'?(args.elementIds??[]).map(id=>({id,isDeleted:true})):args.updates;
+    if(!Array.isArray(updates)||!updates.length||updates.length>100)throw Error('drawing_updates_invalid');
+    for(const patch of updates){
+      const e=doc.elements.find(e=>e.id===patch.id&&!e.isDeleted);if(!e)throw Error('drawing_element_missing: 目标已删除或不存在，请重新读取');
+      const allowed=['id','x','y','width','height','text','color','source',...(args.action==='delete'?['isDeleted']:[])];if(Object.keys(patch).some(k=>!allowed.includes(k)))throw Error('drawing_patch_invalid');
+      const {id,color,source,...changes}=patch;if(changes.text!==undefined){if(e.type!=='text'||typeof changes.text!=='string'||changes.text.length>8000)throw Error('drawing_text_invalid');changes.originalText=changes.text;changes.height=changes.text.split('\n').length*e.fontSize*e.lineHeight;}
+      if(source!==undefined){if(!e.customData?.notaraMath)throw Error('drawing_math_target_invalid');const {mathDefinition}=await import('@oh-my-student/plugin-graph-and-blocks/drawing-math');changes.customData={...e.customData,notaraMath:mathDefinition(source).data};}
+      if(color!==undefined){if(!/^#[\da-f]{6}$/i.test(color))throw Error('drawing_color_invalid');changes.strokeColor=color;}
+      Object.assign(e,changes,{version:(e.version??1)+1,versionNonce:Math.floor(Math.random()*2147483647),updated:Date.now()});affected.push(id);
+    }
+    if(args.action==='delete')for(const e of doc.elements){
+      if(e.isDeleted)continue;let changed=false;
+      for(const key of ['startBinding','endBinding'])if(affected.includes(e[key]?.elementId)){e[key]=null;changed=true;}
+      for(const key of ['containerId','frameId'])if(affected.includes(e[key])){e[key]=null;changed=true;}
+      if(e.boundElements?.some(b=>affected.includes(b.id))){e.boundElements=e.boundElements.filter(b=>!affected.includes(b.id));changed=true;}
+      if(changed){e.version=(e.version??1)+1;e.versionNonce=Math.floor(Math.random()*2147483647);e.updated=Date.now();}
+    }
+  }
+  validateDrawing(doc);exec.signal.throwIfAborted();
+  const result=await ctx.notaraVault.drawingCommit({workspaceId:workspace.id,path:args.path,base:before,content:JSON.stringify(doc),respectActivity:true,operationId,requestHash});
+  const shown=presentation(result.content,result.revision);
+  return {result:JSON.stringify({path:args.path,revision:result.revision,elementIds:affected,...(shown.snapshot?{embed:embed()}:{}),note:'图形已保存。需要在回复中展示这一版本时，原样放入 embed；不会自动向学生发送消息。'}),...shown};
+}
+
+export function registerDrawingTool(ctx,preset){ctx.tools.register(defineTool({
+  name:'excalidraw',description:'在当前课堂共绘画布读取、追加、修改或删除图形。现成图形先用library按query搜索，再以kind=library和libraryId插入。先read取得revision和目标元素/组ID。draw提交局部坐标图形组，已有画布必须指定after；below/beside避让，overlay用于在目标上批注。update/delete遇到学生正在编辑或版本变化会拒绝，需等待后重读。禁止整文件重写；新增批注保留学生原笔迹。图片预览仅在当前模型支持图片时提供。',
+  parameters:{action:{type:'string',enum:['read','draw','update','delete','show','library'],required:true,description:'show只冻结当前白板并返回可放入回复的embed，不修改图形。'},query:{type:'string',description:'library的中英文搜索词，空值返回全部素材。'},path:{type:'string',description:'除library外必填：当前工作区内的 .excalidraw 相对路径。'},expectedRevision:{oneOf:[{type:'string'},{type:'null'}],description:'写操作必须提供read返回的revision；空白新文件为null。'},after:{type:'string',description:'read返回的元素或组ID；非空画布draw必须提供。'},placement:{type:'string',enum:['below','beside','overlay']},title:{type:'string',description:'本次图形组的简短标题。'},elementIds:{type:'array',items:{type:'string'},description:'read筛选或delete指定的真实元素ID。'},
+    shapes:{type:'array',description:'draw的图形。坐标是本组内部坐标，由系统整体放到锚点旁。数学图优先使用math和source，保留定义与交互；function仅生成静态曲线。function按数学表达式采样，必须给xRange/yRange和显示宽高；text使用普通文字或Unicode数学符号。',items:{type:'object',additionalProperties:false,properties:{kind:{type:'string',enum:['rectangle','ellipse','diamond','text','line','arrow','function','math','library'],required:true},libraryId:{type:'string',description:'kind=library必填：library查询返回的素材ID。'},x:{type:'number',required:true},y:{type:'number',required:true},width:{type:'number'},height:{type:'number'},text:{type:'string'},fontSize:{type:'number'},color:{type:'string',description:'#RRGGBB'},points:{type:'array',items:{type:'array',items:{type:'number'}},description:'line/arrow的局部点坐标，例如[[0,0],[100,50]]。'},source:{type:'string',description:'math图的figure定义（不含围栏），一行一个声明。最小例：axes x -2..2 y -1..5\nparam a = 1 in 0.5..2 step 0.1\nfunction f(x) = a*x^2。支持现有figure的平面和基础空间语法，不允许ask或JavaScript。\n'+PLANAR_CONSTRUCTION_SYNTAX},expression:{type:'string',description:'function使用现有数学语法，如x^2、sin(x)、ln(x)，只允许变量x。'},xRange:{type:'array',items:{type:'number'}},yRange:{type:'array',items:{type:'number'}}}}},
+    updates:{type:'array',description:'update按id修改指定字段，未给字段保留。',items:{type:'object',additionalProperties:false,properties:{id:{type:'string',required:true},x:{type:'number'},y:{type:'number'},width:{type:'number'},height:{type:'number'},text:{type:'string'},color:{type:'string'},source:{type:'string',description:'仅用于数学图：替换完整figure定义，并重置该图的参数、自由点和视角。'}}}},
+  },output:{schema:{type:'object',additionalProperties:false,properties:{result:{type:'string',required:true},image:{type:'json'},snapshot:{type:'json'}}},presentationMeta:(_args,value)=>value.snapshot?{notaraDrawing:value.snapshot}:{},render:(_args,value)=>[{type:'text',text:value.result},...(value.image?[{type:'image',attachment:value.image}]:[])]},execute:(args,exec)=>executeDrawing(ctx,preset,args,exec),
+}));}

package/index.js

@@ -0,0 +1,68 @@
+import { fileURLToPath } from 'node:url';
+import { Service } from '@deepseek-ai/cordis';
+import { ROLES } from './catalog.js';
+import { skillsDirectory } from './resources.js';
+import { foldSubagentDescriptor } from '@deepseek-ai/dsh-subagent';
+import { TopicConversations } from './topic-conversations.js';
+
+export { PRESET_IDS, ROLES, SKILL_NAMES } from './catalog.js';
+export { BLIND_PRESET_ID } from './isolation.js';
+
+export function presetDefinitions() {
+  return ROLES.map((role, order) => ({
+    id: role.id, name: role.name, description: role.description, order,
+    plugins: [
+      { id: 'notara-prompt', name: '@oh-my-student/plugin-presets/prompt', config: { preset: role.id } },
+      { id: 'notara-policy', name: '@oh-my-student/plugin-presets/policy', config: { preset: role.id } },
+      ...['teacher', 'coordinator'].includes(role.kind) ? [
+        { id: 'tool-ask-user', name: '@deepseek-ai/dsh-tool-ask-user', config: { mode: 'timed', timeout: -1 } },
+      ] : [],
+      ...role.kind === 'blind' ? [] : [
+        { id: 'tool-fs', name: '@deepseek-ai/dsh-tool-fs' },
+        { id: 'tool-fs-search', name: '@deepseek-ai/dsh-tool-fs-search', config: { sampleOverCapGlobResults: false } },
+      ],
+      ...['teacher', 'worker', 'coordinator'].includes(role.kind) ? [{ id: 'tool-web', name: '@deepseek-ai/dsh-tool-web', config: { fetch: role.kind !== 'coordinator' } }] : [],
+      ...role.kind === 'teacher' || ['worker-problem', 'worker-exercise'].includes(role.id) ? [{ id: 'tool-bash', name: '@deepseek-ai/dsh-tool-bash' }] : [],
+      ...['teacher', 'worker'].includes(role.kind) ? [
+        { id: 'notara-skills', name: '@deepseek-ai/dsh-skill-filesystem', config: { providerName: 'notara-bundled', includeDefaultRoots: false, bundledSkillDir: fileURLToPath(skillsDirectory), watch: false } },
+        { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+      ] : [],
+      ...['teacher', 'coordinator', 'companion'].includes(role.kind) ? [
+        { id: 'notara-delegation', name: '@oh-my-student/plugin-presets/tools', config: { preset: role.id } },
+      ] : [],
+      ...role.kind === 'teacher' ? [{ id: 'tool-jobs', name: '@deepseek-ai/dsh-tool-jobs' }] : [],
+    ],
+  }));
+}
+
+// Same registration API as dsh-agent-preset's Service.init, with disposers
+// retained by Cordis. No host services are published from a preset group.
+export default class NotaraPresets {
+  static inject = ['agentPresets'];
+  constructor(ctx) { this.ctx = ctx; }
+  async *[Service.init]() {
+    const ctx = this.ctx;
+    ctx.inject(TopicConversations.inject, runtimeCtx => { runtimeCtx.plugin(TopicConversations); });
+    // Preset registration has exactly the native preset plugin's dependency.
+    // Host services may arrive independently; model-facing prompt/tool services
+    // need not exist in this root plugin's dependency scope.
+    ctx.inject(['agents', 'subagents'], runtimeCtx => {
+      // Native continuations initially inherit their parent's preset. Commit the
+      // teacher selection before publication releases the first queued prompt.
+      // The native selection event also restores the right role on cold resume.
+      runtimeCtx.on('agent/created', async ({ agent }) => {
+        const events = agent.session.snapshotEvents();
+        const descriptor = foldSubagentDescriptor(events);
+        if (descriptor?.mode !== 'continuable' || descriptor.provider !== 'notara-preset:notara-teacher') return;
+        if (runtimeCtx.agentPresets.composedPreset(agent.ctx) !== 'notara-teacher') {
+          const recorded = events.filter(e => e.type === 'agent-preset/selected').at(-1)?.data.agentPreset ?? agent.session.header.agentPreset;
+          // Restoring the recorded composition is not a new selection in an
+          // already-started classroom. No prompt can run until this listener ends.
+          if (recorded === 'notara-teacher') await runtimeCtx.agentPresets.mount(agent.ctx, recorded);
+          else await runtimeCtx.agentPresets.select(agent, 'notara-teacher');
+        }
+      });
+    });
+    for (const definition of presetDefinitions()) yield await ctx.agentPresets.register(definition);
+  }
+}

package/isolation.js

@@ -0,0 +1,19 @@
+export const BLIND_PRESET_ID = 'companion-deepseek-blind';
+export const BLIND_SYSTEM_PROMPT = '你是认真听讲的大肥鱼。你只能看到原始题面和学生本次讲解，不知道标准答案。请定位第一个缺少前提、逻辑跳步或边界不明之处，一次追问一个具体问题；无法确认时明确说不知道，不假装已验证。';
+
+function text(value, field, max = 48_000) {
+  if (typeof value !== 'string' || !value.trim() || value.length > max) {
+    throw new TypeError(`${field} must be non-empty text of at most ${max} characters`);
+  }
+  return value;
+}
+
+/** Deliberately accepts no generic prompt/context/history/reference fields. */
+export function blindTask(input) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) throw new TypeError('Blind task must be an object');
+  const allowed = new Set(['problem', 'studentExplanation']);
+  for (const key of Object.keys(input)) {
+    if (!allowed.has(key)) throw new TypeError(`Blind task does not accept ${key}`);
+  }
+  return `## 原始题面\n${text(input.problem, 'problem')}\n\n## 学生本次讲解\n${text(input.studentExplanation, 'studentExplanation')}`;
+}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@oh-my-student/plugin-presets",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Native DSH teaching presets and bundled filesystem skills",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./prompt": "./prompt.js",
+    "./policy": "./policy.js",
+    "./tools": "./tools.js",
+    "./catalog": "./catalog.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "*.js",
+    "resources",
+    "COPYRIGHT",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "sync:resources": "node scripts/sync-resources.mjs"
+  },
+  "peerDependencies": {
+    "@oh-my-student/plugin-vault-sqlite": "0.1.1",
+    "@oh-my-student/plugin-graph-and-blocks": "0.1.1",
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-agent-preset": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-scope": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-session-query": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-skill-filesystem": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-subagent": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-bash": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-ask-user": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-user-questions": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-fs": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-fs-search": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-skill": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-jobs": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tool-web": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.4"
+  },
+  "peerDependenciesMeta": {
+    "@oh-my-student/plugin-vault-sqlite": {
+      "optional": true
+    },
+    "@oh-my-student/plugin-graph-and-blocks": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TongZi2003/Notara-Desktop.git",
+    "directory": "notara-core/plugins/presets"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/policy.js

@@ -0,0 +1,98 @@
+import { ROLES, roleById } from './catalog.js';
+import { scopeParentOf, scopeOf, scopeChainOf } from '@deepseek-ai/dsh-scope';
+
+const read = ['read', 'read_image', 'glob', 'grep'];
+export function allowedTools(role) {
+  switch (role.kind) {
+    case 'blind': return [];
+    case 'coordinator': return ['read', 'glob', 'grep', 'web_search', 'subagent', 'send_message', 'ask_user_question'];
+    case 'teacher': return [...read, 'write', 'edit', 'bash', 'web_search', 'web_fetch', 'skill', 'subagent', 'send_message', 'interrupt_agent', 'job_output', 'job_list', 'job_kill', 'ask_user_question', 'canvas','excalidraw'];
+    case 'companion': return [...read, 'send_message'];
+    case 'worker': return [...read, 'web_search', 'web_fetch', 'skill', ...['worker-problem', 'worker-exercise'].includes(role.id) ? ['bash'] : []];
+    default: throw new TypeError('Unknown role kind');
+  }
+}
+
+// A retained preset generation can outlive the plugin that registered it.
+// The standing policy row admits Agents; each admitted Agent owns its own
+// controller, listeners, restriction and guard until that Agent is disposed.
+const controllers = new WeakMap();
+
+// Match the native userQuestions ownership boundary, including restored roots
+// that still have a durable parent-session lineage.
+const toolsForAgent = (ctx, agent, role) => allowedTools(role).filter(name =>
+  name !== 'ask_user_question' || ctx.agents.roots().includes(agent));
+
+function attachPolicy(agent) {
+  const existing = controllers.get(agent);
+  if (existing) { existing.reconcile(); return; }
+  const ctx = agent.ctx;
+  const registry = ctx.get('agentPresets');
+  let installed;
+  let reconciling = false;
+  let disposed = false;
+  function reconcile() {
+    if (reconciling || disposed) return;
+    reconciling = true;
+    try {
+      const id = registry.composedPreset(ctx);
+      const role = ROLES.find(role => role.id === id);
+      const names = role ? toolsForAgent(ctx, agent, role) : [];
+      const available = names.filter(name => ctx.tools.get(name, scopeParentOf(agent)) !== undefined);
+      const signature = available.join(',');
+      if (installed?.id === id && installed.signature === signature) return;
+      installed?.dispose();
+      installed = undefined;
+      if (!role) return;
+      const allowed = new Set(names);
+      const disposers = [];
+      const state = { id, signature, dispose: () => disposers.splice(0).reverse().forEach(dispose => dispose()) };
+      installed = state;
+      try {
+        disposers.push(ctx.tools.presentAs('native'));
+        disposers.push(ctx.tools.restrict({ allow: available }));
+        disposers.push(ctx.tools.guard(exec => allowed.has(exec.name) ? undefined : `Tool ${exec.name} is unavailable for ${id}`));
+      } catch (error) {
+        installed = undefined;
+        state.dispose();
+        throw error;
+      }
+    } finally { reconciling = false; }
+  }
+  controllers.set(agent, { reconcile });
+  ctx.on('tools/change', reconcile);
+  // rc.4 may inject a canonical-directory notice while creating a child.
+  // Blind assessment has no filesystem tools and admits no environment hints.
+  // Filter at the native admission boundary so model input remains replayable.
+  ctx.on('agent/pre-step', async (_payload, next) => {
+    const decision=await next();
+    if(decision.kind!=='enter')return decision;
+    const events=agent.session.snapshotEvents();
+    const initialChild=events.some(event=>event.type==='subagent/descriptor')&&!events.some(event=>event.type==='user/message');
+    const blind=registry.composedPreset(ctx)==='companion-deepseek-blind';
+    return {...decision,messages:decision.messages.filter(message=>!blind||message.source?.kind!=='working-directory').map(message=>initialChild&&message.source?.kind==='user'&&!message.source.rpcId?{...message,source:{kind:'notara-child-handoff',form:'relay'}}:message)};
+  });
+  // The listener is Agent-owned, as is the execution guard. Neither is revoked
+  // when Subagent providers or the registering presets root disappear.
+  ctx.on('system-prompt/assemble', async (assembly, context, next) => {
+    const result = await next();
+    if (context.scope !== agent) return result;
+    const role = ROLES.find(role => role.id === registry.composedPreset(ctx));
+    if (!role) return result;
+    const allowed = new Set(toolsForAgent(ctx, agent, role));
+    return { ...result, tools: result.tools.filter(tool => allowed.has(tool.name)) };
+  });
+  ctx.effect(() => () => { disposed = true; installed?.dispose(); controllers.delete(agent); });
+  reconcile();
+}
+
+export const name = 'notara-agent-policy';
+export const inject = ['agents'];
+export function apply(ctx, { preset }) {
+  roleById(preset);
+  const generation = scopeOf(ctx);
+  if (!generation) throw new Error('Notara permissions require a standing preset scope');
+  const admit = agent => { if (scopeChainOf(agent).includes(generation)) attachPolicy(agent); };
+  ctx.on('agent/created', ({ agent }) => admit(agent));
+  for (const agent of ctx.agents.list()) admit(agent);
+}

package/prompt.js

@@ -0,0 +1,44 @@
+import { roleById } from './catalog.js';
+import { readReviewContext } from './review-context.js';
+
+export const name = 'notara-preset-prompt';
+export const inject = ['systemPrompt'];
+
+function runtimeContract(role) {
+  if (role.kind === 'blind') return '';
+  const lines = ['\n\n## 当前 DSH 工具合同', '文件工具使用实际公布的 schema：文件路径参数名为 file_path。学生从阅读器带入 PDF 时，页码/选区通过原生图片附件提供，并保留来源定位与版本；只根据实际收到的图片说明该页或选区内容。当前原生 read 不支持 PDF page/rect 图像读取参数；只有定位文字、没有图片时，不得声称已查看原页。'];
+  if (['teacher', 'worker'].includes(role.kind)) lines.push('正文中的 read({path:"skill:名称"}) 改用原生 skill({name:"名称"}) 按需加载。');
+  if (['teacher', 'coordinator'].includes(role.kind)) lines.push('简短确认：工具列表提供 ask_user_question 时，学习目标、可用时间、范围或偏好等确需学生补充的信息，优先用原生提问，一次聚焦一件事。用户已说明的信息不重复问；数学练习、推导、费曼讲解等作答仍留在正文与课堂对话，不迁入确认框。原生问题和选项是纯文本，复杂公式先在正文说明。调用示例：ask_user_question({questions:[{id:"focus",question:"今天先学哪一部分？",options:[{label:"导数"},{label:"向量"}]}]})；自由回答省略 options，多选用 multi_select:true。默认等待真实回答，不替学生作选择；收到 answers 后按 selected/custom 继续，空答案、取消、pending 或错误都不等于同意或已掌握。若工具未提供，沿用当前对话询问；被父智能体持有的子会话不能调用原生提问，不得绕过边界或反复重试。');
+  if (role.kind === 'teacher') lines.push('数学图形与板书：遇到函数变化、几何位置、向量关系等适合用图建立理解的内容，主动使用现有 figure 图，而不只说“想象一张图”。使用前按需加载 skill({name:"notara-quest-tutor"}) 中的画图契约；它包含可运行的函数、几何和 Canvas 示例。图随当前教学步骤展开，复杂推导再落到白板；正式练习只呈现题目已有条件，额外辅助线或解题结构算提示。先核对定义域、关键点和约束；图像观察不是证明，展示也不代表学生掌握。');
+  if (role.kind === 'coordinator') lines.push('按需新建独立学习会话时，正文中的 classroom(start) 使用 subagent({preset:"notara-teacher",description:"会话标题",prompt:"知识概况、目标、已确认前置与材料引用"})，创建即返回；简单问题可直接在当前会话回答。要求学生独立尝试时，标题、首页开场语与首轮只呈现客观问题，不提前透露破题方向或关键值；交接注明学生可见内容与内部观察点。多项递进任务按学生节奏分步推进，不必机械限定回合数。沿用现有会话列表，不要求专门入口。worker-* 仍处理一次性材料任务，不传 run_in_background。专题不依赖首页在线，后续需要联系时用 send_message。是否回传、何时回传和内容由会话自己判断，不强制教学进度报告；不要代学生转交答案或把创建成功当成完课。');
+  if (role.kind === 'teacher') lines.push('正文中的 worker 改用 subagent 工具的 preset、description、prompt 参数。工作员使用 worker-problem / worker-review / worker-exercise / worker-general / worker-lesson；伙伴使用 companion-deepseek / companion-claude / companion-gemini / companion-gpt。严格盲测必须使用 companion-deepseek-blind，仅传 problem 和 studentExplanation，不传 prompt、参考、共同记忆或 Skill 正文。');
+  if (role.kind === 'teacher') lines.push('互动题的题干、步骤和选项也支持 KaTeX。数学表达式用 $...$ 或 $$...$$ 标记，与普通正文一致；不要把 (Qx)^T、x^T 等数学源码直接裸写在题干中。选择题与填空题直接用正文出题，学生在对话中作答；不生成 choice/blank 组件或 HTML 选择、填空控件。混合教学按学生目标和情况组合讲解、提问、示范、练习与反馈：学生要求先自己尝试时先给原题并等待，之后按实际缺口补前置；新概念按需讲清对象、条件与例子，独立练习不泄露关键方向和答案。学生卡住时可主动给一步提示或追问，学生要求完整讲解或仍无法继续时直接讲清。费曼总结和小测按需邀请，不强制作为课尾流程；只把学生实际表达的理解沉淀进 `## 学生理解`。');
+  if (role.kind === 'teacher') lines.push('上下文隔离实验：确需单独展开时，可用 subagent({preset:"notara-teacher",description:"讨论标题",prompt:"要讲的知识概况、目标、相关前置与材料"}) 创建原生可持续教学子会话。普通讲解和互动直接在当前课堂进行，不必每个知识点都派出去。没有教学块关系表或教学进度工具；需要时用 send_message 联系父会话或子会话，回不回传、何时回传、内容格式自行判断，不强制汇报。原生 subagent-settled 是本轮运行通知，不代表学生已经掌握或课程完成。');
+  if (['teacher', 'coordinator'].includes(role.kind)) lines.push('专题与子会话均复用原生可恢复会话，旧 continuable 历史仍可访问。普通伙伴可以持续接收学生作答；工作员和盲测按限定任务给出本轮结果。后台工作使用原生子会话通知，不是 job_* 任务。原生子会话会自动通知本轮结束，并可能要求向直接父会话发送结果；这只是运行机制，不强制教学进度报告，更不代表学生掌握。没有 classroom(complete) 或 notara.classroom-result.v1 事件。');
+  if (['teacher','coordinator','companion'].includes(role.kind)) lines.push('会话通信：source 为 agent-message 的来信由其他会话发出。决定回答时调用 send_message 给消息中标明的发送者，不能用当前窗口正文冒充已回信。告知类消息无需自动回复；发送失败不得声称已送达。正常学生输入仍在当前会话回答，备课答案和内部建议不要混入学生正文。');
+  if (['worker', 'companion'].includes(role.kind)) lines.push('当前角色不能再次委派，也不提供 write/edit；需要保存的内容作为草案交还主老师。');
+  return lines.join('\n');
+}
+
+export function apply(ctx, { preset }) {
+  const role = roleById(preset);
+  ctx.systemPrompt.section({
+    name: 'deployment:persona-prefix',
+    order: ctx.systemPrompt.getSectionOrder('DEPLOYMENT_PERSONA_PREFIX'),
+    text: role.prompt + runtimeContract(role),
+    interpolate: false,
+    complete: true,
+  });
+  if (role.kind === 'blind') {
+    ctx.systemPrompt.suppressRuntimeContext();
+    // rc.4 refreshes required contexts again at request admission. Override
+    // this provider in the blind scope so suppression also survives refresh.
+    ctx.systemPrompt.context({name:'working-directory:current',order:ctx.systemPrompt.getContextOrder('WORKING_DIRECTORY'),required:false,text:'',interpolate:false});
+  }
+  if (['teacher','coordinator'].includes(role.kind)) ctx.on('system-prompt/assemble',async(assembly,context,next)=>{
+    const result=await next(),service=ctx.get('notaraTopics');
+    const origin=service&&context.scope?.id?await service.origin(context.scope.id):null;
+    const receipt=await readReviewContext(ctx,context);
+    return {...result,contexts:[...result.contexts,...origin?[{name:'notara-conversation-origin',text:`本对话由会话 ${origin} 发起。若确有必要，可用 send_message(agent_id:"${origin}",message:"需要告知的内容") 联系它；无需每轮回传，也不要求固定的教学进度格式。`}]:[],...receipt?[receipt]:[]]};
+  });
+}