dsplugins — DSH 插件管理工作区

DeepSeek Harness (DSH) 插件仓库管理目录。所有 DSH 自研/本地插件必须进入本目录， 每个插件独立成一个 git 仓库，统一推送到 LosEcher GitHub 账号。

目录职责边界（2026-08-15 约定）

• dsplugins/：DSH 插件的唯一本地归宿（自研插件 + 需要本地开发的第三方插件）。
• dsfolder/：执行目录（业务项目、los 网关代理等非插件服务），不再放置任何插件。
• 纯第三方插件（如 dsh-tool-ocr）走 npm / github: 依赖 + profile patch 激活， 不占用本地目录；仅当需要本地改造时才在 dsplugins 建仓。
• profile 依赖统一指向 link:/Users/echerlos/syncfolder/project/dsplugins/<name> （开发期）或 github:LosEcher/<name>#main（发布后），禁止再指向 dsfolder。

仓库清单

全量登记（2026-08-26 重建，此前版本仅登记 12 项且多处过时）。 2026-09-22 按实装版本复核一次：逐目录比对 <plugin>/package.json 与 ~/.dsh/profiles/web/node_modules/<plugin>/package.json（命令见文末「状态自检」）， 修正 kimi-webbridge-mcp 1.0.x→1.2.0、dsh-scheduler 0.3.x→0.4.0、dsh-context-doctor 0.5.x→0.7.2， 并删除重复的 dsh-channel-telegram 行（原有两条）。 状态口径：✅ github:=已发布且 web profile 依赖为 github:LosEcher/<name>#main；✅ 已发布/link:=已发布但 profile 仍用本地 link:（迭代中）；📦 本地=未发布；⚠️ 停用=已停用（disabled）。

插件	GitHub	状态	说明
dsh-jj	LosEcher/dsh-jj	✅ github:（1.0.1）	jj (Jujutsu) MCP server bundle（自研零依赖，14 工具 + CI 冒烟全绿）
kimi-webbridge-mcp	LosEcher/kimi-webbridge-mcp	✅ github:（1.2.0）	Kimi WebBridge MCP server（浏览器控制，跨 DSH/Claude Code/Codex；快环 obs/act/open_tab + 会话信任守卫）
dsh-terminal-render	LosEcher/dsh-terminal-render	✅ github:（0.1.x，web+headless 双挂载）；本地目录无 origin（保留作 dev 副本）	终端渲染（kitty/sixel 图片协议）
dsh-web-mobile-fork	LosEcher/dsh-web-mobile	✅ github:（@dsh-external/dsh-mobile-nav）	移动端导航 fork（tailscale serve + triage）
dsh-scheduler	LosEcher/dsh-scheduler	✅ 已发布 0.4.0；profile 当前 link:（迭代中，空闲切回 github:）	定时任务（cron/interval/once + headless 执行 + job.model 模型链 + 熔断 + 事件溯源台账 + 0.4.0 机械验收断言/台账归档轮转/派发延迟可见性 + 管理 UI）
dsh-dashboards	LosEcher/dsh-dashboards	✅ 已发布（8/18；8/26-28 已补 origin 并推 GitHub，v0.1.0）；profile link:	看板（los 用量/节点矩阵 + macOS 探针 + 服务探活 + AI 额度 + 磁盘水位告警）
dsh-semantic-eviction	LosEcher/dsh-semantic-eviction	✅ 已 public（workspace:^ 依赖已修 852a132）；未挂载任何 profile；⚠️ 仓库未提交 lib/ 且无 prepare 脚本 → github: 安装当前不可用（DSH CLI 靠 prepare 构建，待补）	语义逐出：大工具结果落盘后替换为 stub
dsh-context-doctor	fork 自 Zhenyu98（upstream remote 保留）；⚠️ origin 仍指 Zhenyu98（待建 LosEcher 仓改指后 README 切 github: 源）	📦 本地（0.7.2）；profile link:	上下文压缩可视化；dock 槽位迁移 + 令牌清理已修活（fork 原因见下）
dsh-multimedia	待发布	📦 本地（0.2.0）；profile link:	多媒体生成（fal/elevenlabs/comfyui/xai/zenmux/pollinations/googletts/cloudflare）
dsh-verify-gate	LosEcher/dsh-verify-gate	✅ 已发布（8/26，public/MIT/main@7f84e45，v0.1.0，origin 已建）；profile 仍 link:（web+headless）	verify_run 工具（包装 verify-gate 二进制，exit 契约映射）
dsh-quick-actions	待发布	📦 本地；profile link:	IFTTT 风格右键动作引擎（todo.add/session.create 等，runs.jsonl 台账）
dsh-code-analysis	待发布	📦 本地；profile link:	CBM 代码知识图谱接入（mcp__cbm__*，本机 allowlist 10 工具）
dsh-health-panel	待发布	📦 本地；profile link:	DSH 观测面板（client 半包，host 指标 API；Wave3 拟并入 code-analysis）
dsh-telemetry	待发布	📦 本地；profile link:	client 崩溃上报（window error/unhandledrejection + data-slot-error）+ spill/checkpoint 记账
dsh-access-gate	待发布	📦 本地；profile link:	移动访问码网关（:3088，访问码鉴权）
dsh-mobile	待发布	📦 本地；profile link:	移动接入（tailscale serve + Web Push + triage）
dsh-feishu-outbound	待发布	📦 本地；profile link:	飞书主动推送（__dshChannelNotify.feishu）
dsh-los-ops	待发布	📦 本地；profile link:	DSH→los 治理操作面（los_gov_* 工具）
dsh-restart-banner	待发布	📦 本地；未挂载任何 profile（web/headless 均未安装，备选插件）	重启 banner（shell.overlay，harness 侧已原生支持，本插件为备选）
dsh-terminal-browser	待发布	📦 本地（git 087d4ef）；disabled:true 按需启用	终端内浏览器（tb_open/ls/action/close，guardrails 白名单；启用步骤见其 README）
dsh-theme-tune	待发布	📦 本地（0.1.0）；profile link:	主题令牌覆盖：全局对比度矫正
dsh-mcp-common	不发布	📦 本地；profile link:	MCP 公共工具（context7 已 disabled；开源评审结论 REBUILD-or-DROP）
dsh-channel-wechat	不发布	⚠️ 停用（2026-08-17，weclaw 全面停用；cordis.patch.yml disabled:true）	微信渠道插件（weclaw 桥接）；恢复需重扫 weclaw 登录
dsh-channel-telegram	LosEcher/dsh-channel-telegram	✅ github:（0.1.x）；⚠️ 2026-08-30 起 disabled（未配置 TELEGRAM_BOT_TOKEN，152 条 ERROR 噪音；恢复=去 disabled + 配 token）	Telegram 薄桥（长轮询 Bot API，allowlist，每聊一会话；CI mock 单测）
install-first-batch.sh	—	历史脚本	第一批社区插件安装（2026-08-15）

第三方依赖（不占本地目录，走 github:/npm:）

依赖	来源	说明
dsh-llm-fallbacks	github:omdsh-dev/dsh-llm-fallbacks#main	模型 fallback 链（Auto 路由）
dsh-memory-evolve	github:csyangwen/dsh-memory-evolve#main	记忆/待办/技能工具（memory/dtodo/skill_manage）
dsh-subagent-tools	github:lynx-gt/dsh-subagent-tools#master	子代理增强工具
dsh-lark-channel	npm ^0.0.7	飞书渠道
dsh-session-pin	npm ^0.3.1	会话置顶
dsh-tool-ocr	npm ^0.1.3	OCR 工具（nbocr 引擎）
nowledge-mem-deepseek-harness	github:nowledge-co/...	Nowledge Mem 上下文包
@zenmux/dsh-plugins	github:ZenMux/dsh-plugins	ZenMux 额度插件
dsh-undo	link:/Users/echerlos/syncfolder/project/dsh-undo	⚠️ 本地 dev 副本（第三方，未迁移进 dsplugins）

结构约定

dsplugins/
├── README.md                  # 本索引（仓库清单 + 目录职责边界）
├── install-first-batch.sh     # 第一批社区插件安装脚本
├── <plugin-name>/             # 每个插件一个独立 git 仓库
│   ├── package.json           # dsh.bundle.patch → cordis.patch.yml 声明
│   ├── cordis.patch.yml       # profile 补丁层
│   ├── src/                   # host 半 + client 半
│   └── tests/
└── .gitignore                 # 忽略插件子目录（子目录各自是独立仓库）

新建/迁移插件的标准流程

# 1. 脚手架起步（参照 dsh-semantic-eviction 结构；迁移则直接搬入）
mkdir -p dsplugins/<plugin-name>/src/client dsplugins/<plugin-name>/tests

# 2. 初始化独立仓库
cd dsplugins/<plugin-name>
git init -b main
git add -A && git commit -m "feat: <plugin-name> — <一句话>"

# 3. 发布到 GitHub（LosEcher 账号）
gh repo create LosEcher/<plugin-name> --public --source=. --remote=origin --push

# 4. 安装到 DSH（发布前用 link: 本地开发，发布后切 github:）
dsh plugin --profile web add link:/Users/echerlos/syncfolder/project/dsplugins/<plugin-name>
dsh plugin --profile web add "github:LosEcher/<plugin-name>#main"

第三方插件安装（不占本地目录）

以 dsh-tool-ocr 为例（plain plugin，非 bundle，add 只装依赖不自动挂载）：

# 1. 引擎（可选，取决于插件）：nbocr 已装 ~/.local/bin/nbocr
# 2. 安装依赖
dsh plugin --profile web add dsh-tool-ocr          # npm 源
# 3. profile patch 激活（cordis.patch.yml insert 行，见 ~/.dsh/profiles/web/cordis.patch.yml）
- insert:
    - id: ocr
      name: dsh-tool-ocr
      inject: [tools, subprocess, systemPrompt]
      config:
        command: '/Users/echerlos/.local/bin/nbocr'
        language: 'chinese'
        detModel: 'v6-tiny'
# 4. 重启 dsh web（新插件必须重启，HMR 不加载新模块）→ RPC 插件树验证 active

注意：cordis.patch.yml 的 insert 块编辑后别重复 reapply（loader 对重复 entry id 拒绝）； 激活行属于 profile 配置层，不属于任何插件目录。

外部插件 fork（样式/兼容性调整后引入）

外部插件（github:/npm: 安装）存在样式不合标准或与当前 DSH 版本不兼容（如槽位改名）时， fork 到 dsplugins 调整后引入（流程详见技能 dsh-plugin-operations「外部插件样式可优化 → fork 流程」）：

• dsh-context-doctor（已 fork，2026-08-15）：上游注册在已移除的 conversation.input.context 槽位 → GUI 完全不渲染；fork 迁移到 conversation.input.dock（list 槽需 id+order）后 UI 修活；同时清理 TONE 常量里的 深色 fallback hex（令牌缺失时浅色主题错乱）、MONO 改 var(--dsw-font-family)。 profile 已切 link:dsplugins/dsh-context-doctor，upstream remote 保留可合上游。

• dsh-memory-evolve（已 fork，2026-09-22；本地提交 46422bb，基线 upstream/main@c337dc1）： 上游 src/client 用了 24 个不存在的 --dsw-alias-* 令牌（border-l×39、bg-elevated、 text-tertiary、state-warning-* 等），渲染时静默 fallback 到硬编码 hex → 浅色/深色主题错乱。 fork 后按「作者 fallback 色值 + harness 自身用法频次」双校准完成 88 处替换，重建 lib/client.js （产物非法令牌 0、React.createElement 0），测试与原始副本逐项一致（829/827/2，2 个失败为 rg 不在 PATH 的环境性失败）。映射全表与验收/启用/回滚步骤见 dsh-memory-evolve/FORK.md。 ⚠️ 尚未激活：profile 仍用 github: 依赖；切换 link: + pnpm install 会触发宿主 AUTO-RELOAD 重启，需在受控窗口执行（步骤见 FORK.md 末节）。

安装脚本

install-first-batch.sh 安装第一批社区插件（context-doctor / llm-fallbacks / subagent-tools / revive / undo / memory-evolve / session-search）：

bash install-first-batch.sh            # 全部安装
bash install-first-batch.sh --dry-run  # 预览

状态自检（2026-09-22 起，防本表再次漂移）

逐目录比对源码版本与 web profile 实装版本，输出不一致项：

cd /Users/echerlos/syncfolder/project/dsplugins
for d in */; do n=${d%/}; [ -f "$n/package.json" ] || continue
  src=$(node -e "console.log(require('./$n/package.json').version||'-')")
  ins=$(node -e "try{console.log(require(process.env.HOME+'/.dsh/profiles/web/node_modules/$n/package.json').version)}catch(e){console.log('(未装)')}")
  [ "$src" = "$ins" ] || printf '%-26s src=%s installed=%s\n' "$n" "$src" "$ins"
done

注意：(未装) 对 dsh-restart-banner / dsh-semantic-eviction / dsh-web-mobile-fork 属预期（未挂载）；其余出现 (未装) 或版本不等即需回填本表。 建议把这条自检挂进 DSH 生态周盘点定时任务（job-d9380cbe-caf）的 prompt。