@khorsheed/dsh-canvas

灵感画布 —— 右栏里的写作工作台：右栏一个「画布」tab，普通右栏宽度自调（拖拽把手 + 一次性收会话列表建议）；画布自己带一排标签，一块画布一行；点卡是在这块画布里就地展开全文，顶上一行面包屑带你回卡板，不借宿主的 dock。一块画布 = 一个主题 = 部署级实体，上面积累灵感、问题、共识、来源、文档五种卡；模型的提议以幽灵卡落板，你 ✓/✗ 决定它的去留。

对话双入口（M2–M3）：当前会话——四个画布工具（canvas_propose_card / canvas_comment / canvas_read_manuscript / canvas_write_manuscript）注册到主会话 Agent，你直接让 Agent 改当前打开的画布、把成稿写到板上；引用进主输入框——选中卡后「与 Agent 对谈」/「开始写作」、Agent 评论旁「追问」，把卡片原文（引用块 + 「画布 · 分类 · 卡片 id」出处行）追加进当前会话的输入框，由你补一句再发（读-合并，不覆盖你已打的字；会话输入不可用时这些入口隐藏）。文本选区交互由引用插件（@khorsheed/dsh-quote）在应用级统一承接（引用到当前会话 / 引用到侧边对话 / 复制）。

v1 的工作区级灵感稿纸存储原样保留（编辑器已退役）——原文件仍在磁盘上，任何编辑器都能打开；v1 五个 Remote 动词在线上不动。

路线注记：M1–M2.5 曾走过 main 面板空间路线，已退役——宿主 RightbarRoot 只在会话面板渲染右栏，自定义 main 面板让一切右栏承接按构造失效；回到右栏是与宿主布局同构的答案。数据模型、Remote、板面/详情组件全部沿用（side-chat 集成后来在 2026-09-27 退役，见下）。

功能

右栏普通宽 + 收列表建议（M3.1 修正）：打开画布 tab 时每会话一次性建议收起左侧会话列表（DOM 门控，绝不盲 toggle、绝不反复强制）；右栏保持普通 track 模式——拖拽把手可用、宽度你自调、布局有记忆（曾建议 fullscreen，因宿主 fullscreen 隐藏拖拽把手而撤销）。唯一座位 = 右栏页型 tab（ctx.sidebarRightTabs + keyed sidebar.right.pane.tab），天然 session 作用域。
一排标签只放画布，行尾一个「画布 ▾」（0.4.6 立，0.4.8 方案 B 收成一块画布一行）：每行记着你在这块画布里站在哪——卡板、某张卡，或那份没存的草稿；切到别的画布再切回来，还在原来那张卡上。行尾的「画布 ▾」开切换器下拉（顶上「＋新画布」内联创建 → 活跃画布 → 已归档井）；卡板上方一行顶栏 = 画布名 + 卡数 + ＋新卡菜单 + 挂载工作区 chip + 卡板/连线切换。每块画布的筛选、勾选、卡板/连线视图、选中的连线和滚动位置各记各的：进一张卡再回来原样都在，换一块画布从干净的状态开始。一排最多 16 行，满了先挤掉最早那块画布（再点一次就回来），站在草稿上的那行最后才挤。不再有独立左列导航。
部署级存储：每块画布是 $DSH_HOME/state/canvas// 一个目录——canvas.json（元信息 + 全部卡 + 计数），纯文本，任何编辑器都能打开。卸载插件不会删除它。state 目录里遗留的旧 draft.md 已成孤儿：既不被读取，也不被删除。
五种内置内容卡（起点，不是上限）：灵感 / 问题（open → exploring → answered 生命周期）/ 共识（用户确认过的共同认识）/ 来源（带出处）/ 文档。五种卡都在详情里编辑：「＋新卡」开出一份草稿，单行时 ⏎ 直接建卡、换行后 ⌘⏎ 建卡（Shift+⏎ 始终换行），建好即回到它落的那块板；Esc 或面包屑的 ‹ 回到卡板（草稿有字或有笔画才弹一次确认）。
摘要与详情分工（M1.5）：板上卡片一律摘要——clamp ~6 行、底部渐隐，长文显示字数标；document 卡用启发式标题（首个 markdown 标题或首行），不再把原文从 # 糊上去。多选改由卡片右上角的悬停勾选框。
详情在画布里就地展开，不是宿主 dock 的标签（0.4.5 立，0.4.6 收回画布内部，0.4.8 从「一张卡一行」改成面包屑）：点卡片正文，这块画布那一行就站到这张卡上。顶上一行面包屑：‹ 回卡板 · 画布名 / 卡名（卡名取正文第一行，不是分类）· ‹n/m› 按卡板当前筛选下的顺序上一张/下一张 · ⋯。按钮平时是淡的、悬停才填底，用的是宿主的 ChevronLeft / Tooltip。分类挪到元信息行，是一枚宿主 Tag，点开宿主 Menu 就地改分类（草稿也一样）。下面是 kind 图标 + 状态 + 来源 + 时间、渲染 / 源码 / 并列三态（MarkdownText 全文渲染、v1 编辑器三件套源码编辑、宽度允许时并列）、评论线程（可读可发）、幽灵卡 ✓/✗、附件区（url 链接；文件附件一键调官方文档预览）。板面本身是只读的：想改字只能进详情（「＋新卡」的草稿也一样）。行上的 × 和面包屑的 ‹ 都是这个包自己画的，所以离开一份有字的草稿会先问一次——0.4.5 记的那个「唯一的缺口」（宿主只按 tab id 关闭、不给拦截，草稿被静默丢掉）随 dock 路线一起没了。
详情里粘贴 md / html / 表格 / 图片：全插件只有这里读剪贴板，落法对着「这次粘贴会产出的那张整卡」回答（卡片格式是渲染器从整张卡嗅出来的，从不看标志位）。六条臂——整页 HTML / 表格 / 富文本转 markdown（保格式：只有转换后的文字与剪贴板纯文本逐字对齐才采用，丢字宁可不转）/ 只有标记 / 整页网页进已有正文的卡时落纯文字（说明理由）/ 交回浏览器原生粘贴；贴上来的图片像素进宿主附件库，卡里只留一行指针（markdown 卡收 ![](https://github.com/Khorsheed/dsh-plugins/blob/548eeabe331c121621b2d08deab4278ad81d6312/)，HTML 卡收 `

`），两条渲染臂都把指针换回真图。

详情自由绘画：详情有一支笔——铅笔在 3:2 的字段上画，橡皮一次擦一整笔（会被擦掉的那一笔在指针下先亮起），同一排还有「撤一笔」和「清空」；Esc 第一下收笔（笔在的时候页面归笔管），再按一下才是回卡板，⌘⏎ 保存草稿。收笔之后字段留在原地变成只读图形，带「点一下接着画」——画的内容是卡的一部分，不该在停笔时消失。画存的是点列（600×400 逻辑框的单位，不是屏幕像素），轮廓每次渲染现算，所以在窄栏里画的位置和宽面板上看到的位置是同一个；一笔落定即写盘（新卡则进草稿），没有「未保存的画」这个状态。板面缩略图显示它，模型的 `` 段带着它的坐标。
HTML 卡渲染（0.4.3）：内容格式与卡种解耦——detectCardFormat 保守启发式判定（宁可漏判不可误判：md 里内联 html 仍是 markdown）；HTML 卡在详情里以严格断网沙箱 iframe 渲染（复用 inline-html-render 的 srcdoc/bridge，源码面打进 bundle、零运行时耦合），板面上显示紧凑占位（`` 提取的标题或「HTML 文档」+ 字数），绝不再把标记原文当纯文本糊上去。卡正文上限 256KB（整板读写仍毫秒级；更大的落 assets/ 是 M4 项）。模型边界：HTML 卡内容不进模型上下文全文——Agent 只看到标题/指针（需要内容时会请你粘贴节选），长 markdown 卡带 4000 字上限与截断注记。
与 Agent 对谈（2026-09-27 改版，取代 M2 的 side-chat 透镜条）：选中卡后底栏只剩「与 Agent 对谈」「开始写作」两个动作——都是把所选卡按板面顺序引成 Markdown 引用块写进主会话输入框（开始写作多带一句写作指令），不自动发送；卡片详情页顶栏同样两个按钮；Agent 评论旁「追问」引用那条评论并注明它挂在哪张卡。HTML 卡只引标题与长度、长卡截到 1200 字并注明全长、评论只带最新 8 条。文本选区交给引用插件统一处理。会话输入不可用时这些入口全部隐藏，板面完整可用。
卡片减负（同一轮）：☐ 选择框和 ⋯ 只在悬停/聚焦时出现（触屏常显）；没有评论的卡不再显示空的 💬；卡上的铅笔去掉（点卡片进详情就是编辑）；数量为 0 的分类 chip 变淡。
主会话工具（M3）：canvas_propose_card（提议卡，proposed 待你 ✓/✗）与 canvas_comment（评论挂卡，指出假设/张力并以追问收尾）注册进主会话 Agent——打开的画布就是目标（tab 切换即上报 focus）；没打开任何画布时工具如实说明而不是乱改。
幽灵提议卡：proposed 状态的卡以虚线幽灵态内联在板上，「收下」转为正式卡、「拒绝」归档（不做删除）；接受率计入 stats，供后续自调整规则使用。
筛选、多选、归档：按 kind 的筛选 chips（这块画布当前启用的分类）；勾选框多选，选择条上可批量归档、批量「改分类」；已归档的卡进「归档井」，随时恢复。
分类是每块画布自己的（0.4.5）：五种内置卡是起点，不是上限。板上右上角「管理分类」开这块画布的面板：改名、加一个（新分类 id 是 cat_…）、停用。卡上存的是分类 id，不是名字——所以改名不动任何一张卡。停用 = 这个分类退出筛选条 + 拒绝新卡，已经挂在它下面的卡一张都不消失；停用一个还有卡在用的分类会弹一次确认，确认就把那几张一起进归档（正文保留、随时恢复）。想把卡留在板上，用勾选批量选中后的「改分类」——面板里刻意没有「挑个去处」的选择器。整套目录写在这块画布的 canvas.json → categories，旧文件没有这个字段，读的时候按默认五种补齐（零迁移）。对模型：canvas_propose_card 的 kind enum 就是这块画布的启用分类；没改过名的内置分类在提示词里仍是裸 id（fragment），改过名或自定义的写作 id（名称）。
卡板与连线，一块画布的两张面（0.4.5，阶段 ⑥）：顶栏右侧一个「卡板 / 连线」切换——卡板是改一张卡的地方，连线是把卡连成一组的地方，切的是同一块板。连线面把每张卡画成一个节点（有画的带着笔迹），拖它就是改它的位置；从节点右缘的圆点拉一条线落到另一个节点，两张卡就连上了（线没有方向，{a,b} 与 {b,a} 是同一条）；「新分区」拖出一个带标题的框，卡的心落进框里就属于这个框——归属是几何算出来的，不是存的字段，所以拖分区会带着里面的卡一起走，把框缩到卡心露出去，那张卡就自动离开框。点节点只选中、不编辑（要编辑点那支笔，或在卡板上点进去）；框选一片是一次追加选中，八像素以内的抖动算点击、只把手上的线取消掉。底栏跟着给出「顺线扩一圈」（沿线取闭包，再补一跳同分区的卡；默认关，且从不落盘）、「与 Agent 对谈」、「开始写作」、「删掉这条线」、「取消选择」。位置、线、分区都写进这块画布的 canvas.json（cards[].x/y 成对出现、links[]、lanes[]），一个 setLayout 动词一次落一盘并带版本守卫；旧文件三个字段都没有，读的时候按「没摆过」补齐，零迁移。
成稿，一块画布的第三张面（2026-09-27）：卡是素材，成稿是这些素材要写成的那篇东西，所以它不是一张卡，是画布上的独立实体——标题、状态（写作中 / 定稿）、版本号、谁最后写的、用了哪些卡、看过但没用哪些卡；正文单独存成一个 .md。顶栏切换多了「成稿 n」，列出这块画布的成稿（最近动过的在前），点开是一页阅读栏：正文、元信息、底部的素材账（用到的卡 / 没用上的卡，点一下进那张卡；卡删了就划掉）。写作走主会话：「让 Agent 改」把成稿的 id 和当前版本号引进输入框，Agent 用 canvas_read_manuscript 读全文、canvas_write_manuscript 写回（改写时 baseVersion 必填）；自己改点「编辑」，源码和实时预览并排，⌘⏎ 保存，能直接粘贴图片。每次保存都带着它起步的版本号：中间有人（包括 Agent）写过，存储拒绝这次保存，页面亮出黄条，两条路都给——「载入最新」丢掉自己的改动，「用我的覆盖」按对方的版本号再存一次；从不替你选。⋯ 里是「复制 Markdown」、「保存到「工作区」」（每个挂载的工作区一项）、重命名、标记定稿 / 重新打开、删除（确认后真删，正文目录一起删掉）。文档卡的 ⋯ 里有「转为成稿」：卡原样留作素材，成稿从它的正文起步、把它记为第一张用到的卡（HTML 卡不能转）。
保存到工作区：写成 /.md，图片落在旁边的 .assets/（文件名取摘要前 16 位，同一张图只写一次），正文里的 attachment:// 指针改写成相对链接。记住这次存到哪（路径 + 文件版本），下次「再次保存」写回同一个文件；那个文件在外面被改过就停下来问（changed），第一次保存撞上一个不是画布写的同名文件也问（exists），确认才覆盖，覆盖本身仍按刚看到的文件版本加守卫。只能存进这块画布挂载的工作区，只读模式的会话拒绝。
评论挂卡上：角标展开线程，评论即数据（Agent 的评论会把 open 问题卡自动推进到 exploring）。
编辑器三件套沿用 v1：非受控 textarea（光标不跳）、输入法组合期间硬停（候选窗绝不被打断）、单滚动容器。
暗色自动跟随：所有颜色都走官方 --dsw-* 主题 token，kind 只靠图标 + 文字区分，不用彩色。

v1 灵感稿纸（存储保留，编辑器已退役）

一个灵感 = 一个文件。正本在 /灵感画布/ 下，文章/ 与 卡片/ 两个子目录分别是两种形态，文件名就是标题。没有数据库、没有私有格式。
M1.5 起右栏 tab 不再是稿纸编辑器（现为画布工作台）：原文件仍在磁盘上，任何编辑器都能打开；v1 的五个 Remote 动词（list / read / create / write / setArchived）在线上不动。
稿纸只归档：归档只从列表里隐藏，文件一个字节都不动；已归档区可随时恢复。画布另有真删除，见下方「已知限制」。

安装

dsh plugin --profile web add @khorsheed/dsh-canvas
# 卸载：
dsh plugin --profile web remove @khorsheed/dsh-canvas

装完重启宿主。卸载不会删除 $DSH_HOME/state/canvas/ 或任何 灵感画布/ 目录——你的稿子和画布是你的。

按 preset 收敛会话工具（0.4.2+）

四个画布工具（canvas_propose_card / canvas_comment / canvas_read_manuscript / canvas_write_manuscript）与它们的英文提示词引导段注册在独立的 composition 入口 ./agent 里，不再钉死在 profile 根。出厂的 cordis.patch.yml 把它作为第二行默认挂载——所有 preset 的所有会话都有工具（与 0.4.1 及以前一致）。想只给某个模式（如 dsh-writing）授予时：

# 
/cordis.patch.yml：关掉根级行
- id: canvas-agent
  disabled: true

# ~/.dsh-official/.agent-presets/dsh-writing/agent.cordis.yml：在该 preset 内授予
- id: canvas-agent
  name: "@khorsheed/dsh-canvas/agent"

两者绝不能同时生效（同名工具会注册两次——local-agent 家族的既定模式）。未授予 preset 的会话：系统提示词完全不含画布引导，工具目录也没有 canvas_*。入口缺席 canvasBoard 时（比如核心行没装）只 warn 不注册，绝不炸组合。

Compatibility

npm 发布线（@deepseek-ai/dsh@0.1.5-rc.1）：✅ 完整——右栏页型 tab（ctx.sidebarRightTabs + keyed sidebar.right.pane.tab）自 0.1.5 起存在，minHost 随之抬到 0.1.5-rc.1；旧宿主没有右栏面，请停留在旧发布线。
源码线（deepseek-harness master）：✅（verifiedHost: 0.1.5-rc.1）
web 面插件：headless profile 没有浏览器消费者，本插件在那里不贡献任何东西。
主会话画布工具注册在独立 composition 入口 ./agent（出厂 patch 根级默认全会话可见，可按 preset 收敛——见上节；origin tag 自带）；目标画布按会话 focus 解析（右栏 tab 当前打开的画布），无打开画布时工具返回明确说明文本。画布不依赖任何其他社区插件（2026-09-27 起不再探测 side-chat，manifest 也不再登记 dsh.references）。
v1 写入按「发起这次点击的会话」围栏。三个写接口（新建/保存/归档）都先取调用会话的沙箱策略再写：围栏挂在会话自己的工作区上，不是宿主的进程目录。所以会话是只读模式时，画布会明确拒绝写入（这个位置不可写），而不是悄悄写进去。
v2 板写入围栏重定界到 state 目录。画布是部署级状态，任何会话的工作区都装不下它：写入沿用挂载的 ctx.fs（版本守卫、原子写、观测轨迹），会话解析出模式与 session id（只读部署照样拒绝），但可写边界重定界为插件自己的 $DSH_HOME/state/canvas——一个正好围住 state 目录的 workspace-write 围栏，绝不用裸 node:fs 绕。DSH_HOME 未设置时 state 根退回 process.cwd()（datasets 先例）。画布工具的写入走同一条围栏（优先执行 Agent 自己的会话）。
粘贴图片走宿主附件库：探测 ctx.get('attachments')（@deepseek-ai/dsh-attachment，peer 声明为 optional）。像素进宿主的内容寻址库，卡里只留一行 attachment://… 指针（五个字段都是宿主读回时要比对的）；没挂附件库的部署里图片入口自己降级——贴一次说一次「这个部署没有装图片存储」，文字粘贴照常。渲染侧只认这一个 scheme：卡片里手写的本地路径永远不会变成一次文件请求（风险 ⑬）。
绘画不向宿主伸手：笔画以点列存在卡里（600×400 逻辑框的单位），轮廓库 perfect-freehand（MIT、0 依赖）随 tsdown 一起打进 lib/client.js——没有额外安装、不落文件、不进附件库。

Known Limitations

画布能删，稿纸不能。画布与卡片都有「删除」（⋯ 菜单里，确认一次，不可撤销）；归档仍是可撤销的那条路。官方 ctx.fs 没有删除接口（13 个抽象方法里没有 remove/rename），所以删画布是插件对自己的状态目录（$DSH_HOME/state/canvas//）直接 rm -r：只读模式照样拒绝，删完再经 ctx.fs 读一遍确认真的没了——状态目录在 node 够不着的远端挂载上时会如实报失败，不假装成功。删卡片只是一次普通的 canvas.json 写入（连同指向它的连线）。删除只给人，不给 Agent：没有对应的工具。稿纸文件在工作区里，插件不替你删，请在文件管理器里删。
贴进来的图片字节不会被回收。像素落在宿主的内容寻址库里，归档或删除画布、删除卡片都不碰它——删掉的只是卡里的指针，像素会一直留在宿主的附件目录，要彻底清掉得在宿主侧动手（宿主附件库没有删除接口）。指针读不回对象时降级成 alt 文本：不报错，也不留破图。
只有贴进去的图会显示。渲染侧只认 attachment:// 一种 scheme，./pic.png 这类自己写上去的路径永远停在 alt 文本（这条白名单就是风险 ⑬ 的设计）。想让图进卡片，就用粘贴。
一张图的像素只过一次 Remote。缓存未命中时字节以 base64 走一趟，之后 24 条以内不再重复读，第 25 条进来时最久没用到的那条出去。所以长文多图的首屏是「文字先到、图一张张亮起」，不是同时出现。
画的上限是 60 笔、单笔 120 点。到了线会说一声，不会静默截断（撤一笔或擦一笔就腾出空间）。存点列、轮廓每次渲染现算，所以线条规则以后改了老画自动跟上——代价是每次重绘多一次计算。
笔画粗细靠移动速度，不靠压感。鼠标本来没有压力可读（走得快就细、走得慢就粗）；触屏与手写笔的真实压力暂未接线。
模型读到的是坐标，不是像素。绘画以点列随 prompt 的 `` 段交出去：Agent 能推理几何，但看不见「一张图」。让它参考画面生成多模态内容还需要一条导出位图的路（未做）。
外部编辑器的改动收不到通知。官方 workspaceFiles.changes 只报被插桩的文件系统操作，不观察操作系统；在别的软件里改了 canvas.json，插件只能靠保存时的版本守卫发现冲突；本页不轮询。
列表顺序存在 .index.json 里，不按修改时间。ctx.fs 不上报 mtime，所以顺序由索引维护（新建的排在最前），未在索引里的文件按文件名排在后面。
跨工作区只能读、不能写。模型的 read 不受工作区限制，所以你能把 A 工作区的稿子引用到 B 工作区的会话里；但会话 B 的沙箱以 B 为界，模型改不回 A 的文件。
中文目录名：git status 里会因 core.quotepath 显示成八进制转义（功能正常，观感吓人）。宿主侧一律走 ctx.fs 拿绝对路径，不 shell 出去，所以中文与空格都不成问题。
HTML 表格的合并单元格降级为「文本 + 空格子」，不重建跨行列。
连线存的是空间，不是屏幕。坐标是布局单位（一帧 600×400），但故意不夹进这一帧：连线面能平移，一张卡摆在 x: 900 是合法的；存屏幕像素的话，面板换个宽度每张卡都会跑错位置。代价是卡可以被拖到你当下看不见的地方——那里没有「回到第一张卡」的按钮。
线没有方向、没有标签、没有样式。{from,to} 就是一个无序对，板面上双向读；要给线加箭头或名字是后面阶段的问题，现在也不替你猜。
两个分区重叠时，卡的归属取先到的那个（列表顺序），不取「更贴合」的那个。重叠是这块板要自己收的口子，不是几何层要猜的题。
「顺线扩一圈」是临时的：它只改这一次要发出去哪几张，默认关，永不落盘——线画在板上是内容，扩圈是手势。
仍不做（后续里程碑）：stats 自适应规则、web 搜索接线（M3 后段）；assets/ 大文件落盘、html 卡的源码编辑高亮、会话侧检索工具（M4）。也没有画布标题改名。长文那一档已于 2026-09-22 整体删除：它从来没有模型侧工具（canvas_propose_draft 与候选 diff 接受流只存在于提案里，exportDraftToWorkspace 从未实现），那份稿关在 state 目录里出不去。2026-09-27 的成稿把这一档接了回来，但换了形状：有模型侧工具、有版本冲突检测、能存进工作区。
保存到工作区的图片从宿主附件库读出、按字节写盘；宿主 ctx.fs 只有文本写入，二进制是本包在 ctx.fs.resolve/contains 围栏之内自己写的（上游缺口，见 Agent Note）。附件库不在或某张图读不出来时，那张图的指针原样留在正文里，保存结果报有几张图没带上。
Agent 改板的可见性靠标签页可见时每 4 秒一次的轻量刷新（共享 rev touch()，版本没变就保留原对象、不重绘）；标签页隐藏时不轮询，回来时下一拍补上。
收列表是一次性建议：tab 首次可见时每会话建议一次收起会话列表（toggleSidebar()，DOM 探测 gated），此后布局由你接管；fullscreen 不作建议（宿主 fullscreen 隐藏右栏拖拽把手，per-tab presentation seam 是上游候选）。

工作原理

内部结构（点击展开）

磁盘布局（v2）

$DSH_HOME/state/canvas//
  canvas.json      # { id, title, attachedWorkspaces, chat, cards[], categories[], links[], lanes[], manuscripts[], stats, archivedAt, … }
  manuscripts//   # 每篇成稿一个目录，正文一个 .md（元信息在 canvas.json 的 manuscripts[] 里）

cards[] 每张卡：{ id, kind, text, source?, status: proposed|kept|archived, question?, comments[], draw?, x?, y?, createdBy, createdAt, updatedAt }。draw 是 [{ pts: [{x,y,w}], color }]——逻辑框（600×400）单位下的点列。x/y 成对出现或一对都没有（只有坐标没有尺寸：尺寸归渲染，不归存储）。links[] 是 { from, to }，lanes[] 是 { id, label, x, y, w, h }。stats 记提议接受/拒绝计数、各 kind 可见卡计数、最后活跃时间（列表排序与后续自调整规则的数据源）。文件损坏或 id 对不上目录时：列表跳过、读写报错，绝不重写一个读不懂的文件。

板服务：CanvasBoardService（ctx.canvasBoard）整板版本围栏读写——读取 → 应用纯函数修改 → replaceIfVersion 写回；版本冲突重读重放一次再报 stale（两个浏览器标签页同时操作不丢卡）。写入围栏见 Compatibility 的「重定界」条。

Remote：namespace canvas 在 v1 五动词（list / read / create / write / setArchived）之外的空间动词：listCanvases / createCanvas / readBoard / putCard / patchCard / addComment / archiveCanvas / deleteCanvas / deleteCard / setCategories / setLayout / focusCanvas，成稿五条 readManuscript / writeManuscript / patchManuscript / deleteManuscript / exportManuscript（写入带 baseVersion，版本对不上回 stale + currentVersion），加上图片那两条不带会话的 attachImage / imageBytes。变更类全部 agent 优先（调用会话供电围栏），读取类不带 agent——v1 的线上约定原样延续。setLayout 是连线面唯一的写动词：一次拖动可能同时动一张分区和它里面五张卡，逐张 patchCard 会各自撞自己的版本守卫，所以位置/分区/线三样合在一个动词里一盘落定。「没带这个字段」和「带了一个空数组」是两件事：省略 = 这一盘不动，[] = 清空。

右栏只有一个 tab 类型（M3 注册一次；0.4.5 一度注册两次，0.4.6 把第二次收回来了）：ctx.sidebarRightTabs.register 一次，body 挂在 keyed sidebar.right.pane.tab 上，注册级开关一处管显隐。canvas 是页面类型（不认领地址，按 kind 打开），而 tab/CanvasTab.tsx 现在是一台路由器：tab/TabStrip.tsx 是那一排标签（一块画布一行），下面的正文看「显示中那一行站在哪」——卡板 = 顶栏 + space/BoardView.tsx（或 space/LinkView.tsx），卡 / 草稿 = 面包屑（detail/DetailCrumbs.tsx）+ detail/CanvasDetailView.tsx，并且按卡带 key（一个不受控 textarea 的值不能从你刚看的那张卡带进这张卡，上一张/下一张也一样）。每块画布的视图记忆（筛选、勾选、视图、选中的线）和各滚动容器的偏移由 CanvasTab 按画布 id 记在内存里，不进 sessionStorage。切换器（tab/CanvasSwitcher.tsx）挂在标签条行尾，只负责往这排里加行（新建 / 挑一块已有的 / 归档）。

共享 store（space/selection.ts）持 { tabs, active, rev }，每行是 { id: b:, canvasId, at }，at 是卡板 / 某张卡（带 heading）/ 草稿（带分类）三选一；canvasId 从「显示中那一行」推出来，主会话工具因此总指向你正看着的那块画布。一块画布一行、一行一个 at，所以一块画布只有一份草稿——「＋新卡」再点一次换的是它的分类，不是又开一张空白。这一排活过刷新：行写进 sessionStorage，读回来时逐行验形状，认不出的整条丢掉（外面塞进来的 payload 一个字都不认）；草稿的字从不进 stash，所以刷新后站在草稿上的行回到卡板；0.4.6/0.4.7 留下的「卡行 / 草稿行」stash 折成一块画布一行、站在卡板上。宿主 dock 上那张芯片的活标题走 sidebar.right.pane.tab.title 那个 inject 槽（tab/CanvasTabTitle.tsx）——宿主只在打开时捕获一次 title、之后从不刷新，所以标题只能自己读 store：站在卡板上读注册表给的名字，站在卡或草稿上读 at 带的 heading。tab 打开/切换即 focusCanvas 上报宿主（主会话工具的目标）；收列表建议（DOM 探测 data-sidebar-collapsed 后 toggleSidebar()）每会话一次（fullscreen 建议已随 M3.1 撤销：宿主 fullscreen 隐藏右栏拖拽把手）。任一侧的变更动词在 apply 层包装里统一 touch() 推 rev，读者重读跟随；板面每次重读也把自己的 summarizeBoard 折回列表，所以别的标签（或 Agent 工具）写进去的卡数不会在切换器里过期。

连线面的两层切分（0.4.5，阶段 ⑥）：space/layout-geometry.ts 是纯函数层——无 DOM、无 store，每个盒子进来都是四个数，所以同一批问题（谁在这个分区里、这条线该怎么弯、框选抓到了谁、分区能被拖到哪）能在 node 测试里回答；space/LinkView.tsx 只剩手势与渲染。每个手势各挂各的 window 指针监听，落点从松开那一刻的事件重新算一遍，不读记忆里的那一刻——所以拖拽中途的旧帧不可能被提交，也不需要一条靠依赖数组撑着的 useEffect。三个决定管住所有形状：分区归属看卡心不看面积（贴边压线的卡不会被两像素的缩放甩出去）；线的控制点沿主轴推、推力带符号（这对卡不管朝哪个方向存，线尾都从邻居那一侧出去，也不会自己打结）；两个维度都不到 8px 的抖动是点击，不是框选。为什么手写而不是 @xyflow/react：客户端 bundle 只允许内联 .module.css（build/tsdown.client.ts 用 lightningcss 把类名编译成哈希再注入），一个第三方全局样式表没有干净的挂载位；加上解包 1.2 MB、主题要整张重上色、原型本来就是手写的。

对谈（2026-09-27 起）：纯客户端，不经 Remote。src/client/quote.ts 把卡片渲染成 Markdown 引用块（原文 + 「画布 · 分类 · 卡片 id」出处行；HTML 卡只给指针，长卡截断并注明全长，评论取最新 8 条），客户端按结构取宿主会话的 conversation.input，先读现有草稿再 setDraft 合并写入（不覆盖用户已打的字）。拿不到输入框时入口隐藏。Agent 改板靠标签页可见时每 4 秒一次的 touch() 共享 rev 浮现，版本不变时保留原对象不重绘。M2 的 side-chat 路径（askAgent / chatStatus 动词、prompt.ts 系统提示段、透镜模板、按 openWith 构建的上下文工具）已整体删除，主会话的两个 canvas_* 工具不受影响。

主会话工具（M3；0.4.2 起经 ./agent 入口）：tools.ts 的 canvasMainSessionToolDefinitions 由 src/agent.ts 的 composition 入口经 ctx.inject(['tools']) 注册（deferred，datasets-tool 先例；出厂 patch 挂在根级、可挪进 preset 的 agent.cordis.yml），附英文 canvas:tools 系统提示段；目标画布 = ctx.canvasBoard.focusedCanvasId(session)（tab 经 focusCanvas 上报），无 focus 返回「没有打开的画布」说明文本。origin tag 同免导入路径。右栏 tab 类型按「当前会话能否触达画布工具」做注册级自隐（双查判据：profile 根挂的 enabled @khorsheed/dsh-canvas/agent 行 = 全会话可见；否则当前会话 preset 组合含该行才可见——preset 挂载形态如 3080 的 dsh-writing 配方；一切读不到的路径 fail-open）。2026-09-16 事故的教训不在「入口按 preset 自隐」而在「判据只查 preset 组」：根挂形态下组合里没有任何行可 keyed，单查即永隐。

v1 磁盘布局

/灵感画布/
  文章/第一章 雨夜.md
  卡片/雨伞的意象.md
  .index.json          # { order: [...], archivedIds: [...] }

.index.json 的形状照官方 workspace registry：order 是显示顺序，archivedIds 是归档集——和官方用 workspaceIds + archivedSessionIds 表达「顺序 + 归档」是同一套。索引缺失或损坏时降级为按文件名排序、无归档项，绝不因此打不开画布。

v1 宿主半边：`CanvasS

安装

说明文档