dsh-soul 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# dsh-soul
+
+DeepSeek Harness 个性化设置插件，用于配置 Agent 的昵称、回复风格、语调和自定义指令。
+
+## 功能
+
+- Web UI 个性化设置页面
+- 启用或禁用个性化设置
+- 设置用户昵称
+- 选择回复风格：`professional`、`casual`、`friendly`、`humorous`、`academic`
+- 选择语调：`neutral`、`formal`、`informal`、`enthusiastic`、`calm`
+- 输入自定义指令和使用示例模板
+- 配置持久化保存
+- 配置更新后同步到所有活动 Agent
+
+## 安装
+
+```powershell
+dsh plugin --profile web add dsh-soul
+dsh --profile web web
+```
+
+插件配置由 `cordis.patch.yml` 提供：
+
+```yaml
+- insert:
+    - id: soul
+      name: dsh-soul
+```
+
+## 使用
+
+启动 DSH 后，进入设置页面中的「个性化设置」栏目，修改配置并点击「保存设置」。
+
+也可以使用斜杠命令：
+
+```text
+/soul show       查看当前配置
+/soul reset      重置配置
+/soul enable     启用个性化设置
+/soul disable    禁用个性化设置
+/soul 小明       设置昵称
+```
+
+配置保存后会同步到所有活动 Agent，当前会话下一次请求即可使用最新配置。
+
+## 配置文件
+
+配置文件位置：
+
+```text
+$DSH_HOME/soul-config.json
+```
+
+未设置 `DSH_HOME` 时使用：
+
+```text
+~/.dsh/soul-config.json
+```
+
+配置示例：
+
+```json
+{
+  "enabled": true,
+  "nickname": "小明",
+  "style": "professional",
+  "tone": "neutral",
+  "customInstructions": "请保持简洁，优先给出结论。"
+}
+```
+
+## 实现原理
+
+插件通过 `compilePrompt()` 将昵称、风格、语调和自定义指令编译成 system prompt，并注册到 DSH：
+
+```js
+spCtx.systemPrompt.section({
+  name: 'soul:persona',
+  order: 0,
+  text: () => compilePrompt(configCache || DEFAULT_CONFIG)
+})
+```
+
+配置更新后，插件会遍历所有活动 Agent，使用标准 `UserMessage` 调用 `agent.inject()`：
+
+```js
+agent.inject(createUserMessage({
+  content: [{ type: 'text', text: prompt }],
+  source: {
+    kind: 'plugin',
+    plugin: 'dsh-soul',
+    form: 'snapshot',
+    sections: [{ name: 'soul:persona', text: prompt }]
+  }
+}))
+```
+
+`agent.inject()` 会将最新配置放入 Agent 的待处理上下文，在下一次请求中生效；不会主动触发新请求，也不会修改历史消息。
+
+## 许可证
+
+MIT License

package/client/index.mjs

@@ -0,0 +1,570 @@
+// client/index.mjs — dsh-soul Web UI 插件
+//
+// 在设置页面添加「个性化」栏目：
+//   - 启用/禁用个性化设置
+//   - 选择回复风格
+//   - 选择语调
+//   - 输入自定义指令
+//   - 查看示例
+//
+// 纯 JS + React jsx-runtime 手写（不依赖 JSX 构建），开箱即用。
+// 注意：dsh web 使用 React 17+ 的 jsx-runtime，children 必须放在 props.children
+// 里；不能把 children 当第三个参数传（第三个参数是 key）。
+
+window.__ModuleLoader__.load({
+  id: 'dsh-soul',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+
+    // react/jsx-runtime：官方 client bundle 使用 jsx/jsxs/Fragment。
+    // 我们用一个小包装 e() 让 children 写法保持直观，同时符合 jsx-runtime 约定。
+    const { jsx: h, jsxs: hs, Fragment } = require('react/jsx-runtime')
+    const React = require('react')
+    const ui = require('@deepseek-ai/dsh-client-ui-primitives')
+
+    // 包装：把多余的参数收集成 props.children，避免直接调用 h(type, props, child)
+    // 时被当成 key 参数。
+    const e = (type, props, ...children) => {
+      const p = props || {}
+      if (children.length === 0) return h(type, p)
+      if (children.length === 1) return h(type, { ...p, children: children[0] })
+      return hs(type, { ...p, children })
+    }
+
+    // -------------------------------------------------------------------------
+    // 状态与控制器
+    // -------------------------------------------------------------------------
+
+    const NS = 'soul'
+    const INITIAL = {
+      enabled: true,
+      nickname: '',
+      style: 'professional',
+      tone: 'neutral',
+      customInstructions: '',
+      loading: false,
+      saving: false,
+      error: null
+    }
+
+    // 第三方插件不能 require('@deepseek-ai/dsh-client-runtime/client')——
+    // dsh web 的 module table 只 seed 9 个 platform 模块，runtime/client 不在里面。
+    // 第三方插件必须自实现 SnapshotStore。
+    const createSnapshotStore = (init) => {
+      let state = init
+      const listeners = new Set()
+      const notify = () => { for (const fn of [...listeners]) fn() }
+      return {
+        getSnapshot: () => state,
+        subscribe: (fn) => { listeners.add(fn); return () => listeners.delete(fn) },
+        update: (mutator) => {
+          const next = { ...state }
+          mutator(next)
+          state = next
+          notify()
+        },
+        set: (next) => { state = next; notify() },
+      }
+    }
+
+    function hostBase() {
+      const origin = globalThis.location?.origin
+      return origin !== void 0 && origin !== 'null' ? origin : 'http://dsh.internal'
+    }
+
+    function messageOf(error) {
+      return error instanceof Error ? error.message : String(error)
+    }
+
+    var SoulController = class {
+      constructor(fetcher = (input, init) => fetch(input, init)) {
+        this.fetcher = fetcher
+        this.store = createSnapshotStore(INITIAL)
+        this.disposed = false
+      }
+
+      async loadConfig() {
+        if (this.disposed) return
+        this.store.update(s => { s.loading = true; s.error = null })
+        
+        try {
+          const url = new URL('/api/soul/config', hostBase())
+          const response = await this.fetcher(url)
+          const payload = await response.json().catch(() => ({}))
+          
+          if (!response.ok || payload.ok !== true) {
+            throw new Error(payload.error || `HTTP ${response.status}`)
+          }
+          
+          this.store.update(s => {
+            s.enabled = payload.config.enabled
+            s.nickname = payload.config.nickname || ''
+            s.style = payload.config.style
+            s.tone = payload.config.tone
+            s.customInstructions = payload.config.customInstructions
+            s.loading = false
+          })
+        } catch (error) {
+          if (this.disposed) return
+          this.store.update(s => {
+            s.loading = false
+            s.error = messageOf(error)
+          })
+        }
+      }
+
+      async saveConfig(config) {
+        if (this.disposed) return
+        this.store.update(s => { s.saving = true; s.error = null })
+        
+        try {
+          const url = new URL('/api/soul/config', hostBase())
+          const response = await this.fetcher(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(config)
+          })
+          const payload = await response.json().catch(() => ({}))
+          
+          if (!response.ok || payload.ok !== true) {
+            throw new Error(payload.error || `HTTP ${response.status}`)
+          }
+          
+          this.store.update(s => {
+            s.enabled = payload.config.enabled
+            s.nickname = payload.config.nickname || ''
+            s.style = payload.config.style
+            s.tone = payload.config.tone
+            s.customInstructions = payload.config.customInstructions
+            s.saving = false
+          })
+        } catch (error) {
+          if (this.disposed) return
+          this.store.update(s => {
+            s.saving = false
+            s.error = messageOf(error)
+          })
+        }
+      }
+
+      async resetConfig() {
+        if (this.disposed) return
+        this.store.update(s => { s.saving = true; s.error = null })
+        
+        try {
+          const url = new URL('/api/soul/config/reset', hostBase())
+          const response = await this.fetcher(url, { method: 'POST' })
+          const payload = await response.json().catch(() => ({}))
+          
+          if (!response.ok || payload.ok !== true) {
+            throw new Error(payload.error || `HTTP ${response.status}`)
+          }
+          
+          this.store.update(s => {
+            s.enabled = payload.config.enabled
+            s.nickname = payload.config.nickname || ''
+            s.style = payload.config.style
+            s.tone = payload.config.tone
+            s.customInstructions = payload.config.customInstructions
+            s.saving = false
+          })
+        } catch (error) {
+          if (this.disposed) return
+          this.store.update(s => {
+            s.saving = false
+            s.error = messageOf(error)
+          })
+        }
+      }
+
+      async dispose() {
+        this.disposed = true
+      }
+    }
+
+    // -------------------------------------------------------------------------
+    // 样式（data-plugin-css 注入，避免与宿主样式冲突）
+    // -------------------------------------------------------------------------
+
+    const css = [
+      '.soul-section{margin:24px 0;padding:20px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-l1)}',
+      '.soul-section h3{margin:0 0 16px 0;font-size:16px;font-weight:600;color:var(--dsw-alias-label-primary)}',
+      '.soul-field{margin-bottom:16px;width:100%}',
+      '.soul-field label{display:block;margin-bottom:6px;font-size:13px;font-weight:500;color:var(--dsw-alias-label-secondary)}',
+      '.soul-field select,.soul-field textarea,.soul-field input[type=text]{width:100%;padding:8px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-l1);color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5;box-sizing:border-box}',
+      '.soul-field textarea{min-height:100px;resize:vertical}',
+      '.soul-field select:focus,.soul-field textarea:focus,.soul-field input[type=text]:focus{outline:none;border-color:var(--dsw-alias-border-focus);box-shadow:0 0 0 2px var(--dsw-alias-border-focus-alpha)}',
+      '.soul-toggle{display:flex;align-items:center;gap:8px;margin-bottom:16px}',
+      '.soul-toggle label{margin:0;font-size:13px;color:var(--dsw-alias-label-primary)}',
+      '.soul-buttons{display:flex;gap:8px;margin-top:16px}',
+      '.soul-examples{margin-top:16px;padding:12px;background:var(--dsw-alias-bg-l2);border-radius:6px;width:100%;box-sizing:border-box}',
+      '.soul-examples h4{margin:0 0 8px 0;font-size:13px;color:var(--dsw-alias-label-secondary)}',
+      '.soul-example{padding:8px 12px;margin-bottom:8px;background:var(--dsw-alias-bg-l1);border-radius:4px;cursor:pointer;font-size:12px;color:var(--dsw-alias-label-primary)}',
+      '.soul-example:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+      '.soul-example:last-child{margin-bottom:0}',
+      '.soul-error{margin-top:8px;padding:8px 12px;background:var(--dsw-alias-bg-danger);border:1px solid var(--dsw-alias-border-danger);border-radius:6px;color:var(--dsw-alias-label-danger);font-size:12px;width:100%;box-sizing:border-box}',
+      '.soul-status{margin-top:8px;font-size:12px;color:var(--dsw-alias-label-secondary)}',
+      '.soul-toast{position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);padding:8px 16px;border-radius:6px;font-size:13px;font-weight:500;z-index:10000;box-shadow:0 2px 8px rgba(0,0,0,0.15);pointer-events:none;text-align:center;min-width:auto;white-space:nowrap}',
+      '.soul-toast-success{background:#f6ffed;border:1px solid #b7eb8f;color:#52c41a}',
+      '@keyframes fadeInOut{0%{opacity:0;transform:translate(-50%,-50%) scale(0.9)}15%{opacity:1;transform:translate(-50%,-50%) scale(1)}85%{opacity:1;transform:translate(-50%,-50%) scale(1)}100%{opacity:0;transform:translate(-50%,-50%) scale(0.9)}}'
+    ].join('')
+    
+    const tagId = 'dsh-soul/styles.css'
+    let styleTagMissing = false
+    if (typeof document !== 'undefined') {
+      try {
+        styleTagMissing = document.querySelector(`style[data-plugin-css="${tagId}"]`) === null
+      } catch {
+        styleTagMissing = true
+      }
+    }
+    if (styleTagMissing) {
+      const tag = document.createElement('style')
+      tag.dataset.plugin = 'dsh-soul'
+      tag.dataset.pluginCss = tagId
+      tag.textContent = css
+      document.head.appendChild(tag)
+    }
+
+    // -------------------------------------------------------------------------
+    // 组件
+    // -------------------------------------------------------------------------
+
+    const STYLE_OPTIONS = [
+      { value: 'professional', label: '专业严谨' },
+      { value: 'casual', label: '轻松自然' },
+      { value: 'friendly', label: '友好亲切' },
+      { value: 'humorous', label: '幽默风趣' },
+      { value: 'academic', label: '学术性' }
+    ]
+
+    const TONE_OPTIONS = [
+      { value: 'neutral', label: '中性客观' },
+      { value: 'formal', label: '正式礼貌' },
+      { value: 'informal', label: '非正式、口语化' },
+      { value: 'enthusiastic', label: '热情积极' },
+      { value: 'calm', label: '平静沉稳' }
+    ]
+
+    const EXAMPLES = [
+      { label: '专业严谨', value: '你是一个专业严谨的助手，采用学术性的语气，注重逻辑和准确性。' },
+      { label: '友好亲切', value: '你是一个友好亲切的助手，采用轻松自然的语气，像朋友一样交流。' },
+      { label: '幽默风趣', value: '你是一个幽默风趣的助手，适当使用比喻和玩笑，让对话更有趣。' },
+      { label: '简洁直接', value: '你是一个简洁直接的助手，回答问题直击要点，避免冗余。' }
+    ]
+
+    function SoulSettings(props) {
+      const { useSoulController, controller } = props
+      const state = useSoulController((state) => state)
+      const { enabled, nickname, style, tone, customInstructions, loading, saving, error } = state
+      
+      const [localEnabled, setLocalEnabled] = React.useState(enabled)
+      const [localNickname, setLocalNickname] = React.useState(nickname || '')
+      const [localStyle, setLocalStyle] = React.useState(style)
+      const [localTone, setLocalTone] = React.useState(tone)
+      const [localInstructions, setLocalInstructions] = React.useState(customInstructions)
+      const [showSuccess, setShowSuccess] = React.useState(false)
+      const [showResetSuccess, setShowResetSuccess] = React.useState(false)
+      
+      // 同步状态
+      React.useEffect(() => {
+        setLocalEnabled(enabled)
+        setLocalNickname(nickname || '')
+        setLocalStyle(style)
+        setLocalTone(tone)
+        setLocalInstructions(customInstructions)
+      }, [enabled, nickname, style, tone, customInstructions])
+      
+      // 保存成功后显示提示，2秒后自动消失
+      React.useEffect(() => {
+        if (showSuccess) {
+          const timer = setTimeout(() => setShowSuccess(false), 2000)
+          return () => clearTimeout(timer)
+        }
+      }, [showSuccess])
+      
+      // 重置成功后显示提示，2秒后自动消失
+      React.useEffect(() => {
+        if (showResetSuccess) {
+          const timer = setTimeout(() => setShowResetSuccess(false), 2000)
+          return () => clearTimeout(timer)
+        }
+      }, [showResetSuccess])
+      
+      const handleSave = async () => {
+        const controller = props.controller
+        await controller.saveConfig({
+          enabled: localEnabled,
+          nickname: localNickname,
+          style: localStyle,
+          tone: localTone,
+          customInstructions: localInstructions
+        })
+        setShowSuccess(true)
+      }
+      
+      const handleReset = async () => {
+        const controller = props.controller
+        await controller.resetConfig()
+        setShowResetSuccess(true)
+      }
+      
+      const handleExampleClick = (example) => {
+        setLocalInstructions(example.value)
+      }
+      
+      return e('div', { className: 'soul-section' },
+        e('h3', null, '个性化设置'),
+        e('div', { className: 'soul-toggle' },
+          e('input', {
+            type: 'checkbox',
+            id: 'soul-enabled',
+            checked: localEnabled,
+            onChange: (ev) => setLocalEnabled(ev.target.checked)
+          }),
+          e('label', { htmlFor: 'soul-enabled' }, '启用个性化设置')
+        ),
+        
+        localEnabled && e(Fragment, null,
+          e('div', { className: 'soul-field' },
+            e('label', { htmlFor: 'soul-nickname' }, '用户昵称'),
+            e('input', {
+              type: 'text',
+              id: 'soul-nickname',
+              value: localNickname,
+              onChange: (ev) => setLocalNickname(ev.target.value),
+              placeholder: '输入你的昵称，回复时会称呼你'
+            })
+          ),
+          
+          e('div', { className: 'soul-field' },
+            e('label', { htmlFor: 'soul-style' }, '回复风格'),
+            e('select', {
+              id: 'soul-style',
+              value: localStyle,
+              onChange: (ev) => setLocalStyle(ev.target.value)
+            },
+              ...STYLE_OPTIONS.map(opt => 
+                e('option', { key: opt.value, value: opt.value }, opt.label)
+              )
+            )
+          ),
+          
+          e('div', { className: 'soul-field' },
+            e('label', { htmlFor: 'soul-tone' }, '语调'),
+            e('select', {
+              id: 'soul-tone',
+              value: localTone,
+              onChange: (ev) => setLocalTone(ev.target.value)
+            },
+              ...TONE_OPTIONS.map(opt => 
+                e('option', { key: opt.value, value: opt.value }, opt.label)
+              )
+            )
+          ),
+          
+          e('div', { className: 'soul-field' },
+            e('label', { htmlFor: 'soul-instructions' }, '自定义指令'),
+            e('textarea', {
+              id: 'soul-instructions',
+              value: localInstructions,
+              onChange: (ev) => setLocalInstructions(ev.target.value),
+              placeholder: '输入自定义指令，例如：你是一个求知的人，采用专业的语气...'
+            })
+          ),
+          
+          e('div', { className: 'soul-examples' },
+            e('h4', null, '💡 示例指令（点击使用）'),
+            ...EXAMPLES.map((example, index) => 
+              e('div', {
+                key: index,
+                className: 'soul-example',
+                onClick: () => handleExampleClick(example)
+              }, `${example.label}：${example.value}`)
+            )
+          )
+        ),
+        
+        error && e('div', { className: 'soul-error' }, error),
+        
+        e('div', { className: 'soul-buttons' },
+          e(ui.Button, {
+            variant: 'primary',
+            onClick: handleSave,
+            disabled: saving
+          }, saving ? '保存中...' : '保存设置'),
+          e(ui.Button, {
+            onClick: handleReset,
+            disabled: saving
+          }, '重置默认')
+        ),
+        
+        loading && e('div', { className: 'soul-status' }, '加载中...'),
+        
+        showSuccess && e('div', { 
+          className: 'soul-toast soul-toast-success',
+          style: {
+            animation: 'fadeInOut 2s ease-in-out'
+          }
+        }, '✅ 设置已保存'),
+        
+        showResetSuccess && e('div', { 
+          className: 'soul-toast soul-toast-success',
+          style: {
+            animation: 'fadeInOut 2s ease-in-out'
+          }
+        }, '✅ 已重置为默认值')
+      )
+    }
+
+    // -------------------------------------------------------------------------
+    // 文案
+    // -------------------------------------------------------------------------
+
+    const zh = {
+      'settings.title': '个性化设置',
+      'settings.description': '自定义Agent回复的风格和语调',
+      'button.save': '保存设置',
+      'button.reset': '重置默认',
+      'option.style': '回复风格',
+      'option.tone': '语调',
+      'option.instructions': '自定义指令',
+      'option.enabled': '启用个性化设置',
+      'example.title': '💡 示例指令（点击使用）',
+      'status.loading': '加载中...',
+      'status.saving': '保存中...'
+    }
+    
+    const en = {
+      'settings.title': 'Personalization Settings',
+      'settings.description': 'Customize agent response style and tone',
+      'button.save': 'Save Settings',
+      'button.reset': 'Reset to Default',
+      'option.style': 'Response Style',
+      'option.tone': 'Tone',
+      'option.instructions': 'Custom Instructions',
+      'option.enabled': 'Enable Personalization',
+      'example.title': '💡 Example Instructions (click to use)',
+      'status.loading': 'Loading...',
+      'status.saving': 'Saving...'
+    }
+
+    // -------------------------------------------------------------------------
+    // 插件装配
+    // -------------------------------------------------------------------------
+
+    const inject = ['slots', 'locale']
+
+    function apply(ctx) {
+      const controller = new SoulController()
+      ctx.provide('soulController', controller)
+      ctx.effect(() => () => {
+        controller.dispose()
+      }, 'dsh-soul: browser lifecycle')
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-soul: dictionaries')
+      
+      // DSH 0.1.x 不支持 settings.section 的 icon 字段
+      // 使用 DOM 操作动态替换图标（类似 dsh-better-sidebar 的方案）
+      const SOUL_NAV_MARKER = 'data-soul-settings-nav'
+      const SOUL_ICON_MARKER = 'data-soul-icon-replaced'
+      
+      const registerSettingsNavIcon = () => {
+        let disposed = false
+        
+        const sync = () => {
+          if (disposed) return
+          
+          const buttons = document.querySelectorAll('[role="dialog"] nav button')
+          for (const button of buttons) {
+            if (button.textContent?.trim() === '个性化') {
+              button.setAttribute(SOUL_NAV_MARKER, '')
+              
+              // 检查是否已经替换过图标
+              if (button.hasAttribute(SOUL_ICON_MARKER)) continue
+              
+              // 查找并替换图标
+              const existingIcon = button.querySelector('svg')
+              if (existingIcon) {
+                // 标记已替换
+                button.setAttribute(SOUL_ICON_MARKER, 'true')
+                
+                // 创建星形图标（跟随主题色）
+                const starSvg = document.createElementNS('http://www.w3.org/2000/svg', 'svg')
+                starSvg.setAttribute('viewBox', '0 0 24 24')
+                starSvg.setAttribute('fill', 'none')
+                starSvg.setAttribute('stroke', 'currentColor')
+                starSvg.setAttribute('stroke-width', '2')
+                starSvg.setAttribute('stroke-linecap', 'round')
+                starSvg.setAttribute('stroke-linejoin', 'round')
+                starSvg.style.width = '16px'
+                starSvg.style.height = '16px'
+                
+                const path = document.createElementNS('http://www.w3.org/2000/svg', 'path')
+                path.setAttribute('d', 'M12 2L15.09 8.26L22 9.27L17 14.14L18.18 21.02L12 17.77L5.82 21.02L7 14.14L2 9.27L8.91 8.26L12 2Z')
+                starSvg.appendChild(path)
+                
+                existingIcon.replaceWith(starSvg)
+              }
+            } else {
+              button.removeAttribute(SOUL_NAV_MARKER)
+            }
+          }
+        }
+        
+        // 延迟执行初始同步，等待设置页面渲染完成
+        const timer = setTimeout(sync, 500)
+        
+        // 监听 DOM 变化（只监听子节点添加，不监听所有变化）
+        const observer = new MutationObserver(() => {
+          // 防抖：只在停止变化后执行
+          clearTimeout(timer)
+          setTimeout(sync, 100)
+        })
+        
+        observer.observe(document.body, {
+          childList: true,
+          subtree: true
+        })
+        
+        return () => {
+          disposed = true
+          clearTimeout(timer)
+          observer.disconnect()
+          document.querySelectorAll(`[${SOUL_NAV_MARKER}]`).forEach((element) => {
+            element.removeAttribute(SOUL_NAV_MARKER)
+          })
+          document.querySelectorAll(`[${SOUL_ICON_MARKER}]`).forEach((element) => {
+            element.removeAttribute(SOUL_ICON_MARKER)
+          })
+        }
+      }
+      
+      // 注册图标替换效果
+      ctx.effect(() => registerSettingsNavIcon(), 'dsh-soul: settings navigation icon')
+      
+      // 注册到设置页面
+      ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section',
+        id: 'soul-settings',
+        order: 50,
+        label: () => '个性化',
+        locale: NS,
+        inject: () => ({
+          hooks: {
+            soulController: controller.store
+          },
+          controller
+        })
+      }, SoulSettings))
+      
+      // 加载初始配置
+      controller.loadConfig()
+    }
+
+    exports.apply = apply
+    exports.inject = inject
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: soul
+      name: dsh-soul

package/index.mjs

@@ -0,0 +1,477 @@
+// index.mjs — dsh-soul host 入口
+//
+// 三层架构：
+//   - Identity（身份）：角色定义、人格特征
+//   - Behavior（行为）：决策逻辑、行为约束
+//   - Style（风格）：语气、表达方式、格式
+//
+// 功能：
+//   - 支持自定义 Agent 回复风格和语调
+//   - 支持用户昵称，回复时使用昵称称呼
+//   - 保存用户配置到文件系统
+//   - 提供 HTTP API 供客户端调用
+//   - 注册斜杠命令 /soul 查看当前配置
+//   - 注入系统提示词到 Agent
+
+import { readFile, writeFile, mkdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { createUserMessage } from '@deepseek-ai/dsh-llm'
+
+const name = 'soul'
+
+// 配置文件路径：$DSH_HOME/soul-config.json
+function configPath() {
+  return join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'soul-config.json')
+}
+
+// ==================== 三层架构 ====================
+
+// Identity 层：身份定义
+const IdentityLayer = {
+  // 角色定义
+  roles: {
+    'default': '助手',
+    'mentor': '导师',
+    'friend': '朋友',
+    'expert': '专家',
+    'critic': '批评家'
+  },
+  
+  // 构建身份描述
+  build(config) {
+    const parts = []
+    
+    // 用户自定义角色
+    if (config.customInstructions) {
+      parts.push(config.customInstructions)
+    }
+    
+    // 用户昵称
+    if (config.nickname) {
+      parts.push(`你的用户叫"${config.nickname}"，在回复中使用这个称呼`)
+    }
+    
+    return parts.join('\n')
+  }
+}
+
+// Behavior 层：行为规则
+const BehaviorLayer = {
+  // 风格映射
+  styles: {
+    professional: '专业严谨、注重逻辑和准确性',
+    casual: '轻松自然、像朋友一样交流',
+    friendly: '友好亲切、温暖体贴',
+    humorous: '幽默风趣、适当使用比喻和玩笑',
+    academic: '学术性、引用权威来源、注重术语准确性'
+  },
+  
+  // 语调映射
+  tones: {
+    neutral: '中性客观',
+    formal: '正式礼貌',
+    informal: '非正式、口语化',
+    enthusiastic: '热情积极',
+    calm: '平静沉稳'
+  },
+  
+  // 行为规则
+  rules: [
+    '在回答任何问题时，都必须体现上述身份特征',
+    '禁止使用标准AI助手的中性语气',
+    '保持角色一致性，不要跳出设定'
+  ],
+  
+  // 构建行为描述
+  build(config) {
+    const parts = []
+    
+    // 风格
+    if (config.style && this.styles[config.style]) {
+      parts.push(`回复风格：${this.styles[config.style]}`)
+    }
+    
+    // 语调
+    if (config.tone && this.tones[config.tone]) {
+      parts.push(`语调：${this.tones[config.tone]}`)
+    }
+    
+    return parts.join('，')
+  }
+}
+
+// Style 层：输出格式
+const StyleLayer = {
+  // 格式模板
+  templates: {
+    default: '{content}',
+    structured: '## {title}\n\n{content}',
+    casual: '{content}~',
+    formal: '尊敬的{nickname}，{content}'
+  },
+  
+  // 构建风格描述
+  build(config) {
+    const parts = []
+    
+    // 根据风格选择格式
+    if (config.style === 'casual') {
+      parts.push('使用轻松的语气')
+    } else if (config.style === 'formal') {
+      parts.push('使用正式的语气')
+    }
+    
+    return parts.join('，')
+  }
+}
+
+// ==================== 配置管理 ====================
+
+// 默认配置
+const DEFAULT_CONFIG = {
+  enabled: true,
+  nickname: '',
+  style: 'professional',
+  tone: 'neutral',
+  customInstructions: '',
+  examples: [
+    { label: '专业严谨', value: '你是一个专业严谨的助手，采用学术性的语气，注重逻辑和准确性。' },
+    { label: '友好亲切', value: '你是一个友好亲切的助手，采用轻松自然的语气，像朋友一样交流。' },
+    { label: '幽默风趣', value: '你是一个幽默风趣的助手，适当使用比喻和玩笑，让对话更有趣。' },
+    { label: '简洁直接', value: '你是一个简洁直接的助手，回答问题直击要点，避免冗余。' }
+  ]
+}
+
+// 内存中的配置缓存
+let configCache = null
+
+// 读取配置
+async function loadConfig() {
+  if (configCache) return configCache
+  
+  try {
+    const data = await readFile(configPath(), 'utf8')
+    configCache = { ...DEFAULT_CONFIG, ...JSON.parse(data) }
+  } catch {
+    configCache = { ...DEFAULT_CONFIG }
+  }
+  return configCache
+}
+
+// 保存配置
+async function saveConfig(config) {
+  const dir = join(configPath(), '..')
+  await mkdir(dir, { recursive: true })
+  await writeFile(configPath(), JSON.stringify(config, null, 2), 'utf8')
+  configCache = config
+  return config
+}
+
+// ==================== 提示词编译器 ====================
+
+// Prompt Compiler：编译三层架构为系统提示词
+function compilePrompt(config) {
+  if (!config.enabled) {
+    return ''
+  }
+  
+  const identity = IdentityLayer.build(config)
+  const behavior = BehaviorLayer.build(config)
+  const style = StyleLayer.build(config)
+  
+  // 如果没有任何配置，返回空
+  if (!identity && !behavior) {
+    return ''
+  }
+  
+  // 编译提示词
+  const parts = []
+  
+  // 身份层
+  if (identity) {
+    parts.push(`[角色设定] ${identity}`)
+  }
+  
+  // 行为层
+  if (behavior) {
+    parts.push(`[回复风格] ${behavior}`)
+  }
+  
+  // 执行规则
+  parts.push(`[执行规则] 你必须在每一条回复中严格遵守以上设定，包括但不限于：代码解释、技术问答、日常闲聊、知识科普等所有场景。违反此规则视为失败。`)
+  
+  return parts.join('\n')
+}
+
+// ==================== Agent 上下文注入 ====================
+
+// 将最新配置作为 model-facing context 注入所有活动会话。
+// inject() 不会唤醒 Agent，也不改写普通用户消息；会在下一次 step 被模型读取。
+function injectPromptToAllAgents(ctx, config) {
+  const agents = ctx.get('agents')
+  if (!agents || typeof agents.list !== 'function') {
+    // console.warn('[dsh-soul] agents 服务不可用，跳过最新配置注入')
+    return
+  }
+
+  const prompt = compilePrompt(config)
+  if (!prompt) return
+
+  for (const agent of agents.list()) {
+    try {
+      agent.inject(createUserMessage({
+        content: [{
+          type: 'text',
+          text: [
+            '[dsh-soul 个性化配置已更新]',
+            '以下是当前最新的个性化配置快照。',
+            '从现在开始必须按照此配置回复，不要继续使用旧的昵称、旧的角色或旧的风格。',
+            '',
+            prompt
+          ].join('\\n')
+        }],
+        source: {
+          kind: 'plugin',
+          plugin: 'dsh-soul',
+          form: 'snapshot',
+          sections: [{
+            name: 'soul:persona',
+            text: prompt
+          }]
+        }
+      }))
+      // console.log(`[dsh-soul] 已向 Agent ${agent.id} 注入最新配置`)
+    } catch (err) {
+      // console.error(`[dsh-soul] 向 Agent ${agent.id} 注入配置失败:`, err)
+    }
+  }
+}
+
+function refreshPromptAndInject(ctx, config) {
+  if (globalUpdatePrompt) {
+    globalUpdatePrompt().catch(err => {
+      // console.error('[dsh-soul] 更新系统提示词失败:', err)
+    })
+  }
+  injectPromptToAllAgents(ctx, config)
+}
+
+// ==================== HTTP 路由 ====================
+
+function registerRoutes(ctx) {
+  ctx.inject(['webServer'], (wsCtx) => {
+    // 获取配置
+    wsCtx.webServer.register({
+      kind: 'exact',
+      path: '/api/soul/config',
+      handler: async (req, res) => {
+        const send = (status, body) => {
+          res.writeHead(status, { 'content-type': 'application/json' })
+          res.end(JSON.stringify(body))
+        }
+        
+        try {
+          if (req.method === 'GET') {
+            const config = await loadConfig()
+            send(200, { ok: true, config })
+          } else if (req.method === 'POST') {
+            let raw = ''
+            for await (const chunk of req) raw += chunk
+            const newConfig = JSON.parse(raw)
+            const current = await loadConfig()
+            const updated = await saveConfig({ ...current, ...newConfig })
+            
+            // 配置变化后更新系统提示词，并注入所有活动会话
+            refreshPromptAndInject(ctx, updated)
+            
+            send(200, { ok: true, config: updated })
+          } else {
+            send(405, { ok: false, error: 'Method not allowed' })
+          }
+        } catch (err) {
+          send(500, { ok: false, error: String(err.message || err) })
+        }
+      }
+    })
+    
+    // 获取系统提示词
+    wsCtx.webServer.register({
+      kind: 'exact',
+      path: '/api/soul/prompt',
+      handler: async (req, res) => {
+        const send = (status, body) => {
+          res.writeHead(status, { 'content-type': 'application/json' })
+          res.end(JSON.stringify(body))
+        }
+        
+        try {
+          const config = await loadConfig()
+          const prompt = compilePrompt(config)
+          send(200, { ok: true, prompt, enabled: config.enabled })
+        } catch (err) {
+          send(500, { ok: false, error: String(err.message || err) })
+        }
+      }
+    })
+    
+    // 重置配置
+    wsCtx.webServer.register({
+      kind: 'exact',
+      path: '/api/soul/config/reset',
+      handler: async (req, res) => {
+        const send = (status, body) => {
+          res.writeHead(status, { 'content-type': 'application/json' })
+          res.end(JSON.stringify(body))
+        }
+        
+        try {
+          const config = await saveConfig({ ...DEFAULT_CONFIG })
+          
+          // 配置变化后更新系统提示词，并注入所有活动会话
+          refreshPromptAndInject(ctx, config)
+          
+          send(200, { ok: true, config })
+        } catch (err) {
+          send(500, { ok: false, error: String(err.message || err) })
+        }
+      }
+    })
+  })
+}
+
+// ==================== 斜杠命令 ====================
+
+function registerCommands(ctx) {
+  ctx.inject(['commands'], (cmdCtx) => {
+    cmdCtx.commands.register({
+      name: 'soul',
+      description: '查看或管理个性化设置。用法：/soul [show|reset|enable|disable|昵称]',
+      input: { hint: '[show|reset|enable|disable|昵称]' },
+      async handler(invocation) {
+        const args = String(invocation.rawInput || '').trim().toLowerCase()
+        
+        try {
+          const config = await loadConfig()
+          
+          if (args === 'show' || args === '') {
+            const status = config.enabled ? '已启用' : '已禁用'
+            const nickname = config.nickname || '未设置'
+            const style = config.style || '未设置'
+            const tone = config.tone || '未设置'
+            const instructions = config.customInstructions || '未设置'
+            
+            return {
+              kind: 'success',
+              text: `🧠 个性化设置\n\n状态：${status}\n昵称：${nickname}\n风格：${style}\n语调：${tone}\n自定义指令：${instructions}\n\n使用 /soul show 查看详情\n使用 /soul reset 重置配置\n使用 /soul enable 启用\n使用 /soul disable 禁用\n使用 /soul 昵称xxx 设置昵称`
+            }
+          } else if (args === 'reset') {
+            const updated = await saveConfig({ ...DEFAULT_CONFIG })
+            // 更新系统提示词，并注入所有活动会话
+            refreshPromptAndInject(ctx, updated)
+            return { kind: 'success', text: '✅ 配置已重置为默认值' }
+          } else if (args === 'enable') {
+            config.enabled = true
+            const updated = await saveConfig(config)
+            // 更新系统提示词，并注入所有活动会话
+            refreshPromptAndInject(ctx, updated)
+            return { kind: 'success', text: '✅ 个性化设置已启用' }
+          } else if (args === 'disable') {
+            config.enabled = false
+            const updated = await saveConfig(config)
+            // 更新系统提示词，并注入所有活动会话
+            refreshPromptAndInject(ctx, updated)
+            return { kind: 'success', text: '✅ 个性化设置已禁用' }
+          } else {
+            // 设置昵称
+            config.nickname = args
+            const updated = await saveConfig(config)
+            // 更新系统提示词，并注入所有活动会话
+            refreshPromptAndInject(ctx, updated)
+            return { kind: 'success', text: `✅ 昵称已设置为：${args}` }
+          }
+        } catch (err) {
+          return { kind: 'error', text: `操作失败：${err.message}` }
+        }
+      }
+    })
+  })
+}
+
+// ==================== 系统提示词注入 ====================
+
+// 全局变量，用于在配置变化时更新提示词
+let globalUpdatePrompt = null
+
+function registerSystemPrompt(ctx) {
+  ctx.inject(['systemPrompt'], (spCtx) => {
+    let disposeSection = null
+
+    const registerSection = () => {
+      // 重新注册前先移除旧 section，触发 system-prompt/change，
+      // 让 DSH 丢弃当前会话已经缓存的 system prompt 快照。
+      disposeSection?.()
+
+      disposeSection = spCtx.systemPrompt.section({
+        name: 'soul:persona',
+        order: 0,
+        text: () => {
+          const prompt = compilePrompt(configCache || DEFAULT_CONFIG)
+          if (prompt) {
+            // console.log(`[dsh-soul] 系统提示词已组装：${prompt.substring(0, 100)}...`)
+          }
+          return prompt
+        }
+      })
+    }
+
+    registerSection()
+
+    globalUpdatePrompt = async () => {
+      await loadConfig()
+      registerSection()
+      // console.log('[dsh-soul] 系统提示词已更新，当前会话下一次请求将使用最新配置')
+    }
+
+    ctx.effect(() => () => {
+      disposeSection?.()
+      disposeSection = null
+      if (globalUpdatePrompt) {
+        globalUpdatePrompt = null
+      }
+    }, 'dsh-soul: system prompt section')
+  })
+}
+
+// ==================== 主入口 ====================
+
+export async function apply(ctx) {
+  // 加载配置
+  await loadConfig()
+  
+  // 提供 soulConfig 服务
+  ctx.provide('soulConfig', {
+    async getConfig() {
+      return await loadConfig()
+    },
+    async updateConfig(newConfig) {
+      const current = await loadConfig()
+      const updated = { ...current, ...newConfig }
+      return await saveConfig(updated)
+    },
+    async getSystemPrompt() {
+      const config = await loadConfig()
+      return compilePrompt(config)
+    },
+    async resetConfig() {
+      return await saveConfig({ ...DEFAULT_CONFIG })
+    }
+  })
+  
+  // 注册各模块
+  registerRoutes(ctx)
+  registerCommands(ctx)
+  registerSystemPrompt(ctx)
+}
+
+export { name }

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "dsh-soul",
+  "version": "0.1.0",
+  "description": "为 DeepSeek Harness 添加个性化设置",
+  "type": "module",
+  "main": "index.mjs",
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "exports": {
+    ".": {
+      "default": "./index.mjs"
+    },
+    "./client": "./client/index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.mjs",
+    "client",
+    "cordis.patch.yml",
+    "README.md"
+  ]
+}