@lin0306/dsh-mind 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +219 -2
- package/client/index.js +1932 -0
- package/cordis.patch.yml +8 -0
- package/icon.svg +26 -0
- package/lib/index.js +8288 -0
- package/lib/index.js.map +1 -0
- package/lib/types/.tsbuildinfo +1 -0
- package/lib/types/commands.d.ts +92 -0
- package/lib/types/commands.d.ts.map +1 -0
- package/lib/types/config.d.ts +116 -0
- package/lib/types/config.d.ts.map +1 -0
- package/lib/types/decide.d.ts +57 -0
- package/lib/types/decide.d.ts.map +1 -0
- package/lib/types/entries.d.ts +124 -0
- package/lib/types/entries.d.ts.map +1 -0
- package/lib/types/host.d.ts +184 -0
- package/lib/types/host.d.ts.map +1 -0
- package/lib/types/index.d.ts +64 -0
- package/lib/types/index.d.ts.map +1 -0
- package/lib/types/inject.d.ts +58 -0
- package/lib/types/inject.d.ts.map +1 -0
- package/lib/types/layout.d.ts +115 -0
- package/lib/types/layout.d.ts.map +1 -0
- package/lib/types/log.d.ts +29 -0
- package/lib/types/log.d.ts.map +1 -0
- package/lib/types/migrate.d.ts +44 -0
- package/lib/types/migrate.d.ts.map +1 -0
- package/lib/types/persist.d.ts +57 -0
- package/lib/types/persist.d.ts.map +1 -0
- package/lib/types/persona-md.d.ts +44 -0
- package/lib/types/persona-md.d.ts.map +1 -0
- package/lib/types/proactive.d.ts +64 -0
- package/lib/types/proactive.d.ts.map +1 -0
- package/lib/types/projection.d.ts +245 -0
- package/lib/types/projection.d.ts.map +1 -0
- package/lib/types/settings-bridge.d.ts +183 -0
- package/lib/types/settings-bridge.d.ts.map +1 -0
- package/lib/types/store.d.ts +188 -0
- package/lib/types/store.d.ts.map +1 -0
- package/lib/types/tools.d.ts +109 -0
- package/lib/types/tools.d.ts.map +1 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +87 -4
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主(DSH / Cordis)接口的**最小声明**与容错取用。
|
|
3
|
+
*
|
|
4
|
+
* 为什么不直接 `import type { Context } from '@deepseek-ai/cordis'`:
|
|
5
|
+
* 插件会被 pnpm 以 `file:` / `link:` 放进 profile,能不能解析到宿主的包**不保证**,
|
|
6
|
+
* 而静态 import 解析不到 = **整个插件加载失败**。所以这一层只声明"我用到的形状",
|
|
7
|
+
* 运行时用 `ctx.get(name)` 取服务,取不到就降级,绝不向上抛。
|
|
8
|
+
*
|
|
9
|
+
* 这一层是**唯一**允许写 DSH 专有名词的地方。core 里不许出现这些名字。
|
|
10
|
+
*/
|
|
11
|
+
/** Cordis 的注册返回值:**是一个函数**,不是 `{ off() }` 对象。 */
|
|
12
|
+
export type Disposable = () => void;
|
|
13
|
+
/** 宿主日志器(headless 下可能没人接,所以日志只当锦上添花)。 */
|
|
14
|
+
export interface LoggerLike {
|
|
15
|
+
debug?(...args: unknown[]): void;
|
|
16
|
+
info?(...args: unknown[]): void;
|
|
17
|
+
warn?(...args: unknown[]): void;
|
|
18
|
+
error?(...args: unknown[]): void;
|
|
19
|
+
}
|
|
20
|
+
/** 我用到的 Context 形状。 */
|
|
21
|
+
export interface MindContext {
|
|
22
|
+
get?(name: string): unknown;
|
|
23
|
+
on?(event: string, listener: (...args: unknown[]) => unknown): Disposable;
|
|
24
|
+
inject?(names: readonly string[], register: (scope: MindContext) => unknown): Disposable;
|
|
25
|
+
/**
|
|
26
|
+
* Cordis 的副作用注册:`ctx.effect(callback, label?)`——作用域销毁时回调返回的清理函数会被调用。
|
|
27
|
+
*
|
|
28
|
+
* 用法与 `on` 一样是"注册了就要能撤":路由与设置服务都是**可撤回**的东西(宿主重载插件、
|
|
29
|
+
* 关掉某个服务时,作用域会销毁),不挂在 effect 上就会留下悬空注册。
|
|
30
|
+
* 声明成可选:老部署或测试里的假 ctx 未必有它,没有时调用方直接执行一次即可。
|
|
31
|
+
*/
|
|
32
|
+
effect?(callback: () => unknown, label?: string): Disposable;
|
|
33
|
+
logger?: LoggerLike;
|
|
34
|
+
[extra: string]: unknown;
|
|
35
|
+
}
|
|
36
|
+
/** 会话对象:只需要 id。 */
|
|
37
|
+
export interface SessionLike {
|
|
38
|
+
id?: string;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* 会话头里我们用到的最小形状。
|
|
42
|
+
*
|
|
43
|
+
* `cwd` 是"我在哪个工作区"的**唯一可靠来源**(平台已确认的声明):
|
|
44
|
+
* 投影 `init` 时就能拿到,而会话头是会话身份的一部分,所以由它派生的状态仍可回放。
|
|
45
|
+
* 不声明它,工作区就只能靠猜(进程 cwd 会变,session.id 与目录无关)。
|
|
46
|
+
*/
|
|
47
|
+
export interface SessionHeaderLike {
|
|
48
|
+
cwd?: string;
|
|
49
|
+
/**
|
|
50
|
+
* 会话 id。
|
|
51
|
+
*
|
|
52
|
+
* 平台声明里是 `SessionHeader.id: SessionId`(branded string),这里只取最小形状。
|
|
53
|
+
* 它也是会话身份的一部分,所以由它派生的状态仍然可回放——这正是我们要的:
|
|
54
|
+
* 没选工作区的会话写下的记忆要能标出"是哪个会话说的"。
|
|
55
|
+
*/
|
|
56
|
+
id?: string;
|
|
57
|
+
}
|
|
58
|
+
/** 会话事件的最小形状(与 core 的 `SessionEventLike` 结构一致)。 */
|
|
59
|
+
export interface HostEvent {
|
|
60
|
+
type: string;
|
|
61
|
+
seq?: number;
|
|
62
|
+
time?: number;
|
|
63
|
+
data?: unknown;
|
|
64
|
+
}
|
|
65
|
+
export interface PromptSectionSpec {
|
|
66
|
+
name: string;
|
|
67
|
+
order?: number;
|
|
68
|
+
text: () => string;
|
|
69
|
+
interpolate?: boolean;
|
|
70
|
+
}
|
|
71
|
+
/** 动态段拿到的渲染上下文。它有 `agent`,所以不必用闭包去抓会话。 */
|
|
72
|
+
export interface PromptRenderContext {
|
|
73
|
+
agent?: {
|
|
74
|
+
id?: string;
|
|
75
|
+
session?: SessionLike;
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
export interface PromptContextSpec {
|
|
79
|
+
name: string;
|
|
80
|
+
order?: number;
|
|
81
|
+
text: (context: PromptRenderContext) => string;
|
|
82
|
+
interpolate?: boolean;
|
|
83
|
+
}
|
|
84
|
+
export interface SystemPromptService {
|
|
85
|
+
section(spec: PromptSectionSpec): Disposable;
|
|
86
|
+
context(spec: PromptContextSpec): Disposable;
|
|
87
|
+
}
|
|
88
|
+
export interface ProjectionWire {
|
|
89
|
+
viewSchema?: unknown;
|
|
90
|
+
/** 同一个状态引用必须复用同一个视图引用(注册表按引用比对)。 */
|
|
91
|
+
view(state: unknown): unknown;
|
|
92
|
+
}
|
|
93
|
+
export interface ProjectionDefinition {
|
|
94
|
+
key: string;
|
|
95
|
+
stateVersion: number;
|
|
96
|
+
stateSchema?: unknown;
|
|
97
|
+
/** 新会话的起点;宿主会传会话头(其中有 `cwd`)。测试与老调用方可能不带参数。 */
|
|
98
|
+
init: (header?: SessionHeaderLike) => unknown;
|
|
99
|
+
apply: (state: unknown, event: HostEvent) => unknown;
|
|
100
|
+
wire?: ProjectionWire;
|
|
101
|
+
}
|
|
102
|
+
export interface SessionProjectionsService {
|
|
103
|
+
register(definition: ProjectionDefinition): Disposable;
|
|
104
|
+
stateOf(session: unknown, key: string): unknown;
|
|
105
|
+
}
|
|
106
|
+
export interface ToolOutputSpec {
|
|
107
|
+
schema?: Record<string, unknown>;
|
|
108
|
+
render?: (args: unknown, value: unknown) => unknown[];
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* 工具执行时宿主给的上下文。
|
|
112
|
+
*
|
|
113
|
+
* 真机会传 `{ agent, signal, deferContext }`(对照 feiyu-memory 的接收方式),
|
|
114
|
+
* `agent.session` 就是"这次调用属于哪个会话"。记忆的跨工作区判定要靠它取工作区键——
|
|
115
|
+
* 工具是根作用域注册的,拿不到会话就没法知道自己在哪个工作区。
|
|
116
|
+
*/
|
|
117
|
+
export interface ToolExecuteContext {
|
|
118
|
+
agent?: {
|
|
119
|
+
id?: string;
|
|
120
|
+
session?: SessionLike;
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
export interface ToolSpec {
|
|
124
|
+
name: string;
|
|
125
|
+
description: string;
|
|
126
|
+
/** 标准 JSON Schema(这里允许 `required: [...]` 数组)。 */
|
|
127
|
+
parameters: Record<string, unknown>;
|
|
128
|
+
output?: ToolOutputSpec;
|
|
129
|
+
execute(args: Record<string, unknown>, context?: ToolExecuteContext): unknown | Promise<unknown>;
|
|
130
|
+
}
|
|
131
|
+
export interface ToolsService {
|
|
132
|
+
register(spec: ToolSpec): Disposable;
|
|
133
|
+
}
|
|
134
|
+
export interface CommandInvocation {
|
|
135
|
+
agent?: {
|
|
136
|
+
id?: string;
|
|
137
|
+
session?: SessionLike;
|
|
138
|
+
};
|
|
139
|
+
rawInput?: string;
|
|
140
|
+
[extra: string]: unknown;
|
|
141
|
+
}
|
|
142
|
+
export interface CommandSpec {
|
|
143
|
+
name: string;
|
|
144
|
+
description: string;
|
|
145
|
+
input?: {
|
|
146
|
+
hint?: string;
|
|
147
|
+
};
|
|
148
|
+
handler(invocation: CommandInvocation): string | Promise<string>;
|
|
149
|
+
}
|
|
150
|
+
export interface CommandsService {
|
|
151
|
+
register(spec: CommandSpec): Disposable;
|
|
152
|
+
}
|
|
153
|
+
/** 取一个服务;拿不到返回 undefined,绝不抛。 */
|
|
154
|
+
export declare function service<T>(ctx: MindContext, name: string): T | undefined;
|
|
155
|
+
/** 包一层 try/catch:插件永远不许挡住聊天。 */
|
|
156
|
+
export declare function safe<T>(what: string, ctx: MindContext, fn: () => T, fallback: T): T;
|
|
157
|
+
/** 异步版的 `safe`。 */
|
|
158
|
+
export declare function safeAsync<T>(what: string, ctx: MindContext, fn: () => Promise<T>, fallback: T): Promise<T>;
|
|
159
|
+
/** 写日志;日志器本身也可能没有。 */
|
|
160
|
+
export declare function warn(ctx: MindContext, ...args: unknown[]): void;
|
|
161
|
+
export declare function debug(ctx: MindContext, ...args: unknown[]): void;
|
|
162
|
+
/**
|
|
163
|
+
* DSH 主目录:`$DSH_HOME` 优先,否则 `~/.dsh`(与 dsh-home-paths 行为一致)。
|
|
164
|
+
* 不 import `@deepseek-ai/dsh-home-paths`:为一个取值多担一次加载风险不值得。
|
|
165
|
+
*/
|
|
166
|
+
export declare function dshHome(): string;
|
|
167
|
+
/**
|
|
168
|
+
* 试着 require 一个宿主自带的包,**多试几个基准**。
|
|
169
|
+
*
|
|
170
|
+
* 只认 `import.meta.url` 是不够的(feiyu-memory 实测):pnpm 把包装进
|
|
171
|
+
* `.pnpm/<pkg>@<ver>/node_modules/<pkg>/`,而它外面的 node_modules 里没有
|
|
172
|
+
* `@deepseek-ai/schemastery`;用 `link:` 安装时插件在别的盘、包在 profile 里,
|
|
173
|
+
* 隔了十万八千里。所以还要试 profile 目录、DSH 安装目录、DSH_HOME 下的各 profile。
|
|
174
|
+
*/
|
|
175
|
+
export declare function resolveModule(name: string, specifier: string, trace?: (base: string, error: unknown) => void,
|
|
176
|
+
/**
|
|
177
|
+
* 判定"这个结果能不能用"。
|
|
178
|
+
*
|
|
179
|
+
* 必须逐个基准判形状,不能拿到就返回:DSH 的安装目录里可能装着**另一个版本的同一个包**
|
|
180
|
+
* (实测:从 `app.asar` 里 require 到的 schemastery 形状与插件自己 node_modules 里的不一样,
|
|
181
|
+
* 于是"require 成功了、但 `object` 不是构造器",插件照样降级,而且**连失败记录都没有**)。
|
|
182
|
+
*/
|
|
183
|
+
usable?: (loaded: unknown) => boolean): unknown;
|
|
184
|
+
//# sourceMappingURL=host.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/host.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dsh-mind · Host 半边
|
|
3
|
+
*
|
|
4
|
+
* 把内核(`dsh-mind-core`,与 agent 无关的纯逻辑)接到 DSH 上。这一层只做四件事:
|
|
5
|
+
*
|
|
6
|
+
* 1. **接线**:把宿主服务取出来,把投影 / 提示词 / 工具 / 命令挂上去;
|
|
7
|
+
* 2. **翻译**:把 DSH 的事件形状翻成内核认的 `SessionEventLike`(其实形状一致,主要是类型);
|
|
8
|
+
* 3. **跨会话**:会话起点接管人设与长期记忆,会话过程中把变化写回档案;
|
|
9
|
+
* 4. **容错**:任何一步失败都只降级——**少一个情感插件,不能影响用户聊天**。
|
|
10
|
+
*
|
|
11
|
+
* 三条不可破的纪律:
|
|
12
|
+
* - 所有事件回调与注入函数都包 try/catch,绝不向上抛;
|
|
13
|
+
* - 状态只由会话日志派生(`applyEvent` 纯函数),这一层**不许**直接改状态;
|
|
14
|
+
* - 不在 `agent/turn-stopping` 这类 serial 且会被 await 的地方做任何慢事。
|
|
15
|
+
*/
|
|
16
|
+
import { Config, type MindConfig } from './config.js';
|
|
17
|
+
import type { CrossSessionResult } from './tools.js';
|
|
18
|
+
import { type MindContext } from './host.js';
|
|
19
|
+
/** Cordis 插件身份:模块上只有 name / inject / Config / apply 会被读。 */
|
|
20
|
+
export declare const name = "dsh-mind";
|
|
21
|
+
/**
|
|
22
|
+
* 硬依赖:缺任何一个就静默不激活。
|
|
23
|
+
*
|
|
24
|
+
* 这是刻意的——**少一个情感插件,不能影响用户聊天**。
|
|
25
|
+
* 只声明"稳定服务",后注册的服务(如 `remote.xxx`)一律用 `ctx.get()` 取,
|
|
26
|
+
* 否则守卫会永久停在 pending(`@deepseek-ai/dsh-agent-loop` 的已知陷阱)。
|
|
27
|
+
*/
|
|
28
|
+
export declare const inject: string[];
|
|
29
|
+
export { Config };
|
|
30
|
+
export type { MindConfig };
|
|
31
|
+
export { CONFIG_FIELDS, CONFIG_GROUPS, configCatalog, describeConfig, flag, num, str, toTunables } from './config.js';
|
|
32
|
+
export { MIND_PACKAGE_NAME, MISSING_SETTINGS_REASON, SETTINGS_ROUTE_PREFIX, RouteFailure, createSettingsApi, entryIdCandidates, handleSettingsRequest, isSettingsConflict, makeSettingsFace, methodOfPath, ownEntryId, registerSettingsBridge, resolveSettingsNamespace, serviceVia, } from './settings-bridge.js';
|
|
33
|
+
export { PROJECTION_KEY, STATE_KEYS, STATE_VERSION, registerProjection, stateOf } from './projection.js';
|
|
34
|
+
export { applyDecision, registerDecision } from './decide.js';
|
|
35
|
+
export { FORGET_TOOL, INNER_NOTE_TOOL, RECALL_TOOL, forgetTool, innerNoteTool, recallTool } from './tools.js';
|
|
36
|
+
export type { CrossSessionOptions, CrossSessionRecall, CrossSessionResult } from './tools.js';
|
|
37
|
+
export { parsePersonaText, readPersonaKernel, writePersonaTemplate } from './persona-md.js';
|
|
38
|
+
export { PROACTIVE_SOURCE_KIND, PROACTIVE_WAKE_TEXT, registerProactive, wakeMessage } from './proactive.js';
|
|
39
|
+
export { personaText, realtimeText, registerPersonaSection, registerRealtimeContext } from './inject.js';
|
|
40
|
+
export { extract, loadArchive, personaFile, signature, stateDir } from './persist.js';
|
|
41
|
+
export { archiveDir, archiveFile, ensureDirFor, fileExists, globalDir, globalMemoryFile, globalPersonaFile, globalSummaryFile, legacyMigrationFile, listSessionIds, listShortFiles, logFile, migrationFile, readJson, readText, readZstdLines, rootDir, safeKey, sessionDir, sessionMemoryFile, sessionSummaryFile, sessionsDir, shortDir, shortFile, trashDir, trashFile, writeJsonAtomic, writeTextAtomic, writeZstdLines, type ZstdLinesResult, } from './layout.js';
|
|
42
|
+
export { migrateToV3, migrateV1, type MigrationCounts, type MigrationResult } from './migrate.js';
|
|
43
|
+
export { TRASH_KEEP } from './store.js';
|
|
44
|
+
export { asWorkspaceEntry, clearSessions, clearShort, collectMemoryIds, loadGlobal, loadPersonaState, loadSession, loadShort, loadTrash, markTrashRestored, purgeTrash, saveGlobal, savePersonaState, saveSession, saveShort, saveTrash, selectSessionsBySummary, toStored, trashGone, type PersonaSnapshotSource, type SessionSelection, type SnapshotWriteOptions, type WritableEntry, } from './store.js';
|
|
45
|
+
export { SCOPES, SNAPSHOT_KEEP, SNAPSHOT_REASONS, STORE_VERSION, entryLine, parseSnapshotLine, parseStoredEntry, parseStoredFile, renderGlobalSummary, renderSessionSummary, wrapSnapshot, type SnapshotReason, type StoredEntry, type StoredFile, type StoredScope, type StoredSnapshot, } from './entries.js';
|
|
46
|
+
/**
|
|
47
|
+
* 两段式跨会话检索的适配层实现:先按简介选会话,再只进选中的那几个读最后一份快照。
|
|
48
|
+
*
|
|
49
|
+
* 抽成不依赖 Cordis 的纯函数(只要数据目录与当前会话 id),是为了能直接测;
|
|
50
|
+
* 它不改任何状态,也不写盘。
|
|
51
|
+
*
|
|
52
|
+
* 分页**不在这里做**:要先 `recall` 打分才知道"共几条命中",所以 `page`/`pageSize`
|
|
53
|
+
* 只回显(`page` 用于排查,`pageSize` 留给工具切命中)。`total` 是搬来的候选条目数,
|
|
54
|
+
* 不是命中数。
|
|
55
|
+
*/
|
|
56
|
+
export declare function crossSessionRecall(raw: string, currentSessionId: string, query: string, page: number, pageSize: number, sessionLimit?: number): CrossSessionResult;
|
|
57
|
+
/**
|
|
58
|
+
* 插件入口。
|
|
59
|
+
*
|
|
60
|
+
* @param ctx 插件作用域(root)。每-agent 的东西一律在 `agent/created` 里用 `agent.ctx` 注册。
|
|
61
|
+
* @param config patch 里给的配置(可能是 `{}`、可能缺键,按默认补齐)
|
|
62
|
+
*/
|
|
63
|
+
export declare function apply(ctx: MindContext, config?: MindConfig): void;
|
|
64
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 提示词注入:一段进**系统提示词**,一段进**请求末尾**。
|
|
3
|
+
*
|
|
4
|
+
* 这个分工不是审美问题,是实测出来的:
|
|
5
|
+
* fyue7-emotion 把每步都在变的状态放进了 `section(order 10150)`,结果它之后的
|
|
6
|
+
* 工具 schema 与全部历史每一步都失去前缀复用,**命中量恒定卡在 ~2.8k token、命中率跌到个位数**。
|
|
7
|
+
* 所以:
|
|
8
|
+
*
|
|
9
|
+
* | 内容 | 落点 | 为什么 |
|
|
10
|
+
* |---|---|---|
|
|
11
|
+
* | 人设(内核 / 自我认知 / 说话习惯 / 硬边界) | `systemPrompt.section` | 改动很少,放系统提示词几乎不影响缓存,且每轮不重复占尾巴 |
|
|
12
|
+
* | 此刻的实况(情绪 / 思想 / 相处 / 手边记忆) | `systemPrompt.context` | 每步都变,放请求末尾则只有尾巴这一小段是新的 |
|
|
13
|
+
*
|
|
14
|
+
* `section` 的 `text()` 是**同步无参**的,拿不到会话,所以人设段必须按 agent 注册
|
|
15
|
+
* (在 `agent/created` 里用 `agent.ctx` 注册,闭包抓住这个 agent 的会话)。
|
|
16
|
+
* 万一拿不到会话对象,就退回"把人设并进请求末尾"——**降级,但绝不缺席**。
|
|
17
|
+
*/
|
|
18
|
+
import { type MindState, type MindTunables } from 'dsh-mind-core';
|
|
19
|
+
import type { Disposable, SystemPromptService } from './host.js';
|
|
20
|
+
/** 段名带自己的前缀,别撞别人的。 */
|
|
21
|
+
export declare const PERSONA_SECTION = "dsh-mind:persona";
|
|
22
|
+
export declare const REALTIME_SECTION = "dsh-mind:realtime";
|
|
23
|
+
/** 宿主自用 order:SANDBOX_POLICY 110、APPROVAL_POLICY 115、SUBAGENT_DELEGATION 120;竞品用 130/131。 */
|
|
24
|
+
export declare const PERSONA_ORDER = 132;
|
|
25
|
+
export declare const REALTIME_ORDER = 133;
|
|
26
|
+
/** 注入层的依赖:都是"取当前状态"的薄函数,方便测试时替换。 */
|
|
27
|
+
export interface InjectDeps {
|
|
28
|
+
tunables(): MindTunables;
|
|
29
|
+
stateOfSession(session: unknown): MindState | undefined;
|
|
30
|
+
}
|
|
31
|
+
/** 人设段正文:内核 / 自我认知 / 说话习惯 / 硬边界。**完全稳定**。 */
|
|
32
|
+
export declare function personaText(state: MindState, t: MindTunables): string;
|
|
33
|
+
/**
|
|
34
|
+
* 实况段正文:此刻的情绪、思想、相处,加上手边记着的事。
|
|
35
|
+
*
|
|
36
|
+
* 没有素材时返回空串——**这一段的正确表现形式就是不存在**,
|
|
37
|
+
* 绝不拿"我现在心情平静"之类的话去把它填满(那会让模型开始朗读情绪)。
|
|
38
|
+
*
|
|
39
|
+
* @param personaFallback 拿不到会话、人设段注册不上时的兜底人设文本
|
|
40
|
+
*/
|
|
41
|
+
export declare function realtimeText(state: MindState, t: MindTunables, now: number, personaFallback?: string): string;
|
|
42
|
+
/** 这个 agent 有没有在系统提示词里拿到人设段。 */
|
|
43
|
+
export declare function hasPersonaSection(agent: unknown): boolean;
|
|
44
|
+
/** 标记:这个 agent 的人设段已挂好。 */
|
|
45
|
+
export declare function markPersonaSection(agent: unknown): void;
|
|
46
|
+
/**
|
|
47
|
+
* 注册人设段(**按 agent**)。
|
|
48
|
+
*
|
|
49
|
+
* @param systemPrompt 该 agent 作用域下的 systemPrompt 服务
|
|
50
|
+
* @param session 该 agent 的会话
|
|
51
|
+
* @param agent 用来做标记,决定尾巴要不要兜底
|
|
52
|
+
*/
|
|
53
|
+
export declare function registerPersonaSection(systemPrompt: SystemPromptService, session: unknown, agent: unknown, deps: InjectDeps): Disposable;
|
|
54
|
+
/**
|
|
55
|
+
* 注册实况段(根作用域即可:渲染回调自带 `agent`,不必用闭包抓会话)。
|
|
56
|
+
*/
|
|
57
|
+
export declare function registerRealtimeContext(systemPrompt: SystemPromptService, deps: InjectDeps): Disposable;
|
|
58
|
+
//# sourceMappingURL=inject.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,UAAU,EAAuB,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAGrF,sBAAsB;AACtB,eAAO,MAAM,eAAe,qBAAqB,CAAA;AACjD,eAAO,MAAM,gBAAgB,sBAAsB,CAAA;AAEnD,6FAA6F;AAC7F,eAAO,MAAM,aAAa,MAAM,CAAA;AAChC,eAAO,MAAM,cAAc,MAAM,CAAA;AAkBjC,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,QAAQ,IAAI,YAAY,CAAA;IACxB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;CACxD;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,CAAC,EAAE,YAAY,EACf,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAmER;AAKD,gCAAgC;AAChC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,2BAA2B;AAC3B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,mBAAmB,EACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,UAAU,GACf,UAAU,CAsBZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAuBvG"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/** 根目录(`$DSH_HOME/dsh-mind/`)。
|
|
2
|
+
*
|
|
3
|
+
* 末尾的分隔符要去掉:`path.normalize` 在 Windows 上会把它留着,而"根"只该有一种写法——
|
|
4
|
+
* 否则 `startsWith(root + sep)` 这类判断会被双分隔符绊住,日志里也会出现两种根路径。
|
|
5
|
+
* 盘符根(`E:\`)是唯一例外,去掉就成了 `E:`,那是另一个意思。
|
|
6
|
+
*/
|
|
7
|
+
export declare function rootDir(raw: string): string;
|
|
8
|
+
/** `global/`:跨会话要带走的东西。 */
|
|
9
|
+
export declare function globalDir(raw: string): string;
|
|
10
|
+
/** 全局记忆(规矩 / 关于人 / 带出处的工作区条目)。每次写入追加一份快照。 */
|
|
11
|
+
export declare function globalMemoryFile(raw: string): string;
|
|
12
|
+
/** 人设的跨会话部分:人设快照 / 性情基线 / 统计 / 遗忘名单。每次写入追加一份快照。 */
|
|
13
|
+
export declare function globalPersonaFile(raw: string): string;
|
|
14
|
+
/** 全局记忆简介(人看,同时是注入里的"长期库有多少条"索引的出处)。 */
|
|
15
|
+
export declare function globalSummaryFile(raw: string): string;
|
|
16
|
+
/** `trash/`:回收站。假删(清 / 划)的落点;宿主停着时整目录搬走就能彻底清掉。 */
|
|
17
|
+
export declare function trashDir(raw: string): string;
|
|
18
|
+
/**
|
|
19
|
+
* 回收站:一个文件装所有被删掉的条目。
|
|
20
|
+
*
|
|
21
|
+
* 为什么不靠"快照文件的前几行":那些行会被 `SNAPSHOT_KEEP` 裁掉——文件满 20 行时,
|
|
22
|
+
* 一次清空正好把被清的内容挤出窗口(2026-11-15 实测:两个文件都已满 20 行)。
|
|
23
|
+
* 所以被删的条目**另存一份**,与裁剪策略无关。
|
|
24
|
+
*/
|
|
25
|
+
export declare function trashFile(raw: string): string;
|
|
26
|
+
/** `sessions/`:每个会话一个目录。 */
|
|
27
|
+
export declare function sessionsDir(raw: string): string;
|
|
28
|
+
/**
|
|
29
|
+
* 一个会话的目录。
|
|
30
|
+
*
|
|
31
|
+
* 会话 id 形如 `session-4a9596a3-…`,本来就是文件系统安全的,但**不假设**:
|
|
32
|
+
* 归一化一次,免得某个宿主版本给出带斜杠的 id 把文件写到目录外面去。
|
|
33
|
+
*/
|
|
34
|
+
export declare function sessionDir(raw: string, sessionId: string): string;
|
|
35
|
+
/** 会话记忆:一份日记,每次写入追加一份完整快照(可修订)。 */
|
|
36
|
+
export declare function sessionMemoryFile(raw: string, sessionId: string): string;
|
|
37
|
+
/** 会话记忆简介。 */
|
|
38
|
+
export declare function sessionSummaryFile(raw: string, sessionId: string): string;
|
|
39
|
+
/** 列出已经有目录的会话 id(按名字排序,稳定)。 */
|
|
40
|
+
export declare function listSessionIds(raw: string): string[];
|
|
41
|
+
/** `short/`:短期记忆,按工作区一份。 */
|
|
42
|
+
export declare function shortDir(raw: string): string;
|
|
43
|
+
/** 短期记忆(一个工作区一份,每次写入追加一份完整快照)。 */
|
|
44
|
+
export declare function shortFile(raw: string, workspaceKey: string): string;
|
|
45
|
+
/**
|
|
46
|
+
* 列出已经存在的短期文件(绝对路径,按文件名排序)。
|
|
47
|
+
*
|
|
48
|
+
* 清空短期记忆时按**文件**清:文件名是工作区键的哈希,反推不回工作区键,
|
|
49
|
+
* 而"这个工作区在这儿"未必有人知道(换个工作区开新会话就不知道了)。
|
|
50
|
+
*/
|
|
51
|
+
export declare function listShortFiles(raw: string): string[];
|
|
52
|
+
/** `archive/`:退休的旧文件。只进不出,出问题还能翻回来对。 */
|
|
53
|
+
export declare function archiveDir(raw: string): string;
|
|
54
|
+
/** 日志文件(单独一个文件夹,别堆在根目录)。 */
|
|
55
|
+
export declare function logFile(raw: string): string;
|
|
56
|
+
/**
|
|
57
|
+
* 一次性迁移的标记(沿用 `reset-once` 那套做法:跑完写下,之后不再重复处理)。
|
|
58
|
+
*
|
|
59
|
+
* v2 的标记叫 `migrated-to-v2`,迁移时会被搬进 `archive/`;从 v3 起只认这一个。
|
|
60
|
+
*/
|
|
61
|
+
export declare function migrationFile(raw: string): string;
|
|
62
|
+
/** 上一代的迁移标记(只在 v2→v3 里搬它进 `archive/` 时用得到)。 */
|
|
63
|
+
export declare function legacyMigrationFile(raw: string): string;
|
|
64
|
+
/**
|
|
65
|
+
* 工作区键 → 一个**文件名安全**的短名。
|
|
66
|
+
*
|
|
67
|
+
* 工作区键长这样:`E:/code/thought`。直接当文件名有两个问题:`:` 在部分文件系统上是非法字符;
|
|
68
|
+
* 而且两个不同工作区去掉非法字符后可能撞名(`E:/a/b` 与 `E:/a\b`)。
|
|
69
|
+
* 所以:可读的 slug(方便人一眼看出是哪个工作区)+ 键的短哈希(保证不撞)。
|
|
70
|
+
* 拿不到工作区(空键)时叫 `_global`——那是"还没选工作区",不是"全局记忆",
|
|
71
|
+
* 但它在短期层里就是"哪儿都算自己人"的那一份。
|
|
72
|
+
*/
|
|
73
|
+
export declare function safeKey(workspaceKey: string): string;
|
|
74
|
+
/** 目录不存在就建(递归)。 */
|
|
75
|
+
export declare function ensureDirFor(file: string): void;
|
|
76
|
+
/** 原子写 JSON:`.tmp` + `rename`。失败返回 false(调用方决定要不要出声)。 */
|
|
77
|
+
export declare function writeJsonAtomic(file: string, value: unknown): boolean;
|
|
78
|
+
/** 原子写文本。失败返回 false。 */
|
|
79
|
+
export declare function writeTextAtomic(file: string, text: string): boolean;
|
|
80
|
+
/**
|
|
81
|
+
* 原子写一个 `.jsonl.zst`:把若干**行**压成一帧 zstd,再 `.tmp` + `rename`。
|
|
82
|
+
*
|
|
83
|
+
* 一次写整份(而不是往文件尾巴上追加一帧):行数有上限(见 `SNAPSHOT_KEEP`),
|
|
84
|
+
* 整份重写才能保证文件始终是**一帧**,体积与解压开销都可预期。
|
|
85
|
+
* 失败返回 false。
|
|
86
|
+
*/
|
|
87
|
+
export declare function writeZstdLines(file: string, lines: readonly string[]): boolean;
|
|
88
|
+
/** `readZstdLines` 的结果:读不动时给一个**说得清**的原因,绝不抛。 */
|
|
89
|
+
export interface ZstdLinesResult {
|
|
90
|
+
/** 文件里的行(去掉空行)。读不动时是空数组。 */
|
|
91
|
+
lines: string[];
|
|
92
|
+
/** `missing` = 文件不在(首次运行,正常);`unreadable` = 在但解压不了(要当"丢了一份数据"报出来)。 */
|
|
93
|
+
error?: 'missing' | 'unreadable';
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* 读一个 `.jsonl.zst` 的所有行。
|
|
97
|
+
*
|
|
98
|
+
* **不许抛**:文件不在、不是 zstd、解压出来不是文本——一律回落成空 + 一个原因。
|
|
99
|
+
* 一行 JSON 好不好解析是上层的事(`parseSnapshotLine` 会丢掉坏行并报数)。
|
|
100
|
+
*/
|
|
101
|
+
export declare function readZstdLines(file: string): ZstdLinesResult;
|
|
102
|
+
/** 读 JSON。文件不存在、坏了都返回 undefined——**不许因为一份文件坏掉挡住聊天**。 */
|
|
103
|
+
export declare function readJson<T>(file: string): T | undefined;
|
|
104
|
+
/** 读文本。读不到返回 undefined。 */
|
|
105
|
+
export declare function readText(file: string): string | undefined;
|
|
106
|
+
/**
|
|
107
|
+
* 把一个文件搬进 `archive/`(改名,不复制,更不删)。
|
|
108
|
+
*
|
|
109
|
+
* 目标已经存在时**不覆盖**:`archive/` 是"当时那份长什么样"的证据,
|
|
110
|
+
* 后来的同名文件没有资格盖掉它。返回 true 表示"搬过了(或者本来就没有)"。
|
|
111
|
+
*/
|
|
112
|
+
export declare function archiveFile(source: string, target: string): boolean;
|
|
113
|
+
/** 文件在不在(迁移与标记判定用)。 */
|
|
114
|
+
export declare function fileExists(file: string): boolean;
|
|
115
|
+
//# sourceMappingURL=layout.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/layout.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件自己的日志。
|
|
3
|
+
*
|
|
4
|
+
* 为什么不用 `ctx.logger` 就够了:**headless 下没人接它**,调试日志完全看不见
|
|
5
|
+
* (feiyu-memory 在真实 DSH 里踩到的 7 个致命问题之一)。
|
|
6
|
+
* 所以这里留一个内存环形缓冲(`/mind log` 能看),并可选落文件。
|
|
7
|
+
*
|
|
8
|
+
* 两条纪律:
|
|
9
|
+
* 1. 日志本身**永远不许抛**(日志把插件搞挂是最蠢的死法);
|
|
10
|
+
* 2. 缓冲有上限(不许无限增长)。
|
|
11
|
+
*/
|
|
12
|
+
import type { MindContext } from './host.js';
|
|
13
|
+
/** 接上宿主的日志器(可选)。 */
|
|
14
|
+
export declare function configureLogger(ctx: MindContext, options: {
|
|
15
|
+
verbose: boolean;
|
|
16
|
+
file?: string | undefined;
|
|
17
|
+
}): void;
|
|
18
|
+
export declare const logger: {
|
|
19
|
+
info(...args: unknown[]): void;
|
|
20
|
+
warn(...args: unknown[]): void;
|
|
21
|
+
error(...args: unknown[]): void;
|
|
22
|
+
/** 只有开了 `debugLog` 才落缓冲(不然每步都在写)。 */
|
|
23
|
+
debug(...args: unknown[]): void;
|
|
24
|
+
/** 最近若干行(`/mind log` 用)。 */
|
|
25
|
+
tail(limit?: number): string[];
|
|
26
|
+
/** 是否在写缓冲(诊断用)。 */
|
|
27
|
+
readonly verbose: boolean;
|
|
28
|
+
};
|
|
29
|
+
//# sourceMappingURL=log.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,WAAW,CAAA;AAsCxD,oBAAoB;AACpB,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvD,IAAI,CAIN;AAED,eAAO,MAAM,MAAM;kBACH,OAAO,EAAE,GAAG,IAAI;kBAQhB,OAAO,EAAE,GAAG,IAAI;mBAQf,OAAO,EAAE,GAAG,IAAI;IAQ/B,qCAAqC;mBACtB,OAAO,EAAE,GAAG,IAAI;IAS/B,4BAA4B;0BACV,MAAM,EAAE;IAG1B,mBAAmB;sBACJ,OAAO;CAGvB,CAAA"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
export interface MigrationCounts {
|
|
2
|
+
/** 落进 `global/memory.jsonl.zst` 的条数。 */
|
|
3
|
+
global: number;
|
|
4
|
+
/** 其中属于某个工作区(带 `where`)的条数。 */
|
|
5
|
+
workspace: number;
|
|
6
|
+
/** 落进各会话 `memory.jsonl.zst` 的条数。 */
|
|
7
|
+
session: number;
|
|
8
|
+
/** 落进 `short/` 的条数。 */
|
|
9
|
+
short: number;
|
|
10
|
+
/** 建了记忆的会话 id。 */
|
|
11
|
+
sessions: string[];
|
|
12
|
+
/** 读不懂、被丢掉的条数(要报出来,不能悄悄少)。 */
|
|
13
|
+
dropped: number;
|
|
14
|
+
/** 这次成功写下的快照文件数(不含简介 `.md` 与标记)。 */
|
|
15
|
+
files: number;
|
|
16
|
+
}
|
|
17
|
+
export interface MigrationResult {
|
|
18
|
+
migrated: boolean;
|
|
19
|
+
note: string;
|
|
20
|
+
counts: MigrationCounts;
|
|
21
|
+
/** 这批老数据是从哪一代搬来的。 */
|
|
22
|
+
from: 'v1' | 'v2' | 'none';
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* 把老档案拆到 v3 布局(一行一份快照),并把退休的旧文件搬进 `archive/`。
|
|
26
|
+
*
|
|
27
|
+
* `stateDir` 是配置里的 `stateDir`(**目录**,与 `layout.ts` 的一套函数一致),
|
|
28
|
+
* `archiveFile` 是旧 `state.json` 的路径。
|
|
29
|
+
*
|
|
30
|
+
* 名字写清楚是有代价换来的:这个参数原来叫 `raw`,调用方顺手把**档案的 JSON 文本**传了进来,
|
|
31
|
+
* 于是标记与文件全落在一个乱路径、写入静默失败,看起来「迁移成功」其实什么都没落地。
|
|
32
|
+
*/
|
|
33
|
+
export declare function migrateToV3(args: {
|
|
34
|
+
stateDir: string;
|
|
35
|
+
archiveFile: string;
|
|
36
|
+
now: number;
|
|
37
|
+
}): MigrationResult;
|
|
38
|
+
/**
|
|
39
|
+
* 旧名字,保留给调用方与测试。
|
|
40
|
+
*
|
|
41
|
+
* 它现在搬的是 **v1/v2 → v3**(`migrateToV3`),不再是"→ v2"。
|
|
42
|
+
*/
|
|
43
|
+
export declare const migrateV1: typeof migrateToV3;
|
|
44
|
+
//# sourceMappingURL=migrate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"AA0EA,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,eAAe,CAAA;IACvB,qBAAqB;IACrB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;CAC3B;AAsCD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAyOzG;AAcD;;;;GAIG;AACH,eAAO,MAAM,SAAS,oBAAc,CAAA"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 跨会话持久层:人设 / 长期记忆 / 累计统计。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么这里可以自己写文件,而会话状态不行
|
|
5
|
+
*
|
|
6
|
+
* 会话内状态(此刻的情绪、张力、脉冲)**必须**由会话投影承载:它是日志的派生量,
|
|
7
|
+
* 才能重放、才能随会话销毁而回收。被查的 5 家竞品全部拿自持 JSON 当会话状态,
|
|
8
|
+
* 于是状态不是日志派生、无法重放、注册挂在 root ctx 上不回收——那是最大的架构缺口。
|
|
9
|
+
*
|
|
10
|
+
* 但"人设跨会话保留同一份""长期记忆库"在定义上就**不在**任何单个会话日志里,
|
|
11
|
+
* 投影的 `apply` 是纯函数、装不下跨会话写入。宿主确实有 `storageDomain`,
|
|
12
|
+
* 但它需要 zod record schema + 与 `@deepseek-ai/dsh-*` 的依赖关系(会触发安装期硬校验),
|
|
13
|
+
* 代价与收益不匹配(feiyu-memory 也是同样的结论)。
|
|
14
|
+
*
|
|
15
|
+
* 所以:**自己的档案文件 + 原子写 + 规范化读**。文件坏了只是"这次想不起来",不影响聊天。
|
|
16
|
+
*
|
|
17
|
+
* ## v3 起:这里不再有"一个 state.json 装完"
|
|
18
|
+
*
|
|
19
|
+
* v2 的权威是根目录那个 `state.json`(`{format:1, mind}`),`global/`、`short/` 只是它的落地副本;
|
|
20
|
+
* v3 把 `global/persona.jsonl.zst`(人设快照 + 性情基线 + 统计 + 遗忘名单)和三层记忆的快照文件
|
|
21
|
+
* 变成**唯一真相**,`state.json` 只活在迁移那一次(改名进 `archive/state.v1.json`)。
|
|
22
|
+
* 所以本文件现在只做三件事:算路径、给"值得写盘吗"的签名、把散在各文件里的东西**拼回一份 `MindPersist`**。
|
|
23
|
+
*/
|
|
24
|
+
import { type MindPersist, type MindState, type MindStats } from 'dsh-mind-core';
|
|
25
|
+
/**
|
|
26
|
+
* 档案目录:`$DSH_HOME/dsh-mind/`。
|
|
27
|
+
*
|
|
28
|
+
* 返回**规范化**过的路径(斜杠风格统一、去掉结尾分隔符、去掉两头的空白):
|
|
29
|
+
* 它是"根在哪里"的唯一答案,而调用方经常拿它做包含判断
|
|
30
|
+
* (`file.startsWith(rootDir(raw) + path.sep)`)。原样回传用户配置的字符串时,
|
|
31
|
+
* `E:/tmp/mind` 与 `E:\tmp\mind` 会被当成两个根,包含判断就会漏。
|
|
32
|
+
*/
|
|
33
|
+
export declare function stateDir(raw: string): string;
|
|
34
|
+
/** 人设内核文件路径(用户可编辑)。 */
|
|
35
|
+
export declare function personaFile(raw: string): string;
|
|
36
|
+
/**
|
|
37
|
+
* 把 v3 的几份文件拼回一份档案。任何异常都当成"全新的"处理——
|
|
38
|
+
* **不许因为某份文件坏了挡住聊天**。
|
|
39
|
+
*
|
|
40
|
+
* 拼的时候只带回**跨会话要带走的**:全局层 + 人设/基线/统计/遗忘名单。
|
|
41
|
+
* - 短期层不在这里汇总:它按工作区一份,由 `adoptShort` 按当前工作区去读(汇总反而会串味);
|
|
42
|
+
* - 会话日记更不汇总:那是某一段对话自己的流水账,读它要看会话 id。
|
|
43
|
+
*/
|
|
44
|
+
export declare function loadArchive(raw: string, now: number): {
|
|
45
|
+
persist: MindPersist;
|
|
46
|
+
note: string;
|
|
47
|
+
};
|
|
48
|
+
/** 从会话状态里抽出要跨会话带走的部分。 */
|
|
49
|
+
export declare function extract(state: MindState, stats: MindStats, now: number): MindPersist;
|
|
50
|
+
/**
|
|
51
|
+
* 判断"值得写盘吗"。
|
|
52
|
+
*
|
|
53
|
+
* 每次会话事件都写盘是不可接受的(一个回合几十个事件)。所以只比一个**签名**:
|
|
54
|
+
* 人设/记忆/统计变了才写。签名本身很便宜(都是小对象)。
|
|
55
|
+
*/
|
|
56
|
+
export declare function signature(persist: MindPersist): string;
|
|
57
|
+
//# sourceMappingURL=persist.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,eAAe,CAAA;AAItB;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU5C;AAED,uBAAuB;AACvB,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwB5F;AAED,yBAAyB;AACzB,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAWtD"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 人设内核文件(`persona.md`)的读写。
|
|
3
|
+
*
|
|
4
|
+
* 为什么内核要放文件而不是写死在代码里:
|
|
5
|
+
* 内核是**唯一"只有用户能直接改"**的东西(硬边界尤其),放文件里用户才改得动;
|
|
6
|
+
* 也因为出厂人格写死在代码里是竞品踩过的坑(包装进 profile 的 node_modules 后相对路径会变脆)。
|
|
7
|
+
*
|
|
8
|
+
* 格式故意做得极简——用户手写不吃力,解析器也不用写成一个 YAML 实现:
|
|
9
|
+
*
|
|
10
|
+
* ```
|
|
11
|
+
* 名字: 小和
|
|
12
|
+
* 价值观:
|
|
13
|
+
* - 诚实: 0.9
|
|
14
|
+
* - 不图快: 0.7
|
|
15
|
+
* 边界:
|
|
16
|
+
* - 不做破坏性操作
|
|
17
|
+
* - 不编造事实
|
|
18
|
+
* ```
|
|
19
|
+
*/
|
|
20
|
+
/** 从文件里读出来的内核片段(全部可选:写多少算多少)。 */
|
|
21
|
+
export interface KernelPatch {
|
|
22
|
+
name?: string;
|
|
23
|
+
values?: Record<string, number>;
|
|
24
|
+
boundaries?: string[];
|
|
25
|
+
}
|
|
26
|
+
/** 解析结果。 */
|
|
27
|
+
export interface ParsedPersona {
|
|
28
|
+
patch: KernelPatch;
|
|
29
|
+
/** 有没有真的读到内容(空文件等于没有内核)。 */
|
|
30
|
+
nonEmpty: boolean;
|
|
31
|
+
note: string;
|
|
32
|
+
}
|
|
33
|
+
/** 读内核文件;不存在或读不动都返回 null(绝不抛)。 */
|
|
34
|
+
export declare function readPersonaKernel(file: string): ParsedPersona | null;
|
|
35
|
+
/** 解析文本(与文件读取分开,方便单测)。 */
|
|
36
|
+
export declare function parsePersonaText(text: string): {
|
|
37
|
+
patch: KernelPatch;
|
|
38
|
+
nonEmpty: boolean;
|
|
39
|
+
};
|
|
40
|
+
/** 首次运行时写一份带注释的模板,让用户有个能改的东西。 */
|
|
41
|
+
export declare function writePersonaTemplate(file: string): boolean;
|
|
42
|
+
/** 给 `/mind persona` 展示时用的路径说明。 */
|
|
43
|
+
export declare function describePath(file: string): string;
|
|
44
|
+
//# sourceMappingURL=persona-md.d.ts.map
|