自学习习惯引擎 Max-Null/dsh-habit

@max-null/dsh-habit

本插件属于 @max-null/ 插件系列——这一系列共同构成 SSID（思灵 · Seek Soul in Darkness） 桌面体验。SSID 是整合它们的盒：dsh-capture · dsh-chat-rail · dsh-chinese-thinking · dsh-draft-polish · dsh-guardian · dsh-habit · dsh-memory · dsh-node-appearance · dsh-plugin-center · dsh-quick-toolbar · dsh-skill-mcp-center · dsh-ssid-panels · dsh-ssid-zh-ui · dsh-achievements。

本插件属于 @max-null/ 系列——这一系列插件共同构成 SSID（思灵 · Seek Soul in Darkness） 桌面体验。

自学习习惯引擎，服务于 DeepSeek Harness——从会话事件里观察用户纠正信号，达到阈值时用低成本模型判断习惯，再让候选经过两级人工闸门落定。不新增智能体角色：判断逻辑是事件驱动的插件，不受上下文衰减影响。

循环

① observe session/event → correction-signal detection (deterministic, zero-token)
② judge >=3 signals in one session → one flash call (evidence slices + existing habits)
③ settle candidate zone → user confirms → dsh-memory remember() (suggested)
→ user confirms again → auto → recall injection

截图

本插件是行为提示类：不新增任何按钮、面板或设置项，也不向会话注入任何内容。

行为效果是后台沉淀，全程静默：同一会话内累积到 3 条命中固定纠正短语（如「再检查一下」「重新做」）的短消息后，插件在回合结束时做一次低成本模型判断；只有判定为「稳定习惯」才落一条候选（状态 pending，存于 $DSH_HOME/storages/habit）。
候选由宿主 UI 读管——SSiD 侧是侧栏的「习惯」面板，确认后写入 dsh-memory（suggested），再由人放行转 auto。
未达阈值、判断失败或消息不匹配时，插件不做任何可见动作，会话里看不到任何痕迹。

按《SSiD 开发手册》§9 截图规范：截图须回答「装完会多出/变成什么」的入口与面板。
本插件无界面元素（no UI surface），故不适用该项要求，改以上述行为效果说明代替。

组装

- id: habit
name: '@max-null/dsh-habit'

宿主组装里需要 storage 和 llm（dsh-base 两者都自带）。
以 bundle 形式安装：dsh plugin --profile <name> add @max-null/dsh-habit。

服务

- ctx.habit —— 引擎：
- snapshot() → 候选列表（最新的在前）
- confirm(id) / discard(id) → 第一级人工闸门
- （第二级闸门是 dsh-memory 自己的 suggested→auto 确认）

配置

| 字段 | 默认值 | 含义 |
| signalThreshold | 3 | 触发一次判断调用前需要的纠正信号数 |
| provider | deepseek-official | 判断模型服务商 |
| model | deepseek-v4-flash | 判断模型（便宜、确定性好） |
| storageRoot | $DSH_HOME/storages/habit | JSON 存储根目录 |

设计说明

- 观察确定，按需调用 LLM：纠正检测靠固定短语表加长度上限（任务描述不算纠正）；只有会话累积到足够信号，LLM 才会运行。
- 两级人工闸门：候选必须先在 UI 里确认，再通过 dsh-memory 自己的 suggested→auto 闸门。模型永远无法把自己的习惯提升上去。
- 窄输入保质量：判断调用最多拿到 5 条证据文本，再加上已有的习惯列表——判断质量来自精确的上下文，而不是数量。

依赖

@deepseek-ai/cordis（^4.0.1），外加四个内核包，都声明为显式范围： @deepseek-ai/dsh-llm 和 @deepseek-ai/dsh-session 为 >=0.1.7-rc.2 <0.3.0， @deepseek-ai/dsh-storage 和 @deepseek-ai/dsh-storage-json 为 >=0.1.1-rc.1 <0.3.0。

为什么用范围而不是 caret。 caret 的上界是下一个 minor：^0.1.7-rc.2 展开为 >=0.1.7-rc.2 <0.2.0-0，内核只要领先一个 minor 就会失败。dsh- peer 不满足不是警告——插件会被跳过，而不是加载：它永远进不了 fiber 图，也永远不会出现在 did not activate 列表里，所以唯一的症状就是少了一组功能。显式范围同时接纳 0.1 和 0.2 两条内核线。

检查逻辑在 app-boot 的 plugin-compatibility.ts：它遍历 peerDependencies 中名字为 @deepseek-ai/dsh 或以 @deepseek-ai/dsh- 开头的条目，测试
semver.satisfies(runtimeVersion, requirement, { includePrerelease: true })——这就是
@deepseek-ai/cordis 和其它非 dsh- peer 不在检查范围内的原因。用 semver 7.7.4 对运行时 0.2.0-rc.1 实测：^0.1.7-rc.2 和 ^0.1.1-rc.1 为 false； >=0.1.7-rc.2 <0.3.0 和 >=0.1.1-rc.1 <0.3.0 为 true。

开发

npm install --legacy-peer-deps
npm test
npm run typecheck
npm run build

SSID 系列

本插件是 SSID（思灵 · Seek Soul in Darkness） 全家桶的一员；也可以单独安装到任意 DSH 配置档——插件自身不依赖其它同系列插件，候选的读管界面由宿主提供（SSiD 侧为 dsh-ssid-panels 的「习惯」面板）。