dsh-soul 0.11.0 → 0.12.0

package/README.md

@@ -33,6 +33,7 @@ DeepSeek Harness 个性化设置插件，用于配置 Agent 的昵称、回复
 - Agent 可调用工具 `set_persona`，让模型在对话中直接调整人设
 - 人设预设：7 个内置人设（苏格拉底式提问者 / 极简主义者 / 资深架构师 / 教学型讲解者 / 严格代码审阅者 / 头脑风暴伙伴 / 自驱型协作者，随插件提供、不可删除）+ 多套自建人设一键切换（保存 / 使用 / 列表 / 删除，Web UI 与命令双入口）；每行摘要显示风格与偏离默认的维度
 - 预设只管 Agent 的人格：**切换预设不会动「关于你」**（昵称 / 职业 / 介绍是你本人的资料，与「Agent 怎么说话」是两码事）。内置与自建一视同仁——保存预设时只快照风格 / 特质 / 回复长度 / 输出语言 / 自定义指令，不包含身份字段；早期版本存下的完整快照会在读取时自动剥离
+- 分层生效范围：**会话覆盖 > 工作区绑定 > 目录绑定 > 全局设置 > 默认值**。绑定是**部分覆盖** —— 只接管那个人设声明过的字段，所以在全局「特质」里保存不会改变绑定了人设的工作区；「关于你」不在覆盖范围内，永远全局说话。`enabled` 同理，任何层都盖不掉它。设置页「特质」区的保存按钮下方有这行提示，细节在旁边的 ⓘ 里
 - **Soul 人设总览**（侧栏面板，**默认关闭**，可在设置页「在侧边栏显示人设总览」打开；关闭时侧栏不占位置，仍可从设置页「打开人设总览」按钮进入）：一屏看清「全局在用什么人设」，以及每个工作区 / 会话是否覆盖。三段结构：**当前生效**（可就地切换全局人设）·**工作区**（失效绑定就地改绑，展开后列出该工作区的会话）·**预设库**（只读清单，增删改仍在设置页）。会话行可直接点击跳到该会话；别的页面改了人设或绑定，面板自动刷新
 - 总览的会话口径与左侧栏一致：注册表成员 − 归档 − 子代理会话；「N 个会话」按同一口径统计，不把归档算进去。从未产生对话的**空会话**标为「（空会话 · 未开始对话）」并默认收起，末尾留一行开关可展开
 - **引用作为上下文**（**默认关闭**；DSH 官方 `dsh-message-quotes` 已内置更合适的入口）：在回答里选中一段文字 → 点「引用」，它作为**运行时上下文**随下一轮请求送达模型 —— 不进你的消息正文，也不写进对话历史
@@ -137,7 +138,7 @@ dsh plugin --profile <profile> update dsh-soul
 
 ## 使用
 
-启动 DSH 后，进入设置页面中的「个性化设置」栏目，修改配置并点击「保存设置」。
+启动 DSH 后，进入设置页面中的「个性化设置」栏目。「关于你」「特质」各自带一个保存按钮，只提交本区字段；「交互与界面」那一组（确认模式、快捷开关、引用、侧栏总览、输入框光轨）拨完即生效，不需要保存。「重置默认」在「高级选项」里，需要再点一次确认。
 
 也可以使用斜杠命令：
 

package/README_EN.md

@@ -33,6 +33,7 @@ A personalization plugin for DeepSeek Harness (DSH). Configure your agent's nick
 - Agent-callable tool `set_persona` to let the model adjust persona during a conversation
 - Named personas: 7 built-in personas (Socratic Questioner / Minimalist / Senior Architect / Teaching Explainer / Strict Code Reviewer / Brainstorm Partner / Self-Driven Collaborator — shipped with the plugin, cannot be deleted) plus your own named personas, switched with one click (save / use / list / delete, in both the Web UI and slash commands); each row summarises the style and every dimension that differs from its default
 - Personas cover the **agent's personality only**: switching a persona never touches **"About you"** (nickname / occupation / bio describe *you*, not how the agent talks). Built-in and self-saved personas behave identically — saving a persona snapshots style / traits / reply length / reply language / custom instructions, never the identity fields; full-config snapshots written by earlier versions are stripped on read
+- Scope precedence: **session override > workspace binding > directory binding > global settings > defaults**. A binding is a **partial** override — it takes over only the fields that persona actually declares, so saving in the global **Traits** section will not change a workspace that has a persona bound. "About you" is never in scope: it always comes from the global config. Neither can any layer turn off `enabled`. The note sits under the Traits section's save buttons as a short hint line, with the detail behind the ⓘ next to it.
 - **Soul persona overview** (sidebar panel, **off by default** — turn it on in Settings → "Show persona overview in sidebar"; while off it takes no sidebar space, and the "Open persona overview" button still opens it): see at a glance which persona is active globally, and whether each workspace / session overrides it. Three blocks: **Current** (switch the global persona in place) · **Workspaces** (rebind a broken binding in place; expand to list that workspace's sessions) · **Presets** (read-only list; add/edit/delete stays in Settings). Click a session row to jump straight to that session; the panel refreshes automatically when persona or bindings change elsewhere
 - The overview uses the same session scope as the sidebar: registry members − archived − subagent sessions, and the "N sessions" count follows the same rule (archived ones excluded). Sessions that never had a conversation are labelled "(empty session · no conversation yet)" and collapsed by default, with a toggle to show them
 - **Quote as context** (**off by default**; DSH already ships a better entry point, `dsh-message-quotes`): select text in a reply → **Quote**, and it is delivered to the model as **runtime context** with your next request — it never enters your message body or the chat history
@@ -139,7 +140,7 @@ dsh plugin --profile <profile> update dsh-soul
 
 ## Usage
 
-After starting DSH, open the **Personalization** section on the settings page, edit the configuration and click **Save Settings**.
+After starting DSH, open the **Personalization** section on the settings page. **About-you** and **Traits** each have their own save button that submits only that section; the **Interaction & UI** group (confirmation mode, quick toggle, quote, sidebar overview, input trail) applies immediately with no save needed. **Reset to defaults** lives under **Advanced** and asks for a second confirmation.
 
 Slash commands are also available: