dsh-plugins — DSH host 层插件集
DeepSeek Harness(DSH)host 层全局插件 monorepo,包含官方级能力的 host 插件与 Web client 扩展。
| 插件包 | 核心功能 | 当前版本 | 适配 DSH |
|---|---|---|---|
@chaoset/dsh-any-connect |
多渠道桌面端与免密模型接入:WorkBuddy(国内/国际版)、ZCode(Coding/Start Plan 双通道)、OpenCode Free 官方免密免费模型通道;支持思考强度自测与补全、积分倍率显示、图片多模态、自定义模型隐藏与 CLI 诊断 | 0.4.30 |
0.2.2-rc.1 |
@chaoset/provider-usage |
对话底栏模型额度指示器:在输入框状态栏(composer dock)实时显示当前会话 provider 剩余额度与重置时间,点击展开可视化进度条与详细计费包;内置 8+ 种 Provider 查询器并提供开放注册 Seam | 0.2.2 |
0.2.2-rc.1 |
@chaoset/sandbox-extra-roots |
沙盒额外允许写入目录:为 workspace-write 沙盒安全追加工具缓存目录(npm/pip/cargo/go 等);跨平台 Seatbelt/bwrap/Landlock 原生沙盒引擎注入;严格防范危险根与 TOCTOU 符号链接逃逸 |
0.4.30 |
0.2.2-rc.1 |
@chaoset/session-archive |
归档会话完整生命周期管理:Web 侧边栏专属归档面板与实时徽标;抽屉式只读浏览历史会话事件流;批量安全恢复到会话树;两段式彻底物理删除与落盘防竞态保护;纯前端毫秒级检索与排序 | 0.3.33 |
0.2.2-rc.1 |
插件特性详解
1. @chaoset/dsh-any-connect — 多渠道桌面端与免密模型接入
接入各类桌面 AI Agent 与免密官方通道的模型到 DSH,无需手动配置复杂的 API Key,开箱即用。
- 多上游通道无缝接入:
- WorkBuddy 国内版 (
workbuddy):零配置自动读取本机桌面 App 登录态;深度支持 WorkBuddy 5.6+ 针对accessToken/refreshToken的$wbEncrypted加密信封(自动定位 macOS Bundle 或 Windows 注册表/安装目录的 Electron 二进制充当解密助手,亦支持WORKBUDDY_ELECTRON_BIN覆盖);支持图片多模态输入;模型选择器以原生徽标标明积分倍率与限免标签(/model弹窗在模型名后缀显示倍率,如· x0.79)。 - WorkBuddy AI 国际版 (
workbuddy-ai):独立接入国际版桌面 App,提供独立的「WorkBuddy AI」模型分组(GPT、Gemini 系列等)、独立凭据与账号积分卡片。 - ZCode Coding Plan (
zcode):接入智谱 ZCode 桌面端 Coding Plan 官方渠道;按桌面端setting.json当前激活计划精准取用 API Key;以客户端本地内置白名单(zcode-builtin.json)动态约束模型,随客户端升级自动更新(智谱此前的 23:00–09:00 夜间免费限时活动已下线,现按 150% 额度与模型基准计费如实展示)。 - ZCode Start Plan (
zcode-start-plan):独立专属通道(zcode.z.ai/api/v1/zcode-plan/anthropic)与独立额度池;采用账号 JWT + 设备标识认证,扣减当日一次性 Token 包(过期不结转);每日领取活动自动探测并在设置卡片中醒目提醒(提供一键复制 Plan ID);动态跟随用户今日实际权益展示模型,未领取或过期如实隐藏。 - OpenCode Free (
opencode-free):官方免密免费模型通道(Muse Spark 1.2/1.3、Qwen3.6 Plus、MiniMax 系列、Nemotron 3.5 Super VL、DeepSeek V4.1 Flash、Big Pickle 等);自动过闸标头与read只读工具守卫注入,解除 "free tier can only be used from within OpenCode" 网关限制;多协议实时流式转码(OpenAI Responses、Anthropic Messages、OpenAI-compatible Chat Completions 统一转为标准 OpenAI SSE 流,完整支持reasoning_content思考过程输出);自动读取本地官方 specs 缓存(~/.cache/opencode/models.json)决议精确上下文与多模态能力。
- WorkBuddy 国内版 (
- 思考强度智能适配:
- 支持 low / medium / high / max 等思考等级选项,在 DSH 模型选择器即可切换;
- 后台全自动探测与补测未声明档位的模型;
- 对只能在思考态工作的模型(
onlyReasoning),选择器「默认」档位智能补选最高档,OpenAI 通道补reasoning_effort,Anthropic 通道补thinking预算对象并相应调整max_tokens。
- 自定义模型管理与优雅体验:
- 设置页模型表格中支持点击删除图标自定义隐藏/排除不常用模型;
- 表格上方展示已排除模型统计,提供一键「恢复默认」入口;
- 完整展示模型名、费率倍率、真实与可选上下文窗口、思考档位与特性标签;
- 与 DSH 原生主题视觉完美融合,刷新与状态切换平滑无抖动。
- 独立诊断 CLI:
- 附带
dsh-any-connect doctor(体检凭据、加密格式、解密助手、心跳与模型数)、status、logout命令,支持--provider <id>针对指定渠道排查。
- 附带
2. @chaoset/provider-usage — 对话底栏模型剩余额度指示器
在对话区底部的状态栏(composer dock)直观显示当前会话 provider 的剩余额度、余额与重置周期。
- Composer Dock 状态栏原生呈现:
- 紧随 DSH 自带的 Token 消耗、步数、轮数指标并列展示,形如
workbuddy 23 credits left、deepseek-official 45.2 cny 剩余、openrouter 5 credits left; - 额度来源与对话框当前所选模型同源(
ctx.modelDirectories),切换模型即刻自动联动切换额度 pill。
- 紧随 DSH 自带的 Token 消耗、步数、轮数指标并列展示,形如
- 交互式额度抽屉 (Popover):
- 点击底栏 pill 展开详细计费抽屉;
- 每个计费包配有图形化进度条(
23 / 100),颜色随余量分三档告警; - 明确展示套餐名称、额度余量/总量与重置时间。
- 全面的内置 Provider 查询器:
- DeepSeek:全面支持 DSH 0.2.1+ 官方的两条路由——
deepseek-account(OAuth 账户余额与赠送代金券钱包)和deepseek-official(API KeyGET /user/balance余额),亦兼容自定义deepseek路由; - OpenRouter:
/api/v1/key+/api/v1/credits,API Key 自身限额优先,回落到账户额度; - Moonshot (Kimi):
GET /v1/users/me/balance可用余额、现金、代金券分列; - SiliconFlow (硅基流动):
GET /v1/user/info总额、可用、充值分列; - BigModel (智谱):
GET /api/monitor/usage/quota/limitCoding Plan 滚动窗口与订阅套餐; - MiniMax:
GET /v1/token_plan/remains5 小时滚动窗口与周额度窗口; - OpenAI / OneAPI:
GET /dashboard/billing/subscription余额与限额用量; - OpenCode / OpenCode Go:
GET /usage滚动、周、月窗口用量百分比。
- DeepSeek:全面支持 DSH 0.2.1+ 官方的两条路由——
- 开放查询器注册架构 (Seam):
- 宿主服务暴露
ctx.providerUsage,任何第三方 provider 插件均可通过register()挂载自有查询器(覆盖重写语义,支持热重载); @chaoset/dsh-any-connect自动通过此机制注入 WorkBuddy 与 ZCode 的额度查询。
- 宿主服务暴露
- 稳健的高可用设计:
- 绝不消耗额度:仅调用只读余额接口;
- 并发单飞与缓存:60s 本地缓存 + 并发单飞合并,多个组件读取共用一次请求;
- 敏感信息脱敏:请求失败保留上次成功快照,报错信息严格脱敏(过滤 JWT、
sk-密钥与 URL 参数凭据); - 会话搁置自愈:防范窗口长期失焦休眠后的数据滞后,激活时具备唤醒恢复机制;
- 延迟就绪挂载:严格等待模型目录服务就绪后再注册 slot,杜绝宿主缓存
undefined导致整页丢失 pill。
3. @chaoset/sandbox-extra-roots — 沙盒额外允许写入目录
为 DSH 的 workspace-write 沙盒模式安全追加用户指定的写入白名单,解决工具缓存无权写入的痛点。
- 解决开发痛点:
- DSH 的
workspace-write沙盒模式默认严格限制命令仅能写入 workspace 根目录与系统/tmp,使 npm、pip、cargo、go、uv 等工具的全局缓存因无权写入而报错。
- DSH 的
- 追加式白名单:
- 官方安全白名单始终严格保留,只追加用户明确配置的额外允许写入目录。
- 跨平台原生沙盒多引擎适配:
- macOS:重构 Seatbelt (SBPL) profile,安全注入允许写入子路径;
- Linux:在官方 profile 基础上安全插入 bwrap
--bind与 Landlock--rw; - Windows:识别 ACL runner 限制并提供清晰友好的单次告警;
- FS Fence:扩展
checkedTarget文件系统围栏,对额外目录安全放行。
- 多层次安全防护:
- 绝对禁止危险根:严禁将
/、盘根、用户主目录本身及其父目录(如/Users、/home)设为可写; - 系统关键路径过滤:自动忽略操作系统核心目录(
/etc、/usr、/bin、/sbin、/private); - TOCTOU 符号链接防御:运行时动态解析软链接真实目标,一旦被替换为危险根立即剔除权限。
- 绝对禁止危险根:严禁将
- 可视化配置与即时热生效:
- 设置页「插件配置」提供专属卡片,支持路径实时校验预览与错误提示;
- 预置常用工具缓存一键快速添加(npm / bun / pip / cargo / go);
- 经官方 config-editor 直接保存到
cordis.patch.yml,修改即时热生效,无需重启。
4. @chaoset/session-archive — 归档会话完整生命周期管理
补全 DSH 仅有「归档动作」而缺失后续查看、恢复、检索与清理的断环,提供完整的会话归档管理。
- Web 侧边栏专属面板与动态徽标:
- 侧边栏底部添加「归档」图标入口;
- 徽标实时显示当前有效归档会话数量(轻量订阅 + 轮询兜底)。
- 历史会话只读抽屉浏览:
- 会话列表展示标题、原工作区路径、时间、占用磁盘大小;
- 点击任意会话可展开抽屉式只读浏览完整用户与助手消息,内置安全截断与字符保护,无需恢复即可回溯历史上下文。
- 批量一键安全恢复:
- 支持多选会话一键恢复到原工作区的会话树;
- 针对底层文件被删除等异常孤儿会话,返回逐条精确的原因诊断。
- 彻底物理删除与安全防竞态:
- 两段式防误删确认(首次点击进入确认态,4 秒内二次确认执行);
- 干净清理底层会话持久化数据与目录;
- 沉降观察窗检测:若会话正处于活跃生成落盘中,严正拒绝删除,防止数据损坏;
- 内存会话占位墓碑机制:防止删除后的内存残留会话复活,对内存尚未消亡的会话明确提示
needsRestart。
- 高效检索与状态记忆:
- 纯前端即时关键字搜索(标题、工作区路径、会话 ID);
- 多维度排序(修改时间、体积大小、标题名称);
- sessionStorage 状态记忆:刷新页面不丢失当前的搜索词与排序规则;
- 分页流式加载,海量归档会话渲染零卡顿。
- Remote API:
- 暴露
ctx.remote.sessionArchive(支持list()、count()、detail(id)、delete(ids)、unarchive(ids))。
- 暴露
安装与使用
本仓库通过 GitHub Releases 分发(Release 资产是标准 npm tarball),并额外提供 DSH 官方的「自定义插件索引」:索引与静态 npm registry 由 CI 从每个 Release 生成,作为站点发布在独立的发布产物分支 market 上(该分支根目录即站点根,URL 固定)。下面两种方式任选,推荐方式一。
方式一:插件索引(推荐,发现页一键安装)
一次性前置:在目标 profile 的
.npmrc声明@chaoset的 scoped registry。不配置时,重启 DSH 后的卸载/更新会回退默认 registry(npmjs)并报ERR_PNPM_META_FETCH_FAIL404;配置后 GUI 与 CLI 都直接可用、CLI 不再需要--registry:printf '@chaoset:registry=https://raw.githubusercontent.com/ShanWuYinShe/dsh-plugins/market/npm/\n' >> "$DSH_HOME/profiles/web/.npmrc"打开 DSH → 插件 → 实验性插件,打开 自定义插件索引(Custom plugin indexes);插件页会出现发现标签页。
发现 → 添加索引源,填入:
https://raw.githubusercontent.com/ShanWuYinShe/dsh-plugins/market/index.json在发现页浏览本仓四个插件并点安装(卡片显示的即与你当前 DSH 版本精确匹配的最高版本);进入插件页的版本列表可以安装历史版本(与你的宿主版本不匹配的会标「不兼容」并禁用安装)。索引安装默认只下载并登记插件、不自动启用:安装完成弹窗点立即启用(或在「已安装」列表打开开关),插件随即在线生效。
更新:配好第 0 步的 scoped registry 后,更新在安装后同一会话内和重启 DSH 后都可用——
- GUI:插件 → 已安装 → 插件详情 → 版本,检查后点「更新到
<版本>」(重启后仍然有效); - CLI:
dsh plugin --profile web add @chaoset/<包名>@<版本>(不再需要--registry)。
- GUI:插件 → 已安装 → 插件详情 → 版本,检查后点「更新到
卸载:GUI 用插件 → 已安装 → 插件详情 → 卸载;CLI 用
dsh plugin --profile web remove @chaoset/<包名>(配好第 0 步的 scoped registry 后不需要--registry)。未配置 registry 的 profile 才需要临时补--registry=https://raw.githubusercontent.com/ShanWuYinShe/dsh-plugins/market/npm/兜底。
索引只提供元数据与安装来源(npm 包名 + 静态 registry),安装/更新仍走 DSH 自带的 pnpm 安装与 bundle 对账流程;索引收录的每个版本都对应本仓的一个 GitHub Release 资产。用索引安装时,插件的宿主运行时依赖由宿主 profile runner 的 runtime resolution 提供(不写入 profile 的 node_modules);需要把依赖装进 profile 时请用下面的 tarball 方式。因此本仓插件发布的 tarball 运行期零依赖(dependencies/optionalDependencies 为空,宿主依赖只放 devDependencies)——否则 pnpm 会按 tarball 里的依赖声明去静态 registry 解析它们而 ERR_PNPM_FETCH_404,装过一个带运行期依赖的版本后,同一 profile 再装/更新其它插件会失败。
索引 URL 固定,添加一次永久有效:任一发布线(
alpha、rc、正式版)发版后,同一个索引 都会自动更新,无需重新添加索引源。
索引里的每个版本都精确声明它所匹配的 DSH 版本(engines.dsh 是精确版本,不是范围),宿主按 SemVer range 判定兼容性;本仓声明精确版本,效果上等价于精确匹配:只有与你当前 DSH 版本完全一致的插件版本会显示可安装,其余版本在列表里标「不兼容」。因此 DSH 每次升级(含同线 alpha→rc→正式版)后,请安装为那个新版本重新发布的插件版本。
历史代价(如实说明):0.2.2 适配线之前发布的 tarball 里
engines.dsh是范围,索引按规则把它们 pin 到发布时适配的精确宿主版本(如0.2.1-rc.3)。所以以0.2.1-rc.5为参考版本的宿主不会看到旧稳定版可安装——这是「精确匹配、不误导」的代价,收敛期发布对应版本后恢复。已发布 tarball 不可变,索引侧严格、安装期检查对历史版本仍宽松(CLI 仍可强制装旧包)。
注:预览线宿主(如 0.2.2-rc.1)下兼容版本可能全是预发布版,而 DSH 的「默认」标签只从兼容的正式版里选,因此卡片可能不打「默认」;「安装」按钮仍指向该宿主兼容的最高版本,功能正常。
运行期依赖的历史代价(如实说明,2026-10-30 实测):2026-10-30T00:00:00Z 之前发布的旧 tarball 里仍带
dependencies(例如zod),这些版本按「策略生效前只告警」的规则保留在索引里。若你 安装过这类旧版本,之后在同一 profile 再装/更新其它插件可能报ERR_PNPM_FETCH_404(去静态 registry 找zod等宿主依赖)。变通:先装好其它插件、把这类旧版本放在最后装;或改用「方式二」 的 tarball URL 安装旧版本(tarball 方式从常规 registry 解析依赖,不受影响)。这类版本无法回改, 但策略生效之后发布的所有版本都强制运行期零依赖(索引侧 check/build 自校验拦截)。
方式二:tarball URL(手动)
Release 资产命名规则为 chaoset-<包目录>-<版本>.tgz,tag 名 <包目录>-v<版本>,可直接安装对应 URL:
# 版本以 Releases 页为准:https://github.com/ShanWuYinShe/dsh-plugins/releases
# 1. 安装 @chaoset/dsh-any-connect(模型接入)
dsh plugin --profile web add https://github.com/ShanWuYinShe/dsh-plugins/releases/download/dsh-any-connect-v<版本>/chaoset-dsh-any-connect-<版本>.tgz
# 2. 安装 @chaoset/provider-usage(底栏额度显示)
dsh plugin --profile web add https://github.com/ShanWuYinShe/dsh-plugins/releases/download/provider-usage-v<版本>/chaoset-provider-usage-<版本>.tgz
# 3. 安装 @chaoset/sandbox-extra-roots(沙盒额外目录)
dsh plugin --profile web add https://github.com/ShanWuYinShe/dsh-plugins/releases/download/sandbox-extra-roots-v<版本>/chaoset-sandbox-extra-roots-<版本>.tgz
# 4. 安装 @chaoset/session-archive(归档会话管理)
dsh plugin --profile web add https://github.com/ShanWuYinShe/dsh-plugins/releases/download/session-archive-v<版本>/chaoset-session-archive-<版本>.tgz
# 从本地源码安装(开发调试时使用绝对路径)
dsh plugin --profile web add /absolute/path/to/dsh-plugins/packages/dsh-any-connect
# 卸载插件(配好第 0 步的 scoped registry 后无需 --registry;未配置时才需要下面的 REGISTRY)
REGISTRY=https://raw.githubusercontent.com/ShanWuYinShe/dsh-plugins/market/npm/
dsh plugin --profile web remove @chaoset/dsh-any-connect --registry=$REGISTRY
dsh plugin --profile web remove @chaoset/provider-usage --registry=$REGISTRY
dsh plugin --profile web remove @chaoset/sandbox-extra-roots --registry=$REGISTRY
dsh plugin --profile web remove @chaoset/session-archive --registry=$REGISTRY
生效时机:启用 HMR 的 web profile 里,安装/启用/停用/卸载/更新都直接在线生效,无需重启(GUI 操作与 CLI 写 profile 后都会被运行中的实例通过 profile 监听重组合;只有结果明确报 restart-required 时才需要重启)。未启用 HMR 的 profile(如 headless/SDK)仍需重启后生效。
常见安装排障
重启后用 CLI 卸载/更新报
ERR_PNPM_META_FETCH_FAIL(registry.npmjs.org/@chaoset/...: 404):pnpm remove会按默认 registry 校验/解析 lockfile 里来自自建 registry 的 tarball;dsh plugin在常驻进程之外执行时拿不到「本进程安装该包时用的注册表」,回退到 pnpm 配置的默认 registry(npmjs)。处理:在 profile 目录配置第 0 步的 scoped.npmrc(一劳永逸,GUI/CLI 都恢复);临时也可给命令补--registry=https://raw.githubusercontent.com/ShanWuYinShe/dsh-plugins/market/npm/。更新/卸载报「无法移除 X」+「其他配置仍在用这个组合包的组件,请先停用它们」:这是 DSH 0.2.2-rc.1 插件管理器的已知误报,不代表真有别的配置在用它。管理器的卸载顺序是「取消选入 → 在线重组合 → 检查该组合包声明的行是否仍在运行 →
pnpm remove」;当这次重组合只能等重启才生效(restart-required,例如运行时包目录/安装映射与磁盘不一致)时,宿主会先把这些行原地恢复并重启,紧接着的「行存活」检查就把它们误当成「其他配置仍在使用」。 常见诱因:在插件管理器之外改动过 profile 依赖(手工编辑package.json、删node_modules、外部pnpm操作)后再安装/更新插件,安装映射与磁盘不一致。处理:重启 DSH(dsh web)后重新卸载/更新。失败不会回滚已写入的「取消选入」,若重启后仍看不到更新,按上面方式用 CLI 重新安装该插件(带--registry)即可恢复。 本仓四个插件的实现不会造成该状态:bundle patch 都是单行insert、不创建 Loader 行、不写 profile 配置,因此「行还在运行」只能由宿主上述重组合恢复路径产生。pnpm 供应链策略拦截安装:pnpm v11 默认拦截依赖的构建脚本并启用「发布满 24 小时才可安装」策略。首次执行
dsh plugin add若报错pnpm failed:- 打开目标 profile 目录(
$DSH_HOME/profiles/<name>/pnpm-workspace.yaml); - 将
allowBuilds占位的set this to true or false改为true; - 将刚发布的
@chaoset/*@<版本>加入minimumReleaseAgeExclude列表; - 重新执行一次
dsh plugin add命令(首次失败时 bundle 对账未完成,必须重跑以完成注册)。
⚠️ 不要直接用
pnpm add或手动写 profile 的package.json:这样跳过了 bundle 对账,web 启动时会报pending (waiting for service: remote.xxx)。- 打开目标 profile 目录(
索引安装后,同 profile 再装/更新插件报
ERR_PNPM_FETCH_404(宿主依赖,如zod):索引安装走静态 registry,pnpm 会按已装 tarball 的dependencies声明去该 registry 解析依赖;装过「历史版本仍带运行期依赖」的插件后,后续包操作就可能命中 404(详见上文「运行期依赖的历史代价」)。变通:- 把该历史版本放到最后装(先装/更新其它插件),或直接改用「方式二」的 tarball URL 安装它;
- 若失败发生在
dsh plugin add的 bundle 对账之后,先停掉dsh web,删除该 profile 的node_modules后按同一顺序重装(见下一条「pnpm store 漂移」的删掉重装做法); - 策略生效时刻(2026-10-30T00:00:00Z)之后发布的版本运行期零依赖,不会再触发;发布侧由
check/build 自校验强制(该时刻之后发布的版本带运行期依赖即失败,见RELEASING.md「收录规则」)。
pnpm store 漂移(宿主升级后安装报错,全部 profile 通用):宿主升级若更换了内置 pnpm 的大版本,每一个旧 profile 的
node_modules都是上一版 pnpm 安装的——只要该 profile 执行过dsh plugin add就会报ERR_PNPM_UNEXPECTED_STORE(use the new store location …):node_modules 里的.modules.yaml记录着旧 store 位置,与新 pnpm 解析出的不一致。逐 profile 修复,对每个受影响的 profile 各做一遍。⚠️ 必须先停掉运行中的 DSH(
dsh web)再做下面的删装。运行中的实例里手动删node_modules/ 改 profile 依赖,会让宿主的运行时安装映射与磁盘不一致,之后在 GUI 里卸载/更新就可能命中restart-required并把「自己没停掉的行」误报成bundle-in-use(见上一条排障)。修复就是删掉重装(node_modules 是纯安装产物,删掉连旧 store 记录一起归零;插件配置在
cordis.patch.yml,不受影响):rm -rf $DSH_HOME/profiles/<name>/node_modules dsh plugin --profile <name> add <同一个 tarball URL>一次
plugin add会按 package.json 把该 profile 已装的全部插件一并装回,store 位置直接写对。(2026-10-24 于宿主 0.2.1-rc.3 时代实测,当时内置 pnpm v11.28.5:web 与 desktop 两个 profile 各用一条命令重装四包;修复后核对node_modules/.modules.yaml的storeDir应指向$DSH_HOME内。)
给 AI Agent
若由 AI Agent 代为在环境中安装:目标环境已启用「自定义插件索引」时,优先引导用户在发现 → 添加索引源填入上面的索引 URL(见「方式一」),再在发现页安装;用命令行安装或指定版本更新时执行 dsh plugin ... 命令,严禁手动编辑 cordis.patch.yml:
- 确认
dsh与pnpm处于 PATH 中; - 确定目标 profile(默认为
web); - 执行
dsh plugin --profile web add <tarball URL>; - 验证安装:
dsh plugin --profile web list或dsh --profile web --dump-config | grep chaoset; - 索引页安装默认不启用:引导用户在弹出的安装结果里点立即启用(或「已安装」列表打开开关);CLI 安装会同时写入
dsh.profile.bundles、默认启用。 - 一般无需重启:启用 HMR 的 web profile 会在线重组合;只有结果报
restart-required(或 profile 未启用 HMR)时才重启。卸载/更新用 CLI 时务必带--registry(见「常见安装排障」第一条)。 - 禁止在管理器之外动 profile:不要手工改 profile 的
package.json/dsh.profile.bundles/cordis.patch.yml/pnpm-workspace.yaml,不要在运行中的实例上删 profile 的node_modules或依赖。需要重建安装产物时先停掉dsh web,装完再启动。否则宿主会进入restart-required,GUI 里的安装/卸载/更新会报bundle-in-use(「其他配置仍在使用…」)——插件实现本身无法绕过这个宿主状态。
开发
本项目采用 Bun 作为包管理器(由根目录 packageManager 锁定),所有包源码均采用 TypeScript 开发。
bun install # 安装依赖(切分支后记得重新 install)
bun run build # 全仓构建:tsc 编译 host → 生成 Typert 工件 → esbuild 打包 client 与独立 CLI
bun run typecheck # 类型检查:host + client 两套 tsconfig --noEmit
bun run test # 运行 vitest 单元与集成测试
bun run test:ci # build + typecheck + test 门禁验证(提交/发版前必跑)
bun run dsh-status # 核对本地依赖基线 vs DSH 上游稳定/预发布线
bun run adapt <版本> # dsh 宿主升级适配(--dry-run 预览,详见 RELEASING.md)
bun run gate # 发布门禁干跑(检查 tag 与待发布包)
bun run audit # 依赖漏洞审计(基于 OSV.dev)
分支与版本规范
- 双分支跟随策略:
- 待命期(DSH 处于稳定线):无
alpha分支,所有功能与修复直接在main分支推进,版本号为纯 semver 正式版(如0.4.19),发布正式 Release。 - 活跃期(DSH 开启高于当前正式版的新
-alpha线):从main拉出alpha分支,版本号为-alpha.N(进 rc 后换-rc.N),发布预发布 Release。 - 收敛期:DSH 发完最新 rc 正式转正后,在
alpha适配去后缀转正,压缩合入main,发正式 Release 并彻底删除alpha分支。
- 待命期(DSH 处于稳定线):无
- 完整的发布流程、推送门禁与分支纪律详见 RELEASING.md。
No comments yet. Be the first to write one.