🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

源码精读与插件集 nutsDad/hello-dsh

DeepSeek Harness
nutsDad71 天前有提交已提供中文文档扫描:含敏感能力

读懂内核源码并加载十个实用插件

30.9/100
综合分
6
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/27 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过:缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。以下命令仍可尝试,但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add nutsDad/hello-dsh
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · tool
装得上吗
本站已真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 71 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包deepseek-harness-community-plugins(未发布到 npm,仅可源码安装)
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/12 06:05:06

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件
查看扫描证据(共 2 处,展示前 2 条)
  • 写入本地文件
    src/session-audit-jsonl.ts:26
    mkdirSync(dirname(file), { recursive: true })
  • 写入本地文件
    src/session-audit-jsonl.ts:27
    const stream = createWriteStream(file, { flags: 'a', encoding: 'utf8' })
扫描于 2026/11/3(1 天前) · 范围 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 中文源码解析
  • 加载十款实用插件

DeepSeek Harness 中文源码解析与十款实用 Cordis 插件

README

由 DeepSeek 最新模型翻译生成
DeepSeek Harness 中文源码精读与 10 个实用插件 这是对 deepseek-ai/deepseek-harness 固定提交 b150a551b8d465e31e418e1b2eaf5e79bbb7d28e 的中文源码分析,以及 10 个可独立加载的 Cordis/Harness 插件。 交付内容 - 完整源码分析:架构图、启动链、Cordis 内核、插件框架、Agent Loop、Session、LLM、Tools、SystemPrompt 与逐段代码示例; - 源码包全索引:自动扫描 253 个含 manifest 的项目,列出路径、包名、用途、源码数和测试数; - src/:10 个严格 TypeScript 插件; - tests/plugins.spec.ts:18 项无网络测试; - scripts/render-patch.mjs:生成当前机器可直接加载的 Cordis overlay; - examples/community-plugins.template.cordis.yml:可读的完整配置模板(实际运行建议由脚本生成绝对路径版)。
展开完整文档(README 剩余 1 节)
DeepSeek Harness 中文源码精读与 10 个实用插件

这是对 deepseek-ai/deepseek-harness 固定提交 b150a551b8d465e31e418e1b2eaf5e79bbb7d28e 的中文源码分析,以及 10 个可独立加载的 Cordis/Harness 插件。

交付内容

- 完整源码分析:架构图、启动链、Cordis 内核、插件框架、Agent Loop、Session、LLM、Tools、SystemPrompt 与逐段代码示例;
- 源码包全索引:自动扫描 253 个含 manifest 的项目,列出路径、包名、用途、源码数和测试数;
- src/:10 个严格 TypeScript 插件;
- tests/plugins.spec.ts:18 项无网络测试;
- scripts/render-patch.mjs:生成当前机器可直接加载的 Cordis overlay;
- examples/community-plugins.template.cordis.yml:可读的完整配置模板(实际运行建议由脚本生成绝对路径版)。

10 个插件

| 插件 | 默认用途 | 主要配置 |
| tool-allowlist | 每个 Agent 的工具白/黑名单 | allow, deny |
| tool-command-firewall | 单调拒绝明显破坏性命令 | tools, argumentPatterns, reason |
| tool-approval-policy | 高风险工具先请求审批 | tools, argumentPatterns, reason |
| tool-secret-redactor | 拦截可能包含凭证的工具结果 | patterns, feedback |
| tool-latency-monitor | 记录慢工具 | thresholdMs, loggerName |
| llm-stream-metrics | 首 chunk、总流时长和 usage | thresholdMs, loggerName |
| session-audit-jsonl | 追加写 Session 事件审计 | file(必填) |
| step-budget | 限制单 turn 的模型 steps | maxStepsPerTurn, warnAtStep |
| system-prompt-policy | 添加有序部署政策 | text(必填), sectionName, order, complete |
| tool-failure-coach | 连续工具失败后提示换策略 | threshold |

使用方式

上游 master 的接口比当时 npm 发布包更新,因此本仓库以“检出到固定 Harness 源码内”的方式保证可复现:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
git checkout b150a551b8d465e31e418e1b2eaf5e79bbb7d28e

把本仓库检出为这个目录(把 URL 换成发布后的地址)
git clone community-plugins
pnpm install --frozen-lockfile

cd community-plugins
pnpm run build
pnpm run typecheck
pnpm run test
node scripts/render-patch.mjs

cd ..
pnpm dsh web --patch ./community-plugins/examples/community-plugins.cordis.yml

render-patch.mjs 会把模块名写成构建产物的绝对 file: URL。请先修改生成 YAML 中的配置;示例全开只是为了展示,不代表每个部署都应启用全部插件。

验证

TypeScript build PASS
Strict typecheck PASS
Vitest 18 passed / 18
Network calls in test 0

测试使用上游源码作为真实类型边界,覆盖 Cordis listener 注册、waterfall next() 合作、单调 guard、流顺序、Session flush/dispose 和配置失败。

兼容性与边界

- 基准:DeepSeek Harness b150a551 / 0.1.1-rc.2;
- Node:^22.19.0 || >=24.0.0;
- 插件是 Harness/Cordis 运行时插件,不是 Codex .codex-plugin;
- 防火墙与 secret regex 是纵深防御,不替代 OS 沙盒、最小凭证权限和数据保留政策;
- JSONL 审计可能含敏感会话内容,生产环境必须额外处理权限、加密、轮转与保留期。

许可证

本仓库代码使用 MIT。上游 DeepSeek Harness 的代码与文档仍按其自身许可证提供;本仓库没有复制其完整源码。
预览分享卡片长什么样 ↓nutsDad/hello-dsh
分享 · DeepSeek Harness Hub
nutsDad/hello-dsh

读懂内核源码并加载十个实用插件

这是你的仓库?认领条目

回到顶部