dsh-ruankao-essay
软考系统分析师论文助手：题库查询 + 10 段式写作与 Word 交付（两个技能：ruankao-essay-writing、ruankao-essay-bank）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Zm886/dsh-ruankao-essay#5c6ba2059752c384739b4d132594409824cca982Ruankao Essay 以 dsh-ruankao-essay 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把「软考系统分析师论文」的题库、写作规范与交付流程打包成 DSH 插件，装上以后在任意会话里都能直接调用；另附一个 Web UI 里的题库速查面板。
dsh-ruankao-essayruankao-essayruankao-essay-writing（写作／改写总纲）、ruankao-essay-bank（题库与写作规范）、ruankao-essay-review（逐段自评与改写建议）client.js，在 conversation.composer.dock 注册「题库速查」面板写软考系分论文的痛点不是「不会写」，而是每次都要重新回忆：这篇题目的子题目有哪几块、该配哪个项目、理论点怎么写全、字数与结构怎么卡、成稿怎么变成 Word、交稿前怎么自查。本插件把这些固化成三个技能：
| 技能 | 干什么 | 何时加载 |
|---|---|---|
ruankao-essay-bank | 查：真题表（2016—2026）、按题型的理论骨架、写作规格与扣分雷区 | 拿到题目先查它 |
ruankao-essay-writing | 写：10 段式结构、字数口径、语气禁忌、子题目回应规则、Word 交付脚本 | 动笔与交付时 |
ruankao-essay-review | 评：机械项检查（段数／字数／禁写项）＋逐段体检＋逐条改写建议 | 交稿前自评 |
两者配合的完整链路：查题 → 定骨架 → 配实例 → 成稿 → 自检 → 生成 .doc。
此外，插件在 DSH Web UI 的对话输入区上方提供一个题库速查面板：点开后可切换「历年真题 / 题型骨架 / 写作规格」三个页签，用于在写之前快速定位题目与要点（内容与仓库内的公开版索引一致）。
在安装了本插件的 DSH 里让 Agent 调用 plugin_manager：
// action: install_bundle, target: 本目录绝对路径
{ "action": "install_bundle", "target": "D:\\project\\deeepseek\\dsh-plugins\\dsh-ruankao-essay" }
也可以在 DSH 桌面端的 插件管理 / Plugin Manager 里选择「安装本地 bundle」，指向本目录。安装后插件会出现在插件清单与设置页，行 id 为 ruankao-essay；改动用 HMR 生效，替换已装包需重启 DSH。
注意：Agent 每次调用
plugin_manager都需要授权；本插件目录请保留在磁盘上（不要打进app.asar），技能里的 references 需要模型直接读文件。
技能目录就是标准布局，直接拷到技能根目录即可被自动发现：
# 只对本项目生效
New-Item -ItemType Directory -Force -Path "D:\project\deeepseek\.dsh\skills" | Out-Null
Copy-Item "D:\project\deeepseek\dsh-plugins\dsh-ruankao-essay\assets\*" "D:\project\deeepseek\.dsh\skills" -Recurse
# 或对所有项目生效
Copy-Item "D:\project\deeepseek\dsh-plugins\dsh-ruankao-essay\assets\*" "$env:USERPROFILE\.dsh\skills" -Recurse
两种方式的资产完全一致：SKILL.md 带 YAML frontmatter（供文件系统发现），插件提供者读取时会自动剥掉 frontmatter。
本插件不发布到 npm：
package.json保持private: true，防止误发布；请用方式 A（本地 bundle）或方式 B（技能目录），或直接克隆本仓库。这样做的原因：npm 打包只看
package.json的files白名单，不看.gitignore，一旦白名单写成目录就可能把本机资料一起发出去；仓库分发没有这条通道。
dsh-ruankao-essay/
├─ package.json # dsh.bundle.patch、meta、icon、files、repository
├─ cordis.patch.yml # 向 profile 插入 id: ruankao-essay 的 Host 插件行
├─ index.js # Cordis 插件：ctx.skills.registerProvider(...) 注册两个技能
├─ client.js # Client 半：在 Web UI 注册题库速查面板
├─ icon.svg # 插件卡片图标
├─ locale/{zh,en}.json # 插件卡片标题与描述
├─ CHANGELOG.md # 版本变更记录
├─ SECURITY.md # 安全策略与漏洞报告方式
├─ CONTRIBUTING.md # 贡献指南与内容边界
├─ scripts/
│ └─ verify-manifest.mjs # 清单／技能资产／脚本 BOM／Client 半 校验
├─ .github/workflows/
│ ├─ ci.yml # CI：Linux 校验 + Windows 端到端测试
│ └─ github-release.yml # 打 tag 时只创建 GitHub Release（不发 npm）
├─ tests/
│ ├─ fixtures/sample-essay.md # 公开的 10 段测试样例
│ └─ out/ # 测试产物（已 gitignore）
└─ assets/
├─ ruankao-essay-writing/ # 技能一：写
│ ├─ SKILL.md
│ ├─ references/writing-rules.md
│ └─ scripts/make-essay-doc.ps1 # Markdown → Word 可打开的 .doc（含段数与字数自检）
├─ ruankao-essay-review/ # 技能三：评
│ └─ SKILL.md # 逐段体检表＋五类扣分＋输出格式
└─ ruankao-essay-bank/ # 技能二：查
├─ SKILL.md
└─ references/topic-index-lite.md
脚本放在写作技能目录内，因此无论是「插件资源基」还是「技能目录」安装，<skill-directory>/scripts/make-essay-doc.ps1 都能正确定位。
会话里出现「写软考系分论文 / 这个论文题目怎么写 / 押题」之类需求时，Agent 会加载技能，然后：
references/topic-index-lite.md 里定位题目（真题题名、通用理论骨架、写作规格、可选项目）；若本地 references/ 下另有参考资料，优先按需读取；pwsh -File——本机 shell 里没有 pwsh 命令）：& "<skill-directory>\scripts\make-essay-doc.ps1" -MdPath "D:\out\论微服务架构及其应用.md"
# 段落数: 10 含标点字数: 2534 纯汉字: 2116
# 已生成: D:\out\论微服务架构及其应用.doc
脚本会剥掉 ** 粗体标记并统计真实字数，段数应为 10、含标点字数落在 2500~2800。
assets/ruankao-essay-bank/references/topic-index-lite.md 追加真题题名与理论骨架；本地另有参考资料时同步维护即可。assets/ 下新建 <kebab-case-name>/SKILL.md（带 frontmatter），再到 index.js 的 SKILLS 数组登记一条，最后跑 node scripts/verify-manifest.mjs 确认资产齐全。assets/ruankao-essay-writing/scripts/make-essay-doc.ps1 里的 @page／字体／字号／行距都可调；中文标点务必用 [char] 码点构造，脚本必须保存为带 BOM 的 UTF-8（Windows PowerShell 5.1 下无 BOM 会按 ANSI 误读中文，CI 会拦截）。node --check index.js
node --check client.js
node scripts/verify-manifest.mjs
# 校验清单字段、加载器补丁、技能资产与 frontmatter、脚本 BOM、Client 半
它检查 9 项：package.json 的 dsh.bundle.patch／manifestVersion／meta／icon／main 与依赖声明、cordis.patch.yml 的 id 与包名、每个技能都有对应 assets/<name>/SKILL.md 且 frontmatter 的 name 与目录一致、生成脚本存在且带 UTF-8 BOM、dsh.client 声明与 client.js 的模块 id／槽位一致、必备文件齐全、references/ 下只有公开文件被跟踪、以及发布白名单只包含仓库已跟踪的文件（防止把本机资料打包出去）。
& .\assets\ruankao-essay-writing\scripts\make-essay-doc.ps1 -MdPath .\tests\fixtures\sample-essay.md -OutPath .\tests\out\sample.doc
# 段落数: 10 含标点字数: 1012 纯汉字: 870
.github/workflows/ci.yml 在 push／PR 时跑两个作业：
| 作业 | 运行环境 | 内容 |
|---|---|---|
| 清单与技能资产校验 | ubuntu-latest | node --check index.js、解析 JSON、跑 verify-manifest.mjs、确认 references/ 下只有公开文件被跟踪 |
| 生成脚本端到端测试 | windows-latest | 校验脚本保留 UTF-8 BOM，用 tests/fixtures/sample-essay.md 生成 .doc，断言段数为 10、正文无直引号且有中文引号 |
另有 .github/workflows/github-release.yml：推送 v* tag 时先跑校验，再创建一个 GitHub Release（仅源码快照，不发布到 npm）。
skill 工具按名字加载 ruankao-essay-bank，能返回目录即成功；或在设置页插件清单里看到「软考系分论文助手」。templates/decoration 起步）。make-essay-doc.ps1 在 Windows PowerShell 5.1 与 PowerShell 7 上均可用；脚本必须保持带 BOM 的 UTF-8，CI 会拦截丢失 BOM 的提交。git clone https://github.com/Zm886/dsh-ruankao-essay.git
# 然后按「二、安装」的方式 A 或方式 B 安装
MIT（见 LICENSE）。仅供个人备考使用，请勿将仓库内容用于商业用途。