@istarry/dsh-assistant-profile 0.6.1 → 0.7.2

package/README.en.md

@@ -0,0 +1,124 @@
+# Assistant Profile · dsh-assistant-profile
+
+One **global persona** and one **long-term memory** for DeepSeek Harness: name, language, persona prompt, and a memory that rides right behind the persona in every system prompt. Install it once and every new session opens with it at the very top of the system prompt. The sidebar shows the assistant's name above New Session.
+
+One profile, all four modes (standard / PTC / minimal / creator). No preset duplication, no mode-picker override.
+
+## What it does
+
+The host half does exactly one thing: when a chat agent is created (and when a blank session is re-bound to another preset), it registers a `deployment:persona-prefix` section in that agent's **own scope**. The nearest same-named section wins, so the preset's identity line is replaced while tools, flow, and mode semantics stay untouched.
+
+That is the same path the official subagent runtime uses for per-child personas (`dsh-subagent`'s `applyChildComposition`), which is why it works for all four presets.
+
+The injected text looks like this (blank-line separated, each part optional):
+
+```
+Your name is 大肥鱼.
+
+Reply in 简体中文 throughout.
+
+<your persona prompt…>
+```
+
+- **Minimal mode** treats the persona as the complete system prompt (`complete: true`). The shadowing section mirrors that flag, so minimal mode's prompt becomes *only* your persona — still no tool instructions, exactly as that mode is designed.
+- With all four fields empty it falls back to the preset's own text, i.e. native behaviour.
+- **Subagents are left alone**: a delegated child keeps its own persona.
+
+## Assistant memory
+
+One profile means one memory: a markdown document (one `- [YYYY-MM-DD HH:mm] content` line per fact) stored with the profile alongside the persona, shared by every session.
+
+**Where it lands**: section `memory:assistant`, order 500 — after the persona (0), before the tool catalog (1000). Memory states who the user and the assistant are, which the tool descriptions then assume.
+
+**Three ways in**:
+
+- **The Remember button in chat**: every assistant message's action strip (beside the official like/dislike pair) gains a ✨. It opens a picker listing the session's user/assistant messages; submit and the host runs **that session's own model** once to condense the selection into a few stable facts, appending each (an identical fact only refreshes its stamp instead of piling up).
+- **Settings → Agent memory**: two switches (memory / auto memory) and an editor. Hand-written edits land on save.
+- **The `memory_add` tool**: registered only while both switches are on, letting the model decide what to remember mid-conversation.
+
+Extraction is fail-closed: an offline session, a missing model configuration, or a model that returns nothing writable leaves the store untouched and reports the reason in the dialog.
+
+### Three pitfalls worth knowing before touching this
+
+1. **A plugin cannot write its own config.** `Volatile` exposes `get()` only; writes must go through the settings service (`settings.update(ns, patch)`), which persists to the profile patch and lets the loader commit the new value back into the runtime reference.
+2. **Write-backs must escape the HMR transaction.** A settings write runs inside `hmr.runExclusive`, and writing the result back opens another transaction — calling it inline throws `HMR transactions cannot be nested`. Every trigger therefore goes through `setTimeout(0)`.
+3. **Settings writes do not emit `loader/volatile-update`** (measured: the value commits into the reference, the event never fires). The mailbox is polled every 700 ms instead — one string read, one JSON check when idle.
+
+Because `@deepseek-ai/dsh-tools` / `dsh-llm` / `dsh-session` do not resolve from the plugin directory (only `cordis` is host-provided), the tool definition and the extraction messages are hand-built to the official wire shapes rather than imported.
+
+## Editing the persona does not recompute history
+
+DeepSeek context caching is prefix caching: the system prompt sits at the front, so rewriting the leading system message invalidates everything after it.
+
+The persona text is **evaluated at every assembly**, so saving a new one changes the next request's prompt while **not touching a single byte of history**. The rest is the host's call: on a model route declaring `systemPromptUpdate: 'in-history'` (the default `deepseek-flash` entry does), the changed prompt is **appended after the cached history**, so the prefix through that history stays reusable and only the new snippet is billed as ordinary input.
+
+The session log states the mode in `request/context`:
+
+```json
+{"provider":"deepseek-official","model":"deepseek-flash","systemPromptUpdate":"in-history"}
+```
+
+On a route without it (the default `deepseek-v4-pro` entry, for example) a mid-session edit costs one full cache miss from the first token. That is a route capability, not a plugin choice; if it matters, make the edit between sessions.
+
+## UI
+
+- A new **Assistant Profile** row in the sidebar, right below Plugins (order 5).
+- It opens a main-area page: name, language, persona prompt, a live character counter (turns warning-coloured past 2000).
+- Left of Save sits the persona row: **Default 1 / 2 / 3** (a click only fills the three fields; Save still decides what sticks) plus "Save as" copies (named after the Name field, each with a small delete button); a fresh install starts on Default 3, and the row scrolls horizontally when it overflows.
+- Above the New Session button: a quiet name row (first-character chip + name). It hides when the sidebar collapses to the 56px rail and updates as soon as a new name is saved.
+- Defaults: name `大肥鱼`, language `中文`.
+
+## Where the data lives
+
+The four fields are this plugin's profile config, read and written through the official settings channel, persisted into the profile's `cordis.patch.yml`:
+
+```yaml
+- id: assistant-profile
+  name: '@istarry/dsh-assistant-profile'
+  config:
+    name: 小星
+    language: 简体中文
+    persona: 你是一个只讲证据的助理。不确定就说不确定。
+```
+
+It travels with the profile: another profile is another persona; backing up the profile backs up the persona.
+
+## Install
+
+```bash
+dsh plugin --profile <profile> add @istarry/dsh-assistant-profile
+# local tarball:
+dsh plugin --profile <profile> add E:/Plugin/发布版/dsh-assistant-profile/dist/istarry-dsh-assistant-profile-0.2.1.tgz
+```
+
+Restart DSH. To remove:
+
+```bash
+dsh plugin --profile <profile> remove @istarry/dsh-assistant-profile
+```
+
+Leftover config lines are harmless (nothing reads them), but deleting them is tidier.
+
+## Relationship to dsh-agent-suite
+
+Both shadow the same section (`deployment:persona-prefix`); **do not enable both** — the later load wins and the personas fight. Use agent-suite when you need several agents with their own personas; use this one for a single persona you carry everywhere.
+
+## Build
+
+```bash
+cd tooling && pnpm install    # once: tsdown + lightningcss + typescript + js-yaml
+cd .. && node build.mjs       # src/ → dist/ (manifest and static files included)
+node build.mjs --staging      # build to .build/out only
+node build.mjs --check        # build + dependency-contract check, no dist/ writes
+```
+
+The host bundle inlines `js-yaml`; at runtime it only depends on `@deepseek-ai/schemastery` (declared in `dependencies`, installed into the plugin's own node_modules by pnpm). The browser bundle only `require`s module-table entries (react / ui-primitives).
+
+Edit `src/` only; artifacts are generated.
+
+## Known edges
+
+- Top-level sessions only; subagents are never injected.
+- When the preset registry cannot be read, injection degrades to a plain section (no `complete` mirroring) and logs nothing.
+- Saving with all three fields cleared injects nothing (native identity); a fresh install carries the Default 3 content.
+- The nameplate is a DOM node inserted before the New Session button (the shell exposes no slot there); a MutationObserver puts it back if a re-render drops it.

package/README.md

@@ -1,4 +1,4 @@
-# 助理档案 · dsh-assistant-profile
+# Agent助理 · dsh-assistant-profile
 
 给 DeepSeek Harness 一份**全局人格**和**一份长期记忆**：名称、语言、人格提示词三段，装一次，之后每个新会话的系统提示最前面都从它开始；记忆紧跟在人格后面，聊天里点一下就能把选中的对话提炼进去。侧栏「新会话」上方会显示这份档案的助理名。
 
@@ -46,6 +46,21 @@ Reply in 简体中文 throughout.
 
 因为插件目录里解析不到 `@deepseek-ai/dsh-tools` / `dsh-llm` / `dsh-session`（只有 `cordis` 由宿主提供），工具定义与提炼用的消息都按官方线上形状**手搭**，不 import 这几个包。
 
+## 删除会话
+
+侧栏任意会话行的「…」菜单里多一行**删除**（红色，带分隔线，排在「复制 Session ID」之后）。确认后删的是这个会话本身：
+
+- **磁盘**：`<DSH_HOME>/sessions/<项目>/<会话 id>/` 整个目录（日志、分代文件一起），
+- **索引**：会话查询里那一行（下次搜索不会再出现），
+- **登记**：工作区里对这个会话的记账，
+- **界面**：宿主发 `api-session/removed`，官方 session-controller 收到后把行从侧栏移除。
+
+正在运行的会话会被拒绝（先停止），空闲但还开着的会话会先被摘下再删。
+
+### 为什么不是调一个 `remove()` 就完事
+
+这一版 harness 的 `sessionPersistence` **没有**删除方法，`locate` / `listArtifacts` 的第一个参数又是 options（里面装 `signal`）——把会话 id 传进去会走进 `signal?.throwIfAborted()`，直接把宿主带崩（实测 `fatal load failure`）。所以删除按目录布局自己做，只认 `<root>/<项目>/<会话 id>` 这一种形状；命中不到就返回「找不到」，宁可不动手。
+
 ## 改人格不会重算历史
 
 DeepSeek 的上下文缓存是前缀缓存：系统提示在最前面，直接改写开头那条会让后面全部失效。
@@ -62,7 +77,7 @@ DeepSeek 的上下文缓存是前缀缓存：系统提示在最前面，直接
 
 ## 界面
 
-- 侧栏「插件」下面多一行**助理档案**（行序 5，夹在插件与自动化任务之间）。
+- 侧栏「插件」下面多一行**Agent助理**（行序 5，夹在插件与自动化任务之间）。
 - 点开是主区的一个页面：名称、语言、人格提示词，右下角实时字数（超过 2000 字转成提醒色）。
 - 「保存」行左侧是人格预设：**默认一 / 默认二 / 默认三**（点击只把三段文本填进表单，落盘仍按「保存」）加「另存」出来的自定义（名字取自「名称」，胶囊右侧带小删除钮）；装好默认用**默认三**，放不下横向滚动。
 - 「新会话」按钮上方一行小字 + 首字方块显示助理名；侧栏收成 56px 图标栏时自动隐藏；改完名称保存后立刻变。

package/cordis.patch.yml

@@ -1,7 +1,7 @@
-# 助理档案插件：一行。
+# Agent助理插件：一行。
 # 宿主半端只做一件事——每个对话 agent 创建时，在它自己的作用域里遮蔽人格那一行
 # （`deployment:persona-prefix`），文本来自本插件的配置；四个模式自动全覆盖，
-# 不需要复制预设、不需要动模式选择器。浏览器半端提供「助理档案」入口、编辑页，
+# 不需要复制预设、不需要动模式选择器。浏览器半端提供「Agent助理」入口、编辑页，
 # 以及「新会话」按钮上方的助理名。
 - insert:
     - id: assistant-profile

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@istarry/dsh-assistant-profile",
-  "description": "助理档案：给 DSH 一份全局人格（名称 / 语言 / 人格提示词）与一份长期记忆，每个新会话的系统提示最前面都带着它；聊天里点一下就能把选中的对话提炼进记忆；侧栏「新会话」上方显示助理名",
-  "version": "0.6.1",
+  "description": "助理档案：给 DSH 一份全局人格（名称 / 语言 / 人格提示词）与一份长期记忆，每个新会话的系统提示最前面都带着它；聊天里点一下就能把选中的对话提炼进记忆；侧栏「新会话」上方显示助理名；会话行菜单里可以直接删除一个会话（日志、索引、工作区登记一起）",
+  "version": "0.7.2",
   "icon": "./icon.svg",
   "type": "module",
   "main": "lib/index.js",
@@ -44,14 +44,23 @@
       "platform": "web"
     }
   },
+  "scripts": {
+    "build": "node build.mjs",
+    "check": "node build.mjs --check",
+    "staging": "node build.mjs --staging",
+    "tooling": "cd tooling && pnpm install"
+  },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
   },
+  "devDependencies": {
+    "js-yaml": "4.2.0"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.2.1-rc.2",
-    "@deepseek-ai/dsh-agent-preset-registry": "^0.2.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.2.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2"
+    "@deepseek-ai/dsh-agent": ">=0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-preset-registry": ">=0.2.1-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.2.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": ">=0.2.1-rc.2"
   }
 }