HCY7757/dsh-lexiforge

dsh-LexiForge · DSH 语言模组框架

LexiForge — 一个面向 DeepSeek Harness（DSH）的可插拔语言模组（LangPack）框架。它拦截模型的回复流，并通过可安装的、基于 ZIP 的语言包对其重新处理：风格改写、术语感知检索、本地规则后处理，或三者组合而成的流水线。面向 DeepSeek Harness 的社区语言模组插件：配置驱动、安全优先、按需计算、零运维。

✨ 特性一览 / Features

| | |
|---|---|
| 🧩 语言包即配置 | ZIP 承载、零可执行代码、格式白名单（.yaml/.yml/.json/.db/.txt），Zip Slip / 炸弹防护 |
| A/B/C 三模式引擎 | A LLM 整段改写（独立请求，不占主上下文）· B SQLite FTS5 术语库检索增强 · C 纯本地规则替换（零 token） |
| 🧬 复合模式 | 单包内 pipeline: [B, A, C] 编排：检索注入 → 一次改写 → 规则收尾，全程只一次 LLM 请求 |
| 🔗 链式多包 | 多个包按优先级依次加工同一回复（如 校对 → 文言 → 口头禅收尾） |
| 🛡️ 安全 | 解压校验（穿越/重复/链接/加密/条目/大小）、manifest/dict/knowledge 结构校验、worker 线程隔离查询、超时回退原文、独立请求防递归 |
| 🎨 原生 UI | 融入 DSH 设置页（settings.section）：启停、拖拽排序、GitHub 市场、手动安装、超时(0.1–600s)、调试日志开关（相对路径） |
| 🌐 市场分发 | 纯 GitHub 驱动：topic:dsh-langpack 搜索；单包仓库（根 langpack.zip）与 多合一仓库（langpacks.json 索引，逐包识别安装）双支持 |
| 🧪 可观测 | 可选运行日志（开关在设置页），记录拦截/跳过原因与每段改写结果 |

📦 演示语言包 / Demo packs

examples/ 下五个官方示例（源码 + zip），并单独发布多合一示例仓库：

| 包 | 模式 | 效果 |
|---|---|---|
| demo-a-wenyan | A | 白话 → 文言文风格 |
| demo-b-gufeng | B | 古风称谓术语（RAG） |
| demo-b-huoxing | composite B→A→C | 重度火星文（字形检索 + 六技法改写 + 混排保险层） |
| demo-a-rikka | A | 中二病·小鸟游六花 语气模仿 |
| demo-a-proofread | A | 输出复查·纠错（无错逐字原样） |

多合一语言包发布示例：dsh-langpack-demo —— 一个仓库包含 4 个可分别安装的语言包（含 langpacks.json 索引）。

🚀 安装 / Install

前置条件
- DeepSeek Harness（web profile）已就绪
- Node.js ≥ 22（构建用）、pnpm

加载插件（本地开发）
1. 把插件加入 web profile（~/.dsh/profiles/web/package.json）
"dsh-lexiforge": "file:F:/dev/dsh-LexiForge"   ← 替换为你的本地路径
并在 dsh.profile.bundles 增加 "dsh-lexiforge"

2. 安装依赖并构建
pnpm install
pnpm build          # tsc + esbuild 客户端打包（scripts/build-client.mjs）

3. 在 profile 的 cordis.patch.yml 注入配置（entry id 必须为 dsh-LexiForge）
- id: dsh-LexiForge
config:
packagesDir: F:/dev/lexiforge-demo   # 数据目录（D/F 盘，绝对路径）
enabled: true
debugLog: debug.log                # 可选：日志位置（相对 packagesDir）

4. 重启 dsh web → 设置页出现「语言模组」

插件包须同时声明 dsh.bundle.patch（cordis.patch.yml，insert 挂载）与 dsh.client（浏览器端 UI）；exports 必须包含 "./package.json"，客户端 bundle 需按 __ModuleLoader__.load 的 CJS 工厂契约构建（见 scripts/build-client.mjs）。修改源码后需删除 profile node_modules 中的拷贝再 pnpm install，host 代码改动需重启 dsh。

CLI（语言包管理）
构建后生成可执行入口
pnpm build
node dist/cli.js --help

lexiforge  disclaimer                                    # 阅读第三方免责声明
lexiforge  install 包.zip 包ID --accept-risk             # 本地 zip 安装
lexiforge  market-install owner/repo 包ID --accept-risk  # 从 GitHub 安装（合集仓需包ID）
lexiforge  search 关键词                                 # 搜索 topic:dsh-langpack
lexiforge  enable 包ID | disable 包ID | on | off | order ID...
lexiforge  uninstall 包ID
lexiforge knowledge 词条.csv 输出.db                               # 生成 B 模式知识库（FTS5 trigram）

📖 语言包规范 / LangPack spec

ZIP 内仅允许四类文件（根目录平铺）：manifest.yaml（必填）、dict.json、knowledge.db、说明.txt。

manifest.yaml
name: 我的语言包        # 必填
version: 1.0.0          # 必填（semver）
author: 某人            # 必填
mode: composite         # A | B | C | composite
pipeline: [B, A, C]     # composite 必填：至少含 A 或 C；B 的检索结果注入其后的 A
prompt_template: |      # 含 A 时必填；{{text}}=原文，{{knowledge}}=B 检索结果
...
dict_path: dict.json        # 含 C 时必填：replacements 字面量替换 + rules 正则
knowledge_db: knowledge.db  # 含 B 时必填：由 lexiforge knowledge 生成

- A：一次独立 LLM 请求整段改写（不带历史/工具，防递归）
- B：先用回复文本检索 knowledge.db（FTS5 trigram），Top-N 注入 A 的 prompt
- C：worker 线程执行字典与正则，零 token；可作“保险层”强制收尾
- 多包可链式叠加；顺序在 UI 拖拽或 CLI order 调整；每个包可设置全局处理超时（默认 0.5s，UI 可调 0.1–600s，超时自动回退原文）

详细示例与多合一发布模板见 dsh-langpack-demo。

🔒 安全设计 / Security

- 解压：扩展名白名单、路径穿越/重复/链接/加密拒绝、64MB & 1024 条目上限、实际字节复核
- 校验：manifest 字段白名单 + semver；dict 规模/正则合法性；knowledge.db 只读打开（trusted_schema OFF），查询运行于可终止的 worker
- 流处理：完整缓冲、超时回退原文、改写请求剥离 session/历史/tools、independentRequests 防递归
- 安装门：首次使用强制《第三方免责声明》闸门；接受记录仅存本机 state.json
- 边界：所有防护为“格式层”，不构成内容安全担保；第三方包可能包含恶意提示词/词条，请按免责声明自查

🧑‍💻 开发 / Development

pnpm install
pnpm build     # tsc + client bundle (esbuild)
pnpm test      # node --test（11 项：安装/恶意包/检索/复合/免责声明/流拦截…）

目录结构：src/services（package-manager / processor / knowledge / market / stream-interceptor / manifest）、src/utils/unpacker.ts（安全解压）、src/client（设置页 UI）、src/disclaimer.ts（免责声明权威文本）、scripts/build-client.mjs（客户端 bundle 契约构建）、tests。

⚖️ 免责 / Disclaimer

本插件只提供语言包的发现、下载与安装能力。语言包由第三方作者制作，插件作者不承担内容审核、质量保证与法律责任。请阅读插件内《第三方语言包免责声明》后自行评估风险。演示包均为学习示例，不构成任何担保。

📄 License

MIT — 详见 LICENSE。