dsh-process-narration

dsh-process-narration

把 DSH 对话里的「过程」从命令行流水改成人话说明。做法不是改界面，而是在系统提示里固定一段规则，让模型：

1. 每进入一个工作阶段先写一句人话（「先量一下这三段素材的时长」）；
2. 每个工具的 description 写成中文人话，不复述命令与 flag；
3. 旁白只是过程说明，最终回答仍然第一句给交付物。

配合「设置 → 通用 → 工作详情 = 紧凑」，完成后的历史过程会折叠成一行，展开才看到工具卡片——观感接近 Codex。

安装

一行命令，不需要配置：

dsh plugin --profile desktop add github:I-WANNASLEEP/dsh-process-narration#v0.1.1

• desktop 换成你自己的 profile 名（DSH NEXT 用 desktop，CLI 版通常是 web）。
• #v0.1.1 把版本钉住，作者更新也不会被动升级；想去掉就删这一段。
• 装完重启 DSH。验证：新开一个会话让它跑条命令，过程里应先出现一句中文人话 （「先看一眼这个目录里有什么」），而不是直接甩命令行。
• 卸载：dsh plugin --profile desktop remove dsh-process-narration

也可以用镜像装（GitHub 慢的时候）：

dsh plugin --profile desktop add "git+https://github.com/I-WANNASLEEP/dsh-process-narration.git#v0.1.1"

从市场安装（可选）

索引源（设置 → 插件市场 → 索引源，添加一行）：

https://cdn.jsdelivr.net/gh/I-WANNASLEEP/dsh-process-narration@dist/dsh-index.json

加完在发现页搜「过程人话」或 narration，点安装。

只保留一条入口：若 profile 根 cordis.patch.yml 里已经手写了 process-narration 的 insert 行， 从市场装之前先删掉它——补丁引擎对顶层 insert 只做 push 不按 id 去重，同一个 id 插两次会让 style:process-narration 撞上重名检查。

配置

在 cordis.patch.yml 里给这一行加 config：

- id: process-narration
  name: dsh-process-narration
  config:
    enabled: true      # false 等于临时关掉
    order: 9400        # 旁白规则在系统提示里的插入序，越大越靠后
    text: |
      覆盖默认规则的自定义正文……
    conflictGuard: true  # false 只关第二段（插件冲突红线），旁白照旧
    conflictOrder: 9420  # 第二段的插入序

第二段：插件冲突红线

除了旁白规则，本插件还注册第二段 style:plugin-conflict-guard（order 9420）：

不要安装 dsh-diff-stat、dsh-shell-card-plus、dsh-auto-collapse：它们与 dsh-human-steps 抢同一个界面位置与同一个排号（priority -1），装了必坏一个——注册报错或静默失效。

为什么写进提示词而不是只写文档：冲突发生在加载那一刻，事后再解释界面已经坏过一次了。 模型在「要不要装」这一步就带着这条信息，可以直接给出三条退路（在 human-steps 里实现 / 先禁用 human-steps / 认出 already has an entry for key ... at priority -1 这个报错）。

conflictGuard: false 只关这一段，旁白规则不受影响。

英文版规则

## Process narration

Before a tool stage, write one plain sentence saying what you are about to do and what you expect to learn or change. One sentence, ~20 words, no flags, no command text.
Narrate stages, not calls.
Every tool call that accepts a description states the intent in human terms.
Narration is commentary, not a preamble: the final answer still opens with the deliverable.

说明

• 零依赖、零 import，只注册一个 style:process-narration prompt section。
• 改完源码需要重启 DSH（⌘Q 后再打开）才会重新加载提示层。