@istarry/dsh-assistant-profile 0.7.7 → 0.7.8
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/README.md +141 -140
- package/lib/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,140 +1,141 @@
|
|
|
1
|
-
# Agent助理 · dsh-assistant-profile
|
|
2
|
-
|
|
3
|
-
给 DeepSeek Harness 一份**全局人格**和**一份长期记忆**：名称、语言、人格提示词三段，装一次，之后每个新会话的系统提示最前面都从它开始；记忆紧跟在人格后面，聊天里点一下就能把选中的对话提炼进去。侧栏「新会话」上方会显示这份档案的助理名。
|
|
4
|
-
|
|
5
|
-
一个档案，四个模式通用（标准 / PTC / 极简 / 创造）。不需要复制预设，也不需要改模式选择器。
|
|
6
|
-
|
|
7
|
-
## 它做了什么
|
|
8
|
-
|
|
9
|
-
宿主半端只做一件事：每个对话 agent 创建时（以及空白会话换模式重新绑定预设时），在这个 agent **自己的作用域**里注册一段 `deployment:persona-prefix`。作用域链上最近的同名段胜出，于是预设自带的身份句被档案替换，而工具、流程、模式语义一律不动。
|
|
10
|
-
|
|
11
|
-
这正是官方给子代理发独立人格用的那条路径（`dsh-subagent` 的 `applyChildComposition`），所以它对四种预设都成立。
|
|
12
|
-
|
|
13
|
-
注入文本长这样（空行分隔，缺哪段就少哪段）：
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
Your name is 大肥鱼.
|
|
17
|
-
|
|
18
|
-
Reply in 简体中文 throughout.
|
|
19
|
-
|
|
20
|
-
<你写的人格提示词…>
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
- **极简模式**的预设把人格当作「整段系统提示只有这一句」（`complete: true`）。遮蔽段会镜像这个标记——极简模式下系统提示就**只有**你的档案，仍然没有工具说明，符合那个模式原本的设计。
|
|
24
|
-
- 四段全空时回落到预设原文，等于原生行为。
|
|
25
|
-
- **子智能体不注入**：委派出去的孩子保留它自己的人格。
|
|
26
|
-
|
|
27
|
-
## 助理记忆
|
|
28
|
-
|
|
29
|
-
单档案所以单记忆：一份 markdown（一行一条 `- [YYYY-MM-DD HH:mm] 内容`），随档案存在 profile 的同一份配置里，所有会话共享。
|
|
30
|
-
|
|
31
|
-
**注入位置**：`memory:assistant` 段，order 500 —— 排在人格（0）之后、工具目录（1000）之前。记忆描述的是「用户和我是什么关系」，工具说明会引用这些前提。
|
|
32
|
-
|
|
33
|
-
**三个入口**：
|
|
34
|
-
|
|
35
|
-
- **聊天里的「记住」按钮**：每条助手消息的动作行上（官方的点赞/点踩旁边）多一个 ✨。点开是一个勾选弹窗，列出这个会话里可提炼的用户/助手消息；勾选后提交，宿主用**该会话自己的模型**跑一次独立请求，把选中的对话压成几条稳定事实，逐条追加（同义条目只刷新时间戳，不重复堆积）。
|
|
36
|
-
- **设置 → Agent记忆**：两个开关（启用记忆 / 自动记忆）+ 一个编辑框。手工写、改、删都在这儿，保存即落盘。
|
|
37
|
-
- **`memory_add` 工具**：只在「启用记忆 + 自动记忆」都打开时注册，模型可以在对话中自己决定记什么。
|
|
38
|
-
|
|
39
|
-
**提炼是 fail-closed 的**：会话不在线、取不到这个会话的模型配置、模型没吐出一条可用条目，都不会写任何东西，只把原因回显在弹窗里。
|
|
40
|
-
|
|
41
|
-
### 三个实现上的坑（改这个功能前先看）
|
|
42
|
-
|
|
43
|
-
1. **宿主不能直接写自己的配置**。`Volatile` 只暴露 `get()`，写入必须经设置服务（`settings.update(ns, patch)`），它才会落进 profile 的 patch 并由加载器提交回运行时引用。
|
|
44
|
-
2. **写回要挪出 HMR 事务**。设置写入本身跑在 `hmr.runExclusive` 里，而写回结果又要经设置服务再开一个事务——直接调用会抛 `HMR transactions cannot be nested`。所以所有触发点都过一层 `setTimeout(0)`。
|
|
45
|
-
3. **设置写入不会触发 `loader/volatile-update`**（实测；值会提交进引用，但没有那次事件）。信箱因此靠 700ms 轮询：每次只读一个字符串字段，没有新请求时就是一次 JSON 判定。
|
|
46
|
-
|
|
47
|
-
因为插件目录里解析不到 `@deepseek-ai/dsh-tools` / `dsh-llm` / `dsh-session`（只有 `cordis` 由宿主提供），工具定义与提炼用的消息都按官方线上形状**手搭**，不 import 这几个包。
|
|
48
|
-
|
|
49
|
-
## 删除会话
|
|
50
|
-
|
|
51
|
-
侧栏任意会话行的「…」菜单里多一行**删除**（红色，带分隔线，排在「复制 Session ID」之后）。确认后删的是这个会话本身：
|
|
52
|
-
|
|
53
|
-
- **磁盘**：`<DSH_HOME>/sessions/<项目>/<会话 id>/` 整个目录（日志、分代文件一起），
|
|
54
|
-
- **索引**：会话查询里那一行（下次搜索不会再出现），
|
|
55
|
-
- **登记**：工作区里对这个会话的记账，
|
|
56
|
-
- **界面**：宿主发 `api-session/removed`，官方 session-controller 收到后把行从侧栏移除。
|
|
57
|
-
|
|
58
|
-
正在运行的会话会被拒绝（先停止），空闲但还开着的会话会先被摘下再删。
|
|
59
|
-
|
|
60
|
-
### 为什么不是调一个 `remove()` 就完事
|
|
61
|
-
|
|
62
|
-
这一版 harness 的 `sessionPersistence` **没有**删除方法，`locate` / `listArtifacts` 的第一个参数又是 options（里面装 `signal`）——把会话 id 传进去会走进 `signal?.throwIfAborted()`，直接把宿主带崩（实测 `fatal load failure`）。所以删除按目录布局自己做，只认 `<root>/<项目>/<会话 id>` 这一种形状；命中不到就返回「找不到」，宁可不动手。
|
|
63
|
-
|
|
64
|
-
## 改人格不会重算历史
|
|
65
|
-
|
|
66
|
-
DeepSeek 的上下文缓存是前缀缓存：系统提示在最前面，直接改写开头那条会让后面全部失效。
|
|
67
|
-
|
|
68
|
-
档案的文本是**每次组装提示词时求值**的，所以保存后下一个请求的提示词就变了，而**历史一个字节都不动**。剩下的交给宿主判定：模型路由声明了 `systemPromptUpdate: 'in-history'`（DSH 默认的 `deepseek-flash` 条目就声明了）时，变化的系统提示会被**追加在已缓存的历史之后**，历史那段前缀仍然命中，只有新增的这一小段按普通输入计费。
|
|
69
|
-
|
|
70
|
-
会话日志里的 `request/context` 会写明当前路由的模式：
|
|
71
|
-
|
|
72
|
-
```json
|
|
73
|
-
{"provider":"deepseek-official","model":"deepseek-flash","systemPromptUpdate":"in-history"}
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
路由不支持这个模式时（例如默认的 `deepseek-v4-pro` 条目），改人格会让下一次请求从开头失效一次——那是路由能力问题，不是插件的选择。介意的话，把改动留到新会话。
|
|
77
|
-
|
|
78
|
-
## 界面
|
|
79
|
-
|
|
80
|
-
- 侧栏「插件」下面多一行**Agent助理**（行序 5，夹在插件与自动化任务之间）。
|
|
81
|
-
- 点开是主区的一个页面：名称、语言、人格提示词，右下角实时字数（超过 2000 字转成提醒色）。
|
|
82
|
-
- 「保存」行左侧是人格预设：**默认一 / 默认二 / 默认三**（点击只把三段文本填进表单，落盘仍按「保存」）加「另存」出来的自定义（名字取自「名称」，胶囊右侧带小删除钮）；装好默认用**默认三**，放不下横向滚动。
|
|
83
|
-
- 「新会话」按钮上方一行小字 + 首字方块显示助理名；侧栏收成 56px 图标栏时自动隐藏；改完名称保存后立刻变。
|
|
84
|
-
- 名称默认 `大肥鱼`、语言默认 `中文`。
|
|
85
|
-
|
|
86
|
-
## 数据存在哪
|
|
87
|
-
|
|
88
|
-
四个字段就是本插件在 profile 里的配置，由官方设置通道读写，落进 profile 的 `cordis.patch.yml`：
|
|
89
|
-
|
|
90
|
-
```yaml
|
|
91
|
-
- id: assistant-profile
|
|
92
|
-
name: '@istarry/dsh-assistant-profile'
|
|
93
|
-
config:
|
|
94
|
-
name: 小星
|
|
95
|
-
language: 简体中文
|
|
96
|
-
persona: 你是一个只讲证据的助理。不确定就说不确定。
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
所以它跟着 profile 走：换 profile 就是另一份档案；备份 profile 就备份了人格。
|
|
100
|
-
|
|
101
|
-
## 安装
|
|
102
|
-
|
|
103
|
-
```bash
|
|
104
|
-
dsh plugin --profile <profile> add @istarry/dsh-assistant-profile
|
|
105
|
-
#
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
cd
|
|
126
|
-
node build.mjs
|
|
127
|
-
node build.mjs --
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
-
|
|
138
|
-
-
|
|
139
|
-
-
|
|
140
|
-
-
|
|
1
|
+
# Agent助理 · dsh-assistant-profile
|
|
2
|
+
|
|
3
|
+
给 DeepSeek Harness 一份**全局人格**和**一份长期记忆**：名称、语言、人格提示词三段，装一次，之后每个新会话的系统提示最前面都从它开始；记忆紧跟在人格后面，聊天里点一下就能把选中的对话提炼进去。侧栏「新会话」上方会显示这份档案的助理名。
|
|
4
|
+
|
|
5
|
+
一个档案，四个模式通用（标准 / PTC / 极简 / 创造）。不需要复制预设，也不需要改模式选择器。
|
|
6
|
+
|
|
7
|
+
## 它做了什么
|
|
8
|
+
|
|
9
|
+
宿主半端只做一件事：每个对话 agent 创建时（以及空白会话换模式重新绑定预设时），在这个 agent **自己的作用域**里注册一段 `deployment:persona-prefix`。作用域链上最近的同名段胜出，于是预设自带的身份句被档案替换，而工具、流程、模式语义一律不动。
|
|
10
|
+
|
|
11
|
+
这正是官方给子代理发独立人格用的那条路径（`dsh-subagent` 的 `applyChildComposition`），所以它对四种预设都成立。
|
|
12
|
+
|
|
13
|
+
注入文本长这样（空行分隔，缺哪段就少哪段）：
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
Your name is 大肥鱼.
|
|
17
|
+
|
|
18
|
+
Reply in 简体中文 throughout.
|
|
19
|
+
|
|
20
|
+
<你写的人格提示词…>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
- **极简模式**的预设把人格当作「整段系统提示只有这一句」（`complete: true`）。遮蔽段会镜像这个标记——极简模式下系统提示就**只有**你的档案，仍然没有工具说明，符合那个模式原本的设计。
|
|
24
|
+
- 四段全空时回落到预设原文，等于原生行为。
|
|
25
|
+
- **子智能体不注入**：委派出去的孩子保留它自己的人格。
|
|
26
|
+
|
|
27
|
+
## 助理记忆
|
|
28
|
+
|
|
29
|
+
单档案所以单记忆：一份 markdown（一行一条 `- [YYYY-MM-DD HH:mm] 内容`），随档案存在 profile 的同一份配置里，所有会话共享。
|
|
30
|
+
|
|
31
|
+
**注入位置**：`memory:assistant` 段，order 500 —— 排在人格（0）之后、工具目录（1000）之前。记忆描述的是「用户和我是什么关系」，工具说明会引用这些前提。
|
|
32
|
+
|
|
33
|
+
**三个入口**：
|
|
34
|
+
|
|
35
|
+
- **聊天里的「记住」按钮**：每条助手消息的动作行上（官方的点赞/点踩旁边）多一个 ✨。点开是一个勾选弹窗，列出这个会话里可提炼的用户/助手消息；勾选后提交，宿主用**该会话自己的模型**跑一次独立请求，把选中的对话压成几条稳定事实，逐条追加（同义条目只刷新时间戳，不重复堆积）。
|
|
36
|
+
- **设置 → Agent记忆**：两个开关（启用记忆 / 自动记忆）+ 一个编辑框。手工写、改、删都在这儿，保存即落盘。
|
|
37
|
+
- **`memory_add` 工具**：只在「启用记忆 + 自动记忆」都打开时注册，模型可以在对话中自己决定记什么。
|
|
38
|
+
|
|
39
|
+
**提炼是 fail-closed 的**：会话不在线、取不到这个会话的模型配置、模型没吐出一条可用条目，都不会写任何东西，只把原因回显在弹窗里。
|
|
40
|
+
|
|
41
|
+
### 三个实现上的坑（改这个功能前先看）
|
|
42
|
+
|
|
43
|
+
1. **宿主不能直接写自己的配置**。`Volatile` 只暴露 `get()`，写入必须经设置服务（`settings.update(ns, patch)`），它才会落进 profile 的 patch 并由加载器提交回运行时引用。
|
|
44
|
+
2. **写回要挪出 HMR 事务**。设置写入本身跑在 `hmr.runExclusive` 里，而写回结果又要经设置服务再开一个事务——直接调用会抛 `HMR transactions cannot be nested`。所以所有触发点都过一层 `setTimeout(0)`。
|
|
45
|
+
3. **设置写入不会触发 `loader/volatile-update`**（实测；值会提交进引用，但没有那次事件）。信箱因此靠 700ms 轮询：每次只读一个字符串字段，没有新请求时就是一次 JSON 判定。
|
|
46
|
+
|
|
47
|
+
因为插件目录里解析不到 `@deepseek-ai/dsh-tools` / `dsh-llm` / `dsh-session`（只有 `cordis` 由宿主提供），工具定义与提炼用的消息都按官方线上形状**手搭**，不 import 这几个包。
|
|
48
|
+
|
|
49
|
+
## 删除会话
|
|
50
|
+
|
|
51
|
+
侧栏任意会话行的「…」菜单里多一行**删除**（红色，带分隔线，排在「复制 Session ID」之后）。确认后删的是这个会话本身：
|
|
52
|
+
|
|
53
|
+
- **磁盘**：`<DSH_HOME>/sessions/<项目>/<会话 id>/` 整个目录（日志、分代文件一起），
|
|
54
|
+
- **索引**：会话查询里那一行（下次搜索不会再出现），
|
|
55
|
+
- **登记**：工作区里对这个会话的记账，
|
|
56
|
+
- **界面**：宿主发 `api-session/removed`，官方 session-controller 收到后把行从侧栏移除。
|
|
57
|
+
|
|
58
|
+
正在运行的会话会被拒绝（先停止），空闲但还开着的会话会先被摘下再删。
|
|
59
|
+
|
|
60
|
+
### 为什么不是调一个 `remove()` 就完事
|
|
61
|
+
|
|
62
|
+
这一版 harness 的 `sessionPersistence` **没有**删除方法，`locate` / `listArtifacts` 的第一个参数又是 options（里面装 `signal`）——把会话 id 传进去会走进 `signal?.throwIfAborted()`，直接把宿主带崩（实测 `fatal load failure`）。所以删除按目录布局自己做，只认 `<root>/<项目>/<会话 id>` 这一种形状；命中不到就返回「找不到」，宁可不动手。
|
|
63
|
+
|
|
64
|
+
## 改人格不会重算历史
|
|
65
|
+
|
|
66
|
+
DeepSeek 的上下文缓存是前缀缓存：系统提示在最前面，直接改写开头那条会让后面全部失效。
|
|
67
|
+
|
|
68
|
+
档案的文本是**每次组装提示词时求值**的，所以保存后下一个请求的提示词就变了，而**历史一个字节都不动**。剩下的交给宿主判定：模型路由声明了 `systemPromptUpdate: 'in-history'`（DSH 默认的 `deepseek-flash` 条目就声明了）时，变化的系统提示会被**追加在已缓存的历史之后**，历史那段前缀仍然命中，只有新增的这一小段按普通输入计费。
|
|
69
|
+
|
|
70
|
+
会话日志里的 `request/context` 会写明当前路由的模式：
|
|
71
|
+
|
|
72
|
+
```json
|
|
73
|
+
{"provider":"deepseek-official","model":"deepseek-flash","systemPromptUpdate":"in-history"}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
路由不支持这个模式时（例如默认的 `deepseek-v4-pro` 条目），改人格会让下一次请求从开头失效一次——那是路由能力问题，不是插件的选择。介意的话，把改动留到新会话。
|
|
77
|
+
|
|
78
|
+
## 界面
|
|
79
|
+
|
|
80
|
+
- 侧栏「插件」下面多一行**Agent助理**（行序 5，夹在插件与自动化任务之间）。
|
|
81
|
+
- 点开是主区的一个页面：名称、语言、人格提示词，右下角实时字数（超过 2000 字转成提醒色）。
|
|
82
|
+
- 「保存」行左侧是人格预设：**默认一 / 默认二 / 默认三**（点击只把三段文本填进表单，落盘仍按「保存」）加「另存」出来的自定义（名字取自「名称」，胶囊右侧带小删除钮）；装好默认用**默认三**，放不下横向滚动。
|
|
83
|
+
- 「新会话」按钮上方一行小字 + 首字方块显示助理名；侧栏收成 56px 图标栏时自动隐藏；改完名称保存后立刻变。
|
|
84
|
+
- 名称默认 `大肥鱼`、语言默认 `中文`。
|
|
85
|
+
|
|
86
|
+
## 数据存在哪
|
|
87
|
+
|
|
88
|
+
四个字段就是本插件在 profile 里的配置，由官方设置通道读写，落进 profile 的 `cordis.patch.yml`：
|
|
89
|
+
|
|
90
|
+
```yaml
|
|
91
|
+
- id: assistant-profile
|
|
92
|
+
name: '@istarry/dsh-assistant-profile'
|
|
93
|
+
config:
|
|
94
|
+
name: 小星
|
|
95
|
+
language: 简体中文
|
|
96
|
+
persona: 你是一个只讲证据的助理。不确定就说不确定。
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
所以它跟着 profile 走：换 profile 就是另一份档案；备份 profile 就备份了人格。
|
|
100
|
+
|
|
101
|
+
## 安装
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
dsh plugin --profile <profile> add @istarry/dsh-assistant-profile
|
|
105
|
+
# 本地包：先构建，再在 dist/ 里打包
|
|
106
|
+
node build.mjs && (cd dist && npm pack)
|
|
107
|
+
dsh plugin --profile <profile> add ./dist/istarry-dsh-assistant-profile-<version>.tgz
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
重启 DSH 后生效。卸载：
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
dsh plugin --profile <profile> remove @istarry/dsh-assistant-profile
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
`profile` 里残留的四行配置不会影响原生行为（插件不在了，没人读它），手工删掉更干净。
|
|
117
|
+
|
|
118
|
+
## 与 dsh-agent-suite 的关系
|
|
119
|
+
|
|
120
|
+
两者遮蔽的是同一个段（`deployment:persona-prefix`），**不要同时启用**：后加载的会赢，人格会互相覆盖。需要多个 agent 各自的人格请用 agent-suite；只要一个随身人格就用这个。
|
|
121
|
+
|
|
122
|
+
## 构建
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
cd tooling && pnpm install # 首次：tsdown + lightningcss + typescript + js-yaml
|
|
126
|
+
cd .. && node build.mjs # src/ → dist/（含清单与静态文件）
|
|
127
|
+
node build.mjs --staging # 只构建到 .build/out
|
|
128
|
+
node build.mjs --check # 构建 + 依赖契约校验，不写 dist/
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
宿主产物把 `js-yaml` 内联进去，运行时只依赖 `@deepseek-ai/schemastery`（声明在 `dependencies`，由 pnpm 装进插件自己的 node_modules）。浏览器半端只 `require` 模块表里的条目（react / ui-primitives）。
|
|
132
|
+
|
|
133
|
+
改代码只改 `src/`，产物由构建生成。
|
|
134
|
+
|
|
135
|
+
## 已知边界
|
|
136
|
+
|
|
137
|
+
- 只注入**顶层会话**，子代理不注入（记忆段是全局的，子代理读得到）。
|
|
138
|
+
- **没有远程调用**：记忆、信箱、归档全都走设置通道与配置字段，所以不需要 typert 生成物。
|
|
139
|
+
- 读不到预设定义时（注册表异常）降级为普通注入，不镜像 `complete`，也不报错。
|
|
140
|
+
- 三栏全部清空再保存 = 什么都不注入（回到原生身份句）；装好时默认是默认三的内容。
|
|
141
|
+
- 侧栏名plate 是插在「新会话」按钮前的 DOM 节点（外壳没给这个位置留 slot），React 重渲染把它冲掉时会自动补回。
|
package/lib/index.js
CHANGED
|
@@ -2992,7 +2992,7 @@ var AssistantProfile = class extends Service {
|
|
|
2992
2992
|
await this.writeMemory(result.text);
|
|
2993
2993
|
return {
|
|
2994
2994
|
saved: true,
|
|
2995
|
-
content:
|
|
2995
|
+
content: trimmed,
|
|
2996
2996
|
outcome: result.appended ? "appended" : result.refreshed ? "refreshed" : "unchanged"
|
|
2997
2997
|
};
|
|
2998
2998
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@istarry/dsh-assistant-profile",
|
|
3
3
|
"description": "助理档案：给 DSH 一份全局人格（名称 / 语言 / 人格提示词）与一份长期记忆，每个新会话的系统提示最前面都带着它；聊天里点一下就能把选中的对话提炼进记忆；侧栏「新会话」上方显示助理名；会话行菜单里可以直接删除一个会话（日志、索引、工作区登记一起）",
|
|
4
|
-
"version": "0.7.
|
|
4
|
+
"version": "0.7.8",
|
|
5
5
|
"icon": "./icon.svg",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"main": "lib/index.js",
|