dsh-prompt-self

个人 Prompt 画像引擎 —— 为 DeepSeek Harness（DSH） 打造的双面客户端插件：在消息级自动改写你的 prompt、自动学习你的书写习惯，并提供可视化的开关与画像查看界面。

起因：希望 AI 能记住「我喜欢怎样的表达、经常省略哪些约束、哪些说法容易让它误解」，并在每次对话前自动补齐 —— 而不是早期那样，每次满意后还得自己敲一句 -fin 手动让 AI 记录（-fin 的来龙去脉见下文「关于 -fin」）。

✨ 特性

• 消息级自动改写：每次发出新请求，引擎先用 LLM 按你的个人画像改写（消除歧义、补齐习惯性省略的约束、应用防幻觉规则），再把优化版注入给模型执行 —— 模型看到的、执行的始终是优化后的意图。
• 自动学习画像：每次回合结束后，自动分析「原始请求 + 最终回答」，提炼你的书写习惯、防幻觉规则与优化经验，持续沉淀到画像文件 —— 不再需要 -fin（仍保留 -fin 作为"立即学习并确认"的兼容触发）。
• 可视化控制（设置 →「Prompt 画像」）：
  • 「自动改写优化」「自动学习画像」两个开关，即点即存、实时生效；
  • 画像三栏视图：习惯清单 / 防幻觉规则 / 学习记录（含计数、更新时间、折叠）；
  • 中英双语，跟随应用语言。
• 对话区快捷入口：输入框上方常驻「● Prompt 画像 · 已开启」状态胶囊，点击弹出浮动面板，无需进设置即可查看/切换。
• 零侵入：不改动 DSH 应用代码，全部通过官方扩展点安装（web profile 补丁 + 用户预设 + skill 文件 + AGENTS.md）。

关于 -fin（旧的手动反馈指令）

-fin 是本插件前身（prompt-self-optimizer 技能）时代留下的手动反馈指令：那时还没有自动学习，用户对某次回答满意，就要自己敲一句 -fin（可理解为「finish —— 这次不错，记下来」），AI 才会把刚才这组「请求 + 回答」学进画像。

它的痛点是：每次都靠人记得敲，漏一次就少学一次，还得多打一句话。于是本插件把这一步自动化——每次回合结束（turn/end）自动分析并学习，日常不再需要 -fin。

不过 -fin 仍被保留，作为**「立即学习 + 确认」的兼容触发**：哪怕把「自动学习画像」开关关掉了，敲一句 -fin 也能强制学习最近一次交互，并得到简短确认，老用户沿用旧习惯也不会失效。

🏗 工作原理

你发出 prompt
   │
   ▼
┌──────────────────────────────┐
│ 宿主引擎（Agent 层预设）      │
│  agent/pre-step 钩子          │
│  1. 读画像 profile.md          │
│  2. 读运行时开关 config.json   │
│  3. LLM 按画像改写 prompt      │
│  4. 注入「优化后的请求」消息   │
└──────────────────────────────┘
   │
   ▼
模型以优化版为准执行 ──→ 回合结束（turn/end）
                             │
                             ▼
                  ┌──────────────────────────┐
                  │ 自动学习：LLM 分析         │
                  │ (请求, 输出) → 合并画像    │
                  │ 习惯清单 / 防幻觉规则 / 学习记录 │
                  └──────────────────────────┘

浏览器半边（dsh.client）
  ├─ 设置页「Prompt 画像」：开关 + 画像查看
  └─ 对话输入坞：状态胶囊 + 弹出面板
        ↕ 通过宿主侧 Web 路由读写
  GET  /prompt-self/profile   画像 + 开关状态
  GET/POST /prompt-self/config  开关读写

📁 目录结构

.
├── package.json                     # 插件清单（dsh.bundle + dsh.client 声明与导出）
├── cordis.patch.yml                 # bundle 补丁（安装入口，加载宿主半边）
├── lib/
│   ├── index.js                     # 宿主引擎（改写/学习/路由/开关）
│   └── client.js                    # 浏览器半边（设置页 + 输入坞 UI）
├── install/                         # 安装材料
│   ├── code-prompt-self/            # 用户预设（code 预设副本 + 引擎行）
│   │   ├── agent.cordis.yml
│   │   └── prompt-self/             # 引擎内嵌副本（预设按相对路径加载）
│   ├── web-profile.cordis.patch.yml # 追加到 web profile 补丁层
│   ├── skills/prompt-self-optimizer/SKILL.md   # 画像查看/解释 skill
│   ├── AGENTS.md                    # 用户全局指令（注入每个会话）
│   └── settings.yaml.example        # 默认预设切换示例
└── tests/
    └── engine.test.mjs              # 引擎自测套件（6 组用例，mock LLM）

📦 安装（DSH Desktop，Windows）

约定：<DSH_HOME> 为 DSH 家目录。DSH Desktop 默认为 C:\Users\<你>\AppData\Roaming\dsh-desktop\harness；其余部署通常为 ~/.dsh。

0. 插件市场一键安装（推荐）

插件已声明 dsh.bundle 与 dsh.client，可直接从 GitHub 源码安装：

dsh plugin --profile web add github:Hua1Q1nG/dsh-prompt-self

这一步装好「宿主层 Web 路由 + 设置页 Prompt 画像 + 对话输入坞」。要启用消息级改写与自动学习引擎， 还需安装用户预设（下面第 3 步）——引擎运行在 Agent 层，与 web profile 半边是双面结构。

1. 复制插件包到 web profile

把 package.json、cordis.patch.yml 与 lib/ 复制到 <DSH_HOME>\profiles\node_modules\dsh-prompt-self-client\：

这一步让 web profile 的插件行可以通过裸包名 dsh-prompt-self-client 解析到插件，并由模块系统把浏览器半边提供给 Web GUI。

2. 在 web profile 补丁层注册插件行

把 install/web-profile.cordis.patch.yml 的内容追加到 <DSH_HOME>\profiles\web\cordis.patch.yml。

3. 安装用户预设并切换默认

…