dsh-soul 0.3.2 → 0.4.0

package/README.md

@@ -7,6 +7,7 @@ DeepSeek Harness 个性化设置插件，用于配置 Agent 的昵称、回复
 ## 功能
 
 - Web UI 个性化设置页面
+- 设置页体验：中英双语文案（随界面语言切换）、dirty 检测（无改动禁用保存）、保存结果提示、「查看当前生效提示词」只读面板
 - 启用或禁用个性化设置
 - 「关于你」：设置用户昵称、职业和介绍，回复时结合你的背景
 - 选择回复风格和语调（合并为单一选项）：`professional`（专业严谨）、`casual`（轻松自然）、`humorous`（幽默风趣）、`roast`（吐槽达人）、`efficient`（高效干练）
@@ -14,16 +15,19 @@ DeepSeek Harness 个性化设置插件，用于配置 Agent 的昵称、回复
   - 标题和列表：`default`（默认）、`more`（增强，采用清晰格式和列表结构）、`less`（减弱，使用更多段落文本）
   - 表情符号：`default`（默认）、`more`（增强，使用较多表情符号）、`less`（减弱，尽量减少使用表情符号）
 - 选择输出语言（Agent 回复语言 + `/soul` 命令输出语言）：中文 / English
+- 提示词随输出语言本地化：`language=en` 时 system prompt 使用英文描述
 - 输入自定义指令
 - Agent 可调用工具 `set_persona`，让模型在对话中直接调整人设
 - 配置持久化保存
+- 配置输入校验：字段白名单、类型、长度上限（昵称/职业 50、介绍 500、自定义指令 2000 字符）与枚举校验，非法或超限字段整单拒绝
 - 配置更新后同步到所有活动 Agent
+- 变更检测：仅在配置实际变化时刷新提示词并注入会话，无变化的保存不产生注入消息
 
 ## 安装
 
 ```powershell
 dsh plugin --profile web add dsh-soul
-dsh --profile web web
+dsh plugin --profile web update dsh-soul
 ```
 
 插件配置由 `cordis.patch.yml` 提供：
@@ -92,6 +96,8 @@ soul-config.json
 }
 ```
 
+字段长度上限：昵称 / 职业 50 字符，介绍 500 字符，自定义指令 2000 字符；未知字段会被丢弃，非法或超限字段整单拒绝（HTTP 返回 400 与字段级错误明细）。
+
 ## 实现原理
 
 插件通过 `compilePrompt()` 将昵称、风格、语调和自定义指令编译成 system prompt，并注册到 DSH：

package/README_EN.md

@@ -7,6 +7,7 @@ A personalization plugin for DeepSeek Harness (DSH). Configure your agent's nick
 ## Features
 
 - Personalization settings page in the Web UI
+- Localized settings UI (English/Chinese, follows the interface language), dirty tracking (save disabled when unchanged), save-result toasts, and a read-only "active prompt" viewer
 - Enable or disable personalization
 - "About you": set your nickname, occupation and bio so replies fit your background
 - Combined style & tone option: `professional`, `casual`, `humorous`, `roast`, `efficient`
@@ -14,16 +15,19 @@ A personalization plugin for DeepSeek Harness (DSH). Configure your agent's nick
   - Headings & lists: `default`, `more` (clear formatting with headings and lists), `less` (more paragraph text)
   - Emoji: `default`, `more` (frequent emoji usage), `less` (minimal emoji usage)
 - Output language (agent reply language + `/soul` command output language): Chinese or English
+- The compiled system prompt follows the output language (English descriptions when `language=en`)
 - Custom instructions
 - Agent-callable tool `set_persona` to let the model adjust persona during a conversation
 - Configuration persisted to disk
+- Input validation: field whitelist, types, length limits (nickname/occupation 50, bio 500, custom instructions 2000 chars) and enum checks; invalid or oversized fields reject the whole write
 - Configuration synced to all active agents after every update
+- Change detection: the prompt is refreshed and sessions injected only when the configuration actually changed — no-op saves inject nothing
 
 ## Installation
 
 ```powershell
 dsh plugin --profile web add dsh-soul
-dsh --profile web web
+dsh plugin --profile web update dsh-soul
 ```
 
 The plugin is registered via `cordis.patch.yml`:
@@ -92,6 +96,8 @@ Example:
 }
 ```
 
+Length limits: nickname / occupation 50 chars, bio 500 chars, custom instructions 2000 chars. Unknown fields are dropped; invalid or oversized fields reject the whole write (HTTP returns 400 with per-field error details).
+
 ## How It Works
 
 The plugin compiles the nickname, style, tone and custom instructions into a system prompt via `compilePrompt()` and registers it with DSH: