@morlay/dsh-preset 0.0.3 → 0.0.4

package/README.md

@@ -6,12 +6,16 @@
 
 ## 内容
 
-| 文件                       | 作用                                                                              |
-| -------------------------- | --------------------------------------------------------------------------------- |
-| `cordis.patch.yml`         | bundle patch：禁用官方 preset、注册本包 preset 为默认、声明个人 `llm-pi-ai` route |
-| `tool/generate-presets.ts` | 从上游生成 preset 的模块 + tsdown hooks                                           |
-| `dist/presets/standard/`   | 构建产物：自定义 preset「标准模式」（由上游 `standard` 生成）                     |
-| `dist/presets/ptc/`        | 构建产物：自定义 preset「PTC 模式」（由上游 `ptc` 生成）                          |
+| 文件                       | 作用                                                                                                         |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `cordis.patch.yml`         | bundle patch：禁用官方 preset、注册本包 preset 为默认、声明个人 `llm-pi-ai` route、插入 `prompt-reminder` 行 |
+| `tool/generate-presets.ts` | 从上游生成 preset 的模块 + tsdown hooks                                                                      |
+| `dist/presets/standard/`   | 构建产物：自定义 preset「标准模式」（由上游 `standard` 生成）                                                |
+| `dist/presets/ptc/`        | 构建产物：自定义 preset「PTC 模式」（由上游 `ptc` 生成）                                                     |
+
+`cordis.patch.yml` 里插入的 `prompt-reminder`（`@morlay/dsh-prompt-reminder`）把被
+裁掉的系统提示词 section 降级为 `<system-reminder>` user 消息，见「工具说明降级为
+reminder」。
 
 ## 禁用官方 preset
 
@@ -69,11 +73,40 @@ section 在插件构造时注册；dev 模式重启 `just custom dev`/`just cust
 roster（id 沿用官方名以走客户端语言字典），以及桌面形态下 preset 必须落在 dsh 包的
 `config/agent-presets` 挂载点（见 dsh-desktopify 的 `dsh.desktop.agentPresets`）。
 
+## 工具说明降级为 reminder，不进系统提示词
+
+上游把每个工具的跨调用说明（`tool:bash`、`tool:read`、…）、Agent Teams 协作规则、
+harness 源码位置、Web GUI 说明都注册成系统提示词的 section。本部署实测它们占
+9200 字符里的约 7400：条数多、篇幅大、挤在上下文最前面，稀释真正要遵守的那几行
+纪律。`cordis.patch.yml` 因此在 host plane 插一行：
+
+```yaml
+- insert:
+    - id: prompt-reminder
+      name: "@morlay/dsh-prompt-reminder"
+```
+
+一处定义覆盖全部 preset（standard / ptc 以及后续新增的）——这是与具体 preset 无关
+的部署级策略，preset composition 不各自带这一行，生成器也就不必碰它。该插件注册
+在 root scope，会收到每个 agent 的装配与 pre-step 事件（含子 agent）：
+
+- 装配（`system-prompt/assemble` 瀑布）时保留 `keep` 名单——默认是部署级
+  `deployment:persona-prefix` / `deployment:persona-suffix`——内的 section，其余
+  非空 section 从 assembly 移除并按 order 捕获文本；
+- pre-step 时把捕获的文本作为一条 `<system-reminder>` user 消息注入，紧随本轮
+  用户消息之后；文本不变不重复注入，`plan:policy` / `tools:ptc-only` 这类按模式
+  渲染的 section 变化时追加一条新的全量 reminder（首行声明最新一条覆盖更早的）。
+
+于是系统提示词只剩首尾两段个人提示词，其余内容仍在上下文里、但不再占系统提示词
+的位置，也不再随模式切换改动。**为什么不用 `persona` 行的 `complete: true`**：那会
+连 suffix 一起丢，且子 agent 自己注册同名 persona 时 `complete` 语义消失，保留 /
+降级会不一致；本插件按 `keep` 名单匹配 section 名，两种 agent 行为一致。完整行为与
+配置见 `packages/preset/dsh-prompt-reminder/README.md`。
+
 ## 工作区指令走官方行为，候选收紧为 AGENTS 系列
 
-preset 里的 `agent-instructions` 行仍是官方 `@deepseek-ai/dsh-agent-instructions`：
-本仓库的 fork `@morlay/dsh-agent-instructions-as-prompt` 暂不接入默认打包，baseline
-仍按官方语义作为 user 消息注入一次。生成器只覆盖该行 config 的两个字段：
+preset 里的 `agent-instructions` 行是官方 `@deepseek-ai/dsh-agent-instructions`：
+baseline 按官方语义作为 user 消息注入一次。生成器只覆盖该行 config 的两个字段：
 
 ```yaml
 instructionFileCandidates: ["AGENTS.md"] # 上游默认 ['AGENTS.md','CLAUDE.md']
@@ -82,8 +115,10 @@ localInstructionFileCandidates: ["AGENTS.local.md"] # 上游默认还含 CLAUDE.
 
 即**不读 CLAUDE 系列**（本部署不需要 CLAUDE 兼容）；`maxBytes` 等其余字段跟随上游。
 
-fork 源码保留在 `packages/preset/dsh-agent-instructions-as-prompt/`；后续要恢复时按
-它的 README 操作：生成器把该行 `name` 换成 fork 名，profile 侧再禁用上游行。
+本仓库曾有一个把 baseline 落点改成 system-prompt section 的 fork
+（`@morlay/dsh-agent-instructions-as-prompt`），一直未接入默认打包；提示词分层定为
+「系统提示词只留 persona、其余走 reminder」之后它已删除——baseline 留在 user 消息
+通道与这个分层一致。
 
 ## preset 由构建生成，不是手工副本
 
@@ -102,10 +137,11 @@ pnpm --filter @morlay/dsh-preset run generate-presets [outDir]
 ```
 
 脚本把上游 composition 当**数据**读入：`js-yaml` 用 include 的
-`entryListSchema` 解析（`!!js` 标签保留为表达式节点）→ 在 JS 里改一处（删掉
-`persona` 行）→ `dump` 回 YAML。因此上游任何结构性改动（新增 / 重命名 row、改字段）
-都自动跟随，不依赖易碎的文本锚点；上游若删掉 `persona` 行，目标（preset 不自带
-persona）本就达成，脚本照常通过。
+`entryListSchema` 解析（`!!js` 标签保留为表达式节点）→ 在 JS 里改三处（删掉
+`persona` 行、把 `agent-instructions` 行的候选收紧为 AGENTS 系列、插入
+`prompt-reminder` 行）→ `dump` 回 YAML。因此上游任何结构性改动（新增 / 重命名
+row、改字段）都自动跟随，不依赖易碎的文本锚点；上游若删掉 `persona` 行，目标
+（preset 不自带 persona）本就达成，脚本照常通过。
 
 脚本先**整目录清空**输出目录再生成：产物完全派生自脚本，残留目录（改过
 `source`、旧命名）不该留下——否则 discovery 会把它们当有效 preset 扫出来。
@@ -118,7 +154,7 @@ persona）本就达成，脚本照常通过。
 
 1. 升级 `DEEPSEEK_HARNESS_VERSION` 并 sync/patch/build。
 2. `pnpm --filter @morlay/dsh-preset run build`（build:done 会重新生成）
-3. `pnpm exec vitest run packages/preset/dsh-preset` 确认无 drift。
+3. `pnpm exec vitest run packages/preset` 确认无 drift（含 reminder 插件的行为测试）。
 
 ## 装配
 
@@ -159,6 +195,9 @@ profile 里把内容物化到该挂载点；`includeShippedRoot: false` 两种
 ## 维护注意
 
 - `package.json` 的 `files` 必须含 `dist`（preset 在其中）与 `tool`，否则发布产物缺内容。
+- `cordis.patch.yml` 插入的 `@morlay/dsh-prompt-reminder` 必须能被 **profile** 的依赖
+  树解析：示例 app 已在 `dependencies` 声明；换工作区时要一并声明，否则该行加载失败、
+  工具说明会留在系统提示词里。
 - 生成器显式设 `quotingType: '"'`：`yaml.dump` 默认单引号而仓库 oxfmt 偏好双引号，
   不指定会让生成器与 formatter 来回改；产物在 gitignore 的 dist 里，本就不参与 fmt。
 - **dev 模式需要先构建**：`just dev` / `just desktop` / `just bundle` 都先跑

package/cordis.patch.yml

@@ -2,21 +2,16 @@
   config:
     includeHarnessIdentity: false
     includeRuntimeContext: false
-    personaSuffix: 你的工作目录在 `{{cwd}}`
+    personaSuffix: |-
+      你的工作目录在 `{{cwd}}`，工作目录内的  AGENTS.md 的规则非常重要，必须严格遵守
     personaPrefix: |-
       你是一个经验丰富的编程专家，YAGNI 是你的编程哲学，PDCA 是你的行为规范
 
-      ## 指令遵循（强制）
+      ## 语言和行为
 
-      以下指令都是**约束**而非建议；冲突时按 用户的直接指令 > 工作区 `AGENTS.md` > 全局提示词 取舍并说明：
-
-      - **工作区 `AGENTS.md`**（仓库根与目录链，随 `<system-reminder>` 注入）：「红线」与命令约定必须遵守。模板里的 "may be relevant"、"as guidance" 是通用保守措辞，不表示可以跳过。
-      - **全局提示词**：
-        - 所有思考、分析、推理过程、工具调用描述等必须使用中文，专有名词除外
-        - 思考不要陷入重复循环，一旦循环，立即退出
-        - 思考聚焦需求理解与方案设计（要点、流程、验证策略），不预演具体代码实现；代码在 Do 阶段基于实际文件状态输出，正确性由 Check 验证
-
-      协议：动手前读相关 `AGENTS.md`（不凭记忆）；过程中自检、违反即纠正；交付前核对红线与验证证据，未验证项必须标注；无法遵守时立即说明（不静默忽略、不自行判定「不适用」）；派发子代理时把约束写进任务说明。
+      - 所有思考、分析、推理过程、工具调用描述等必须使用中文，专有名词除外
+      - 思考不要陷入重复循环，一旦循环，立即退出
+      - 思考聚焦需求理解与方案设计（要点、流程、验证策略），不预演具体代码实现；代码在 Do 阶段基于实际文件状态输出，正确性由 Check 验证
 
 - id: agent-presets
   config:
@@ -62,3 +57,10 @@
               low: low
               high: high
               max: max
+
+# 提示词分层：系统提示词只留上面的 persona，工具说明 / Agent Teams 规则 / plan
+# 规则等由该插件降级为 <system-reminder> user 消息。部署级策略，在这里定义一次
+# 即覆盖全部 preset（含子 agent），preset composition 不再各自带这一行。
+- insert:
+    - id: prompt-reminder
+      name: "@morlay/dsh-prompt-reminder"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-preset",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Personal dsh profile bundle: disables the shipped agent presets, builds generated standard / ptc presets into dist, and declares personal llm-pi-ai provider routes.",
   "keywords": [
     "dsh",
@@ -25,6 +25,9 @@
     "./package.json": "./package.json",
     "./cordis.patch.yml": "./cordis.patch.yml"
   },
+  "dependencies": {
+    "@morlay/dsh-prompt-reminder": "^0.0.1"
+  },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
     "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",

package/src/__tests__/generated-presets.spec.ts

@@ -29,7 +29,7 @@ import {
 /** 上游 preset 里承载工作区指令的行 id。 */
 const INSTRUCTIONS_ROW_ID = "agent-instructions";
 
-/** 上游那行指向的官方插件（fork 暂未接入，产物须保持官方名）。 */
+/** 上游那行指向的官方插件（产物须保持官方名；提示词分层由 profile 的 patch 承担）。 */
 const UPSTREAM_INSTRUCTIONS_PLUGIN = "@deepseek-ai/dsh-agent-instructions";
 
 /** 产物里指令候选的文件名（字面量：不读 CLAUDE 系列）。 */
@@ -105,7 +105,7 @@ describe("generated presets", () => {
       expect(productRow?.config?.localInstructionFileCandidates).toEqual(["AGENTS.local.md"]);
       // 其余 config 字段跟随上游（如 maxBytes 的字节预算）。
       expect(productRow?.config?.maxBytes).toBe(upstreamRow?.config?.maxBytes);
-      // 产物里不应出现本仓库的插件行。
+      // 提示词分层（prompt-reminder）是 profile 的 bundle patch，不进 preset 产物。
       expect(
         product.some((row) => typeof row.name === "string" && row.name.startsWith("@morlay/")),
       ).toBe(false);

package/src/__tests__/patch.spec.ts

@@ -0,0 +1,41 @@
+// 装配守卫：prompt-reminder 是 host plane 的唯一装配点。被误删 / 改名时提示词分层
+// 静默失效（工具说明回到系统提示词），这里 fail loud；persona 是 keep 名单的唯一
+// 提供者，删掉它系统提示词会变空。
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
+import yaml from "js-yaml";
+import { describe, expect, it } from "vitest";
+
+const PATCH_PATH = join(process.cwd(), "packages/preset/dsh-preset/cordis.patch.yml");
+
+/** patch 的一行；只用到覆盖目标与 insert 的新增行。 */
+interface PatchRow {
+  id?: string;
+  config?: Record<string, unknown>;
+  insert?: { id?: string; name?: string }[];
+}
+
+// 用 include 的 entry schema 解析：patch 里含 `!!js` 表达式，默认 schema 会拒绝。
+const rows = yaml.load(readFileSync(PATCH_PATH, "utf8"), {
+  schema: entryListSchema,
+}) as PatchRow[];
+
+describe("dsh-preset patch wiring", () => {
+  it("declares the prompt-reminder row exactly once, on the local plugin", () => {
+    const inserted = rows
+      .flatMap((row) => row.insert ?? [])
+      .filter((row) => row.id === "prompt-reminder");
+
+    expect(inserted).toHaveLength(1);
+    expect(inserted[0]?.name).toBe("@morlay/dsh-prompt-reminder");
+  });
+
+  it("keeps the deployment persona the reminder keeps in the system prompt", () => {
+    const config = rows.find((row) => row.id === "system-prompt")?.config;
+
+    expect(config?.personaPrefix).toBeTruthy();
+    expect(config?.personaSuffix).toBeTruthy();
+  });
+});

package/tool/generate-presets.ts

@@ -9,8 +9,8 @@
  * `agent-instructions` 行的指令候选收紧为 AGENTS 系列），再 `dump` 回 YAML。
  * 上游任何结构性改动（新增/重命名 row、改字段）都自动跟随，不依赖易碎的文本锚点。
  *
- * `agent-instructions` 行仍是上游官方插件：fork
- * （`@morlay/dsh-agent-instructions-as-prompt`）暂不接入，工作区指令走官方行为。
+ * `agent-instructions` 行是上游官方插件：工作区指令的 baseline 留在 user 消息通道，
+ * 与「系统提示词只留 persona、其余走 reminder」的分层一致。
  *
  * 产物落在 `dist/` 而非源码树：dist 是构建输出（gitignore），既不会与 oxfmt
  * 互相改格式，也不会把派生文件混进源码。