dsh-canvas-tsx-sidebar
DSH web plugin（dsh-better-sidebar consumer）：将 Qoder Canvas `*.canvas.tsx` 报告以结构化页面呈现在右侧边栏中。仅进行静态解析——不执行代码。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:drscrewdriver/dsh-canvas-tsx-sidebar#13dd0c28c042b0d562651dd43a72ad479d5dfea3Canvas Tsx Sidebar 以 dsh-canvas-tsx-sidebar 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH（DeepSeek Harness）Web 插件 —— dsh-better-sidebar 消费插件。
把工作区里的 Qoder Canvas *.canvas.tsx 静态解析为结构化页面，在 DSH 右侧栏渲染。
纯静态管线：不执行 canvas 源码。无
eval、无new Function、无 bundler、无沙箱 iframe。 解析在浏览器侧用自研的轻量递归下降解析器完成（零解析器依赖）。
dsh web 可正常运行>=0.19.1）未安装 better-sidebar 时插件完全惰性：注册被静默跳过，不影响 DSH 其他功能。
dsh plugin --profile <profile> add <dsh-canvas-tsx-sidebar-0.1.0.tgz>
dsh 会把本包加入 dsh.profile.bundles，启动时由本包自带的 cordis.patch.yml
插入 loader entry，并按 entry.name 注册下发客户端 bundle。
把包复制到 ~/.dsh/profiles/<profile>/node_modules/dsh-canvas-tsx-sidebar
（或在 profile 的 package.json 的 dependencies 里加 "dsh-canvas-tsx-sidebar": "link:<插件路径>"）；
把下面这行追加到 ~/.dsh/profiles/<profile>/cordis.patch.yml：
- insert:
- id: dsh-canvas-tsx-sidebar
name: dsh-canvas-tsx-sidebar
在 profile 目录执行 pnpm install。
⚠️ 方式 A 与方式 B 二选一，勿重复注册。
dsh web —— 新增 bundle 需要宿主侧重载（对已挂载插件的 client 改动才只热加载）；可用 pwsh -NoProfile -File ./scripts/mount-check.ps1 复查挂载状态。
在 DSH 右侧栏的 + 菜单里打开 Canvas 报告。插件会扫描当前会话工作区内的
*.canvas.tsx，选中后渲染为结构化页面。
本插件不注册文件预览器。打开
.canvas.tsx不会自动进入本插件——原因见下节。
这是本项目最关键的一个设计裁定，依据全部来自 better-sidebar 源码与生态实测：
| # | 约束 | 证据 |
|---|---|---|
| L1 | extOf() 只取最后一段扩展名 → extOf('a.canvas.tsx') === 'tsx' | src/client/paths.ts:80-85 |
| L2 | 唯一能命中的 exts: ['tsx'] 会认领工作区全部 .tsx，且 priority 0 压掉内置 code（-100）的 CodeMirror | service.ts:847-875 |
| L3 | detect 只在 head 字节可用时调用，而 head 仅来自二进制 fs.read —— 文本 .tsx 永远走不到该分支 | service.ts:860 |
| L4 | descriptor 认领后 component 必须渲染，无委托/回退 API，误认领不可挽回 | EditorHost.tsx:349,486 |
| L5 | 生态插件 dsh-code-nav 的 LANG_EXT 已含 tsx 并以 priority: 10 认领 —— 我们低于它会永不触发，高于它会遮蔽它 | dsh-code-nav/src/lang-registry.js |
→ .canvas.tsx 的判定必须在自有组件内完成，因而必须自持文件选择 UX → 页签。
在 dsh-better-sidebar@0.19.0 / 0.19.1 上，openTab({ path }) 的 path seed 会被改道到
文件编辑器，组件型页签不会挂载（上游 #632，0.19.2+ 修复）。因此本插件不依赖 path seed，
而是自行经 /sidebar/api（session.cwd → fs.tree → fs.read）解析目标文件——
该实现对 0.19.2+ 同样成立。
所有视觉值只消费 DSH 的 --dsw-alias-* 令牌，零硬编码颜色，自动跟随全部皮肤与深浅色
（tests/theme.spec.ts 守护）。调色板不取自 Qoder 自带的 palettes.d.ts。
pnpm install
pnpm typecheck # tsc（含仅客户端的零 Node 依赖校验）
pnpm test # vitest
pnpm build # tsc dts + tsdown（宿主半 + 客户端 bundle）
解析为轻量自研解析器，非编译器级精度。复杂 TSX（泛型箭头函数、as 断言、装饰器）
可能落入 unsupported，此时该节点渲染为行内降级条而非报错，不是整页失败。
仅支持 Qoder Canvas 的声明式子集：字面量 props。任何非字面量（变量、调用、
.map()、条件表达式、成员访问、{...spread}）一律降级，不做求值：
unresolved 里，其余属性照常渲染。页签渲染为只读。
解析器比编译器更宽容：Qoder SDK 要求作者用 IDE 的 "Canvas TypeScript check" 修掉诊断，
但真实文件未必干净。本插件遇到非法 TSX 不报错、不中断，只降级出问题的那个节点。
可用 node scripts/syntax-oracle.cjs <file.canvas.tsx> 查看权威诊断。
实测：仓库自带的样本
cmp-cloud-sdk-report.canvas.tsx第 46 行{'created': ...}即为非法 TSX（TypeScript 报 TS1005 + TS1381 —— 裸展开运算符）。 本插件把该处降级为一个行内标记，其余 147 行照常渲染。
文本子节点严格按 React 的 cleanJSXElementLiteralChild 语义折叠：
…相加（0 + {'created': ...}）… 中的空格，去掉会让两段粘在一起）。| 脚本 | 用途 |
|---|---|
scripts/dump-ir.ts | 导出某文件的 IR 大纲 / JSON / 黄金夹具（--write） |
scripts/syntax-oracle.cjs | 用真实 TypeScript 编译器判定源文件是否合法 TSX（typescript 仅为 devDependency，不进 bundle） |
scripts/audit-bundle.cjs | 审计真实构建产物：内建模块泄漏、重解析器、eval、越界注册 |
scripts/mount-check.ps1 | 检查/修复 profile 挂载（纯 ASCII，兼容 Windows PowerShell 5.1） |