dsh-runtime-kitv0.1.0

dsh-runtime-kit

DSH 通用运行时插件 —— 复刻 WorkBuddy 级执行效率与沙箱环境，零业务依赖。

对标规格：DSH-快速执行与沙箱方案.md v2.1（§0–§8）

🎯 核心定位

📦 能力矩阵（对标 v2.1 §4）

🔌 对外契约：Registry（唯一耦合面）

// 工具注册
registry.registerTool({
  name: 'my_tool',
  description: '...',
  schema: { type: 'object', properties: {...} },
  isStateChanging: false,      // 是否触发屏障/审批
  returnBudget: 4096,          // 返回体预算
  timeout: 30000,
  handler: async (args) => ({ success: true, data: {...} })
});

// 模板注册（快路径）
registry.registerTemplate({
  name: 'my_template',
  match: (input) => input.startsWith('do something'),
  plan: [
    { tool: 'tool_a', args: { param: 'value' } },
    { tool: 'tool_b', args: (input, prev) => ({ data: prev.get('tool_a')?.data }) },
  ],
  idempotencyKeyFn: (input) => `my_template:${input}`
});

// 工作区注册（沙箱边界）
registry.registerWorkspace({
  profile: 'my-profile',
  root: '/absolute/path/to/workspace',
  networkAllowlist: ['api.example.com'],
  permissionMode: 'workspace-write',
  envPrefix: 'MY_',
  trusted: false,
});

插件不关心 handler 里跑什么——浏览器、HTTP、纯计算均可。

⚙️ 配置（完整 schema 见 config.schema.json）

{
  "context": { "maxReturnBytes": 4096, "fieldsProjection": true, "prunerEnabled": true, "compactionEnabled": true, "lazyLoadTools": true },
  "loop": { "preset": "code", "disabledLayers": ["plan","todo","goal","subagent"], "maxParallelToolCalls": 8, "enableCustomLoop": false },
  "sandbox": {
    "mode": "workspace-write",
    "approval": "ask",
    "rules": {
      "files": [{ "pattern": "**/*.secret", "read": "deny", "write": "deny", "delete": "deny" }],
      "commands": [{ "prefix": "rm -rf", "action": "ask" }],
      "network": [{ "domain": "api.github.com", "action": "allow" }]
    },
    "networkDefault": "deny",
    "backupEnabled": true,
    "deletionProtection": true,
    "injectionGuard": true,
    "sensitiveProtection": true,
    "shell": "pwsh",
    "workspaceTrust": false,
    "toolControl": { "dangerous_tool": false }
  },
  "audit": { "mode": "append-only", "desensitize": true, "exportable": true, "retentionDays": 90 }
}

🧪 验收指标（§6，纯通用夹具，零业务）

测试夹具：echo / kv_get/kv_set / file_read/file_write + 两个临时目录 / http_probe / echo-chain 模板 / crash_tool

🚀 快速开始

cd D:Dshdsh-pluginsdsh-runtime-kit
pnpm install
pnpm build

在 DSH profile 中启用：

{
  "plugins": {
    "dsh-runtime-kit": {
      "enabled": true,
      "config": { /* 见上方配置示例 */ }
    }
  }
}

📋 管理命令

# 健康检查
runtime_kit_health

# 配置核对 / 应用预设
runtime_kit_config [minimal-no-orchestration|code-ptc-friendly]

# 指标查看
runtime_kit_metrics

# 审计日志
runtime_kit_audit_logs [profile] -t <tool> -a <action> -r <result> -s <date> -l 50

# 隔离验证
runtime_kit_isolation <profile>

# 快路径执行
runtime_kit_fastpath "echo-chain:test" [profile]

# PTC 执行
runtime_kit_ptc 'callTool("echo", {"text":"hi"})' [profile]

# 注册表查看
runtime_kit_registry_tools
runtime_kit_registry_templates
runtime_kit_registry_workspaces

🏗️ 内部架构

src/
├── types.ts              # 所有类型定义（零业务）
├── registry/             # 唯一对外耦合面
├── context/              # C1 上下文治理（中间件）
├── sandbox/              # C6 沙箱（路径/网络/命令/工具/快照/回收站/注入/脱敏/shell/执行域）
├── audit/                # C7 审计（append-only + 脱敏 + 指标）
├── loop/                 # C2 快路径 + C3 PTC + C5 并发/恢复
├── preset/               # C4 编排裁剪补丁
└── index.ts              # 插件主入口，组装所有能力

📌 实施阶段（§7）

每阶段独立验收，无需任何业务信息。

⚠️ 禁止项（§8.2）

1. 禁止在插件内引用任何业务脚本、记忆文件、账号、选择器、登录态
2. 禁止内置任何具体任务模板或业务参数
3. 禁止把工具返回的大对象、二进制、日志全文塞进 context
4. 禁止把 danger-full-access 设为默认；禁止策略异常时降级放行
5. 禁止依赖 git bash 或任何绕开受限令牌的 shell 适配
6. 禁止在验收夹具里出现真实业务系统、真实 URL、真实凭据
7. 禁止在主力 profile 直接试用未经验证的第三方 loop 实现
8. 禁止让插件核心 import 使用方代码——耦合只允许发生在 registry

🔗 关键参考

• 规格书：C:UsersAWorkBuddy2026-10-31-23-20-43DSH-快速执行与沙箱方案.md (v2.1)
• WorkBuddy 官方文档：附录 C 证据索引
• DSH 运行时：D:软件Deepseek Harnessresourcesapp.asardsh