KannaKuron/dsh-ptc-cordis-preset

dsh-ptc-cordis-preset

Awesome DSH Plugin

简体中文 | English

PTC 模式基础上的创造模式 —— 给 DeepSeek Harness (DSH) 补上第四种组合:Code Mode 工具编排 × 创造能力。

DSH 内置四个 preset:标准(standard)、PTC(code,dsh 0.1.2 起改名为 ptc,标准之上用 Code Mode SDK 把工具呈现为一个 TypeScript 程序)、极简(minimal)、创造(cordis,标准之上叠加自引用 Cordis 工具与 preset 创作指导)。

内置的创造模式建立在标准模式之上。本插件提供缺失的那一格:PTC 创造模式(ptc-cordis)—— PTC 模式的全部能力原样保留(包括 tool-presentation 的 Code Mode 呈现),叠加创造模式的全部增量:

- 🧬 自引用 Cordis 工具 — cordis_inspect / cordis_define / cordis_run / cordis_stop / cordis_undefine:读运行时、定义/运行/停止动态插件包
- 📐 双平面创作指导 persona — 主机组合 vs Agent preset 的取舍规则,外加 Code Mode 下的组合方式(把 cordis 工具当 SDK 函数写进 run_code 程序)
- 📚 composition 创作技能随行 — editing-cordis-compositions / cordis-plugin-development 两个 skill 跟着 preset 走
- 🎛️ workflow 开关(设置卡,v0.8.0) — 官方 PTC 模式自 dsh 0.1.2-alpha.4 起默认不提供 workflow 工具(run_code 已是唯一模型编排面),而创造模式保留它;本插件默认提供(继承创造模式能力,与历史版本一致)。设置 → 插件 → 「PTC 创造模式」卡片可一键切换:切换即时重物化,新会话即刻生效(已打开的会话保持原组合);需要 dsh ≥ 0.1.2

也就是说:在 PTC 创造模式的会话里,你可以让模型一边用 Code Mode 单程序组合多步操作,一边检查活运行时、试验动态插件、创作新的 agent preset。

安装

dsh plugin --profile web add dsh-ptc-cordis-preset   # npm 公开包
源码与 Release: https://github.com/KannaKuron/dsh-ptc-cordis-preset

本插件是纯 JS、零构建、零依赖,安装不触发 pnpm 构建脚本,无需 allowBuilds 放行。装完重启 DSH(host 半变更),新建会话时在模式选择器里选 「PTC 创造模式」 即可。

工作原理

DSH 的 preset roster(agentPresets 服务)每次 list() 都重扫各根目录——进程运行中落盘的 preset 立即可见。本插件在启动时把 ptc-cordis preset 物化到第一个 user 信任根(默认 ~/.dsh/.agent-presets/ptc-cordis/):

┌────────────────┐  启动时物化   ┌─────────────────────────────┐
│  dsh 插件       │ ───────────▶ │ ~/.dsh/.agent-presets/       │
│ (host 半)      │              │ └─ ptc-cordis/               │
└───────┬────────┘              │    ├─ agent.cordis.yml  合成组合 │
│                       │    ├─ preset.yml         显示名  │
│ skills/ 从本机已装的    │    ├─ skills/            创作技能 │
│ cordis preset 现场拷贝  │    └─ .plugin-managed.json 标记 │
└──────────────────────▶└─────────────────────────────┘
roster 下一次 list() 即刻可见 → 出现在模式选择器

- 合成组合:assets/agent.cordis.yml = 内置 code preset 原封不动 + cordis preset 的增量(persona / tool-cordis / customSkillDirs)
- 技能随部署走:skills/ 不是仓库里的快照,而是从本机已安装的内置 cordis preset 现场拷贝,DSH 升级后重新物化即跟随更新
- 用户优先,哈希标记:.plugin-managed.json 记录物化时每个文件的 sha256。未改动 → 插件升级时原位刷新;你改过任何文件 → 插件从此不再碰它(启动不覆盖、卸载不删除);一个没有标记的 ptc-cordis 目录是你自己建的 → 插件完全不接管
- 安静启动(v0.2.1 起):目录未改动、插件版本未变、且本机 cordis preset 的 skills 源哈希一致 → 启动不重写任何文件、不打印任何日志。一行物化日志只在首次安装、插件升级或 skills 源变化(如 DSH 升级)时出现;例行的「已是最新」降级为 cordis logger 的 debug 级(ptc-cordis 命名空间)
- 双 era 组合文本(v0.7.0 起):内置 code/ptc preset 各有一份已提交的组合文本,启动时探测本机 dsh 自动选择(见下节)

dsh 版本双适配(0.1.1 与 0.1.2+)
dsh 0.1.2 把内置 code preset 改名为 ptc(mode: code → mode: ptc,官方明确不做兼容别名),组合文本因此分 era。本插件同时携带两个 era 的完整组合文本,启动时探测内置 roster 里是 ptc 还是 code 自动选择,并记进 .plugin-managed.json 的 base 字段:

- 先升级插件、后升级 dsh:插件先按 code era 物化;dsh 升级后下次启动探测翻转,自动重物化为 ptc era,无需任何手动操作;
- 先升级 dsh、后升级插件:窗口期内旧版插件物化的 code era 文本在新版挂载失败(新版 roster 会把它标为 broken),装上本版插件重启即恢复;
- 老规矩不变:你改过的 preset 一律不碰,删掉目录即可让插件重新物化。

dsh 0.1.6 适配(工作流引擎行改名)

dsh 0.1.6-alpha.1 把内置预设的工作流引擎行 workflow-worker-thread 改名为
workflow-ptc,并删除了旧包。组合里一行 import 失败会拒绝整棵 preset 挂载,
所以把旧名钉死在资产里的 preset 在新版上会直接不可用。本插件两个拼法都不钉:物化时
从宿主自己的内置 ptc preset 现场抄那一行的 id、包名与 disabled 状态
(rowFormsOf / alignEngineRow),并让 tool-ralph 跟随新版默认的 disabled: true。
workflow ON/OFF 两种孪生语义不同:ON 版把引擎强制启用(要真跑起来),OFF 版照抄宿主
(镜像官方 ptc 的 disabled 引擎)。改写是纯字符串手术(不解析 YAML,!!js 安全)且幂等;
探测失败(旧宿主、无 roster)时资产保持逐字节原样——一份资产通吃两个 era,升级顺序无关。

更新与卸载

- 更新:市场页「更新」按钮或重跑安装命令 → 重启 DSH → 未改动的 preset 原位刷新为新版本
- 市场页卸载:先删包再 dispose → 插件检测到包目录消失,且 preset 未被你改过 → 自动删除 preset;你改过 → 保留,交给你处理
- 命令行卸载(dsh plugin --profile web remove dsh-ptc-cordis-preset):独立进程执行,disposer 不会运行,preset 会残留 —— 在设置页删除 ptc-cordis,或手动 rm -rf ~/.dsh/.agent-presets/ptc-cordis
- 想基于它改出自己的模式?直接在设置页把它复制成新 preset 再改副本,或编辑它(编辑后本插件自动让位)

市场页没出现「更新」按钮?

npm 安装的插件由 dshmarket 按注册表版本检测更新。常见原因:

1. 30 分钟 TTL 缓存——刚发布就刷新会缓存"无更新",期间再刷直接吃缓存。访问 /dsh-market/updates?force=1 强制刷新。
2. 安装时机晚于发布——装的时候已是最新版(版本号可在市场页或 node_modules/dsh-ptc-cordis-preset/package.json 里确认),没有更新按钮是正确行为。

更新命令(dshmarket 之外的手动方式):

dsh plugin --profile web add dsh-ptc-cordis-preset

使用

1. 新建会话 → 模式选择器选 PTC 创造模式
2. 正常用 Code Mode(run_code 组合多步操作);cordis_inspect 等工具就在 SDK 里,和别的工具一样调用
3. 让它创作 preset / 试验动态插件时,它会自动加载随行的两个创作技能

⚠️ 信任边界与内置创造模式一致:cordis_define/cordis_run 会在活运行时上执行模型写的 JavaScript。把 PTC 创造模式的会话当作 shell 访问对待。

✅ 与内置创造模式同进程共存(v0.4.0 起):宿主面 runner 的 inspect 注册表遇重复 provider id 即抛错,是"一个进程只能开一个 cordis 模式会话"的唯一根源(v0.2.0 曾用 isolate realm 规避,代价是掐断浏览器桥,v0.3.0 移除)。v0.4.0 提供兼容 shim:注册先走原路径,仅在撞"已注册"时改为替换条目(同包 manifest 等价,身份守卫 disposer 保持拆卸一致)—— 两个 preset 共用唯一宿主 runner,审批卡/Client Provider/Client 激活/动态工具全通(已实测:双模式同进程挂载 + 9 个 Provider 含 5 个 client 侧全部应答)。

⚠️ 0.6.3 修复了 shim 的安装时机:此前在插件启动时一次性采样 cordisInspect,而宿主 runner 行激活晚于插件行,真机启动时该服务尚未提供,shim 静默未安装——于是只要进程内(哪怕只是曾经)挂载过内置创造模式,ptc-cordis 就会一直撞 "Provider is already registered",直到重启 dsh;且关闭/归档会话并不卸载 standing 挂载,所以"现在没有创造模式会话"不代表竞争消失。现在 shim 通过 ctx.inject(['cordisInspect']) 在服务就绪的那一刻安装,与行激活顺序无关。shim 依旧防御式:形状探测不过即自动退回 v0.3.0 裸挂行为(仅打日志,不影响启动);上游若原生容忍重复注册,原路径自然成功,shim 成为 no-op。根治仍建议上游把 runner 按会话多实例化。

界面语言

设置卡跟随 DSH 的语言设置(ctx.locale)实时切换,内置 21 本词典:简繁中文(含 zh-HK / zh-MO / zh-TW)、英语、日语、韩语、德语、法语、意大利语、葡萄牙语、俄语、荷兰语、波兰语、瑞典语、土耳其语、印尼语、越南语、泰语、印地语、阿拉伯语。词典一门一条躺在 src/client.js 的 LOCALES 表里(条目前面是一行 /* locale:  / 标记),并整体注册进 DSH 的 locale 注册表(ctx.locale.register)。
解析顺序是「精确 tag → 主语言子标签 → 英文」，zh-Hant- 归港式繁体；英文始终是键完整的那一本，所以任何未覆盖的语言都回退英文，不会露出键名。查表按当前 locale 每次实时解析（按 tag 缓存），卡片同时订阅 ctx.locale.subscribe，切换语言当场重绘、不必刷新页面。

冒烟测试强制每本词典的键集与中文完全相等——缺键只会静默回退英文，卡片就成了半翻译状态，那正是这条测试要挡住的。第三语言为机器辅助翻译，欢迎在 issue / PR 里指正。

从源码构建与测试

git clone https://github.com/KannaKuron/dsh-ptc-cordis-preset.git
cd dsh-ptc-cordis-preset
npm test   # node --test,62 项冒烟测试(无网络、无构建;数量以 npm test 输出为准)

本插件无构建步骤：src/index.js 与 assets/ 即发布产物。

tests/fixtures/official-preset-rows.json 是官方 dsh 预设行的捕获（解析 loader 方言、按 profile 宿主求值 !!js 后的结果），用来把本插件的声明式组合锁在官方文本上——组合漂移会直接让 npm test 变红。换 dsh 版本后重建它：用 dsh 检出里的 packages/bundle/web-app/presets/{cordis,ptc}.patch.yml 重新生成同名文件即可：node tools/gen-official-preset-fixture.mjs（路径可用 DSH_CHECKOUT / DESKTOP_BUILD 覆盖）。

与 dsh-gitbash-shell 联动

与 dsh-gitbash-shell（v0.2.0+）同装时，两个插件在三个面上配合（改动见 CHANGELOG v0.14.0，对应本仓库 issue #1 与对方 issue #7）。

组合与名录显示名跟随 Git Bash

本插件物化 PTC 创造模式 时检测对方的 gitBash 宿主能力服务：两插件合用 → 使用
assets/agent.cordis.gitbash.yml（tool-bash 启用、tool-pwsh 禁用，即 Git Bash 版）；
未安装或非 Windows → 使用默认 assets/agent.cordis.yml。能力开关变化会触发一次
自动刷新（仅限未修改的 preset），无需新增模式、无需手工改文件。

名录里的显示名与描述同样跟随这一侧：Git Bash 活动时显示 PTC 创造模式 · Git Bash，
描述追加 (Shell 使用 Git Bash)，与对方四个  · Git Bash 变体的命名风格一致；非 Git Bash
时仍是 PTC 创造模式。旧宿主（物化路径）自 v0.6.0 起一直如此；v0.13.0 的声明式重写一度把
显示名硬编码，只有 dsh ≥ 0.1.7 的新宿主会丢后缀，已在 v0.14.0 修好。名称以
assets/preset.gitbash.yml 的 name: 为单一事实来源，冒烟测试锁住两边同名，防止再次漂移。

发布 ptcCordisPreset 协作能力

启动时（两个宿主时代都发，且早于时代分流）本插件向运行时发布一个能力服务：

{ id: 'ptc-cordis', gitBashActive: true /* 非 Git Bash 侧为 false */ }

对方据此判断「这个 preset 已经在 Git Bash 上覆盖了创造模式」，从而在用户打开去重开关时不再
注册它自己的 创造模式 · Git Bash。因为对方是靠「服务出现」这一事件做决定的，本插件
先做完有界（1 秒）的 gitBash 能力探测、再发布——发布出去的值就是终值，不会出现
「先发 false、之后再翻成 true」而对方已经错过的情况。没有安装对方的宿主上这个服务同样发布
（gitBashActive: false），「服务缺席」因此只表示本插件没挂载。

设置卡上的共享去重开关

对方的 创造模式 · Git Bash 与本插件（联动后已是 Git Bash 版）指向同一件事，同装时模式选择器里
会出现两条。v0.14.0 起本插件的设置卡多出一行 「与 dsh-gitbash-shell 去重」：

- 默认关（显示为「保留两个」），不改变任何现有行为；
- 只有一份状态：这一行不存自己的值，而是通过 ctx.configForms.get('gitbash-shell') 绑定
对方那一行的 suppressPeerCordis 字段，并 subscribe 对方的变更——两处设置卡显示的是
同一个开关，任一侧改动另一侧立即同步；
- 对方的行不存在（未安装）时这一行不渲染，本插件设置卡退回原来的单行形态；
- 版本要求：去重真正生效需要 dsh-gitbash-shell ≥ 0.25.0（开关本体）与本插件
≥ 0.14.0（协作能力）同时满足，名录里才会少掉那一条；
- 旧宿主边界：只有 dsh ≥ 0.1.7 上两侧都能改（新宿主才有 configForms）；旧宿主
（≤ 0.1.6）在本插件卡里看不到这一行，只能在对方自己的设置面里改，并按对方的启动时语义生效。

若你的 ptc-cordis 目录由旧版本物化且已处于 unmodified 状态，升级后首次启动
会自动刷新；若被手工修改过，删除 ~/.dsh/.agent-presets/ptc-cordis 再重启即可
以新逻辑重新物化。

致谢与许可

- 合成组合与技能内容派生自 @deepseek-ai/dsh 内置 preset（MIT），运行时从本机安装拷贝，遵循其许可
- 本仓库代码：MIT

run_code 后端开关（v0.15.0，默认关）
设置 → 插件 → 「PTC 创造模式」卡片新增一行 run_code 后端:

- Node / TypeScript(默认):run_code 使用 dsh 官方 Node PTC 后端,与官方 ptc 组合逐字节一致。
- Python(实验性):改用 dsh 实验性 CPython 后端 @deepseek-ai/dsh-experimental-ptc-runtime-python(随本插件安装,无需二次安装)。run_code 的语言、生成的 Python SDK 提示词与工具呈现会自动切换(由 provider 的 language / executionInstructions 驱动)。

要求与边界:

- 平台:仅 POSIX(macOS / Linux)。Windows 上实验后端在加载期直接抛错,本插件保持官方 Node 后端并在日志给出指引。
- 解释器:需要 CPython ≥ 3.10。插件按「显式 pythonBin → DSH_PYTHON → dsh 运行时自带 → /opt/homebrew/bin、/usr/local/bin → PATH → /usr/bin/python3」逐个探测,并把胜出的绝对路径冻结给 provider;桌面端 GUI 的 PATH 通常只有 macOS 自带的 3.9,必要时 brew install python@3.12,或在行 Config 里填 pythonBin 指向你的解释器。
- 与 workflow 互斥:workflow-ptc 硬要求 TypeScript 运行时,官方 Python 组合同样禁用 workflow;开启期间本插件把 workflow-ptc / tool-workflow 强制关闭(你的 workflow 设置值保留,关掉后恢复)。
- 生效时机:重启 dsh 后生效(切换发生在 profile patch 层,启动时求值)。卡片状态与 dsh-gitbash-shell 的设置卡共享同一份值,任一侧改动两侧即时同步。
- 不可用时:插件不会切换后端——保持官方 Node 后端,并在宿主日志打印可执行指引(缺解释器 / 缺包 / 平台不支持)。