前言¶
在 DeepSeek Harness（DSH）里写长文、编故事时，模型往往会给一大段泛泛建议，而真正有用的是「同类处境里别人用过什么叙事动作」。若把整库检索结果都塞进对话，正文会被条目刷屏，后续轮次也难聚焦。
storymine 是一套叙事手法库：把书切章、提取动作并写入 SQLite。社区插件 dsh-storymine（维护者 amberpulse，分类：联网工具）把该库接进 DSH：写东西卡住了可以问一句「别人怎么写这一段」，查询结果推到右侧「手法库」面板，主对话里只留简短播报。下面介绍定位、能力与安装配置。
这是什么¶
dsh-storymine 是 DSH 插件（host + client 两半），不是 storymine 内核本身。内核 storymine.py 负责切章、提取、入库；本插件负责在 DSH 里查询、展示与管理。
- 仓库：github.com/amberpulse/dsh-storymine
- 社区目录：skillhub.cn/plugins/amberpulse/dsh-storymine
- 许可证：MIT；当前 package 版本 0.1.0
- 引擎要求：Node ≥ 20，DSH
>=0.2.0 <0.3.0
核心功能¶
六个工具¶
| 工具 | 作用 |
|---|---|
storymine_query |
给一句处境描述，从库里找可复用的叙事手法 |
storymine_stats |
家底：几本书、几条动作、动作分布、各书进度 |
storymine_list |
按动作分组浏览整张手法表 |
storymine_failures |
列出提取失败 / 切分可疑的章 |
storymine_extract |
把 txt 逐章提取入库（慢，需分批） |
storymine_delete |
删条目（默认只预览，confirm 才动手） |
storymine_query 在 Node 侧直接读 SQLite，并走 DSH 的模型；stats / list / failures / extract / delete 需要本机 Python 3.10+ 与 storymine.py 内核。
右侧「手法库」面板¶
- 历次查询的条目卡片按动作分组，带出处
- 面板底部有输入框：在面板里问，结果只进面板，主对话不占字
- 按会话分区，可清空；样式跟随 DSH 主题（
--dsw-*token）
工具返回值只包含「推了多少条 + 动作分布」，条目正文进面板与 store，避免对话刷屏。模型因此看不到条目全文，是否采用某条手法由你自己判断。
默认「两轮精选」查询¶
库很大时，若把每条完整做法一次塞给模型，token 与注意力成本都高。默认 queryMode 为 two-stage：第一轮用短摘要在全库挑 shortlistSize（默认 20）个候选，第二轮只对候选给完整做法并精选。README 记载在同一句处境、deepseek-v4.1-flash 下，单轮与两轮耗时接近，token 约省 65%。也可改为 single 对比。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
1. 装进 profile（桌面版也可：侧栏「插件 → 添加插件 → 本地路径」）
dsh plugin --profile <你的profile> add /path/to/dsh-storymine
2. 在 profile 的 cordis.patch.yml 里配置库路径（不配会明确报错）
- id: storymine
name: 'dsh-storymine'
config:
dbPath: '/abs/path/to/storymine.db'
kernelPath: '/abs/path/to/storymine.py' # 只跑 query 可不填
也可用环境变量（config 优先）：STORYMINE_DB、STORYMINE_KERNEL、STORYMINE_PYTHON 等，详见 README「配」一节。
3. 重启 DSH（Host 在宿主进程，热替换不生效）
怎么确认装好了¶
- 右侧「开始」引导页多一格 storymine 手法库
- 面板底部输入框可直接问，条目当场出现（不经过主对话）
- 主对话里问同样问题：正文只有播报 + 提议，条目在面板
典型用法¶
前置：DSH ≥ 0.2.0（web profile 或桌面版）、已有的 storymine.db；无库则无可查内容。
在主对话中示例（README）：
用 storymine_query 找几条：角色刚摊牌，下一拍该收还是该抬
条目出现在右侧「手法库」，正文只留一行播报。需要看库规模或维护数据时，可调用 storymine_stats、storymine_list、storymine_failures；入库用 storymine_extract（走内核自己的 storymine/config.json 渠道，不吃 DSH provider）。
适用场景与注意¶
适合谁：已有或计划维护 storymine 手法库的写作、编剧、叙事设计场景；希望在 DSH 里查手法但不污染对话流的用户。
常见限制（README 已知限制）
query常需几十秒（两轮各一次模型往返）；可调小shortlistSize或改queryMode- 面板需在已打开的会话中使用，否则会
no session surface is mounted extract的模型调用走内核配置，与 DSH 所选模型无关- 插件版本与 DSH 不匹配时可能出现
Invalid schema for function ... type: null（需满足engines.dsh范围）
排错速查：未配 dbPath 会报「没配置手法库路径」；仅非 query 工具需要 kernelPath；装完务必重启并看日志中 [storymine] 行。
结尾¶
dsh-storymine 把 storymine 叙事库嵌进 DSH 工具与右侧面板：查询走模型与 SQLite，展示与存档分离，适合「卡住时问别人怎么写这一段」的工作流。
- 目录页：https://www.skillhub.cn/plugins/amberpulse/dsh-storymine
- GitHub：https://github.com/amberpulse/dsh-storymine
