dsh-spec-panel
用于 dsh-better-sidebar 的 SDD（规范驱动开发）工作台：浏览 OpenSpec 的 specs/ 和 changes/，切换 tasks.md 清单，并创建新的变更文件夹——规范以真实文件形式存储在会话工作区中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zhangkkkai/dsh-spec-panel#49c07828a2bb4bf4ff6bb5fd14735133ddd66488
Spec Panel 以 dsh-spec-panel 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个基于 dsh-better-sidebar 的 SDD（规范驱动开发，Spec-Driven Development）配套插件：在侧边栏提供一个 Spec 工作台，围绕 OpenSpec 的标准目录结构，让「先写规范 → 再实现 → 再验证」的流程一目了然、可操作。
核心亮点：spec 不是存在浏览器里的数据，而是工作区里真实的文件（openspec/ 目录）。host 半负责读写文件，client 半通过 Typert Remote 调用，勾选任务清单会直接写回 tasks.md。
| 模块 | 说明 |
|---|---|
| 事实源 specs/ | 列出 openspec/specs/<domain>/spec.md，点击即渲染需求 + 场景 |
| 变更工作台 changes/ | 每个变更一张卡片：提案 / 设计 / 任务 / 增量 四个工件齐全度、任务进度、状态徽标 |
| 状态推断 | 不引入额外状态文件：按工件存在 + tasks.md 完成度推断 提案中 → 实施中 → 已完成（归档目录恒为 已归档） |
| 任务清单 | 直接勾选 tasks.md 的复选框，写回磁盘，实时刷新进度 |
| 模板新建 | 一键创建 openspec/changes/<name>/，使用 OpenSpec 官方模板（proposal / design / tasks / specs） |
| 已归档 archive/ | 展示 openspec/changes/archive/ 的历史变更 |
| 编辑器联动 | 每个工件可一键在 better-sidebar 内置 editor 中打开（绝对路径） |
dsh web）已安装ctx.betterSidebar 服务）dsh plugin --profile web add dsh-spec-panel
~/.dsh/profiles/web/package.json：{
"dependencies": {
"dsh-spec-panel": "file:/path/to/dsh-spec-panel"
},
"dsh": {
"profile": {
"bundles": [ "…", "dsh-spec-panel" ]
}
}
}
pnpm installdsh web（新增 bundle 需重启），浏览器硬刷新（Cmd/Ctrl+Shift+R）openspec/ 目录）+ 菜单 → Spec（或已打开的 tab）add-dark-mode）→ 自动生成四个工件模板tasks.md；用「↗」在编辑器中打开任意工件继续完善面板兼容 OpenSpec 标准布局：
<workspace>/openspec/
├── specs/<domain>/spec.md # 事实源（系统当前行为）
├── changes/<change-name>/
│ ├── proposal.md # 为什么 / 改什么
│ ├── design.md # 怎么做
│ ├── tasks.md # 实施清单（勾选）
│ └── specs/<domain>/spec.md # 增量 spec（ADDED/CHANGED/REMOVED）
└── changes/archive/ # 已归档变更
装上 openspec CLI 后，面板管理的目录可以直接配合
openspec命令使用（/opsx:*工作流）。
pnpm install
pnpm run typecheck # tsc --noEmit
pnpm run build # build:types + tsdown（host ESM + client CJS 双产物）
构建成功的标志：lib/client.js 开头包含 window.__ModuleLoader__.load({ id: "dsh-spec-panel", ...。
src/
├── index.ts # host 半入口：实例化 SpecService
├── spec-service.ts # host 服务：openspec/ 读写、状态推断、模板脚手架（TypertRemoteService）
├── spec-types.ts # 共享 wire 类型
├── typert-descriptors.ts # zod codecs + InvocationDescriptor[]
├── typert.host.ts # host Typert 贡献（./typert）
├── remote.ts # browser Typert 贡献（./remote + 类型合并）
└── client/
├── index.tsx # client 入口：mount remote + registerTab('spec')
├── SpecPanel.tsx # 工作台面板
├── Markdown.tsx # 安全 Markdown 渲染（无 HTML 注入）
└── spec.module.css # CSS Module，仅 --dsw-alias-* 主题 token
<会话cwd>/openspec 内，路径解析后校验，越界即拒绝（参照 dsh-file-review-tab 的围栏做法）ctx.sessions.scope(sessionId).get('remote.specPanel') 调用 host 服务；host 从 agent.session.header.cwd 推导 openspec 根ctx.effect 里；inject 声明硬依赖 + ctx.get 判空；tab id 不与内置冲突（内置：explorer/git/subagent/terminal/browser/editor/diff）MIT
