GinerYard/dsh-chords 预览 preview

GinerYard/dsh-chords

Bundle捆绑包 ⭐ 3 MIT Runtime & Injection运行时与注入

A chord between code and natural language — CHORDS = Code Harness, Online Reference for DeepSeek.

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), called Chords, which adds a dual-pane card view for code generation and editing inside DSH. The left pane displays code with syntax highlighting and line numbers, while the right pane shows chunked natural language pseudocode explanations for each section of code. It comes with a range of quality of life features, including certainty labeling, linked anchor highlighting, in-place editing, version history, persistence, and tiered model routing based on code size. It also automatically switches to an English interface when running on non-Chinese system locales.

The plugin is designed for DSH users who generate and maintain code with natural language explanations inside agent conversations. When you ask the DSH agent to write code, the plugin is called automatically, and outputs the result as a dual-pane card instead of duplicating the code in the conversation text. You can hover over explanation blocks to highlight matching code lines, click either pane to scroll the other to the matching section, and make both block-level edits and full algorithm redesigns, all without cluttering your conversation history. Only one edit can run at a time per card, and you can stop an in-progress edit at any point.

To install the plugin, you need to have DeepSeek Harness version 0.1.0-rc.6 or an API-compatible version already installed, plus a working configured model route. It defaults to the deepseek-official model provider, but supports other providers as long as their corresponding DSH adapters are installed. Installation requires copying the plugin directory to your DSH node_modules and registering it in the cordis config before restarting DSH. The plugin is open source under the MIT license, all data is stored locally, idle documents expire after 14 days, and session data is automatically cleaned up when the session ends.

dsh-chords 是专为 DeepSeek Harness 开发的原生插件,提供代码生成与编辑的双栏卡片展示能力。左侧是带语法高亮和行号的代码区,右侧是分块的自然语言伪代码说明,支持确定性标签标记、锚点高亮联动、原地编辑、版本历史、持久化存储等功能,还能根据代码长度自动选择对应模型档位和思考级别,适配非中文系统自动切换英文界面。

对于需要在 DSH 对话中生成、维护带自然语言说明的代码的用户,该插件会在 agent 生成代码时自动调用,以双栏卡片形式呈现结果,不会在对话正文中重复粘贴代码。用户可以悬停查看对应代码行高亮,点击任意一侧让对侧滚动居中,还支持块级精修和整体算法重设计,所有修改都在后台完成,不会污染对话历史。

该插件要求已安装 DeepSeek Harness 0.1.0-rc.6 或 API 兼容版本,且配置可用的模型路由,默认使用 deepseek-official,其他厂商需要对应适配器已安装。插件采用 MIT 许可开源,所有数据都存储在本机,闲置 14 天自动过期,会话销毁后会自动清理数据,无额外隐私风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:GinerYard/dsh-chords

把 GinerYard/dsh-chords 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

封面

dsh-chords · Chords(和弦)

DeepSeek Harness 插件:代码与自然语言的和弦;CHORDS = Code Harness, Online Reference for DeepSeek.

A DeepSeek Harness plugin: a chord between code and natural language — CHORDS = Code Harness, Online Reference for DeepSeek.

版本 Version: 0.3.3 | 兼容 Compatible with: DeepSeek Harness 0.1.0-rc.6


功能特性 / Features

  • 双栏卡片:左侧代码(语法高亮 + 行号),右侧分块伪代码(通俗易懂的自然语言) Dual-pane card: code on the left (syntax highlight + line numbers), chunked pseudocode on the right (real natural language, never if/for/new keywords)
  • 三色确定性标签:🔵 明确(用户要求)/ 🟡 推测(上下文推导)/ ⚪ 默认(惯例填充) Certainty labels: 🔵 Explicit / 🟡 Inferred / ⚪ Default
  • 锚点高亮:悬停解释块 → 对应代码行整行琥珀色高亮;点击任一侧 → 对侧滚动居中 Anchor highlighting: hover a pseudocode block to light the exact code lines; click either side to center the counterpart
  • 原地编辑:✎ 修改(块级精修)/ ✎ 改算法(整体重设计);后台 LLM 完成,对话完全零污染 In-place editing: block-level edits and whole-card redesigns run in the background — the conversation stays untouched
  • 版本历史:◀ ▶ 浏览任意历史版本;基于任意版本修改都追加为最新版本;每卡上限 20 版 Version history: browse any past version with ◀ ▶; edits based on any version always append as the newest; 20 versions per card
  • 重命名:点击标题即可改名;改名链保证旧标题查询依然命中、刷新后依然生效 Rename: click the title to rename; the rename chain keeps old titles resolvable across refreshes
  • Agent 集成:后台修改自动进入运行时上下文;chords_current / chords_list / chords_history 供 agent 查询任意版本 Agent integration: background edits surface in the runtime context; three query tools let the agent read any version
  • 持久化:文档、历史、改名链落盘,重启存活;TTL 自动老化;会话销毁即清理 Persistence: docs, history and rename chains survive restarts; TTL aging; cleaned up on session disposal
  • 自动国际化:非中文系统自动切换英文界面 Auto i18n: English UI on non-Chinese systems
  • 分层模型路由:按代码长度自动选择模型档位与思考级别(见下文) Tiered model routing: model tier and reasoning level follow the code size (see below)

环境要求 / Requirements

  • DeepSeek Harness 已安装(dsh 命令可用,web profile 可启动),版本 0.1.0-rc.6 或 API 兼容 DeepSeek Harness installed (the dsh command works and the web profile boots), version 0.1.0-rc.6 or API-compatible
  • 模型路由可用(默认 deepseek-official;其他厂商需对应适配器已安装) A usable model route (deepseek-official by default; other vendors need their adapters installed)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-tool-json 下一个 Next dsh-model-capabilities →