提示词自适应 FABAGV/dsh-prompt-adapt

dsh-prompt-adapt

一个 DeepSeek Harness（DSH）插件：让 AI 更好地适配你。

它从你自己的历史会话里归纳出一份「用户画像」，按预算裁剪后注入系统提示 —— 于是每次开新会话， AI 不用你重新交代一遍就知道你的偏好、以及哪些做法在你这儿行不通。

安装

先看结论，四条路线按「省事程度」排序：

| 路线 | 怎么装 | 前置条件 | 实测耗时（本机，走镜像） |
| A 一键脚本 | .\install.ps1 -Profile desktop | Windows + 仓库目录 | 3.1 s（冷装，含 282 KB 下载） |
| B 桌面端插件页 | 粘贴下面那个 release 地址 | 桌面客户端 | 一次点击 + 一次粘贴 |
| C 命令行 | dsh plugin --profile web add <同一个地址> | DSH 命令行 | 一次 pnpm 安装 |
| D npm（已发布） | dsh plugin --profile add dsh-prompt-adapt | 无 | 一次 pnpm 安装（走 registry.npmmirror.com 镜像） |

D 路线已经可用：包发布在 npm 上 —— <https://www.npmjs.com/package/dsh-prompt-adapt>，裸包名不再 404，registry.npmmirror.com 会自动镜像，国内这条最快。
⚠️ 与 C 路线同一个限制：桌面 profile 由应用独占管理，桌面端请走 A 或 B。
⚠️ npm 镜像同步新版本会滞后几分钟到几小时：刚发版时 dsh plugin add dsh-prompt-adapt 可能仍装到旧版。想立刻拿到当前版本，用 A/B/C（Release 资产）或在安装后确认 node_modules/dsh-prompt-adapt/package.json 的 version。

A. 一键脚本（推荐）

.\install.ps1 -Profile desktop # 或 web；不传则按 DSH_PROFILE → desktop → web 猜

没有本地副本时也能一行跑（raw.githubusercontent.com 同样走镜像）：

& ([scriptblock]::Create((irm https://gh-proxy.com/https://raw.githubusercontent.com/FABAGV/dsh-prompt-adapt/main/install.ps1))) -Profile desktop

脚本做四件事：走镜像下载 → 用 DSH 自带的 pnpm 装进 profile → 把 dsh-prompt-adapt 登记进 dsh.profile.bundles → 校验宿主入口与客户端半边都在。-Tag main 装分支最新代码、 -Uninstall 卸载（保留 ~/.dsh/prompt-adapt 里的画像与自定义文本）、-WhatIf 只打印会做什么。

两个刻意的设计：

- 以本地文件依赖安装（file:.dsh-packages/<包名>.tgz），不把镜像 URL 写进 package.json/lockfile —— 镜像哪天挂了，不会连 pnpm install 都跑不起来；tgz 留在 profile 目录内，之后离线可重装。
- 直接改 profile 文件，所以桌面端（dsh plugin 会拒绝的那个 profile）也能装。

B. 桌面客户端（内置插件页）

在插件页里填这个发布产物地址（版本化、内容不变）：

https://github.com/FABAGV/dsh-prompt-adapt/releases/download/v0.1.5/dsh-prompt-adapt-0.1.5.tgz

装完刷新页面（插件在宿主启动时 apply() 一次；桌面端热加载有时不重跑）。

C. 命令行（web / tui 等非桌面 profile）

dsh plugin --profile web add https://github.com/FABAGV/dsh-prompt-adapt/releases/download/v0.1.5/dsh-prompt-adapt-0.1.5.tgz

不要用 github:FABAGV/dsh-prompt-adapt：这种 spec 形式下 pnpm 会先跑 git ls-remote，本机没有 git 就直接失败（与网络无关）；裸包名 dsh-prompt-adapt 现在已经可以直接用（见 D 路线）。

⚠️ 桌面客户端的 profile 由应用独占管理：dsh plugin --profile desktop … 会被启动器直接拒绝（profile "desktop" is managed exclusively by the Electron application）。
桌面端请用 A 或 B。

国内网络实测：github.com / codeload.github.com 直连只有 30–50 KB/s；脚本按 gh-proxy.com → ghfast.top → ghproxy.net → 直连 依次回退，同一个 282 KB 的包直连 8.4 s、镜像 0.9–2.5 s。本地已有同版本 tgz 时会跳过下载（再装 0.9 s）。

它是不是一个真插件

给自动扫描器与人工审核省点事，机械信号都摆在这里：

| 信号 | 值 |
| Bundle manifest | cordis.patch.yml（package.json 里 dsh.bundle.patch 指向它） |
| 包名 / 插件 id | dsh-prompt-adapt |
| 宿主入口 | lib/index.js —— export default { name, Config, apply } |
| 客户端半边 | lib/client.js —— dsh.client 声明 platform: web，挂进 settings.section |
| 依赖 | 无运行时依赖；@deepseek-ai/cordis 与 @deepseek-ai/schemastery 由 DSH 装载时提供 |
| 数据去向 | 只有本机。不联网、不遥测、不上传（见「数据落在哪」） |

三个模式

| 模式 | 是什么 | 谁写 | 参与注入 |
| 1 自动画像 | 从历史会话归纳「你是什么样的人」+「哪些做法在你这儿行不通」 | LLM 自动，你只读 | ✅ |
| 2 自定义 | 你自己的系统提示词文本框 | 你手写 | ✅ |
| 3 提示词大厅 | 一个外链 查看网友提示词 ↗ | 不参与 | ❌ |

硬规则：

- 模式 1 和模式 2 不能同时开启 —— 落实方式是 state.mode 是单字段枚举（'auto' | 'custom'）而不是两个布尔量，「两个都开」这个状态在结构上无法表示。
- 从模式 1 到模式 2 是你手动复制粘贴，没有自动写入路径。
- 模式 2 生效时不自动生成画像：注入的是你手写的文本，画像不进 system prompt，自动生成只会白烧 LLM 额度。手动「重新生成」仍然可以（你想先更新画像再切回模式 1），但不计入注入账本。
- 模式 3 只是一个链接，宿主侧不抓取、不缓存、不鉴权。

你能在界面上看到什么

「设置 → AI 适配」里，模式 1 卡片分成六区（后三区默认折叠，不占屏幕）：

| # | 区块 | 默认 | 能做什么 |
| ① | 置顶 | 常显 | 被 pin 的条目 |
| ② | 实际注入的系统提示 | 常显 | 看到真正进了系统提示的那段文本全文 |
| ③ | 完整画像 | 常显 | 每条三个按钮：置顶 / 封印 / 删除 |
| ④ | 未注入 | 折叠 | 被预算裁掉的条目，可展开翻找、可 pin 回来 |
| ⑤ | 垃圾桶 | 折叠 | 被封印的条目，可恢复 |
| ⑥ | 已删除 | 折叠 | 被删的条目，显示被删了多少次 |

② 区渲染的是宿主吐出的 injectedText 原样字节，界面不自己重拼 ——所以「你看到的」与「模型收到的」逐字节相同。这是这个插件刻意守住的一条不变式。

除了六个区，界面还会显示三样东西：

- 本轮生成警告（正在 ② 上方折叠）：含换血上限"拒绝了哪几条净新增"，不刷屏。
- 每条条目的账本徽标：「已注入 N 版」/「从未注入」，跨版本累计 —— 直接回答 "这条到底有没有进过系统提示"。
- 工作笔记：项目/工具/路径类事实单独一块，不占画像槽位，见下一节。

第一次打开时（还没有画像）

界面不会只写一句"攒够发言后会自动生成"，而是给出可执行的进度（0.1.4 起）：

- 第一轮扫描还没跑完时写「正在读取本机会话记录（只读）…」，不把"还没数"说成"没有发言"；
- 扫描完成后写「首版画像需要累计 12 条真人发言（已收集 5 条，还差 7 条）」——阈值与计数都来自宿主，界面不自己编；
- 如果 profile.autoRun=false，或当前生效的是模式 2，会直说不会自动生成，并把用户的下一步指向「重新生成」/ 切回模式 1；
- 「上次生成」是三态：成功 / 失败 / 未触发。未触发 = 没到阈值，是正常状态，界面上会明确写"不是出错"——以前它被渲染成"失败"，是这一版修掉的 UX 缺陷。

置顶 / 封印 / 删除的区别

| 动作 | 效果 | 之后还会回来吗 |
| 置顶（pin） | 界面置顶 + 保证注入（豁免预算），上限 10 条 | 一直在 |
| 封印 | 拉进垃圾桶，永不参与注入；并把你封印过的结论喂给模型，要求「一条都不许再产出」 | 不会（两道防线：提示词 + 注入侧硬过滤） |
| 删除 | 只是删掉当前这条 | 可能重新出现 —— 材料里仍有依据时模型会再归纳出来 |

封印与删除的区别是刻意的：你删掉一条但不封印，说明「我不想现在看到它，但我不否认它」；删除计数会记在⑥区，被删过多次的条目反而值得回看 —— 它反复被模型认为是你的特质，而你反复删掉它。

注入预算

注入文本按估算 token（中文 1 字 ≈ 1、ASCII 4 字符 ≈ 1）裁剪，默认 1500：

- B（行不通的做法）、C（有效的做法）合计上限 50% —— 保证它们不会吃光预算
- A（稳定特质）保底 30% —— 保证注入里一定有关于你的正面描述，不被禁止项挤成 0
- 剩余 20% 是弹性
- D（证据不足）不注入，只在标注行报条数
- 超预算的条目只在注入侧省略，state.json、界面完整画像、复制到模式 2 始终是全量

⚠️ 这是一个有意的成本取舍：注入进系统提示的文本会随画像变化而作废提示缓存。
预算就是给这件事装的刹车。

它做了什么

1. 增量读取会话日志（~/.dsh/sessions/，只读）。
日志是「每行一个独立 zstd 帧」的拼接容器，而 Node 的 zlib.zstdDecompressSync 遇到多帧 只解第一帧 —— 所以按帧边界切开逐帧解，并把「已解压到第几字节」持久化成游标。
重启后一个帧都不会重解。
2. 四个零 LLM 的计数信号：让你代跑 / 命令过长 / 工具反复失败 / 给了选项但你自己另说。
3. 按间隔用 LLM 增量生成画像。上一版画像会一起喂回去，并要求「只增删确有依据的条目，未变动条目原样保留」—— 从零重写会产生大量假变化（实测假变化率 26.3%）。
输出走差量契约：只回新增/改写条目与未变条目 id，未变正文由程序从上一版搬回。
4. 把当前生效的画像文本注入系统提示（systemPrompt.section()，order: 30）。
5. 持久化你在 ~/.dsh/prompt-adapt/ 下的模式、自定义文本、画像、处置标记、复制快照。

只有主会话算"你的发言"

会话日志里，父代理写给子代理的委派 prompt 也是 source.kind: 'user'。插件按 session 事件顶层的 origin: 'subagent' / parentSession 整会话排除它们：画像材料、四个信号、触发计数都不再把「AI 对 AI 说的话」当成用户发言。
（界面点开单个会话的明细仍然全量，排障不受影响。）

注入落账与新生试用位

每一版画像真正进了 system prompt 的条目 id 与累计次数会写进 state.injectionLedger。于是「这条从来没被交付过」第一次成为可查询的事实。
清空画像时会同时清空这本账：账是按条目 id 记的，旧 id 会留在账上，并可能被模型复用的短 id（n1、n2…）继承，导致新结论永远拿不到试用位。

排序分数由模型自报的 confidence / 引文数决定，老条目会长期压住新生条目（实测当前画像 A 线 242、B/C 线 232、新生最好 231 —— 新生在算术上进不去）。
所以每个池子（A 一个、B/C 合用一个）留 1 个试用位给「交付次数为 0 且引文 ≥2」的最高分新生条目，只保一版；下一版它有了交付记录，就回到正常排序里比。

换血上限

画像到 44 条后，新增条数必须 ≤ 本轮删除（含合并）条数，否则净新增按分数从低到高被拒绝（profile.capRejected 会记下拒绝了哪几条）。只拒新条目，改写沿用旧 id 不受影响；旧画像已经超过 44 条时不强制瘦身（那需要档案层，不能静默删用户数据），只停止继续增长。

饱和守卫

画像达到软上限后，如果连续两轮生成都是 0 新增 / 0 删除 / 0 改写，自动生成会暂停并在 lastRun.reason 写明原因 —— 再跑一次也不会改变任何东西，只会白烧一次 LLM 调用（本机实测 v44–v47 连续 4 轮 0 变更仍按 12 条/3 会话触发）。设置页在模式 1 卡片里显示“画像已达增长上限（当前 N 条）”。

用户删除 / 封印 / 取消置顶后，zeroChangeStreak 清零，自动生成重新尝试；手动「重新生成」不受守卫限制。

工作笔记（项目事实不占画像槽位）

画像条目只写用户本人的稳定特质/偏好/纪律；项目、工具、路径、账号、仓库类事实由模型写进生成结果的 projectNotes，宿主合并到 state.workingNotes：

- 不占 44 条画像槽位，不参与注入预算，也不会被自动注入（换一个项目就不成立）；
- 界面在 ③ 下面单列「工作笔记」，按文本去重，最多保留 50 条；
- 旧画像里 3 条“本插件设计需求”（模式 1/2 互斥、画像文本无上限、画像归纳器）在升级后第一次启动时一次性移入工作笔记（文本保留、可逆，不是删除）。

配置

走 profile 的插件配置界面（或 cordis.patch.yml 的 config 段）：

- id: dsh-prompt-adapt
name: dsh-prompt-adapt
config:
logLevel: info
signals:
longToolMs: 60000 # 「命令过长」阈值 repeatFailMin: 3 # 「工具反复失败」连续次数 answerWindowMs: 1800000 # 「给了选项但用户自己另说」的时间窗 profile: triggerUserMessages: 12 # 累计新增真人发言达到这个数就更新画像 triggerNewSessions: 3 # 或新增会话达到这个数（先到者触发） maxTokens: 16000 # 单次生成的输出上限（调小会在条目变多后截断 JSON） autoRun: true scan: intervalMs: 120000 # 后台扫描间隔 maxFramesPerScan: 400 # 每轮的帧预算（既限最多解压多少帧，也限结构扫描走多远） inject: budgetTokens: 1500 # 注入预算（估算 token） maxPinned: 10 # 最多置顶多少条

完整字段见 lib/schema.js（每个字段都有中文说明）。

配置里有意没有的东西：

- 没有 API key：画像生成走 ctx.llm.stream()，复用宿主已配置的 provider/model 与凭据。
- 没有三个模式的开关：模式、自定义文本、画像都是用户数据，在 ~/.dsh/prompt-adapt/state.json 里，由界面通过 HTTP 路由读写。放配置里会导致「改一次模式就重载插件」。

界面接口（HTTP）

宿主把服务暴露在一条 prefix 路由下（webServer 缺失时这层整体降级，插件其余功能不受影响）：

GET /dsh-prompt-adapt/api/state 状态 + profile + injectedText + hallUrl POST /dsh-prompt-adapt/api/mode {mode:'auto'|'custom'} PUT /dsh-prompt-adapt/api/custom {text} POST /dsh-prompt-adapt/api/regenerate 触发画像生成（立刻 202，后台跑） POST /dsh-prompt-adapt/api/copied {text, entries?, algorithmVersion?} POST /dsh-prompt-adapt/api/rescan 强制重扫会话日志 POST /dsh-prompt-adapt/api/entry/pin {id?, claim} 置顶 POST /dsh-prompt-adapt/api/entry/seal {id?, claim} 封印 POST /dsh-prompt-adapt/api/entry/delete {id?, claim} 删除 POST /dsh-prompt-adapt/api/entry/unpin {key} 取消置顶 POST /dsh-prompt-adapt/api/entry/unseal {key} 从垃圾桶恢复 ⚠️ 前缀匹配要求 ${prefix}/，所以不要直接请求裸的 /dsh-prompt-adapt/api （那会落到宿主的 fallback）。用 GET /dsh-prompt-adapt/api/ 或任一具体端点。

数据落在哪

~/.dsh/prompt-adapt/ （$DSH_HOME 优先） ├─ state.json 用户数据 + 画像 + 处置标记（置顶/封印/删除） ├─ cursor.json 帧偏移水位 ├─ plain/<sha1>.jsonl 已解压会话明文缓存 ├─ profile-history/ 每次生成的画像快照，只增不删 └─ plugin.log 日志镜像

没有任何数据离开这台机器。 插件不发起网络请求；唯一的出站调用是你自己配置的 LLM provider（ctx.llm.stream()），且只发送用于归纳画像的会话片段，不发送原始日志文件。

开发与测试

依赖 @deepseek-ai/cordis 与 @deepseek-ai/schemastery，由 DSH 在装载时提供，所以本仓库不带 node_modules。本地跑测试时把它指向你已装好的 DSH profile：

把 $profileName 换成你机器上实际存在的 profile（web / desktop / …）
$profileName = 'web'
$target = "$env:USERPROFILE\.dsh\profiles\$profileName\node_modules\@deepseek-ai"
New-Item -ItemType Directory -Force -Path "$PWD\node_modules" | Out-Null
New-Item -ItemType Junction -Path "$PWD\node_modules\@deepseek-ai" -Target $target

跑测试（对真实会话日志只读，状态写临时目录，不改你的运行数据）：

node test/parity.mjs # 帧扫描 vs 宿主自己的实现，逐帧差分
node test/selftest.mjs # 核心不变式（差量契约、截断抢救、删除守卫）
node test/loadtest.mjs # 真实 cordis Context 上跑 apply()
node test/httptest.mjs # 真 HTTP server + fetch 打全部端点
node test/http-trust.mjs # 来源栅栏 + 桌面端 token/CORS 预检
node test/saturation-guard.mjs # 画像饱和守卫与 zeroChangeStreak
node test/state-hardening.mjs # 落盘原子性、损坏文件留档、类型兜底
node test/inject-budget.mjs # 预算分配与极端场景
node test/marks-guard.mjs # 置顶/封印/删除的语义与跨版本效果
node test/profile-delta-guard.mjs # 差量拼装与截断抢救
node test/extract-bugfix.mjs # 提取层增量与游标
node tools/calibrate.mjs # 与宿主真实路由的集成自检

test/parity.mjs 需要宿主那支 dsh-session-persistence-jsonl 的实现当标尺，按 $DSH_HOME（默认 ~/.dsh）自动探测各 profile 的 node_modules；探测不到时它判失败而不是跳过（"取不到标尺"不该被当成"比对通过"）。
实在找不到可用 DSH_CANONICAL_SESSION_PKG 显式指定。

test/selftest.mjs 的帧扫描与信号统计对着真实会话日志跑；本机没有日志时（CI、新机器）它会自动生成一份结构相同的合成语料继续跑完全部断言，并在输出第一行明确写「本次用合成语料」——不静默跳过，也不冒充真实数据。

全部测试是绿的（最后一次实测）：

parity PASS —— 230 个文件 / 71180 帧与宿主实现逐帧一致（不一致 0） selftest 142 通过 / 0 失败 httptest 54 通过 / 0 失败 http-trust 50 通过 / 0 失败 saturation-guard 15 通过 / 0 失败 loadtest 44 通过 / 0 失败 state-hardening 33 通过 / 0 失败 extract-bugfix 12 通过 / 0 失败 profile-delta-guard 22 通过 / 0 失败 inject-budget 54 通过 / 0 失败 marks-guard 70 通过 / 0 失败 client-marks-render 54 通过 / 0 失败 calibrate 147 通过 / 0 失败

设计意图、接口查证记录、以及已知的未完成/不确定项见 IMPLEMENTATION.md 与 UI-IMPLEMENTATION.md。

排障

| 现象 | 先看哪里 / 怎么办 |
| 一直没有画像 | 模式 1 卡片里的首跑进度：它写着已收集多少条、还差多少条。首版要累计 profile.triggerUserMessages（默认 12）条真人发言；模式 2 生效或 autoRun=false 时不会自动生成。 |
| 「上次生成」显示未触发 | 正常状态：这次检查没到阈值，什么都没做。下面那行 原因 里有 发言 +3/12，会话 +1/3 这样的实数。 |
| 「上次生成」显示失败 | 看同一张卡里的 原因 与错误行；常见原因是宿主 provider/model 不可用、超时（profile.timeoutMs）、或输出被 maxTokens 截断。 |
| 设置页显示「未连接宿主」 | 先确认插件装进了当前 profile；桌面端装完要刷新页面。再确认宿主 HTTP 路由前缀是 /dsh-prompt-adapt/api（界面每次请求都带这个前缀）。 |
| 画像更新了，但界面没变 | 生成在后台跑，界面每 3 秒轮询一次；还在跑时按钮显示「生成中…」。超过 5 分钟仍未更新，看 lastRun.error。 |
| 删除的条目又回来了 | 这是设计：删除不禁止模型重新归纳；要永久挡住请用封印。 |

已知限制

- freeformAnswers（「给了选项但你自己另说」）此前不可信 —— 已修：判据依赖 user/message 的 turn 字段，而实测真实日志里该字段非空的有 0 条（user/message 的 data 就是 message 本身，键是 content/source/role/id），所以位置约束整块是死代码。
现在 turn 由 bySession() 在会话级按事件顺序位置性推导（turn/start 可能落在更早的帧里，所以不能只在单帧内推），countFreeformAnswers 自己还兜了一层。实测本机 14 个会话： 4 → 1，误计的 3 条全是「提问之后跨了 turn 边界才出现的新话题」。
- 索引可能长期不完整 —— 已改：帧预算过去按文件顺序先到先得，排在后面的文件一轮轮读不到（实测 216 个文件里一度 100 个 offset=0，按 400 帧/轮要 130+ 轮才追上）。现在游标里记轮转位置、每轮从上次收尾处继续，并且只从游标处读尾巴（不再每轮从头扫整个文件）。
- 封印按文本精确匹配：中文同义改写认不出来（实测相似度分不开同一条换说法与两条不同结论），所以改写过的封印条目会漏认 —— 由提示词那道概率性防线兜。
- 多进程共用 DSH_HOME 时是「后写覆盖先写」：整份状态由内存写出，两个宿主进程同时跑会让设置页的编辑被静默回滚。

许可证

MIT，见 LICENSE。