dsh-thesis 2.0.1 → 2.0.2

package/docs/host-api.md

@@ -436,7 +436,14 @@ type PreStepDecision = { kind: 'reject' } | { kind: 'enter'; messages: UserMessa
 
 `next()` 保持当前 messages；返回值替换进入该步骤的消息，或拒绝该步骤（mode `waterfall`，按 agent 作用域过滤派发）。
 注入物必须是 `UserMessage`：`{ id, role: 'user', content: ContentBlock[], source }`，`source` 用
-`{ kind: 'plugin', plugin: '<name>' } & ContextFormed`（`form: 'instructions' | 'catalog' | 'snapshot' | 'notice' | 'relay' | 'recall'`）。
+`{ kind: 'plugin:<name>' } & ContextFormed`（`form: 'instructions' | 'catalog' | 'snapshot' | 'notice' | 'relay' | 'recall'`）。
+
+> **`kind` 必须是生产者自有值。** 从 v4 会话格式起，共享兜底 kind `plugin` 会被直接拒写：
+> `format v4 message requires a producer-owned source kind`，而且是在落会话日志时抛，
+> 整条会话起不来。第三方插件的规范写法是 `plugin:<包名>`——宿主的 v3→v4 迁移器
+> （`@deepseek-ai/dsh-session-format-v3-to-v4` 的 `producerKind`）给未知生产者生成的就是它，
+> 这样旧会话迁移后与新消息同源同 kind。本插件踩过：2.0.1 用了 `kind: 'plugin'`，
+> 论文工作区里的新会话一开就报上面那句。
 `form` 决定客户端怎么渲染，且**每个形态只带自己那几个字段**（`ContextFormed` 是判别联合）：
 `sections` 只属于 `snapshot`，`summary` 只属于 `notice`，`instructions` 的渲染依据是
 `changes`（工作区指令文件的改动清单，见 `dsh-agent-instructions`）。
@@ -459,7 +466,7 @@ export function registerPreStep(ctx: Context, buildCard: (cwd: string) => Promis
       kind: 'enter',
       messages: [...decision.messages, {
         id: randomUUID(), role: 'user', content: [{ type: 'text', text: note }],
-        source: { kind: 'plugin', plugin: 'my-plugin', form: 'snapshot', sections: [{ name: 'my-plugin', text: note }] },
+        source: { kind: 'plugin:my-plugin', form: 'snapshot', sections: [{ name: 'my-plugin', text: note }] },
       }],
     }
   }, { prepend: true })

package/docs/release.md

@@ -18,6 +18,16 @@
    | Workflow filename | `publish.yml`（只写文件名，不带路径）|
    | Environment name | **留空**（除非 workflow 里写了 `environment:`）|
 
+   同一页下方的 **Allowed actions**：
+
+   | 选项 | 勾不勾 | 为什么 |
+   |---|---|---|
+   | stage publish | 强制，改不了 | — |
+   | **Allow npm publish** | **勾上** | 不勾的话 `npm publish` 会被拒（`403 OIDC permission denied for this action`），只接受 `npm stage publish`，每次发版还得你到网页上做 2FA 批准 |
+   | Allow npm dist-tag | 不用勾 | `npm publish` 会自动把 `latest` 指过去；我们没有 `npm dist-tag` 操作 |
+
+   > 黄色提示条只说「provider 与必填字段建好后不能改」，`Allowed actions` 的两个勾选框随时可以改。
+
 2. 确认仓库是 **public**：私有仓库发不出 provenance。
 3. 不需要 `NPM_TOKEN`，**之前建过的话建议在 Settings → Secrets 里删掉**，免得以后误用。
 
@@ -103,6 +113,8 @@ Actions → publish → Run workflow：只做打包预览，**不会发布**。
 | 现象 | 原因 |
 |---|---|
 | `EOTP` / `This operation requires a one-time password` | 用的是需要 OTP 的 token（2FA 账号的 Granular / Publish token）。CI 里没人能输 OTP：改用可信发布，或换 Classic → Automation token |
+| 发布被拒，提示只能 `npm stage publish` | 可信发布里没勾 **Allow publish directly**（默认只允许 stage）|
+| `403 … OIDC permission denied for this action` | 同一条：OIDC 认证已经通过（组织/仓库/workflow 名字都对），只是没给「直接发布」权限。去包设置里编辑那条配置，勾上 **Allow npm publish** |
 | `401 Unauthorized` | token 过期（Automation token 有 90/180 天寿命），或可信发布配置里 workflow 文件名写错 |
 | `npm ci … not in sync` | 改了 `package.json` 的依赖/peer 却没跑 `npm install --package-lock-only` |
 | `403 … cannot publish over previously published version` | 版本号没升；这条在 workflow 里已被「已存在则跳过」挡住，手动发版时要注意 |

package/lib/autopilot/messages.d.ts

@@ -1,7 +1,8 @@
 /**
  * 自动驾驶注入的消息与关卡确认文案。
  *
- * 与闸门消息共用同一条 source 约定：`{ kind: 'plugin', plugin: 'dsh-thesis', form: 'instructions' }`。
+ * 与闸门消息共用同一条 source 约定：`{ kind: 'plugin:dsh-thesis', form: 'instructions' }`
+ * （v4 会话格式禁止兜底 kind `plugin`，见 `shared/message-source.ts`）。
  * `form` 是宿主渲染指令的语义形态；`sections` 只属于 snapshot 形态，这里不写。
  *
  * @module dsh-thesis/autopilot

package/lib/autopilot/messages.js

@@ -1,7 +1,8 @@
 /**
  * 自动驾驶注入的消息与关卡确认文案。
  *
- * 与闸门消息共用同一条 source 约定：`{ kind: 'plugin', plugin: 'dsh-thesis', form: 'instructions' }`。
+ * 与闸门消息共用同一条 source 约定：`{ kind: 'plugin:dsh-thesis', form: 'instructions' }`
+ * （v4 会话格式禁止兜底 kind `plugin`，见 `shared/message-source.ts`）。
  * `form` 是宿主渲染指令的语义形态；`sections` 只属于 snapshot 形态，这里不写。
  *
  * @module dsh-thesis/autopilot

package/lib/codewalk/host-types.d.ts

@@ -91,8 +91,8 @@ export interface InjectedUserMessageShape {
     readonly role: 'user';
     readonly content: readonly TextBlockShape[];
     readonly source: {
-        readonly kind: 'plugin';
-        readonly plugin: string;
+        /** 生产者自有 kind（本插件是 `plugin:dsh-thesis`）；v4 会话格式不接受兜底值 `plugin`。 */
+        readonly kind: string;
         /** 上下文形态：instructions / catalog / snapshot / notice / relay / recall（可缺省 = 不透明）。 */
         readonly form?: string;
         /** 只有 `form: 'snapshot'` 携带分节；`instructions` 形态的有效字段是 `changes`。 */

package/lib/codewalk/prestep.js

@@ -10,6 +10,7 @@
  */
 import { AiLearningEngine } from "./engine.js";
 import { newMessageId } from "./tools.js";
+import { THESIS_SOURCE } from "../shared/message-source.js";
 /** 为一份状态快照构造注入用的进度消息。 */
 export function buildProgressMessage(state) {
     const text = [
@@ -24,8 +25,7 @@ export function buildProgressMessage(state) {
         role: 'user',
         content: [{ type: 'text', text: full }],
         source: {
-            kind: 'plugin',
-            plugin: 'dsh-thesis',
+            ...THESIS_SOURCE,
             form: 'snapshot',
             sections: [{ name: '代码演练进度', text: full }],
         },

package/lib/gates/messages.d.ts

@@ -1,8 +1,10 @@
 /**
  * 闸门注入消息与决策理由的模板。
  *
- * 注入消息的 source 采用 `{ kind: 'plugin', plugin: 'dsh-thesis', form: 'instructions' }`：
- * - `plugin` 是生产者标识（GUI 用它做行首标签，也用于防重入识别"这已经是闸门消息"）；
+ * 注入消息的 source 采用 `{ kind: 'plugin:dsh-thesis', form: 'instructions' }`：
+ * - `kind` 是生产者自有标识。v4 会话格式禁止共享兜底 kind `plugin`，否则写会话日志
+ *   时直接抛 `format v4 message requires a producer-owned source kind`（见
+ *   `shared/message-source.ts`）；
  * - `form` 声明这条上下文的语义形态（当前契约的取值域：instructions / catalog /
  *   snapshot / notice / relay / recall）；
  * - **不带 `sections`**：`sections` 只属于 `snapshot` 形态（见
@@ -16,12 +18,11 @@
  * @module dsh-thesis/gates/messages
  */
 import type { UserMessage } from '@deepseek-ai/dsh-llm';
-/** 插件标识：注入消息 source.plugin 的值。 */
-export declare const PLUGIN_ID = "dsh-thesis";
+/** 插件标识：注入消息 source 的命名来源。 */
+export { PLUGIN_ID } from '../shared/message-source.ts';
 /** 注入消息的 source 基础形状（form 由调用方补充）。 */
 export declare const PLUGIN_SOURCE: {
-    readonly kind: "plugin";
-    readonly plugin: "dsh-thesis";
+    readonly kind: "plugin:dsh-thesis";
 };
 /**
  * 写作意图闸门注入给模型的指令。

package/lib/gates/messages.js

@@ -1,8 +1,10 @@
 /**
  * 闸门注入消息与决策理由的模板。
  *
- * 注入消息的 source 采用 `{ kind: 'plugin', plugin: 'dsh-thesis', form: 'instructions' }`：
- * - `plugin` 是生产者标识（GUI 用它做行首标签，也用于防重入识别"这已经是闸门消息"）；
+ * 注入消息的 source 采用 `{ kind: 'plugin:dsh-thesis', form: 'instructions' }`：
+ * - `kind` 是生产者自有标识。v4 会话格式禁止共享兜底 kind `plugin`，否则写会话日志
+ *   时直接抛 `format v4 message requires a producer-owned source kind`（见
+ *   `shared/message-source.ts`）；
  * - `form` 声明这条上下文的语义形态（当前契约的取值域：instructions / catalog /
  *   snapshot / notice / relay / recall）；
  * - **不带 `sections`**：`sections` 只属于 `snapshot` 形态（见
@@ -16,10 +18,11 @@
  * @module dsh-thesis/gates/messages
  */
 import { randomUUID } from 'node:crypto';
-/** 插件标识：注入消息 source.plugin 的值。 */
-export const PLUGIN_ID = 'dsh-thesis';
+import { THESIS_SOURCE } from "../shared/message-source.js";
+/** 插件标识：注入消息 source 的命名来源。 */
+export { PLUGIN_ID } from "../shared/message-source.js";
 /** 注入消息的 source 基础形状（form 由调用方补充）。 */
-export const PLUGIN_SOURCE = { kind: 'plugin', plugin: PLUGIN_ID };
+export const PLUGIN_SOURCE = THESIS_SOURCE;
 /**
  * 写作意图闸门注入给模型的指令。
  *

package/lib/intake/gate-rules.d.ts

@@ -52,7 +52,6 @@ export declare function makeIntakeGateMessage(status: SpecStatus, specRel: strin
     }>;
     source: {
         kind: string;
-        plugin: string;
-        form: string;
+        form: 'instructions';
     };
 };

package/lib/intake/gate-rules.js

@@ -10,6 +10,7 @@
  *
  * @module dsh-thesis/intake/gate-rules
  */
+import { THESIS_SOURCE } from "../shared/message-source.js";
 /** 「要开始写正文/开题报告」的意图模式（中英文）。 */
 const WRITING_INTENT_PATTERNS = [
     // 中文：写/生成/起草 + 论文/正文/章节/开题/中期
@@ -114,8 +115,7 @@ export function makeIntakeGateMessage(status, specRel, id) {
         role: 'user',
         content: [{ type: 'text', text }],
         source: {
-            kind: 'plugin',
-            plugin: 'dsh-thesis',
+            ...THESIS_SOURCE,
             form: 'instructions',
         },
     };

package/lib/memory/recall.d.ts

@@ -53,8 +53,7 @@ export declare function makeRecallMessage(entries: readonly MemoryEntry[], maxCh
     }>;
     source: {
         kind: string;
-        plugin: string;
-        form: string;
+        form: 'snapshot';
         sections: Array<{
             name: string;
             text: string;

package/lib/memory/recall.js

@@ -17,6 +17,7 @@
  */
 import { randomUUID } from 'node:crypto';
 import { textOfBlocks } from "../shared/text.js";
+import { THESIS_SOURCE } from "../shared/message-source.js";
 /** 出厂默认值（与 `PAPER_DEFAULTS.recall` 保持一致，单一来源见 `src/config.ts`）。 */
 export const RECALL_DEFAULTS = { maxEntries: 4, maxChars: 600, minKeywordLength: 2 };
 /** 停用词（中英混合，只去最吵的一批；不求语言学完备）。 */
@@ -111,8 +112,7 @@ export function makeRecallMessage(entries, maxChars) {
         role: 'user',
         content: [{ type: 'text', text }],
         source: {
-            kind: 'plugin',
-            plugin: 'dsh-thesis',
+            ...THESIS_SOURCE,
             form: 'snapshot',
             sections: [{ name: '已确认事实', text }],
         },

package/lib/shared/message-source.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 注入消息的 source 约定。
+ *
+ * 宿主从 v4 会话格式起要求消息 source 是**生产者自有的 kind**：共享兜底值
+ * `plugin` 会被直接拒写，错误是 `format v4 message requires a producer-owned
+ * source kind`，而且发生在写会话日志时——整条会话都起不来。2.0.1 发布后真踩过。
+ *
+ * 第三方插件的规范形态是 `plugin:<包名>`：宿主的 v3→v4 迁移器给未知生产者生成的
+ * 就是这个值（`@deepseek-ai/dsh-session-format-v3-to-v4` 里的 `producerKind`），
+ * 因此旧会话迁移后与新消息同源同 kind，前端不会把同一类上下文认成两种东西。
+ *
+ * @module dsh-thesis/shared/message-source
+ */
+/** 插件标识（与 package.json 的 name 一致）。 */
+export declare const PLUGIN_ID = "dsh-thesis";
+/** 生产者自有 kind。**不要改回 `plugin`**，否则 v4 会话写不进去。 */
+export declare const THESIS_SOURCE_KIND = "plugin:dsh-thesis";
+/** 注入消息 source 的基础形状（`form`/`sections` 由调用方补充）。 */
+export declare const THESIS_SOURCE: {
+    readonly kind: "plugin:dsh-thesis";
+};

package/lib/shared/message-source.js

@@ -0,0 +1,19 @@
+/**
+ * 注入消息的 source 约定。
+ *
+ * 宿主从 v4 会话格式起要求消息 source 是**生产者自有的 kind**：共享兜底值
+ * `plugin` 会被直接拒写，错误是 `format v4 message requires a producer-owned
+ * source kind`，而且发生在写会话日志时——整条会话都起不来。2.0.1 发布后真踩过。
+ *
+ * 第三方插件的规范形态是 `plugin:<包名>`：宿主的 v3→v4 迁移器给未知生产者生成的
+ * 就是这个值（`@deepseek-ai/dsh-session-format-v3-to-v4` 里的 `producerKind`），
+ * 因此旧会话迁移后与新消息同源同 kind，前端不会把同一类上下文认成两种东西。
+ *
+ * @module dsh-thesis/shared/message-source
+ */
+/** 插件标识（与 package.json 的 name 一致）。 */
+export const PLUGIN_ID = 'dsh-thesis';
+/** 生产者自有 kind。**不要改回 `plugin`**，否则 v4 会话写不进去。 */
+export const THESIS_SOURCE_KIND = `plugin:${PLUGIN_ID}`;
+/** 注入消息 source 的基础形状（`form`/`sections` 由调用方补充）。 */
+export const THESIS_SOURCE = { kind: THESIS_SOURCE_KIND };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-thesis",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "论文与答辩全流程助手（DeepSeek Harness 插件）：材料摄取 → 逐题追问 → 文献检索 → 逐章写作与评审 → 原创性自查与合规 → Word/答辩幻灯生产，全流程留痕，并跨会话记住学校规范与导师要求。",
   "type": "module",
   "main": "lib/index.js",