dsh-dynamic-toolbox

A session toolbox for DeepSeek Harness: 1 framework + 28 tool plugins as dynamic Cordis plugins · MIT License

中文文档见下方 中文 section。

Every plugin is mounted through a disk-loading stub: the payload is a ~0.9KB stub, the implementation lives on disk, so code edits take effect by simply re-running the plugin — no re-define, no re-approval.

Features

• Framework plugin (tbx): Host-side tool registry + RPC, Client-side drawer / tab bar / shared HTML panel shell (tb- design system)
• Project tools: Jira (query/archive), Git (history/diff), workspace file tree
• Utilities: trace, HTTP client, ports, regex tester, codec, text diff, cron explainer, generator
• Session insight: token usage, system-prompt assembly, context window, tool list, full-text search, lineage tree, multi-model compare
• AI tools: ask, translate, prompt optimizer, commit message, code review, session summary, usage ledger — all routed through a shared makeLlmHelper
• Self-inspection: selfview (screenshot / semantic snapshot / ui_* model tools)
• Bootstrap rebuild: the framework auto-defines and starts all missing plugins from plugins.json on startup (idempotent, ~0.4s for all 28), honoring per-plugin enable memory
• Contract smoke tests: node smoke.mjs runs 13 simulation suites against real plugin impls with mocked ctx/services

Quick start (as a user)

Prerequisites: DeepSeek Harness running with dynamic-plugin (Cordis) support; a workspace directory.

1. Clone this repo and open the repo root as your DSH workspace (repo root = workspace root)
2. In a DSH session: cordis_define ← plugins/toolbox/payload.json
3. cordis_run and approve once in the GUI
4. The framework auto-bootstraps the remaining 28 plugins (selfview asks for one more approval)

Credentials (e.g. Jira) live in the Harness credential store or environment variables — never in this repo. Full guide: REBUILD.md, plugin authoring: PLUGIN-DEV.md.

License

MIT © 2026 Iwctwbh

---

中文文档

DSH 工具箱（动态 Cordis 插件集）· MIT License

运行在 DeepSeek Harness 上的会话级工具箱：1 个框架插件 + 28 个工具插件， 全部以「磁盘加载桩」方式挂载——payload 是 ~0.9KB 的桩，实现全在磁盘，改代码重跑即生效。

使用（把本仓库装进你的 DSH）

前置：已安装并运行 DeepSeek Harness（支持动态 Cordis 插件）；有一个工作区目录。

1. 将本仓库 clone 下来，并把仓库根目录作为 DSH 工作区打开（仓库根 = 工作区根）
2. 在 DSH 会话中：cordis_define  ←  plugins/toolbox/payload.json
3. cordis_run，并在 GUI 批准一次
4. 框架启动自动补齐其余 28 个插件（幂等，全量 ≈ 0.4s；selfview 会再弹一次批准）

• 启动集合遵循启停记忆 <工作区>/.dsh-dynamic-toolbox/toolbox-plugins.json
• 主题插件（青绿/暖橙）只 define 不启动，互斥按需激活
• 凭据（Jira 等）走 Harness 凭据存储或环境变量，不写入本仓库任何文件
• 无框架时的手动路径与完整细节见 REBUILD.md

目录结构

（仓库根 = 工作区根）
  plugins.json          重建总清单（决策元数据）
  make-payloads.mjs     单一事实源：PLUGINS 表 → 生成全部 payload + 语法检查
  smoke.mjs             契约冒烟入口（node smoke.mjs 全量回归）
  loader.js             磁盘级加载器（桩的固定入口）
  shared/host.js        共享辅助（注册重试/持久化/AI 助手 makeLlmHelper 等）
  plugins/<key>/        文件夹即插件：plugin.json + payload.json + impl
  REBUILD.md            重建/迭代/数据结构完整指南
  PLUGIN-DEV.md         新插件编写指南与面板契约
  插件.md               动态插件开发踩坑实录

插件清单（29）

分组	插件
框架	toolbox（Host 注册表 + Client 抽屉/Tab/面板壳）
项目工具	jira（查询/归档）、git（历史/diff）、files（文件树）
主题	theme-teal / theme-amber（互斥，按需激活）
实用工具	trace、http、ports、regex、codec、txtdiff、cron、gen
会话洞察	usage、prompt、context、tools、search、lineage、compare
AI 工具	ask、translate、promptopt、commitmsg、review、aisummary、aiusage（台账）
界面自查	selfview（截屏/语义快照/ui_* 模型工具）

日常迭代

改 plugins/<key>/tool.js（或 framework、shared、loader）
  → 抽屉齿轮「重跑」该行即生效（不用重新 define/批准）
  → 批量改完点「全部重跑」
插件增减/改 inject → 编辑 make-payloads.mjs 的 PLUGINS 表
  → node make-payloads.mjs 重新生成 + 语法检查
改 shared/framework/面板协议 → 必跑 node smoke.mjs

数据与隐私约定

以下内容不入库（见 .gitignore）：

路径	内容
.dsh-dynamic-toolbox/	运行状态与历史：Jira 查询记录、AI 台账、启停记忆、自动补齐报告
.dsh-dynamic-toolbox/data/	内容产物：Jira 工单归档（issue.md/json + 附件）
.scratch/	开发草稿/一次性脚本

文档索引

• REBUILD.md — 目录结构、重建、迭代、数据与凭据
• PLUGIN-DEV.md — 新插件三步、impl 骨架、面板契约
• 插件.md — 心智模型与真实坑清单

License

MIT © 2026 Iwctwbh