@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,188 @@
|
|
|
1
|
+
import { type SnapshotReason, type StoredEntry, type StoredScope } from './entries.js';
|
|
2
|
+
import { type MemoryEntry } from 'dsh-mind-core';
|
|
3
|
+
/**
|
|
4
|
+
* 能落盘的条目:结构上兼容 core 的 `MemoryEntry`(v2 的它自带 `scope`/`seq`,
|
|
5
|
+
* 这里只要求最小公共字段,多出来的属性原样带过去)。
|
|
6
|
+
*/
|
|
7
|
+
export interface WritableEntry {
|
|
8
|
+
id: string;
|
|
9
|
+
kind: MemoryEntry['kind'];
|
|
10
|
+
text: string;
|
|
11
|
+
importance: number;
|
|
12
|
+
hits: number;
|
|
13
|
+
createdAt: number;
|
|
14
|
+
lastAt: number;
|
|
15
|
+
because?: string;
|
|
16
|
+
origin?: 'self' | 'heard' | 'digest';
|
|
17
|
+
/** 工作区键;`''`/`null`/缺省的含义与 core 一致(显式全局 / 未分组会话 / 不知道)。 */
|
|
18
|
+
ws?: string | null;
|
|
19
|
+
sessionId?: string;
|
|
20
|
+
/** 这条是从会话日志的第几条事件来的(能追到出处)。 */
|
|
21
|
+
seq?: number;
|
|
22
|
+
/** 归属层(回收站按它决定"恢复回哪一层")。 */
|
|
23
|
+
scope?: MemoryEntry['scope'];
|
|
24
|
+
}
|
|
25
|
+
/** 一次写入的来由:为什么会有这一份新快照。 */
|
|
26
|
+
export interface SnapshotWriteOptions {
|
|
27
|
+
reason: SnapshotReason;
|
|
28
|
+
/** 会话日志走到第几个事件了(只有会话层有)。 */
|
|
29
|
+
seq?: number;
|
|
30
|
+
}
|
|
31
|
+
/** 把运行时的条目转成磁盘形状。`where` 只对工作区记忆有意义。 */
|
|
32
|
+
export declare function toStored(entry: WritableEntry, scope: StoredScope, extra?: {
|
|
33
|
+
where?: string;
|
|
34
|
+
legacy?: boolean;
|
|
35
|
+
}): StoredEntry;
|
|
36
|
+
/** 工作区记忆:留一份在全局文件里,但明写出处(人看的一行字)。 */
|
|
37
|
+
export declare function asWorkspaceEntry(entry: WritableEntry, workspaceKey: string): StoredEntry;
|
|
38
|
+
export declare function loadGlobal(raw: string): {
|
|
39
|
+
entries: StoredEntry[];
|
|
40
|
+
dropped: number;
|
|
41
|
+
};
|
|
42
|
+
/** 全局记忆是全量语义:把当前这份完整写成一行的新快照(顺手把简介也重写,别让两份对不上)。 */
|
|
43
|
+
export declare function saveGlobal(raw: string, entries: StoredEntry[], now: number, opts: SnapshotWriteOptions): boolean;
|
|
44
|
+
export declare function loadSession(raw: string, sessionId: string): {
|
|
45
|
+
entries: StoredEntry[];
|
|
46
|
+
dropped: number;
|
|
47
|
+
};
|
|
48
|
+
/** 第一段挑会话的结果:看了多少、缺简介多少、最后进了哪几个。 */
|
|
49
|
+
export interface SessionSelection {
|
|
50
|
+
/** 选中、准备进去读条目的会话 id(按简介相关度降序)。 */
|
|
51
|
+
entered: string[];
|
|
52
|
+
/** 一共看了几个会话目录(不含当前会话)。 */
|
|
53
|
+
lookedAt: number;
|
|
54
|
+
/** 其中简介缺失或为空的个数:这些跳过,不参与打分。 */
|
|
55
|
+
missing: number;
|
|
56
|
+
/** 简介非空、但与 query 一个字面重合都没有的个数。 */
|
|
57
|
+
irrelevant: number;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* 跨会话检索的第一段:**只读简介,不碰日记。**
|
|
61
|
+
*
|
|
62
|
+
* 用户的原话是"先读这个会话记忆的简介,看是不是自己需要的,不是就查下一题,是的话,
|
|
63
|
+
* 就进这个会话里去查"。所以这里只做挑选:把每个会话的 `summary.md` 当成一篇文档,
|
|
64
|
+
* 用 core 的 `bm25Scores` 打分(不另写一套打分),取前 `limit` 个。
|
|
65
|
+
*
|
|
66
|
+
* 门槛是"至少共享一个检索词"(BM25 原始分 > 0)。简介全缺、全空、或全不相关时
|
|
67
|
+
* 就返回空 `entered`——宁可如实说"没一个像",也不硬凑会话。
|
|
68
|
+
*
|
|
69
|
+
* 当前会话必须排除:它的日记本来就在 `memory()` 里,再进一遍会重复。
|
|
70
|
+
*/
|
|
71
|
+
export declare function selectSessionsBySummary(raw: string, query: string, limit?: number, excludeSessionId?: string): SessionSelection;
|
|
72
|
+
/**
|
|
73
|
+
* 会话记忆:写一整份当前内容(**可修订**)。
|
|
74
|
+
*
|
|
75
|
+
* 旧条目在这次快照里没出现就等于删了,改了就改了——这正是"后一次做完了"该有的样子。
|
|
76
|
+
* 返回是否真的落了盘(内容没变时返回 true,表示"盘上已经是对的")。
|
|
77
|
+
*/
|
|
78
|
+
export declare function saveSession(raw: string, sessionId: string, entries: StoredEntry[], now: number, opts: SnapshotWriteOptions): boolean;
|
|
79
|
+
export declare function loadShort(raw: string, workspaceKey: string): {
|
|
80
|
+
entries: StoredEntry[];
|
|
81
|
+
dropped: number;
|
|
82
|
+
};
|
|
83
|
+
/** 短期记忆是全量语义:写一整份当前内容。 */
|
|
84
|
+
export declare function saveShort(raw: string, workspaceKey: string, entries: StoredEntry[], now: number, opts: SnapshotWriteOptions): boolean;
|
|
85
|
+
/**
|
|
86
|
+
* 把所有短期文件清空(各追加一份空快照),返回清了几份。
|
|
87
|
+
*
|
|
88
|
+
* 为什么按**文件**清而不是按工作区键清:文件名是工作区键的哈希(见 `safeKey`),反推不回来。
|
|
89
|
+
* 这是 `/mind reset` 与 `reset-once` 的一部分——"记忆从空开始"不能只清全局层,
|
|
90
|
+
* 不然下一个会话又从 `short/` 里把手边的事捡回来。
|
|
91
|
+
*/
|
|
92
|
+
export declare function clearShort(raw: string, now: number): number;
|
|
93
|
+
/**
|
|
94
|
+
* 把所有会话日记清空(各追加一份空快照),返回清了几份。
|
|
95
|
+
*
|
|
96
|
+
* 与 `clearShort` 同一个道理:读取只认最后一行,所以"追加一份空的"就是清空,
|
|
97
|
+
* 旧内容仍留在文件里可以翻回来对。会话日记是**可修订**的(每次写一整份快照),
|
|
98
|
+
* 所以空快照落下之后,那一段旧日记就真的没了——这正是"清库"要的效果。
|
|
99
|
+
* `saveSession` 会顺手把那份人读的 `summary.md` 重生成(不会留着旧简介)。
|
|
100
|
+
*
|
|
101
|
+
* 只清**已经有日记文件**的会话:没写过日记的会话不该因为它多出一份空文件。
|
|
102
|
+
*/
|
|
103
|
+
export declare function clearSessions(raw: string, now: number): number;
|
|
104
|
+
/**
|
|
105
|
+
* 把三层记忆里所有条目的 id 收一份(清库用)。
|
|
106
|
+
*
|
|
107
|
+
* 为什么从**磁盘**收、而不是从 `MindPersist` 收:档案里只有跨会话层与人设——
|
|
108
|
+
* 手边(`short/<工作区>.jsonl.zst`)住在会话状态那边,会话日记住在各自的会话目录里。
|
|
109
|
+
* 2026-11-13 就是这么漏的:`/mind reset-memory` 只划到了跨会话库那一条,手边那两条没进名单,
|
|
110
|
+
* 于是下一次落盘又把它们写回来,面板上看着像"清了个寂寞"。
|
|
111
|
+
*/
|
|
112
|
+
export declare function collectMemoryIds(raw: string): string[];
|
|
113
|
+
/**
|
|
114
|
+
* 回收站里的一条:原样留着它在时的全部字段,另加"什么时候、从哪一层、为什么"。
|
|
115
|
+
*
|
|
116
|
+
* 为什么要有回收站:清 / 划都是**假删**——条目从三层里消失,但正文必须留着,
|
|
117
|
+
* 用户才能"我清错了,捞回来"。只靠快照文件的前几行不够:那些行会被 `SNAPSHOT_KEEP` 裁掉
|
|
118
|
+
* (文件写满以后,一次清空正好把旧内容挤出窗口)。
|
|
119
|
+
*
|
|
120
|
+
* 它**不进会话状态**:回收站是"文件历史",不是它此刻记得的事——不进注入、不参与检索,
|
|
121
|
+
* 因此也不会让"可回放"依赖磁盘。恢复才是把条目送回某一层的动作。
|
|
122
|
+
*/
|
|
123
|
+
export interface TrashedEntry extends StoredEntry {
|
|
124
|
+
trashedAt: number;
|
|
125
|
+
/** 从哪一层消失的(展示用;条目自己的 `scope` 才是权威)。 */
|
|
126
|
+
trashedFrom: StoredScope;
|
|
127
|
+
/** 为什么被删(人话,`show trash` 直接印出来)。 */
|
|
128
|
+
trashedReason: string;
|
|
129
|
+
/** 恢复过的时间;有它就不在"等恢复"之列,也不会被重复恢复。 */
|
|
130
|
+
restoredAt?: number;
|
|
131
|
+
}
|
|
132
|
+
/** 回收站最多留几条(超了丢最老的)。它是后悔药,不是永久档案。 */
|
|
133
|
+
export declare const TRASH_KEEP = 300;
|
|
134
|
+
/** 读回收站:只看最后一行;读不动就当空,**绝不抛**(坏文件不该让命令崩)。 */
|
|
135
|
+
export declare function loadTrash(raw: string): TrashedEntry[];
|
|
136
|
+
/** 写一整份回收站(全量语义,与别的层一致:追加一行,读取只认最后一行)。 */
|
|
137
|
+
export declare function saveTrash(raw: string, entries: TrashedEntry[], now: number, opts: {
|
|
138
|
+
reason: SnapshotReason;
|
|
139
|
+
}): boolean;
|
|
140
|
+
/**
|
|
141
|
+
* 把"从三层里消失的条目"记进回收站:**这是所有假删的唯一入口**。
|
|
142
|
+
*
|
|
143
|
+
* 为什么用"前后 diff"而不是在每个删除点分别调用:删除的路不止一条——
|
|
144
|
+
* 命令 `/mind clear|forget`、模型自己的 `forget_memory` 工具(走会话日志折叠)、
|
|
145
|
+
* 遗忘名单过滤(`withoutForgotten`)、短期池淘汰(`pruneShort`)。逐点调用必然漏一处,
|
|
146
|
+
* 而"上一份里有、这一份没有了"是**唯一能覆盖全部**的判据。
|
|
147
|
+
*
|
|
148
|
+
* 按 id 去重:同一条已经在回收站里等恢复(`restoredAt` 为空)就不重复记。
|
|
149
|
+
* 返回这一次新记进去几条。
|
|
150
|
+
*/
|
|
151
|
+
export declare function trashGone(raw: string, before: readonly WritableEntry[], after: readonly WritableEntry[], at: number, reason: string): number;
|
|
152
|
+
/** 标记一批 id 已恢复(在回收站里留痕,但不再算"等恢复",也不会被重复恢复)。 */
|
|
153
|
+
export declare function markTrashRestored(raw: string, ids: readonly string[], at: number): boolean;
|
|
154
|
+
/**
|
|
155
|
+
* **真删**:把一批 id(或全部)从回收站里抹掉。这是唯一不可逆的地方,
|
|
156
|
+
* 所以只有 `/mind purge` 会调它——别的路径一律只做假删。
|
|
157
|
+
*/
|
|
158
|
+
export declare function purgeTrash(raw: string, ids: readonly string[] | 'all', at: number): number;
|
|
159
|
+
/**
|
|
160
|
+
* 人设快照的落盘内容(`global/persona.jsonl.zst`)。
|
|
161
|
+
*
|
|
162
|
+
* 装的是"跨会话要带走、但又不在三层记忆里"的东西:人设(说话习惯/自我认知/内核史)、
|
|
163
|
+
* 性情基线、统计,以及**遗忘名单**——名单必须跟着走,丢了它,被明确要求忘掉的东西
|
|
164
|
+
* 下次就会自己冒出来。
|
|
165
|
+
*
|
|
166
|
+
* 参数故意用结构类型而不是 core 的 `MindPersist`:迁移路径手里拿的是"读进来的旧档案",
|
|
167
|
+
* 形状只是碰巧一样,没必要为了类型去构造一个假的 persist。
|
|
168
|
+
*/
|
|
169
|
+
export interface PersonaSnapshotSource {
|
|
170
|
+
persona: unknown;
|
|
171
|
+
baseline: unknown;
|
|
172
|
+
stats: unknown;
|
|
173
|
+
memory: {
|
|
174
|
+
forgotten: string[];
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
/** 读人设快照:只看最后一行。文件不在、坏了都返回 undefined。 */
|
|
178
|
+
export declare function loadPersonaState(raw: string): {
|
|
179
|
+
persona: unknown;
|
|
180
|
+
baseline: unknown;
|
|
181
|
+
stats: unknown;
|
|
182
|
+
forgotten: string[];
|
|
183
|
+
} | undefined;
|
|
184
|
+
/** 写一份人设快照。内容与来由都没变时不追加(同 `writeSnapshot` 的规矩)。 */
|
|
185
|
+
export declare function savePersonaState(raw: string, source: PersonaSnapshotSource, now: number, opts: SnapshotWriteOptions, extra?: {
|
|
186
|
+
migratedAt?: number;
|
|
187
|
+
}): boolean;
|
|
188
|
+
//# sourceMappingURL=store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 给模型用的工具。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么思想要靠一个工具写回,而不是再跑一个小模型
|
|
5
|
+
*
|
|
6
|
+
* 三条硬理由(见 core 的 thought.ts):
|
|
7
|
+
* 1. 钱与延迟——每轮再跑一次模型,成本翻倍,而"像人"的收益不随调用次数线性增长;
|
|
8
|
+
* 2. 不可回放——同一份会话日志折两次会得到两套思想,本项目的立身之本(状态可重放)就没了;
|
|
9
|
+
* 3. 不可审计——你没法回答"它当时到底在想什么"。
|
|
10
|
+
*
|
|
11
|
+
* 而工具调用**天然落在会话日志里**(`tool/call` 事件带着参数),于是思想变成日志的一部分:
|
|
12
|
+
* 可回放、可审计、可解释。**不需要新增任何 session 事件类型**(官方明令禁止第三方 append)。
|
|
13
|
+
*
|
|
14
|
+
* ## 工具 schema 的一个坑
|
|
15
|
+
*
|
|
16
|
+
* `parameters` 是标准 JSON Schema(`required: [...]` 数组可用);
|
|
17
|
+
* 但 `output.schema` 是**受限的作者态 DSL**,只允许 type/oneOf/items/properties/
|
|
18
|
+
* additionalProperties/enum/const/description/title/default/examples,
|
|
19
|
+
* 加上**每个属性自己的 `required: true`**,**不能写 `required: [...]` 数组**。
|
|
20
|
+
*/
|
|
21
|
+
import { type MemoryEntry, type MemoryState, type MindTunables } from 'dsh-mind-core';
|
|
22
|
+
import type { ToolExecuteContext, ToolSpec } from './host.js';
|
|
23
|
+
/** 工具名。折叠层(core/fold.ts 的 `parseNote`)按这个名字认它。 */
|
|
24
|
+
export declare const INNER_NOTE_TOOL = "inner_note";
|
|
25
|
+
/** 长期记忆检索工具名(工具名只有一处真相,在 core 里)。 */
|
|
26
|
+
export declare const RECALL_TOOL = "recall_memory";
|
|
27
|
+
/**
|
|
28
|
+
* `inner_note`:写一条**给自己下一轮看**的内心记录。
|
|
29
|
+
*
|
|
30
|
+
* 描述里必须把"什么时候该用、什么时候不该用"写清楚——否则模型会每轮都调一次,
|
|
31
|
+
* 那就退化成"每句话都在深想",比不写还假。
|
|
32
|
+
*/
|
|
33
|
+
export declare function innerNoteTool(): ToolSpec;
|
|
34
|
+
/** 跨会话检索一次调用的选项:适配层只需要知道"这次从哪儿来"与第一段选几个。 */
|
|
35
|
+
export interface CrossSessionOptions {
|
|
36
|
+
/** 这次工具调用来自哪个宿主上下文(适配层靠它认出当前会话 id)。 */
|
|
37
|
+
context?: ToolExecuteContext;
|
|
38
|
+
/** 第一段最多进几个会话(默认 5)。 */
|
|
39
|
+
sessionLimit?: number;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* 两段式跨会话检索的结果。
|
|
43
|
+
*
|
|
44
|
+
* `entries` 是**选中会话的全部条目**(不是分页后的命中):分页发生在 `recall` 打分之后,
|
|
45
|
+
* 因为"共 N 条命中"只有打过总分才知道;适配层不去猜这件事。
|
|
46
|
+
*/
|
|
47
|
+
export interface CrossSessionResult {
|
|
48
|
+
entries: readonly MemoryEntry[];
|
|
49
|
+
/** 看了几个会话的简介(不含当前会话)。 */
|
|
50
|
+
lookedAt: number;
|
|
51
|
+
/** 第一段选中、真正进去翻了的会话 id(按简介相关度降序)。 */
|
|
52
|
+
entered: readonly string[];
|
|
53
|
+
/** 这次要的是第几页(工具回显,便于排查)。 */
|
|
54
|
+
page: number;
|
|
55
|
+
/** 进会话读到的候选条目数;命中数与分页数在工具里算。 */
|
|
56
|
+
total: number;
|
|
57
|
+
/** 拿不到当前会话 id 时给 'no-session':工具据此如实回答,而不是抛错。 */
|
|
58
|
+
reason?: 'no-session';
|
|
59
|
+
}
|
|
60
|
+
/** 适配层接进来的跨会话检索(两段式 + 分页参数)。 */
|
|
61
|
+
export type CrossSessionRecall = (query: string, page: number, pageSize: number, options?: CrossSessionOptions) => CrossSessionResult;
|
|
62
|
+
/** `recall_memory` 与 `forget_memory` 的依赖:三层记忆与参数都由适配层注入,core 不认识宿主。 */
|
|
63
|
+
export interface RecallToolDeps {
|
|
64
|
+
/** 当前三层记忆(全局库 + 本会话日记 + 手边那几条)。 */
|
|
65
|
+
memory: () => MemoryState;
|
|
66
|
+
tunables: () => MindTunables;
|
|
67
|
+
/**
|
|
68
|
+
* 当前会话的工作区键(适配层从这次调用的 agent 会话上取)。
|
|
69
|
+
*
|
|
70
|
+
* 可选:拿不到就返回空串(未知)——这时**不做跨工作区降权**。
|
|
71
|
+
* 宁可当全局,也不要在不知道自己在哪的时候误伤记忆。
|
|
72
|
+
*/
|
|
73
|
+
workspace?: (context?: ToolExecuteContext) => string;
|
|
74
|
+
/**
|
|
75
|
+
* 别的会话的日记(`scope: 'all'` 才用):**先读简介选会话,再进会话读条目**。
|
|
76
|
+
*
|
|
77
|
+
* core 不碰磁盘,所以两段式由适配层实现;分页留在工具里,因为要先拿到全部命中。
|
|
78
|
+
* 不接这个依赖时,`scope: 'all'` 会如实说跨会话查不了。
|
|
79
|
+
*/
|
|
80
|
+
crossSession?: CrossSessionRecall;
|
|
81
|
+
}
|
|
82
|
+
/** 遗忘工具名(唯一真相在 core,两边共用一处,免得拼错)。 */
|
|
83
|
+
export declare const FORGET_TOOL = "forget_memory";
|
|
84
|
+
/**
|
|
85
|
+
* `recall_memory`:**想不起来的时候先去翻。**
|
|
86
|
+
*
|
|
87
|
+
* 这正是用户要的分工:"短期记忆注入上下文(不用想就知道),长期记忆需要大模型主动去查"——
|
|
88
|
+
* 就像人有时候忘记了会说"我想想"。
|
|
89
|
+
*
|
|
90
|
+
* 查不到就老实说查不到。工具结果里那句"不要凭印象编"是**给模型看的**:
|
|
91
|
+
* 记忆类功能最大的失败不是想不起来,而是想不起来还硬答。
|
|
92
|
+
*
|
|
93
|
+
* 跨会话(`scope: 'all'`)走两段式:先看简介挑会话,再进会话翻日记;数据多时分页。
|
|
94
|
+
*/
|
|
95
|
+
export declare function recallTool(deps: RecallToolDeps): ToolSpec;
|
|
96
|
+
/**
|
|
97
|
+
* `forget_memory`:**用户明确要求忘掉某一条时**才用。
|
|
98
|
+
*
|
|
99
|
+
* 为什么它必须存在(而不是只留一条 `/mind forget`):人是会忘的,而且**忘什么由它自己判断**
|
|
100
|
+
* 才算"像人"。`/mind forget` 是"我(用户)替它决定忘掉什么",工具是"它自己决定"。
|
|
101
|
+
*
|
|
102
|
+
* 两条不可破的规矩:
|
|
103
|
+
* 1. **只删得掉能唯一指认的**(id 或足够像的一段原文)。对上多条就如实列出来让人选,
|
|
104
|
+
* 绝不"全部删掉"——遗忘不可逆;
|
|
105
|
+
* 2. 这里**只负责回答"能不能删"**,真正的删除发生在折叠那一步(`tool/call` 事件进来时),
|
|
106
|
+
* 所以"忘掉"这件事一样落在会话日志里,可重放、可审计。
|
|
107
|
+
*/
|
|
108
|
+
export declare function forgetTool(deps: RecallToolDeps): ToolSpec;
|
|
109
|
+
//# sourceMappingURL=tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE7D,kDAAkD;AAClD,eAAO,MAAM,eAAe,eAAe,CAAA;AAE3C,qCAAqC;AACrC,eAAO,MAAM,WAAW,kBAAmB,CAAA;AAE3C;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAoExC;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,gCAAgC;AAChC,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,mBAAmB,KAC1B,kBAAkB,CAAA;AAEvB,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,MAAM,WAAW,CAAA;IACzB,QAAQ,EAAE,MAAM,YAAY,CAAA;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,MAAM,CAAA;IACpD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAClC;AAED,qCAAqC;AACrC,eAAO,MAAM,WAAW,kBAAmB,CAAA;AAyD3C;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,CA+IzD;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,CA6DzD"}
|
package/locale/en.json
ADDED
package/locale/zh.json
ADDED
package/package.json
CHANGED
|
@@ -1,6 +1,89 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lin0306/dsh-mind",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "让 agent 带上延续的情感与思想:人设 / 情感 / 记忆 / 思想四层 + 自更新闭环(非官方插件)。Inner life for DSH agents — persona, affect, memory and thought, closed by a self-update loop.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./lib/index.js",
|
|
7
|
+
"types": "./lib/types/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./lib/types/index.d.ts",
|
|
11
|
+
"default": "./lib/index.js"
|
|
12
|
+
},
|
|
13
|
+
"./package.json": "./package.json",
|
|
14
|
+
"./cordis.patch.yml": "./cordis.patch.yml",
|
|
15
|
+
"./locale/*.json": "./locale/*.json",
|
|
16
|
+
"./icon": "./icon.svg",
|
|
17
|
+
"./client": "./client/index.js"
|
|
18
|
+
},
|
|
19
|
+
"icon": "./icon.svg",
|
|
20
|
+
"repository": {
|
|
21
|
+
"type": "git",
|
|
22
|
+
"url": "git+https://github.com/lin0306/mind.git",
|
|
23
|
+
"directory": "dsh-mind"
|
|
24
|
+
},
|
|
25
|
+
"homepage": "https://github.com/lin0306/mind",
|
|
26
|
+
"bugs": {
|
|
27
|
+
"url": "https://github.com/lin0306/mind/issues"
|
|
28
|
+
},
|
|
29
|
+
"files": [
|
|
30
|
+
"lib",
|
|
31
|
+
"locale",
|
|
32
|
+
"client/index.js",
|
|
33
|
+
"icon.svg",
|
|
34
|
+
"cordis.patch.yml",
|
|
35
|
+
"README.md",
|
|
36
|
+
"LICENSE"
|
|
37
|
+
],
|
|
38
|
+
"engines": {
|
|
39
|
+
"node": ">=22"
|
|
40
|
+
},
|
|
41
|
+
"scripts": {
|
|
42
|
+
"build": "node -e \"require('fs').rmSync('lib',{recursive:true,force:true})\" && tsc -b && tsdown && tsc -p client/tsconfig.json && node scripts/build-client.mjs",
|
|
43
|
+
"clean": "node -e \"const fs=require('fs');for(const p of ['lib','../mind-core/lib','client/out'])fs.rmSync(p,{recursive:true,force:true})\"",
|
|
44
|
+
"typecheck": "tsc -b",
|
|
45
|
+
"test": "node --test \"test/**/*.test.mjs\"",
|
|
46
|
+
"pack:check": "pnpm pack --dry-run",
|
|
47
|
+
"publish:check": "node scripts/validate.mjs",
|
|
48
|
+
"prepublishOnly": "pnpm run build && node scripts/validate.mjs"
|
|
49
|
+
},
|
|
50
|
+
"keywords": [
|
|
51
|
+
"deepseek-harness",
|
|
52
|
+
"dsh-plugin",
|
|
53
|
+
"affect",
|
|
54
|
+
"emotion",
|
|
55
|
+
"persona",
|
|
56
|
+
"memory",
|
|
57
|
+
"情感",
|
|
58
|
+
"思想",
|
|
59
|
+
"人设"
|
|
60
|
+
],
|
|
61
|
+
"license": "MIT",
|
|
62
|
+
"dsh": {
|
|
63
|
+
"manifestVersion": 1,
|
|
64
|
+
"bundle": {
|
|
65
|
+
"patch": "./cordis.patch.yml"
|
|
66
|
+
},
|
|
67
|
+
"client": {
|
|
68
|
+
"platform": "web",
|
|
69
|
+
"inject": [
|
|
70
|
+
"slots"
|
|
71
|
+
]
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
"dependencies": {},
|
|
75
|
+
"peerDependencies": {
|
|
76
|
+
"@deepseek-ai/cordis": "^4.0.4"
|
|
77
|
+
},
|
|
78
|
+
"devDependencies": {
|
|
79
|
+
"@deepseek-ai/schemastery": "^3.18.1",
|
|
80
|
+
"@types/node": "^22.10.0",
|
|
81
|
+
"dsh-mind-core": "workspace:^",
|
|
82
|
+
"tsdown": "^0.23.4",
|
|
83
|
+
"typescript": "^5.9.0",
|
|
84
|
+
"zod": "^4.6.5"
|
|
85
|
+
},
|
|
86
|
+
"publishConfig": {
|
|
87
|
+
"access": "public"
|
|
88
|
+
}
|
|
89
|
+
}
|