dsh-experience
DeepSeek Harness 的自学习经验库：包含经过索引的 Markdown 知识、错误特征路由、失败捕获、从缺口到条目的闭环，以及侧边栏面板。附带初始库。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wqx11235/dsh-experience#2eee8883fab009b48a01aef6da212d435b49b37b
Experience 以 dsh-experience 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 的自学习经验库：把踩过的坑变成可检索的本地知识，在错误发生的那一刻自动递到 agent 面前，并在收尾时把"问题"变成"条目"。 Self-learning experience library for DeepSeek Harness: local, indexed markdown knowledge that is retrieved at the moment of failure and closed into new entries afterwards.
没有模型调用、没有向量库、没有联网上报。检索是纯本地打分，索引每 3 秒跟磁盘对齐。
提示词解决"agent 该怎么做"，解决不了"同一台机器上的同一个报错又出现一次"。经验库补的是后者： 错误签名 → 命中已有条目 → 当场注入症状与避坑 → 解决后把缺的那条补齐。
| 机制 | 作用 | 代码 |
|---|---|---|
| 分区加权检索 | 标题/正文命中之外，命中「诊断关键词」+8、「避坑」+5；中文按 2-gram 兜底；别名半权扩展 | search() / zoneText() / ALIASES |
| 错误签名路由 | ERR_MODULE_NOT_FOUND、EPERM、fetch failed、Error NNN 等签名给专属加权，并记录复发频率 | SIGNATURES / signatureWeight() / repeatBoost() |
| 精确重排与去重 | top15 用整句命中/标题覆盖率重排；近似条目后一名 ×0.6；severity: critical 提权 | similarMap / search() 尾部 |
| read-as-click 闭环 | "按签名搜 → 读命中条目"记为解法（resolveMap）；同签名短时间内真实复发则记 miss 降权 | noteRead() / pendingRead |
| 失败采集 + 修复证据 | tools/result 的 isError（或 value.ok === false）进候选；同工具 30 分钟内成功调用参数回填为"修复证据" | tools/result 监听 |
| 缺口 → 条目闭环 | 复发但无解法的签名 + 未命中查询 + 待认领草稿 → experience_promote 一条命令入库（套模板/查重/同步分类 README/删草稿/重建索引/返回覆盖结果） | lib/promote.js / promote() |
| 主动推送 | 工具失败时自动检索，命中分数过阈值就把「症状 + 避坑」注入本轮对话；按采纳率自适应阈值 | tools/post-execute |
| 面板 | 侧边栏：按库浏览 / 结构化正文（避坑一键复制）/ 缺口与待认领 / 候选池 | client.js |
细节见 docs/architecture.md；条目格式见 library/README.md。
# 从 GitHub 安装（当前主要方式）
dsh plugin --profile web add github:wqx11235/dsh-experience
# npm 发布后
dsh plugin --profile web add dsh-experience
官方桌面端请在应用的设置 → 插件里安装，不要用命令行改桌面 profile。
装完重启宿主（host 插件不热更），侧边栏出现「经验库」。
首次启动会把包内 library/ 复制到库根；已有库不会被覆盖。
| 工具 | 用途 |
|---|---|
experience_search | 检索；支持空格分词、中文 2-gram、报错签名加权；返回摘要与元数据 |
experience_read | 读全文；同时记录阅读次数与"解法关联" |
experience_ask | 要结论而非文件列表：按 top 命中汇总「症状/原因/避坑」 |
experience_gaps | 缺口清单：反复出现无解法的签名、待认领草稿、未命中查询 |
experience_promote | 把草稿/签名/未命中查询写成正式条目；dryRun: true 先预览 |
HTTP 端点（面板同源使用）：/experience/list、/search、/read、/gaps、/drafts、/promote、/inbox、/inbox/prune、/inbox/draft、/inbox/dismiss、/flag、/dedup、/stats、/missed/dismiss、/refresh。
优先级：config.experienceRoot → 环境变量 DSH_EXPERIENCE_ROOT → ~/.dsh/experience。
# 在 profile 的 cordis.patch.yml 里按 id 覆盖（不要重复 insert）
- id: experience
config:
experienceRoot: '/absolute/path/to/experience'
seed: false
| 私有库 | 公开起步库 | |
|---|---|---|
| 位置 | 你机器上的库根（默认 ~/.dsh/experience） | 仓库 library/ |
| 来源 | 你的使用积累 | 白名单 + 脱敏构建 |
| 谁写 | 运行时（采集 / 认领 / 归档） | 只有 tools/build-library.mjs |
| 是否发布 | 永不 | 随 npm/git 包 |
| 检查 | — | 隐私 + 死链 + 边界 |
tools/public-entries.txt 生成；运行时代码从不写 library/。library/ 播种到空的库根；已有私有库不会被覆盖（seed: false 可关）。cordis.patch.yml 不写任何机器路径；私有库用 profile patch 的 experienceRoot 指过去。node tools/check-boundaries.mjs 断言两边不混（CI 每次跑）：公开库条目 = 白名单、仓库无 .meta.json/.drafts、无私有分类、patch 无绝对路径。verify: url 校验）。docs/privacy.md。node test/run-all.mjs # 集成测试 + 死链 + 隐私闸门
node test/host-harness.mjs # 无宿主集成测试（假 ctx + 真 defineTool schema）
node tools/build-library.mjs <私有库目录> # 从私有库重建公开起步库
node tools/privacy-rules.mjs library # 公开库隐私闸门
test/host-harness.mjs 会自行 stage 一份插件并注入 @deepseek-ai/dsh-tools，不需要真的起宿主。
收录流程（awesome-dsh-plugin 一个 YAML 文件就是一个投稿）见 docs/publishing.md。
MIT