@morlay/dsh-preset 0.0.1 → 0.0.3

package/README.md

@@ -47,10 +47,44 @@ preset 自带的 `persona` 行会在 agent scope 注册 `deployment:persona-pref
 固化了该语义），所以生成器把那一行**删掉**，而不是复制一份改过的 persona——同一份
 文案只维护一处。
 
+### 指令遵循设计
+
+`personaPrefix` 位于 order 0（prompt 最前，紧跟被关掉的 harness identity 之后）：
+声明指令优先级（直接用户指令 > 工作区 `AGENTS.md` > 本系统提示词）与执行协议。其中
+点名 `AGENTS.md` 是**强制约束**——官方 `agent-instructions` 注入模板的措辞
+（"may be relevant" / "as guidance" / "do not override…"）是上游的通用保守表述，会让
+模型把仓库规则当参考而不是规则，所以这里显式反制。协议一行覆盖：动手前读相关
+`AGENTS.md`、过程自检、交付前核对红线与验证证据、无法遵守时明确说明、派发子代理时
+把约束写进任务说明。
+
+`personaSuffix` 位于 order 10200（prompt 最后）：一句话复述"结束任务前对照本提示词与
+`AGENTS.md` 自检"。长 prompt 里中段指令会被稀释，首尾各放一次最关键的约束，用近因
+位置兜住遵循度；细节只在 prefix 维护，避免两处重复。
+
+改这两段后**必须重启 dsh 才能生效**：profile 在进程启动时装载，`system-prompt` 的
+section 在插件构造时注册；dev 模式重启 `just custom dev`/`just custom desktop`，打包
+形态需重新 `just custom bundle`（patch 随 seed 快照复制）。
+
 自建 preset 仍然必要，但只为别的事：`includeShippedRoot: false` 之后需要一份自己的
 roster（id 沿用官方名以走客户端语言字典），以及桌面形态下 preset 必须落在 dsh 包的
 `config/agent-presets` 挂载点（见 dsh-desktopify 的 `dsh.desktop.agentPresets`）。
 
+## 工作区指令走官方行为，候选收紧为 AGENTS 系列
+
+preset 里的 `agent-instructions` 行仍是官方 `@deepseek-ai/dsh-agent-instructions`：
+本仓库的 fork `@morlay/dsh-agent-instructions-as-prompt` 暂不接入默认打包，baseline
+仍按官方语义作为 user 消息注入一次。生成器只覆盖该行 config 的两个字段：
+
+```yaml
+instructionFileCandidates: ["AGENTS.md"] # 上游默认 ['AGENTS.md','CLAUDE.md']
+localInstructionFileCandidates: ["AGENTS.local.md"] # 上游默认还含 CLAUDE.local.md
+```
+
+即**不读 CLAUDE 系列**（本部署不需要 CLAUDE 兼容）；`maxBytes` 等其余字段跟随上游。
+
+fork 源码保留在 `packages/preset/dsh-agent-instructions-as-prompt/`；后续要恢复时按
+它的 README 操作：生成器把该行 `name` 换成 fork 名，profile 侧再禁用上游行。
+
 ## preset 由构建生成，不是手工副本
 
 产物落在 `dist/`，由 tsdown 的 `build:done` hook 在每次 `pnpm build` 时生成
@@ -68,11 +102,10 @@ pnpm --filter @morlay/dsh-preset run generate-presets [outDir]
 ```
 
 脚本把上游 composition 当**数据**读入：`js-yaml` 用 include 的
-`entryListSchema` 解析（`!!js` 标签保留为表达式节点）→ 在 JS 里改两处（删掉
-`persona` 行、把 `agent-instructions` 行指向本仓库的 fork）→ `dump` 回 YAML。
-因此上游任何结构性改动（新增 / 重命名 row、改字段）都自动跟随，不依赖易碎的文本
-锚点；上游若删掉 `persona` 行，目标（preset 不自带 persona）本就达成，脚本照常
-通过。
+`entryListSchema` 解析（`!!js` 标签保留为表达式节点）→ 在 JS 里改一处（删掉
+`persona` 行）→ `dump` 回 YAML。因此上游任何结构性改动（新增 / 重命名 row、改字段）
+都自动跟随，不依赖易碎的文本锚点；上游若删掉 `persona` 行，目标（preset 不自带
+persona）本就达成，脚本照常通过。
 
 脚本先**整目录清空**输出目录再生成：产物完全派生自脚本，残留目录（改过
 `source`、旧命名）不该留下——否则 discovery 会把它们当有效 preset 扫出来。

package/cordis.patch.yml

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

package/dist/presets/ptc/agent.cordis.yml

@@ -1,8 +1,12 @@
 # 本文件由 packages/dsh-preset/tool/generate-presets.ts 生成，请勿手工编辑
 - id: agent-instructions
-  name: "@morlay/dsh-agent-instructions-as-prompt"
+  name: "@deepseek-ai/dsh-agent-instructions"
   config:
     maxBytes: 65536
+    instructionFileCandidates:
+      - AGENTS.md
+    localInstructionFileCandidates:
+      - AGENTS.local.md
 - id: tool-bash
   name: "@deepseek-ai/dsh-tool-bash"
   disabled: !!js process.platform === 'win32'

package/dist/presets/standard/agent.cordis.yml

@@ -1,8 +1,12 @@
 # 本文件由 packages/dsh-preset/tool/generate-presets.ts 生成，请勿手工编辑
 - id: agent-instructions
-  name: "@morlay/dsh-agent-instructions-as-prompt"
+  name: "@deepseek-ai/dsh-agent-instructions"
   config:
     maxBytes: 65536
+    instructionFileCandidates:
+      - AGENTS.md
+    localInstructionFileCandidates:
+      - AGENTS.local.md
 - id: tool-bash
   name: "@deepseek-ai/dsh-tool-bash"
   disabled: !!js process.platform === 'win32'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-preset",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "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,9 +25,6 @@
     "./package.json": "./package.json",
     "./cordis.patch.yml": "./cordis.patch.yml"
   },
-  "dependencies": {
-    "@morlay/dsh-agent-instructions-as-prompt": "^0.0.1"
-  },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
     "@deepseek-ai/dsh-agent-presets": "^0.1.5-rc.2",
@@ -40,7 +37,14 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
-    }
+    },
+    "configTrees": [
+      {
+        "mount": "config/agent-presets",
+        "path": "dist/presets",
+        "scanRoster": true
+      }
+    ]
   },
   "scripts": {
     "build": "pnpm exec tsdown"

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

@@ -1,9 +1,11 @@
 /**
  * 生成产物的回归测试：`dist/presets/standard` / `dist/presets/ptc` 必须等于
- * 「上游 composition 的 persona prefix 替换版」。
+ * 「上游 composition 删 persona 行、指令候选收紧为 AGENTS 系列」的版本。
  *
  * 断言方式是把产物与**现算的**期望值比较，而不是与一份快照比——上游升级后
- * 忘记重跑构建时，这条测试会失败并指出 drift，而不是继续绿着。
+ * 忘记重跑构建时，这条测试会失败并指出 drift，而不是继续绿着。期望值由测试
+ * 自己解析上游推出、不经过被测的 `renderComposition`：生成器多删 / 改任何
+ * 一行都会失败，而不是自证。
  *
  * 产物在 dist（构建输出，gitignore），因此测试自身调用 `generatePresets` 到
  * 临时目录，不依赖 build 是否跑过。
@@ -13,47 +15,112 @@
 import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
+import yaml from "js-yaml";
 import { afterAll, describe, expect, it } from "vitest";
 import {
   PRESET_SOURCES,
-  INSTRUCTIONS_PLUGIN,
   PERSONA_ROW_ID,
   UPSTREAM_PRESETS,
   generatePresets,
-  renderComposition,
   renderMetadata,
 } from "../../tool/generate-presets.ts";
 
+/** 上游 preset 里承载工作区指令的行 id。 */
+const INSTRUCTIONS_ROW_ID = "agent-instructions";
+
+/** 上游那行指向的官方插件（fork 暂未接入，产物须保持官方名）。 */
+const UPSTREAM_INSTRUCTIONS_PLUGIN = "@deepseek-ai/dsh-agent-instructions";
+
+/** 产物里指令候选的文件名（字面量：不读 CLAUDE 系列）。 */
+const PRODUCT_INSTRUCTION_CANDIDATES = ["AGENTS.md"];
+const PRODUCT_LOCAL_INSTRUCTION_CANDIDATES = ["AGENTS.local.md"];
+
+/** 上游 composition 的一行；比较只看结构。 */
+type CompositionRow = {
+  id?: string;
+  name?: string;
+  config?: Record<string, unknown>;
+  [key: string]: unknown;
+};
+
 const OUT_DIR = mkdtempSync(join(tmpdir(), "dsh-preset-"));
 afterAll(() => {
   rmSync(OUT_DIR, { recursive: true, force: true });
 });
 generatePresets(OUT_DIR);
 
+/** 独立解析 composition 文本（include 的 schema，`!!js` 标签保留为表达式节点）。 */
+function parseRows(text: string): CompositionRow[] {
+  return yaml.load(text, { schema: entryListSchema }) as CompositionRow[];
+}
+
+/** 解析上游 preset 与生成产物。 */
+function readPair(source: string): { upstream: CompositionRow[]; product: CompositionRow[] } {
+  return {
+    upstream: parseRows(readFileSync(join(UPSTREAM_PRESETS, source, "agent.cordis.yml"), "utf8")),
+    product: parseRows(readFileSync(join(OUT_DIR, source, "agent.cordis.yml"), "utf8")),
+  };
+}
+
+/** 生成器对上游 composition 的期望改动：删 persona 行、收紧指令候选。 */
+function expectedRows(upstream: CompositionRow[]): CompositionRow[] {
+  return upstream
+    .filter((row) => row.id !== PERSONA_ROW_ID)
+    .map((row) =>
+      row.id === INSTRUCTIONS_ROW_ID
+        ? {
+            ...row,
+            config: {
+              ...row.config,
+              instructionFileCandidates: PRODUCT_INSTRUCTION_CANDIDATES,
+              localInstructionFileCandidates: PRODUCT_LOCAL_INSTRUCTION_CANDIDATES,
+            },
+          }
+        : row,
+    );
+}
+
 describe("generated presets", () => {
   it.each(PRESET_SOURCES)(
-    "$source matches its upstream source with only the persona and instructions rows replaced",
+    "$source equals its upstream source with only the persona row dropped and the instruction candidates narrowed",
     (entry) => {
-      const upstream = readFileSync(
-        join(UPSTREAM_PRESETS, entry.source, "agent.cordis.yml"),
-        "utf8",
-      );
-      const actual = readFileSync(join(OUT_DIR, entry.source, "agent.cordis.yml"), "utf8");
-      expect(actual).toBe(renderComposition(entry.source, upstream));
+      const { upstream, product } = readPair(entry.source);
+      // 期望由测试自行推出：上游删 persona 行 + 收紧候选，其余逐行不动。
+      expect(product).toEqual(expectedRows(upstream));
     },
   );
 
-  it.each(PRESET_SOURCES)("$source loads the fork for workspace instructions", (entry) => {
-    const text = readFileSync(join(OUT_DIR, entry.source, "agent.cordis.yml"), "utf8");
-    // preset 是会话级 composition：不在这里换掉，上游插件仍会把 baseline 作为
-    // user 消息注入一次（profile 级的 disable 管不到 preset）。
-    expect(text).toContain(`name: "${INSTRUCTIONS_PLUGIN}"`);
-    expect(text).not.toContain('"@deepseek-ai/dsh-agent-instructions"');
-  });
+  it.each(PRESET_SOURCES)(
+    "$source keeps the agent-instructions row on the upstream plugin with AGENTS-only candidates",
+    (entry) => {
+      const { upstream, product } = readPair(entry.source);
+      const upstreamRow = upstream.find((row) => row.id === INSTRUCTIONS_ROW_ID);
+      const productRow = product.find((row) => row.id === INSTRUCTIONS_ROW_ID);
+      // 官方插件名保持（fork 一旦接入即失败，改名也不失效）。
+      expect(upstreamRow?.name).toBe(UPSTREAM_INSTRUCTIONS_PLUGIN);
+      expect(productRow?.name).toBe(upstreamRow?.name);
+      // 候选收紧为 AGENTS 系列：CLAUDE 系列不再被读取。
+      expect(productRow?.config?.instructionFileCandidates).toEqual(["AGENTS.md"]);
+      expect(productRow?.config?.localInstructionFileCandidates).toEqual(["AGENTS.local.md"]);
+      // 其余 config 字段跟随上游（如 maxBytes 的字节预算）。
+      expect(productRow?.config?.maxBytes).toBe(upstreamRow?.config?.maxBytes);
+      // 产物里不应出现本仓库的插件行。
+      expect(
+        product.some((row) => typeof row.name === "string" && row.name.startsWith("@morlay/")),
+      ).toBe(false);
+    },
+  );
 
   it.each(PRESET_SOURCES)("$source carries generated metadata", (entry) => {
     const actual = readFileSync(join(OUT_DIR, entry.source, "preset.yml"), "utf8");
     expect(actual).toBe(renderMetadata(entry));
+    // 字段级校验：多写 / 漏写字段在这里失败（上面的逐字比较是自指的）。
+    expect(yaml.load(actual)).toEqual({
+      name: entry.name,
+      description: entry.description,
+      order: entry.order,
+    });
   });
 
   it("drops the persona row: the deployment system-prompt owns the persona", () => {

package/tool/generate-presets.ts

@@ -6,8 +6,11 @@
  * 必须随包发布；但手工维护副本会与上游 drift。这里把上游 `standard` / `ptc`
  * 当数据读入——`js-yaml` 用 include 的 `entryListSchema` 解析（`!!js` 标签
  * 因此保留为表达式节点）——在 JS 里改两处（删掉自带的 `persona` 行、把
- * `agent-instructions` 行指向本仓库的 fork），再 `dump` 回 YAML。上游任何结构性
- * 改动（新增/重命名 row、改字段）都自动跟随，不依赖易碎的文本锚点。
+ * `agent-instructions` 行的指令候选收紧为 AGENTS 系列），再 `dump` 回 YAML。
+ * 上游任何结构性改动（新增/重命名 row、改字段）都自动跟随，不依赖易碎的文本锚点。
+ *
+ * `agent-instructions` 行仍是上游官方插件：fork
+ * （`@morlay/dsh-agent-instructions-as-prompt`）暂不接入，工作区指令走官方行为。
  *
  * 产物落在 `dist/` 而非源码树：dist 是构建输出（gitignore），既不会与 oxfmt
  * 互相改格式，也不会把派生文件混进源码。
@@ -75,39 +78,41 @@ export const PERSONA_ROW_ID = "persona";
 export const INSTRUCTIONS_ROW_ID = "agent-instructions";
 
 /**
- * 承载工作区指令的插件：本仓库的 fork（baseline 走 system prompt）。
+ * 工作区指令的候选文件：只要 AGENTS 系列，不要 CLAUDE 系列。
  *
- * preset 是**会话级** composition，profile 级的 patch（禁用上游行 + 挂 fork）
- * 管不到它——不在这里替换，每个会话仍会由上游插件把 baseline 作为 user 消息
- * 注入一次。
+ * 上游默认是 `['AGENTS.md','CLAUDE.md']` 与 `['AGENTS.local.md','CLAUDE.local.md']`；
+ * 本部署不读 CLAUDE 系文件（覆盖上游 config 的这两个字段，其余字段如 `maxBytes`
+ * 保持上游值）。行本身仍是官方 `@deepseek-ai/dsh-agent-instructions`——fork 暂未
+ * 接入，见模块注释。
  */
-export const INSTRUCTIONS_PLUGIN = "@morlay/dsh-agent-instructions-as-prompt";
+export const INSTRUCTIONS_CONFIG = {
+  instructionFileCandidates: ["AGENTS.md"],
+  localInstructionFileCandidates: ["AGENTS.local.md"],
+} as const;
 
 /**
- * 把上游 composition 文本渲染成产物文本：解析 → 改 persona 与 instructions 两行 → dump。
- * @param source - 上游 preset id，用于 header 与诊断。
+ * 把上游 composition 文本渲染成产物文本：解析 → 删 persona 行、收紧指令候选 → dump。
  * @param upstream - 上游 composition 文本。
  * @returns 带 header 的产物文本。
  */
-export function renderComposition(source: string, upstream: string): string {
+export function renderComposition(upstream: string): string {
   const rows = yaml.load(upstream, {
     schema: entryListSchema,
   }) as CompositionRow[];
-  const instructions = rows.find((row) => row.id === INSTRUCTIONS_ROW_ID);
-  if (instructions === undefined) {
-    throw new Error(
-      `generate-presets: upstream \`${source}\` has no \`${INSTRUCTIONS_ROW_ID}\` row; ` +
-        "upstream changed — re-check which plugin loads the workspace instructions",
-    );
-  }
-
-  instructions.name = INSTRUCTIONS_PLUGIN;
   // 删掉 preset 自带的 `persona` 行：它会在 agent scope 注册
   // `deployment:persona-prefix` 并**遮蔽**部署级 persona（system-prompt 的
   // personaPrefix，见上游 system-prompt 的 Config 文档）。个人提示词只由
   // `cordis.patch.yml` 的 system-prompt 行提供，这里不再复制一份。
   const persona = rows.findIndex((row) => row.id === PERSONA_ROW_ID);
   if (persona >= 0) rows.splice(persona, 1);
+  const instructions = rows.find((row) => row.id === INSTRUCTIONS_ROW_ID);
+  if (instructions === undefined) {
+    throw new Error(
+      `generate-presets: upstream composition has no \`${INSTRUCTIONS_ROW_ID}\` row; ` +
+        "upstream changed — re-check which plugin loads the workspace instructions",
+    );
+  }
+  instructions.config = { ...instructions.config, ...INSTRUCTIONS_CONFIG };
   // `quotingType: '"'` 是刻意选择：yaml.dump 默认用单引号，而仓库的 oxfmt 会把
   // YAML 单引号改成双引号——不显式指定就会 fmt 与生成器来回改。指定后产物与
   // `oxfmt --check` 零差异（实测），故 `presets/**` 无需 fmt 忽略。
@@ -144,7 +149,7 @@ export function generatePresets(outDir: string = join(PACKAGE_ROOT, PRESETS_OUT_
     const dir = join(outDir, entry.source);
     mkdirSync(dir, { recursive: true });
     const compositionPath = join(dir, "agent.cordis.yml");
-    writeFileSync(compositionPath, renderComposition(entry.source, upstream));
+    writeFileSync(compositionPath, renderComposition(upstream));
     const metadataPath = join(dir, "preset.yml");
     writeFileSync(metadataPath, renderMetadata(entry));
     written.push(compositionPath, metadataPath);