zuoyunlai/lunheng-article-pipeline-dsh

🌐 English ｜ 中文（本文件）｜ Español ｜ Português ｜ हिन्दी

版本：v18.62.4（DSH bundle：package.json + cordis.patch.yml + lib/index.js）

一个 DeepSeek Harness（DSH）bundle 插件，注册两个按需加载的 agent 技能：lunheng-article-pipeline（9 角色主流水线）与 lunheng-commands（薄壳包装 11 个 /lunheng-* 斜杠命令：draft / resume / cite / audit / journal / ppt / history / rollback / status / stats / help；不引入新角色、不引入新 M 门，详见 skills/lunheng-commands/SKILL.md）。主技能把深度长文的生产——学术论文、行业分析、商业评论、公众号深文——变成带人在环节点的 9 角色流水线。

What this is

论衡是流水线，不是文本生成器。它把一份深度长文拆成 9 个独立角色 T1–T9（互不可替代），跨 6 个阶段，用 DSH subagent 编排，产出带证据底座、反方论证、独立审计、人工核验节点的交付物。

九角色：T1 文献检索员 / T2 数据检索员 / T3 案例检索员 / T4 分析员 / T5 写手 / T6 批判伙伴 / T7 审计员 / T8 终检（由主控亲执行，不 spawn）/ T9 同行评审。

When to use it

• 需要 2000 字以上、经得起追问的深度长文，且可接受 1–3 小时流水线时长。
• 题材涉及事实、数据或多方观点，需要证据底座而非纯观点输出。
• 你希望保留人在环节点：写作前确认大纲，交付前过目终稿。

When not to use it

论衡主动检索已公开发表的证据，并整合你投喂的材料。以下类型它无法自行产出——请先投喂素材，或换用别的工具：

• 一手数据采集——实验、问卷、访谈、田野。
• 统计分析——它能引用结论，但不跑 SPSS/R/Python。
• 原始图表数据采集——它负责渲染数据图；抓取、OCR、语音转写需要专门工具。
• 原创图像或视频——DSH 无内置文生图；封面回退到本地 SVG 或你提供的文件。
• 代码执行——流水线只跑白名单脚本，其余需要你显式批准。

判据一句话：先问「证据是否已公开」。已公开 → 论衡能检索；未公开 → 先投喂。

What you get

产物	内容
文献卡 [Lxx]	已发表来源 + A/B/C 可信度分级 + 先行者清单（用于原创性核对）
数据卡 [Dxx]	数字 + 来源/年份/时效分级/信任级别；冲突数字并列呈现
案例卡 [Cxx]	事件结构（谁/何时/何事/各方说法），或显式 [C-空] 空卡标记
分析大纲	论点线索、论点-论据映射、反方论证计划、承重证据清单
初稿	逐版递进，含中文 AI 痕迹清理，每轮由独立写手执行
审阅报告	批判报告（C1–C7）、审计报告（G0–G14）、审稿报告（6 维度 + 期刊匹配）、AI 痕迹报告
终交付	final/定稿.md、图件、证据包、交付说明、M 门报告
DSH 集成（bundle 安装时）	四个只读工具 lunheng_m_gate（M 门机械预检）、lunheng_char_count（纯汉字数）、lunheng_handoff_check（交接报告形态/版本/成对/agents-log 校验）与 lunheng_ethics_sanitize（伦理脱敏：把访谈逐字稿/田野笔记里的身份证/手机/邮箱/银行卡/人名/地名换成占位符；返回脱敏文本、由调用方决定落盘；v18.60.1）——清单里没有就照旧用 pwsh 调同名脚本（同源）。人类命令 /lunheng-status 与 /lunheng-stats（读 run/<项目>/status.md，不产生模型消息）。机制文件写保护：全局 guard 否决指向技能包内的 write/edit 类工具调用，会话无法悄悄改写流水线自己的规则。边界如实声明：guard 只看工具调用——pwsh/子进程不经此门；主人授权例外走 LUNHENG_ALLOW_MECH_EDIT=1（或本插件行 config: { allowMechanismEdit: true }）。插件 Config（部署开关，写在你 profile 的本插件行上）覆盖 quiet / allowMechanismEdit / scriptTimeoutMs / scriptMaxOutputBytes / handoffLevel（交接门灰度）——其中 quiet / allowMechanismEdit 与 LUNHENG_QUIET / LUNHENG_ALLOW_MECH_EDIT env 同义，而 scriptTimeoutMs / scriptMaxOutputBytes / handoffLevel 三者仅 Config（无 env 路径）；五者均随 profile 走且可 review；非法配置在加载期响亮失败，不静默回落默认值。

Pipeline overview

Phase 0  定题      确认主题/篇幅/引用格式 + 外部服务同意
Phase 1  并行检索  T1 文献 ∥ T2 数据 ∥ T3 案例（真并行、互不干涉）
Phase 1.5 定向补检索 T1 定向补检索（可选；关键 [Dxx] 回查 + 缺口论点补检，Permanent Gap 标注）
闸门 T2.5          数据条目 ≥ 简报要求；信任级别完整
Phase 2  分析      T4 分析员 → 分析大纲
Phase 2.5 大纲确认 主人过目（人在环）
Phase 3  写作      T5 写手 → 初稿 v1
Phase 3.5 洞察补充 主人补充一手语境（人在环）→ 初稿 v2
Phase 3.6 批判     T6 批判伙伴 → C1–C7 报告
Phase 4  审计      T7 审计员 → G0–G14 审计报告 + 修订任务书
Phase 4.2 修订     写手修订 + 修订说明（≤2 轮，独立写手）
Phase 4.5 审稿     T9 同行评审 + G14 中文 AI 痕迹闸（并行）；配图
闸门 T7.5          最新审计 + P0/P1 清单 + M 门 exit 0 + 报告隔离
Phase 5  终检      T8 终检（主控执行）→ 定稿、证据包、交付说明

三角证据底座（[L] + [D] + [C]）——每条论断都要能映射到文献、数据与（事件类论断）案例证据。独立审计——审计员不改稿，只报告。四道人在环节点——Phase 0 / 2.5 / 3.5 / 5。

Repository layout

lunheng-article-pipeline/                 # 包即仓库
├── package.json              # 声明 main（lib/index.js）+ dsh.bundle.patch
├── cordis.patch.yml          # bundle 层：本包自注册行 + 3 档 subagent 工具（设了 LUNHENG_* 才装载）
├── lib/index.js              # 插件入口：注册技能 + 只读工具 + 机制写保护 + /lunheng-status
├── skills/lunheng-article-pipeline/       # 技能本体（一个目录）
│   ├── SKILL.md              # 技能入口（角色 / 闸门 / 执行能力边界）
│   ├── AGENTS.md             # 操作手册
│   ├── QUICKSTART.md         # 5 分钟快速开始
│   ├── README.md             # 技能级说明（中文）
│   ├── references/           # 9 张角色卡、模板、共享闸门算法、期刊数据库
│   └── scripts/              # 零依赖 .mjs 机械校验脚本（数量真源 = 技能白名单行）
├── skills/lunheng-commands/   # 伴随技能：11 个 /lunheng-* 斜杠命令（draft / resume / cite / audit / journal / ppt / history / rollback / status / stats / help）
│   ├── SKILL.md              # 命令入口（命令清单、派发模型）
│   ├── README.md             # 命令级说明
│   ├── scripts/              # 命令处理器（如 lunheng-stats.mjs）
│   └── tests/                # 命令级测试（不自动跑，手动 npm test 范围）
├── scripts/                  # 仓库门：打包面 + 机械卫生 + 打包产物冒烟
├── tests/                    # node --test 回归（脚本 + 插件入口冒烟）
├── docs/                     # 安装 / 使用 / 架构 / FAQ / 排障
├── examples/preset/          # 分档说明与安装指南
├── README.md                 # 英文源版
├── README-zh.md README-es.md README-pt.md README-hi.md
├── SECURITY.md CHANGELOG.md CONTRIBUTING.md LICENSE

插件入口把 skills/lunheng-article-pipeline/SKILL.md 注册为技能，其 resourceBase 指向该目录——因此 references/** 与 scripts/** 的相对引用在任意工作目录下都能解析。

patch 层做两件事：插入一行本包自注册行（- id: lunheng-article-pipeline / name: lunheng-article-pipeline）——loader 靠这一行按包名 import lib/index.js，技能才注册得上——以及插入三档分档 subagent 工具，后者默认不装载（设任一档 LUNHENG_{RETRIEVAL,STRONG,AUDIT}_{PROVIDER,MODEL} 或 LUNHENG_TIERING=on 才装载，off 强制不装载）。这一行是承重的：缺了它入口永远不会被 import、技能不会出现（v18.0.0 的缺陷，18.0.1 修复；由 tests/bundle-contract.test.mjs 机械防守）。

Documentation

文件	内容
docs/installation.md	安装与验证
docs/usage.md	使用流程（阶段 + 产物结构）
docs/architecture.md	架构（9 角色 + 三角验证 + G0–G14 审计 + M 门）
docs/introduction.md	插件介绍
docs/faq.md	常见问题
docs/troubleshooting.md	安装/验证故障排查（症状 → 原因 → 处置）
SECURITY.md	安全策略与信任边界
CHANGELOG.md	版本历史
CONTRIBUTING.md	维护与发布指南

Publishing (maintainers)

只推 tag 发布，禁止本地 npm publish（本地直发会绕过 CI 三道门与 OIDC 来源证明，且 npm 版本不可覆盖）。

git tag v18.62.4 && git push origin v18.62.4   # 一次只推 1 个 tag（GitHub：单次 push >3 个 tag 不触发任何 workflow）
# publish.yml 依次跑：门 1 一致性 → 门 2 打包面 → 门 3 机械卫生 → 门 4 打包产物冒烟 → 脚本回归测试
#   → tag/版本一致校验 → 幂等守卫 → OIDC 发布 --provenance --tag dsh → 发布后审计

Install

方式一：作为 bundle 安装（推荐；入口注册技能 + C 组能力，patch 层可装载分档工具——默认不装，见 Model routing）

dsh plugin --profile web add lunheng-article-pipeline
dsh --profile web --dump-config   # 应出现 "# == lunheng-article-pipeline" 层

新版 dsh 看到 dsh.bundle 声明后会自动把依赖加进 dsh.profile.bundles——装完重启 dsh web 即可。仅当用纯 npm/pnpm 安装或旧版 dsh 时，才需手工在 profile 的 package.json 里加 dsh.profile.bundles 条目。

方式二：作为纯技能目录（免安装；宿主监听技能根、文件改动即刷新目录——方式一的 SKILL.md 是入口 apply 期读的快照，改内容需重载插件或重开会话）

# 复制**技能目录**（不是仓库根）到任一 DSH 技能根：
#   $DSH_HOME/skills/lunheng-article-pipeline        （用户级，rank 400）
#   <项目>/.dsh/skills/lunheng-article-pipeline      （项目级，rank 100）

纯目录不含 dsh.bundle 声明，因此 dsh plugin add 只会把它当普通依赖安装、不激活任何层——复制技能目录才是受支持的路径。

Requirements

项	要求
DSH（产品版）	dsh CLI 可用；bundle 的 - insert: 增量 patch 行需 DSH 5.5.0+ 产品发行版——注意：dsh 有两条并行版本线，产品发行线（semver，如 5.5.0）与 npm 包线 @deepseek-ai/dsh（prerelease tags，如 0.1.7-rc.2），两者不可互换
@deepseek-ai/dsh（npm 包版）	peerDependencies 声明 >=0.1.2-rc.1 <0.2.0；CI 仅实测过 0.1.7-rc.2（ci.yml pin 的 prerelease tag）；早于该版本的 0.1.x 能否工作未实测——下限是声明而非验证
Node	^22.19.0 || >=24.0.0（DSH 运行时下限；见 package.json 的 engines）
pnpm	安装/卸载依赖它（dsh plugin 内部转 pnpm）
平台	Windows / macOS / Linux（脚本零依赖，跨平台可跑）

Uninstall

dsh plugin --profile <profile> remove lunheng-article-pipeline

卸载后 cordis.patch.yml 的 4 段 - insert:（自注册行 + 三档工具行）与入口注册的技能一并消失，不留残余行。若曾手工把技能目录拷到技能根（.dsh/skills/ 或 .agents/skills/），需另行删除该目录。

Model routing

DSH 通过 settings.yaml 路由模型；subagent 继承会话模型，因此单模型零配置即可跑。要按角色分档时，bundle 可装入三档工具——默认不装载（三档全继承时它们与内置 subagent 完全同义，无条件装载等于每会话白付 3 份工具 schema）：

工具	角色	能力定位
subagent_retrieval	T1 文献 / T2 数据 / T3 案例	便宜快
subagent_strong	T4 分析 / T5 写作	推理强
subagent_audit	T6 批判 / T7 审计 / T9 审稿 / G14 检测	顶配防漏判

用 LUNHENG_{RETRIEVAL,STRONG,AUDIT}_PROVIDER 与 LUNHENG_{RETRIEVAL,STRONG,AUDIT}_MODEL 覆盖——设任一档即同时装载三行（既有的分档配置行为不变）：provider 与 model 是独立字段，跨 provider 时才需同时给；LUNHENG_TIERING=on 可在不指定模型的情况下只把三行挂上（用于确认工具是否可见），LUNHENG_TIERING=off 一键让三档全部退回继承并卸载三行。某档工具未挂载时，派发自动回退内置 subagent。详见 examples/preset/README.md 与 docs/installation.md。

Data and external services

流水线会向第三方发送：

操作	发送内容	接收方
web_search / web_fetch	检索关键词、目标 URL	DSH 配置的检索/抓取服务商
模型推理	文献卡/数据卡/案例卡、大纲、初稿	当前模型 provider
文生图（可选，默认关闭）	主题与品牌描述	图像 MCP，仅在你启用并配置时

主控必须在 Phase 0 披露并取得明示同意。敏感题材：措辞脱敏、封面改用本地 SVG（零外发）、选用本地模型端点。拒绝任一项即回到 Phase 0 调整方案。

Verification status

文章	规模	关键结果
品牌一致性文章（2026-08）	约 7900 字，15 条文献 + 54 条数据	证据包齐备；8 项审计问题全部关闭
原创性悖论文章（2026-08）	约 9500 字，12 文献 + 34 数据 + 6 案例	全程共 4 轮修订，A- 评级，已发表
教师场域隔离论文（2026-08）	约 12000 字，18 文献 + 47 数据 + 9 案例	审计第 2 轮通过；首次一致性审计
生成式 AI 学生写作评论（2026-08）	约 2000 字，12 文献 + 26 数据	三方并行检索；M 门 exit 0
甲醛白菜文章（2026-08）	约 4200 字，12 文献 + 29 数据 + 4 案例	M 门 exit 0；并入 6 条反哺规则
观念与理念哲学论文（2026-09）	约 6280 字，18 文献 + 15 数据，0 案例	2 轮审计，23/30 minor revision，M 门真 P0 = 0

本表怎么读（两种容易混的口径）：① 「修订轮数」数的是那一次跑的全部写手过稿（Phase 3.5 → v2、T6 批判修订、G14 轮、审计回环），而流水线自己的上限 ≤2 轮只约束 Phase 4.2 的审计回环——两个数字量的不是一回事；② 表内结论是当时那一次跑的历史值（配当时的脚本版本），用当前脚本无法复现：今天拿随包脚本重跑归档项目，甲醛白菜文章会得到 exit 2 与 5 个 P0（M-Form-6/10、M-Exist-7/9、M-Integrity-1），因为其中三项门是那篇文章之后才加的。请把本表读成「当时产出了什么」，而不是「当前门集能过这些项目」。

本地四道门 + 回归测试（仅源码仓库——npm 包内不含 scripts/ 与 tests/，故下面几条在装包形态下无法执行；包内可用 pack-smoke 对刚下载的 tarball 跑等价检查）：node skills/lunheng-article-pipeline/scripts/consistency-check.mjs、node scripts/plugin-surface-check.mjs、node scripts/repo-hygiene-check.mjs、node scripts/pack-smoke.mjs、node --test "tests/**/*.test.mjs"。

Known limitations

• 中文优先。 角色提示词、交付物、文件名与流程默认中文。
• 默认不做网络核验。 数字级出处核对常停留在「待人工复核」，因为付费墙与线下来源取不到。
• 审计独立性有成本。 一次完整运行会派 15+ 个子代理；大部分 token 花在上下文读取而非生成。
• M 门可能假阳性。 脚本会误判合法写法；T8 必须记录 script_exit_raw 并说明 exit 裁定理由，而不是改稿去凑 exit 0。
• 不能替代同行评审。 T9 报告只是投稿前的模拟。

License

MIT，见 LICENSE。