dsh-quote-to-agent
DSH Web 客户端插件：选中 AI 回复中的一句或多句，引用到当前对话（输入框最左侧正上方的引用条），或分派到子智能体对话（右侧面板打开，没有子智能体时自动派生）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gongstudent/dsh-quote-to-agent#46aff62017a48a640c2c3cdba974d0900e5951d3Quote To Agent 以 dsh-quote-to-agent 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DSH Web 客户端插件：在会话记录里划词，把选中的内容引用到当前对话，或分派到子智能体对话。
dsh.client，platform: "web"），host 半边为空| 场景 | 行为 |
|---|---|
| 主对话里划词 | 两个动作：引用到当前对话 / 引用到子对话 |
| 子智能体里划词 | 三个动作：引用到主对话 / 引用到当前对话 / 引用到另一个子对话 |
| 引用到当前对话 | 落到输入框最左侧正上方的横向引用条：点开看被引用的原文、逐条 × 删除；发送时自动拼进消息 |
| 引用到子对话 | 右侧新开一格打开该子智能体会话（与主对话同屏、分隔条可拖），并把引用放到它的引用条上 |
| 目标没有子智能体 | 挂起这条引用，把「派生一个子智能体…」写进输入框；新子会话一出现就自动接续 |
有多个子智能体时弹候选列表；只有一个时直接打开。
package.json 插件清单（dsh.bundle.patch + dsh.client）
cordis.patch.yml 一行 insert，把插件本体插进组合树
lib/index.js host 半边（空 apply，只为让 Loader 扫到 entry）
lib/client.js 浏览器半边（全部逻辑）
scripts/check.mjs 门禁：i18n key 集合 / t() 引用完整性 / CSS var() 兜底 / jsx 元数
scripts/smoke.mjs 冒烟：bundle 信封、导出、加载期、槽位接线、渲染回归、目标解析
scripts/audit.mjs 自审：包契约、兼容门槛、非官方依赖面、全局副作用
scripts/mutate-check.mjs 变异测试：验证冒烟测试的回归断言真能抓住对应 bug
scripts/inspect-profile.cjs 只读检查 profile 组合树
全局 dsh CLI 管不了 desktop profile，要用 Desktop 自带的 CLI：
$env:ELECTRON_RUN_AS_NODE='1'
& "<安装目录>\DeepSeek Harness.exe" --expose-internals `
"<安装目录>\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js" `
plugin --profile desktop add "<本仓库目录>"
装完必须重启 Desktop 应用（静态客户端插件在服务启动时加载），然后 Ctrl+Shift+R 强刷页面。
卸载：
# 同上，把 add 换成 remove
... plugin --profile desktop remove dsh-quote-to-agent
node scripts/check.mjs # 门禁
node scripts/smoke.mjs # 冒烟
node scripts/audit.mjs # 自审
smoke.mjs 在 node 里用桩 window / react 跑一遍客户端 bundle，断言 apply(fakeCtx)
把两个挂载面注册到预期槽位与选项上，并渲染一遍真实元素树 ——
不需要浏览器、不需要重启。
scripts/inspect-profile.cjs 是只读的 profile 组合树检查（用应用自己的 boot loader）：
$env:ELECTRON_RUN_AS_NODE='1'
& "<安装目录>\DeepSeek Harness.exe" scripts/inspect-profile.cjs `
--asar "<安装目录>\resources\app.asar" --profile desktop
已完成：
slots；动作条另等 sessions / sidebarRight / conversation）null）subagentchat tab，preferNewPane 与主对话同屏）node scripts/audit.mjs）包契约 7 项全过：type: module、main、exports 的 . 与 ./client、
dsh.bundle.patch、dsh.client.platform: "web"、dsh.client.inject、不声明 peerDependencies。
兼容门槛永不触发 —— evaluatePluginCompatibility（dsh-app-boot）：
if (!Object.hasOwn(fields, "peerDependencies")) return undefined // ← 直接放行
if (name !== "@deepseek-ai/dsh" && !name.startsWith("@deepseek-ai/dsh-")) continue
不声明 peerDependencies 就永远不会被版本门槛拒绝；即便声明，@deepseek-ai/cordis
也不在检查范围内。dsh.client.inject: [] 也正确 —— 只 require 平台种子表里的
react / react/jsx-runtime。
| 依赖面 | 具体 | 失效后果 | 失败是否可见 |
|---|---|---|---|
| DOM 锚点 | [data-conversation-scroll] -content -session、[data-composer-seat] -card、[data-chat-flow-key] -kind | 划词检测 / 发送注入失效 | ❌ 静默 |
| CSS Module 选择器 | button[class*="_primary"] | 点按钮发送不带引用 | ❌ 静默（回车仍可用） |
| 槽位 key | conversation.input.dock、shell.overlay | 引用条 / 动作条不出现 | ❌ 静默 |
| 资源地址 | dsh-resource://subagentchat/session/ | 右侧打不开子会话 | ✅ 可见（throw） |
| 宿主行为 | mode 校验、dsh-session: 解析 | 历史加载失败 / 整轮失败 | ✅ 可见 |
缓解：所有非官方锚点集中在文件顶部常量区（ANCHOR_*）与 readSelection() 一个函数里；
不依赖任何 slash/* 事件（0 处）；不声明 peerDependencies。
升级后自检清单（四步，全部是静默失败面）：
| 检查项 | 结果 |
|---|---|
| 全局变量赋值 | 0 |
原生定时器（setTimeout/setInterval） | 0 |
| 全局监听器 | 7 个，全部 capture，但 0 处 preventDefault / stopPropagation —— 只观察不拦截 |
preventDefault | 仅 2 处，都挂在插件自己的按钮上（onMouseDown） |
依赖的官方 slash/* 事件 | 0 |
| 槽位 id / locale 命名空间 | 全部私有前缀（quote-to-agent-* / dsh-quote-to-agent） |
| 渲染期异常 | 每个挂载面独立 ErrorBoundary，失败渲染 null |
| 草稿写入 | 只用官方路径（inputActions.setDraft / ctx.conversation.input.for().setDraft），不碰 DOM 状态 |
唯一的两处"侵入"（都是功能本身）：
① 发送时把引用拼进草稿；② 给被引用原文里的 dsh-session: 插零宽字符（只动我拼进去的那段）。
内存：两个模块级 Map。quoteStore 的监听器正确清理、spawnStore 有 5 分钟 TTL；
quoteStore.bySession 的键在插件生命周期内不删除（按会话数增长，有界，可接受）。
dsh-quote-to-agent —— 前缀 dsh-quote-* 与生态一致
（dsh-quote-reply / -annotate / -selection / -followup），
to-agent 点明了本插件相对同类插件唯一的差异：把引用分派到子智能体对话，
并在没有子智能体时自动派生一个。
（v1.17 之前叫 dsh-quote-dispatch。改名同步了 package.json 的 name、cordis.patch.yml
的 name 与 id、客户端 bundle 的 loader id、locale 命名空间、槽位 id 前缀与文档。）
v1.18（修「首次引用到子对话，引用不跟着发出去」）
primaryButtonDisabled()
用的是 document.querySelector —— 只拿到第一个（主对话那个）。主对话草稿为空时
它的发送按钮是禁用的，于是子会话的发送被误判成"禁用"而跳过注入。
第二次之所以能带上，是因为那时主对话的状态变了。conversationRootOf(sessionId)（遍历 [data-conversation-content][data-conversation-session]
逐个比对属性，避免拼选择器）+ belongsToSession(element, sessionId)；
primaryButtonDisabled(sessionId) 与 keydown / click 两条手势都过一遍该判定。scripts/mutate-check.mjs（list / apply <case> / restore）。v1.17（改名 + 收尾）
dsh-quote-dispatch → dsh-quote-to-agent（仓库名一致）。
同步了 package.json、cordis.patch.yml、客户端 bundle 的 loader id、locale 命名空间、
两个槽位 id（quote-to-agent-cards / quote-to-agent-actions）。inspect-profile.cjs 改为
--asar / --profile / DSH_HOME 参数化；audit.mjs 不再依赖本机抽出的参考源码；
文档里的个人路径改为 <安装目录> / %APPDATA% 这类通用写法。package.json 的 scripts（check / smoke / audit）。v1.16（拿到可继续的子会话，而不是一次性记录）
改：A′ 的派生指令改成明确要求后台模式： 「请派生一个子智能体来处理下面这段引用，用后台模式运行（不要等它出结果） —— 这样它是一个可以继续对话的子会话」。
为什么：subagent 工具有三条执行路线，产物完全不同 ——
| 路线 | 产物 |
|---|---|
run_in_background: false（前台、等结果） | one-shot 子会话（只读记录） |
run_in_background: true | continuable 子会话（可继续对话）✅ |
本机 base 配置里 backgroundMode: continuable，所以后台 = 可继续。
真机症状是右侧显示「一次性子智能体记录 / 一次性任务不支持后续消息」——
根因是模型选了前台模式（它想拿到结果）。
备选路子：让模型创建 teammate（spawn_teammate）也一定是 continuable，
但它会进团队 roster、语义更重，且官方策略要求"仅在用户明确要求时才创建 teammate"。
所以默认走后台 subagent 这条更轻的路。
v1.15（修 subagent/unauthorized）
mode 写死成 'continuable'，而模型用 subagent 工具派生的
多半是 one-shot → host 校验不符 → subagent/unauthorized。
host 的规则是：address.mode !== "unknown" && identity.mode !== address.mode 才抛错 ——
也就是 'unknown' 永远被接受。childModeOf）；查不到就退到 'unknown'；
member.mode 缺省也用 'unknown'。mode === 'one-shot' 的子会话是只读执行记录，不投放引用，只记一条 warn。v1.14（修「点了没反应」）
stageSpawnForSubagent 里用了 ctx.locale.bind(NS)，但 actions 所在的 scope 是
ctx.inject(['sessions','sidebarRight','uiWorkspace','conversation']) 派生的，
不保证带 locale 面 —— 取不到就抛异常。现在文案 t 由组件传入。stageSpawnForSubagent 整体包 try/catch 返回 {ok:false, reason}；
所有按钮处理器过一层 safeRun，失败必落 console。⚠ …），不再只写 console —— 没开 DevTools 也能看到。v1.13（A′：没有子智能体时自动接续）
subagent 工具；插件同时盯着投影，
一出现新子会话就自动在右侧打开它并投放那条引用。sessions 契约里
没有任何 create/spawn（forkSession/startSession 开的是顶层会话，不是子智能体）；
客户端 catalog 里 subagent 声明 0 条；全仓 subagent/* 事件全是观测性的。
根因是创建要 ctx.subagents.start(name, { parent: Agent })，而 Agent 是 host 侧对象。v1.12（严重：引用含 dsh-session: 会让整轮失败）
@[label](dsh-session:…) 或裸 dsh-session:xxx 的文字后发送，
本轮直接报 invalid session reference URI 并失败。
根因：host 在 agent/pre-step 对每条用户输入跑 parseSessionReferenceText
（dsh-session-reference），正则同时匹配 Markdown mention 和裸 URI，命中后
decodeSessionReferenceUri 对不规范的值抛错 → 整轮失败（fail-loud）。
而被引用的原文是原样透传的，所以别人解释这个语法时写的示例就足以炸掉一轮。dsh-session 与冒号之间插零宽空格（U+200B），破坏字面量、正则不再命中；
零宽不可见，去掉后原文一字不差。dsh-session: 是唯一会被 host 从 prompt 文本解析的 wire form，
其余 dsh-*: scheme 都是内部标识，不碰（避免无谓改动被引用的代码原文）。v1.11
❝ 正文 ❞（原来只有左侧 ❝ ）。
每行都成对，在纯文本气泡里引用边界一眼可见。v1.10（发送后的显示形态）
> 第一行 改成 ❝ 第一行。
原因是一个被推翻的假设：v1.3 我假设会话记录按 Markdown 渲染用户消息，
所以 > 会变成引用块。实际上 DSH 的用户消息完全不解析 Markdown ——
UserStyleBubble 的正文用的是 projectUserText(...)（dsh-client-ui-primitives），
它只切纯文本 span + 换 mention 芯片。所以 > 一直显示成字面的 > 字符，
是纯噪音。conversation.chat.node 的 user 键），要重实现 UserStyleBubble 的全部内容，
升级必炸 —— 已否决。>、每行必须左右成对）。v1.9（带附件的发送路径）
keydown；② 点主发送按钮 click（[data-composer-card] button[class*="_primary"]）。uploadsPending 会挡下提交并弹"文件仍在上传"，
但那时引用已经被写进草稿了，再按一次回车会再拼一遍。现在：
先看发送按钮是否禁用（禁用说明这次提交会被挡下），禁用就不注入；并记录上次注入的块，
草稿已以它开头时跳过。empty 禁用），
点它不该注入 —— 用 hasContent（有字或有附件）区分。v1.8（收尾）
2 条引用 · v1.7）—— 内容本身就是引用原文，标题是多余的。BUILD 标记。构建标记改为只通过 exports.__test.build 暴露。exports.__test：scripts/smoke.mjs 的渲染回归测试依赖它。v1.7（第五轮真机验收）—— 找到真正的根因
jsx/jsxs 的第三个参数用错了：
自动 JSX 运行时里 jsx(type, props, key) 的第三参是 key，children 必须放进 props。
我把 children 数组当第三参传了，于是条目 div 渲染出来是空的，而且不报任何错。
v1.2 起用户看到的"空白一片"从头到尾都是这一个 bug。scripts/check.mjs 新增 jsx/jsxs 元数检查（第三参必须是 key）。scripts/smoke.mjs 新增真实元素树渲染断言，并用变异测试验证过它确实能抓住
这个 bug（scripts/mutate-check.mjs 把 children 改名后，3 项断言失败）。v1.6（第四轮真机验收）
mouseleave 关闭 → 布局缩回 → 胶囊回到鼠标下 → mouseenter 打开 →
循环。展开动作本身移动了触发器，所以这个位置的 hover 方案根本不成立。v1.5（诊断版）
BUILD 标记 —— 用来判断"浏览器里跑的到底是不是这份代码"。
这一步定位了关键事实：代码确实加载了、事件也确实到达了胶囊（箭头会翻转）。v1.4（第三轮真机验收）
require('react-dom')，少一个未知量。v1.3（第二轮真机验收后的修正）
overflow 裁剪。
改为 portal 到 document.body + position: fixed（用胶囊 rect 定位，底边重叠 2px 保 hover）。--dsw-specific-menu 是半透明色、必须配
backdrop-filter 使用，而我漏了 blur，兜底色又只有 10% 不透明度。
现在统一「半透明底 + backdrop-filter + 描边」，并给浅/深色各自的兜底底色。retain → ready → setDraft 时序依赖。【引用】/【引用结束】 标记，只输出标准 Markdown 引用块。v1.2（第一轮真机验收后的修正）
agentTeam 投影，
而普通子智能体走 subagentCatalog。现在两个投影都读，并区分"目录为空"与"目录加载中"。subagentCatalog 投影是按父会话组织的，
客户端拿不到 listDescendants发送时注入（useSubmitInjection）靠 DOM 捕获阶段拦两条发送手势：回车 keydown、
主发送按钮 click（[data-composer-card] button[class*="_primary"]）。
主路径已实测可用，但下面几条没验过：
Shift+Enter 换行是否原样放行isComposing / keyCode 229）是否被正确跳过不稳的话，退路是改用官方引用芯片（inputTriggers + codec）——
代价是引用会以行内 chip 出现，且草稿里也能看到。