前言¶
在 DeepSeek Harness（DSH）里做软件著作权（软著）材料，常见做法是分步跑脚本：打包源程序、生成说明书与源代码文档、做图集、再人工对数字。送审要求源程序目录、源代码文档封面、哈希值清单、研发日志四处报出同一组「N 个源文件 / M 行代码」，而这些数字往往由不同脚本各自产出，缺少交叉校验；任一步收窄范围，其余三处可能对不上且不易察觉。
下面介绍社区工作流插件 dsh-skill-softcopyright（维护者 shay-Ckm）。它把从开发验证到统一交付的环节收成一条带门禁的流水线，并把「四处口径一致」做成可机械校验、可指出修法的能力。
这是什么¶
dsh-skill-softcopyright 是面向 DSH 的 npm 插件包，定位是软件著作权交付流水线。按仓库说明，它包含 4 个技能、8 个工具（共 33 个 action）、10 阶段可定制清单，以及三类门禁、证据记录与 Checkpoint 强制汇报。
插件在 SkillHub 分类为「工作流」；GitHub 仓库为 shay-Ckm/dsh-skill-softcopyright，许可证 MIT（package.json 版本 0.1.0）。社区目录页：SkillHub 插件页。
它解决什么问题¶
软著送审的硬约束是四处必须一致。本插件在交付前读取四处并交叉核对；不一致则报错并说明修法。规则是以源程序目录为准，重新生成其余三处，禁止手改单个文档以避免口径漂移。
除四处一致外，审计还覆盖图集屏数与说明书图题/图片数、源码范围等（见下文工具 sc_audit）。
核心能力¶
技能与工具¶
| 类型 | 内容 |
|---|---|
| 技能 | 4 个：Python 全流程交付、界面图集、降 AIGC、AIGC 申诉证明 |
| 工具 | 8 个：sc_doctor sc_manual sc_source sc_aigc sc_proof sc_atlas sc_audit sc_pipeline（33 个 action） |
| 编排 | 10 阶段清单（可定制 YAML）+ 三类门禁 + 证据记录 + Checkpoint 强制汇报 |
| 命令 | /sc-status /sc-audit /sc-milestone /sc-reset |
流水线覆盖的环节（仓库 README 表述）：软件开发 → 回归测试 → 源码打包 → 说明书 → 界面图集 → 源代码文档 → 降 AIGC → 申诉证明 → 统一交付。
门禁与铁律¶
每个阶段完成并校验通过后立即停下汇报，等明确确认才继续。这是 README 中的「流水线铁律」，与门禁、证据记录配合，避免在未确认状态下跳步。
设计取舍（使用前宜知）¶
- 页数以 Word COM 真实渲染为准，估算仅作兜底；
pagesSource会标注来源。 check_aigc的退出码恒为 0，无成败语义；判读需比对数值目标，不能只看退出码。- 插件启动自诊断：
apply()逐段隔离，某段失败只影响该段；日志位于$DSH_HOME/softcopyright-boot.log（测试进程不写）。 - 各工具输出信封不含
undefined（满足 DSH 对 lossless JSON 的要求）。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前应阅读仓库源码与 THIRD-PARTY-NOTICES.md，并知悉随包技能资产的著作权说明（见下文「适用场景与注意」）。
方式一：DSH 插件管理页（推荐）¶
打开 设置 → 插件管理，在安装框输入包名：
dsh-skill-softcopyright
安装源可选 npm 官方源或中国大陆镜像源。
方式二：命令行¶
npm install dsh-skill-softcopyright
方式三：手动放入 profile¶
将包复制到 <DSH_HOME>/profiles/<profile>/node_modules/dsh-skill-softcopyright/，并在该 profile 的 cordis.patch.yml 中追加：
- insert:
- id: skill-softcopyright
name: dsh-skill-softcopyright
config: {}
重启 DSH 后，应看到 8 个工具与 /sc-* 命令。首次使用请先调用 sc_doctor 体检，确认两条 Python 链与资产完整。
运行环境：Node.js >= 20；peer 依赖含 @deepseek-ai/cordis ~4.0.4 等（见 package.json）。
典型用法¶
先做体检与流水线状态查看，再按阶段调用工具。下列示例来自仓库 README，路径需替换为你的项目目录。
sc_doctor # 体检：运行链 / 受管 seam / 资产
sc_pipeline action=status # 看 10 阶段与共享口径
sc_pipeline action=recompute-facts sourceDir=<项目的 src 目录>
sc_source action=gen-doc sourceDir=... outPath=...
sc_manual action=check docx=... # 图位版格式复验
sc_atlas action=shoot # 真实浏览器逐屏截图
sc_manual action=insert-atlas docx=... atlasDir=...
sc_manual action=check-figs docx=... # 图题数 == 图片数
sc_audit action=four-way projectRoot=... sourceDir=...
交付前可专门跑四处审计：
sc_audit action=four-way projectRoot=... sourceDir=...
可定制配置¶
修改 cordis.patch.yml 里本插件的 config 段即可，热生效，无需重启。常用项如下：
| 配置 | 作用 |
|---|---|
source.includeExt / excludeDirs |
送审源程序的收录范围（多语言项目靠它界定） |
skills.enabledSkills / injectToolGuide |
只启用部分技能 / 是否注入工具指引 |
tools.* |
逐个开关 8 个工具 |
pipeline.manifestPath |
自定义阶段清单 YAML |
pipeline.commands / recordEvidence |
命令与证据记录开关 |
security.pathGuard.allowlist |
允许工具访问工作区外的目录 |
runtime.* |
两条 Python 链的路径与超时 |
diagnostics.bootLog |
启动自诊断日志开关 |
适用场景与注意¶
适合谁：在 DSH 中系统化产出软著交付物、且需要可重复校验四处数字与图集/说明书一致性的团队或个人。
技能资产与分发：assets/skills/ 下四个技能包的 SKILL.md 均标记 agent_created: true，且无作者署名与许可证。若你不是这些内容著作权人，公开分发可能构成再分发他人作品。不确定归属时，可按 README 建议只带框架发布——从 npm 包中移除 assets/skills/，自行放入合法技能包；插件工具与编排不依赖具体技能正文。
生态说明：DSH 理念是「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系，本文不将其描述为官方应用商店。
仓库测试入口：node test/run-all.mjs（README 称 13 个 harness / 639 项断言，含路径守卫、解析器端到端、33 个 action 可调用性等）。
结尾¶
dsh-skill-softcopyright 把软著交付收成 10 阶段门禁流水线，并把四处口径一致做成可执行的 sc_audit 能力，适合在 DSH 里按步确认、减少 silent mismatch。
- 社区目录：https://www.skillhub.cn/plugins/shay-Ckm/dsh-skill-softcopyright
- 源码与中文详文档：https://github.com/shay-Ckm/dsh-skill-softcopyright（README.zh.md）
