lynote-ai/dsh-humanizer

dsh-humanizer

一个面向 DeepSeek Harness（dsh）的写作技能。核心理念不是"写得像人"，而是"写得像我"：一边剥离泛泛的 AI 腔调模式，一边学习你自己的写作指纹，把任何草稿变成你写出来的东西。

这是一个给 agent 用的技能，而不是 LLM 包装器：它不进行任何模型调用。它只产出规则、指纹、评分和改写简报——真正的改写由 agent 自己完成。

安装

从 GitHub 安装（附带预构建的 lib/）
dsh plugin add github:lynote-ai/dsh-humanizer

或者，发布到 npm 之后：
dsh plugin add dsh-humanizer

可选配置（所有字段都有默认值）：

- insert:
- id: dsh-humanizer
name: 'dsh-humanizer'
config:
strength: standard                          # light | standard | aggressive
storagePath: ~/.dsh/voice-profiles.json
maxExcerpts: 3

工具（8 个——全部确定性，无模型调用）

去 AI 味：

| 工具 | 用途 |
|---|---|
| humanize_scan | 检测 AI 模式，返回 AI 味评分以及命中的规则 |
| humanize_rules | 导出完整规则目录（透明、可编辑） |
| humanize_rewrite | 返回改写简报（规则 + 本文本中发现的问题）；由 agent 应用 |

个人声音克隆：

| 工具 | 用途 |
|---|---|
| voice_import | 导入样本 → 提取风格指纹 → 持久化一个档案 |
| voice_profile | 读取单个档案，或列出全部 |
| voice_remove | 删除一个档案 |
| voice_score | 文本与档案之间的相似度（0–100 + 逐特征明细） |
| voice_rewrite | 返回改写简报（指纹 + 少样本示例 + 发现的问题） |

工作原理

src/core/ 是一个纯函数、无依赖、带单元测试的库：

- rules.ts —— AI 写作模式目录（英文 + 中文，参照 stop-slop / Humanizer-zh 建模）
- analyze.ts —— 去 AI 味扫描：空洞开头、陈词滥调、模糊限定、模板化过渡、机械排比、总结式结尾
- fingerprint.ts —— 风格指纹：句长 / 突发性、标点习惯、立场（人称、副词、缩略形式）、偏好词汇、词汇丰富度
- score.ts —— 相似度评分（0–100 + 逐特征明细）
- render.ts —— 改写简报构建

humanize_rewrite / voice_rewrite 从不调用模型——它们返回一份简报，agent 在自己的回合里完成改写。voice_score 的逐特征输出是未来"从反馈中学习"迭代的挂钩。

示例（从 agent 的视角）

用户：我写了十几条推文。帮我建一个"我的声音"档案。

Agent：
1. voice_import(name="me-x", samples=[...])   → 提取并存储指纹

用户：用我的声音改写这篇 AI 写的发布帖。

Agent：
1. voice_score(text=draft, name="me-x")        → 41/100
2. voice_rewrite(text=draft, name="me-x")      → 获取简报（指纹 + 样本 + 问题）
3. agent 按照简报进行改写
4. voice_score(rewritten, name="me-x")         → 83/100

开发

npm install
npm run check       # 类型检查 + 构建
npm test            # 单元测试（node --experimental-strip-types）
npm run build       # tsc → lib/

设计决策

- 不调用 LLM —— 规则、指纹和评分都是确定性的、可复现的。
- 单一自包含打包 —— 没有未发布的共享依赖，因此 dsh plugin add 开箱即用。
- 基于文件的持久化 —— ~/.dsh/*.json，无需存储后端。

许可证

BSD-3-Clause

中文说明

面向 DeepSeek Harness（dsh）的写作插件。核心理念是——不是「像人写」，而是「像我写」：一边去掉通用 AI 腔，一边学习你本人的写作指纹，把任意草稿改成「你写的」。

这是一个给 Agent 用的 skill，不调模型：只产出规则、指纹、打分和「改写 brief」，真正的改写由 Agent 自己完成。

- 去 AI 味：humanize_scan（检测）/ humanize_rules（规则库）/ humanize_rewrite（改写 brief）
- 文风克隆：voice_import / voice_profile / voice_remove / voice_score（0–100 相似度）/ voice_rewrite（改写 brief）

规则库中英双语覆盖（参考 stop-slop / Humanizer-zh）。指纹提取与打分均为确定性计算，可复现、可单测；Profile 默认持久化到 ~/.dsh/voice-profiles.json。

安装：dsh plugin add github:lynote-ai/dsh-humanizer