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

结构

核心原则

• 文件是唯一真相: 每书一个 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)