小说工坊 FengHuoLinShan/novelAssist-dsh

novelAssist-dsh

NovelCraft M4 —— 「自主智能式作家助手」的 DSH 插件族 monorepo。旧 FastAPI/PG/Vue 引擎已于 2026-08-14 退役(归档于 annotated tag old-engine); 本仓库只承载 M4 纯 TS 确定性核心 + DSH 挂载适配 + web 客户端。

- 形态: fork deepseek-harness 的独立仓库(ADR-0017), remote origin =
https://github.com/FengHuoLinShan/novelAssist-dsh.git(PUBLIC)
- 分支: main(唯一主干); 迁移基点 annotated tag dsh; 旧引擎归档 tag old-engine

结构

| 目录 | 内容 |
| packages/novelcraft/ | 16 个纯 TS 包: vault/store/llm-step/writing/imports/world/outline/memory/context/rag/rag-bge(可选 BGE 嵌入后端, N22)/assistant(13 核心)+ dsh(唯一 DSH 接触面)+ client(双面包 UI)+ trace(trace contract 框架)+ preset |
| plugin/ | 公开 npm bundle novelcraft-dsh: 预构建宿主插件 + Web client + cordis.patch.yml |
| specs/ | R0 规格: assets(资产 schema)/ prompts(catalog 34 spec)/ rules(store-rules R1–R64 + policy-defaults)/ adjudications(二十一批裁定, N1–N61) |
| docs/adr/ | ADR-0016～0025(M4 重写、仓库/共享层、结构关系、map atlas、事务/恢复、生命周期、capability 与源码分发) |
| docs/agent/dsh-rebuild/ | M4 交接/设计/验收文档(单一事实入口: 跨会话交接.md; 总进度: STATUS-M4.md) |
| starter/ | 一键安装 starter |

核心原则

- 文件是唯一真相: 每书一个 git 仓库(vault), 资产 = frontmatter 文件 + git commit; 派生索引任何时刻可全量重建; git 本身就是回滚面。
- 核心包零 DSH 运行时依赖: 内容手/编排为纯 TS 确定性库, DSH 接触面唯一收敛在 @novelcraft/dsh。
- adopt 必过 approval: 采用类资产写入由助手 agent 经 DSH approval(fail-closed, allowed-once 只放行一次); 客户端 RPC 通道(loopback)只读信号 + 记录决定, 不写资产。
- 内容手受控: 每个 llm_step 带 output_schema/预算/超时/journal, 由确定性工作流编排。

快速开始

运行时要求 Node >=24.11.0。推荐从 npm 安装已预构建的 DSH bundle：

dsh plugin --profile web add novelcraft-dsh
dsh --profile web

公开发布面只有 novelcraft-dsh；16 个内部 workspace 继续保持 private: true，由发布构建合并为单个可安装包，不暴露内部包拓扑。

源码开发

默认 profile 不安装可选 BGE/Transformers 链：

npm ci --omit=optional
npm run build # 固定依赖拓扑构建
npm test # 全仓测试全绿
npm run typecheck # 零错误
npm run check:distribution
npm run check:audit-gate && npm run audit:default
npm run pack:plugin # 构建并检查可安装 tarball
npm run bench:continuity # 结构维护连续性基准(错误注入→检测器捕获率矩阵, 仅报告不设门禁; --json 可选)

仅在需要本地 BGE 嵌入时显式安装 optional profile，并单独验证：

npm ci --include=optional
node --input-type=module -e "const m=await import('@huggingface/transformers'); if(typeof m.pipeline!=='function'||!m.env) throw Error('invalid runtime')"
npm test -w @novelcraft/rag-bge
npm run audit:bge

默认 embedding: off；可选包缺失或加载失败时检索降级到文本链并记录 embedding_failed，不会阻断写作。

文档

- 架构事实/安全边界/坑清单/复现命令: docs/agent/dsh-rebuild/跨会话交接.md
- 总进度: docs/agent/dsh-rebuild/STATUS-M4.md
- seam 契约: packages/novelcraft/README.md + dsh/README.md + client/README.md
- 工具清单: docs/TOOLS.md
- 数据与隐私: docs/PRIVACY.md
- 设计: docs/agent/dsh-rebuild/自主智能式作家助手设计.md(D1–D25)