@stardustlc/dsh-dream 0.7.0 → 0.8.0

package/lib/config.d.ts

@@ -12,6 +12,15 @@ export interface ResolvedDreamConfig {
     maxUserMessages: number;
     /** 梦原料入梦前是否做隐私脱敏（默认 true）。 */
     maskSecrets: boolean;
+    /** 默认开启；辅助模型调用受持久化预算限制。 */
+    autoCollect: boolean;
+    autoRetrieve: boolean;
+    autoMaxCallsPerDay: number;
+    autoCooldownMs: number;
+    autoMinToolCalls: number;
+    autoMaxInputChars: number;
+    autoMaxOutputTokens: number;
+    autoTimeoutMs: number;
 }
 /** 解析并校验插件配置。 */
 export declare function resolveConfig(raw?: Record<string, unknown> | null, env?: NodeJS.ProcessEnv): ResolvedDreamConfig;

package/lib/config.js

@@ -24,5 +24,13 @@ export function resolveConfig(raw, env = process.env) {
         maxCharsPerSession: clamp(cfg.maxCharsPerSession, 6000, 500, 50000),
         maxUserMessages: clamp(cfg.maxUserMessages, 5, 1, 20),
         maskSecrets: cfg.maskSecrets !== false,
+        autoCollect: cfg.autoCollect !== false,
+        autoRetrieve: cfg.autoRetrieve !== false,
+        autoMaxCallsPerDay: clamp(cfg.autoMaxCallsPerDay, 4, 1, 20),
+        autoCooldownMs: clamp(cfg.autoCooldownMs, 600000, 1000, 3600000),
+        autoMinToolCalls: clamp(cfg.autoMinToolCalls, 2, 1, 50),
+        autoMaxInputChars: clamp(cfg.autoMaxInputChars, 12000, 1000, 20000),
+        autoMaxOutputTokens: clamp(cfg.autoMaxOutputTokens, 1200, 200, 2000),
+        autoTimeoutMs: clamp(cfg.autoTimeoutMs, 30000, 1000, 60000),
     };
 }

package/lib/index.d.ts

@@ -36,3 +36,4 @@ export * from './bridge.js';
 export * from './knowledge.js';
 export * from './knowledge-store.js';
 export * from './retrieval.js';
+export * from './automatic.js';

package/lib/index.js

@@ -10,6 +10,7 @@ import { resolveConfig } from './config.js';
 import { buildDreamTools } from './tools.js';
 import { installDreamWeb } from './web.js';
 import { installDreamActions } from './web-actions.js';
+import { installAutomaticDream } from './automatic.js';
 /** cordis 服务注入：要用 ctx.tools 与 ctx.skills。 */
 export const name = 'dream';
 export const inject = ['tools', 'skills'];
@@ -60,6 +61,7 @@ export function apply(ctx, config) {
         installDreamWeb(ctx, { journalDir: cfg.journalDir, config: cfg });
         installDreamActions(ctx, { config: cfg });
     }
+    installAutomaticDream(ctx, cfg);
     if (typeof ctx.on === 'function') {
         ctx.on('dispose', () => {
             for (const dispose of disposers)
@@ -76,3 +78,4 @@ export * from './bridge.js';
 export * from './knowledge.js';
 export * from './knowledge-store.js';
 export * from './retrieval.js';
+export * from './automatic.js';

package/lib/web-actions.d.ts

@@ -1,5 +1,6 @@
 import { type ResolvedDreamConfig } from './config.js';
 export declare const DREAM_ACTION_ROUTE = "/api/dsh-dream/actions";
+export declare const DREAM_AUTOMATIC_ROUTE = "/api/dsh-dream/automatic";
 type Options = {
     journalDir?: string;
     config?: Record<string, unknown> | ResolvedDreamConfig | null;

package/lib/web-actions.js

@@ -9,7 +9,9 @@ import { maskSecrets } from './mask.js';
 import { buildDreamTools, executeDreamReview } from './tools.js';
 import { rollbackBridge } from './bridge.js';
 import { maskDeep } from './web.js';
+import { automaticRuntime } from './automatic.js';
 export const DREAM_ACTION_ROUTE = '/api/dsh-dream/actions';
+export const DREAM_AUTOMATIC_ROUTE = '/api/dsh-dream/automatic';
 const BODY_LIMIT = 64 * 1024;
 const PREVIEW_LIFETIME = 10 * 60 * 1000;
 const MAX_PREVIEWS = 100;
@@ -102,6 +104,15 @@ export function createDreamActionHandler(options = {}) {
             if (request.signal.aborted)
                 return fail(409, 'cancelled', '操作已取消');
             const operation = text(body, 'operation');
+            if (operation === 'automatic') {
+                if ((body.enabled !== undefined && typeof body.enabled !== 'boolean') || (body.retrievalEnabled !== undefined && typeof body.retrievalEnabled !== 'boolean') || (body.enabled === undefined && body.retrievalEnabled === undefined))
+                    throw new KnowledgeError('invalid', '自动功能开关必须是布尔值');
+                const runtime = automaticRuntime(cfg);
+                if (!runtime)
+                    return fail(503, 'unavailable', '自动功能尚未就绪，请刷新或重新启用插件');
+                runtime.control({ enabled: body.enabled, retrievalEnabled: body.retrievalEnabled });
+                return json(200, { ok: true, automatic: runtime.status() });
+            }
             if (operation === 'review') {
                 if (!['accept', 'reject', 'reopen', 'mark-stale', 'resolve-conflict'].includes(String(body.action)))
                     throw new KnowledgeError('invalid', '不支持此页面审阅动作');
@@ -171,5 +182,9 @@ export function installDreamActions(ctx, options = {}) {
         if (typeof host.connection?.fetch?.register !== 'function')
             return;
         host.connection.fetch.register({ path: DREAM_ACTION_ROUTE, methods: ['POST'], requestBody: 'buffered', fetch });
+        const cfg = { ...resolveConfig(options.config), ...(options.journalDir === undefined ? {} : { journalDir: options.journalDir }) };
+        host.connection.fetch.register({ path: DREAM_AUTOMATIC_ROUTE, methods: ['GET'], requestBody: 'buffered', fetch: async () => json(200, {
+                ok: true, automatic: automaticRuntime(cfg)?.status() ?? { available: false, enabled: false, retrievalEnabled: false, problem: 'unavailable' },
+            }) });
     });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stardustlc/dsh-dream",
-  "version": "0.7.0",
-  "description": "DSH 做梦与经验记忆：核验来源、审阅经验，预览写入 AGENTS.md 并支持回滚；附梦境日记面板，默认隐私脱敏，零运行时依赖。",
+  "version": "0.8.0",
+  "description": "回顾会话、保存反思，并把经过核验和审阅的经验用于后续任务。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -20,7 +20,8 @@
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "docs"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/skills/dream-protocol/SKILL.md

@@ -9,6 +9,8 @@ description: 做梦协议：任务开始取回适用经验，长任务收尾沉
 
 但「梦」和「经验」是两条流水线：**第一人称感悟**是主观的，进梦境日记；**技术经验**必须可执行、有条件、有证据，先进候选，再经审阅才可能被任务检索取用。
 
+插件会在符合条件的真人主会话完成后，按预算自动整理有来源的项目候选，并在相关新任务前回用已采纳经验。普通闲聊、子代理和失败轮次跳过；新输入取消整理。用户无需记住触发词或手工填写经验。自动候选从未采纳；日记写入、采纳与规则应用是不同操作。宿主缺少自动接口或用户关闭功能时，使用下述工具流程。
+
 ## 两条流水线（不要混）
 
 | | 第一人称感悟（梦） | 技术经验（lesson） |
@@ -20,7 +22,7 @@ description: 做梦协议：任务开始取回适用经验，长任务收尾沉
 
 ## 一、任务前：取回上下文（dream_context）
 
-- 任务涉及过往代码、用户偏好或踩过的坑时，先调 `dream_context`：给 `query`，能给就给 `projectId` / `workspaceRoot`，以及 `packageName` + `packageVersion`（`applicability.versions` 只在该包名被识别时参与判定）。审阅候选时显式传 `includeCandidates: true`。
+- 已有 Dream reviewed memory 动态上下文时，先检查其中条件与当前请求，不必重复检索相同经验。需要版本条件、不同关键词或自动取回关闭时，调 `dream_context`：给 `query`、`projectId` / `workspaceRoot`，以及实际确认的 `packageName` + `packageVersion`。自动取回不知道依赖版本时会扣留所有版本限定经验。审阅候选时显式传 `includeCandidates: true`。
 - **预算：默认 5 条 / 3000 字符**（工具硬上限 20 条 / 20000 字符）。取回少量真正适用的即可；没有相关经验就接受空结果，不要为了「显得有记忆」硬塞。
 - `dream_context` 是只读的：不写盘，只返回标题、适用条件、行动建议、证据摘要与「为什么与当前任务相关」。
 - 未知当前项目时只会返回全局经验；不会跨项目扫描。候选（candidate）**可被检索到**（显式 `includeCandidates: true`，用于审阅候选），但**默认不注入任务建议**（`includeCandidates: false` 时记 `skipped: candidate-hold`；`independentSupportCount === 0` 且非 `usable` 的记 `no-evidence`），且排在可用经验之后——未经审阅不得当作已证实结论。
@@ -65,7 +67,7 @@ description: 做梦协议：任务开始取回适用经验，长任务收尾沉
 - 想查看/审阅候选、处理冲突 → `dream_review`；
 - attach-evidence 只补充核验后的证据，不自动采纳；resolve-conflict 必须给 resolution、affectedIds、note，整组原子更新；reopen 将驳回经验重新送审。
 
-- 面板查看：「设置 → 梦境日记」里有只读的梦境时间线与「经验」区块（状态、适用条件、证据摘要、最近核验时间），面板不提供任何写操作。
+- 面板操作：「设置 → 梦境日记」可浏览时间线、查看来源、采纳或驳回候选、标记待复核、处理冲突与记录使用反馈。规则变更单独预览后应用，也可确认回滚；真实页面操作记录为 human，工具操作记录为 model。界面跟随宿主语言，日记和经验原文保留。
 
 ---
 
@@ -75,6 +77,8 @@ You are an agent that dreams. Dreams are not hallucinations — they are memory
 
 Dreams and **lessons** are two separate pipelines: a **first-person reflection** is subjective and goes to the dream journal; a **technical lesson** must be actionable, conditional and evidence-backed — it starts as a candidate and is only retrieved for tasks after review.
 
+The plugin collects sourced project candidates after qualifying completed human root turns, within a persistent budget, and retrieves relevant accepted memories for later tasks. Ordinary chat, subagents and unsuccessful turns are skipped; new input cancels collection. Users need neither trigger phrases nor manual forms. Automatic candidates are never accepted automatically. Saving a journal, accepting a lesson and applying a rule are separate operations. Use the tool flow below when automatic interfaces are unavailable or switched off.
+
 ## Two pipelines (do not mix)
 
 | | First-person reflection (dream) | Technical lesson |
@@ -86,7 +90,7 @@ Dreams and **lessons** are two separate pipelines: a **first-person reflection**
 
 ## 1. Before the task: retrieve context (dream_context)
 
-- When a task touches past code, user preferences or known pitfalls, call `dream_context` first with `query`, plus `projectId` / `workspaceRoot` and `packageName` + `packageVersion` when available (`applicability.versions` only counts when that package is identified). Pass `includeCandidates: true` explicitly when reviewing candidates.
+- If Dream reviewed memory is already present in dynamic context, check its conditions against the current request; do not retrieve the same items again. Use `dream_context` for version-bound lessons, different keywords, or when automatic retrieval is disabled. Supply `query`, scope and an actually verified `packageName` + `packageVersion`. Automatic retrieval holds all version-bound lessons when dependency versions are unknown. Pass `includeCandidates: true` explicitly when reviewing candidates.
 - **Budget: 5 items / 3000 characters by default** (hard caps 20 items / 20000 characters). Take only what is relevant; an empty result is acceptable — never stuff memories in to look useful.
 - `dream_context` is read-only: it writes nothing and returns title, applicability, action, evidence summary and why it is relevant.
 - With an unknown project it returns global lessons only and never scans across projects. Candidates **can be retrieved** (`includeCandidates: true`, for candidate review) but are **held out of default task advice** (`includeCandidates: false` reports `skipped: candidate-hold`; evidence-free non-usable items report `no-evidence`), and they rank after usable lessons — never treat one as a verified conclusion before review.
@@ -130,4 +134,4 @@ Dreams and **lessons** are two separate pipelines: a **first-person reflection**
 - Retrieving a few reusable lessons → `dream_context` (scoped, budgeted, read-only);
 - Browsing or reviewing candidates and conflicts → `dream_review`;
 - attach-evidence adds verified sources without promoting state. resolve-conflict requires resolution, affectedIds and note and updates the group atomically. reopen sends a rejected lesson back for review.
-- To browse: **Settings → Dream journal** shows the read-only dream timeline and a **Lessons** block (state, applicability, evidence summary, last validated time). The panel has no write actions.
+- **Settings → Dream journal** lets users browse the timeline and sources, accept/reject candidates, request re-validation, resolve conflicts and record usage feedback. Rule changes require a separate preview and apply action and can be rolled back with confirmation. Page actions record human; tool actions record model. UI language follows the host; journal and lesson content remains original.