dsh-ptc-cordis-preset
简体中文 | 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 按注册表版本检测更新。常见原因:
- 30 分钟 TTL 缓存——刚发布就刷新会缓存"无更新",期间再刷直接吃缓存。访问
/dsh-market/updates?force=1 强制刷新。
- 安装时机晚于发布——装的时候已是最新版(版本号可在市场页或
node_modules/dsh-ptc-cordis-preset/package.json 里确认),没有更新按钮是正确行为。
更新命令(dshmarket 之外的手动方式):
dsh plugin --profile web add dsh-ptc-cordis-preset
使用
- 新建会话 → 模式选择器选 PTC 创造模式
- 正常用 Code Mode(
run_code 组合多步操作);cordis_inspect 等工具就在 SDK 里,和别的工具一样调用
- 让它创作 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: <tag> */ 标记),并整体注册进 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,48 项冒烟测试(无网络、无构建;数量以 npm test 输出为准)
本插件无构建步骤:src/index.js 与 assets/* 即发布产物。
与 dsh-gitbash-shell 联动
若同时安装 dsh-gitbash-shell(v0.2.0+),
本插件物化 PTC 创造模式 时检测其 gitBash 宿主能力服务:两插件合用 → 使用
assets/agent.cordis.gitbash.yml(tool-bash 启用、tool-pwsh 禁用,即 Git Bash 版);
未安装或非 Windows → 使用默认 assets/agent.cordis.yml。能力开关变化会触发一次
自动刷新(仅限未修改的 preset),无需新增模式、无需手工改文件。
若你的 ptc-cordis 目录由旧版本物化且已处于 unmodified 状态,升级后首次启动
会自动刷新;若被手工修改过,删除 ~/.dsh/.agent-presets/ptc-cordis 再重启即可
以新逻辑重新物化。
致谢与许可
