gba-mep-docx-toc
DeepSeek Harness bundle，注册一个 Word 目录技能：仅使用 Python 标准库，将真实的目录字段插入现有的 .docx 文件，支持分级缩进、点引导符、右对齐页码和 _Toc 书签。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gba-mep/docx-toc#c38be1719b88aca02739041b3244aabd19fab174Gba Mep Docx Toc 以 gba-mep-docx-toc 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness (dsh) bundle that registers one skill: insert a real Word table of contents into an existing .docx.
The skill writes a genuine TOC field with _Toc bookmarks straight into word/document.xml — graded indent per heading level, dot leaders, right-aligned page numbers — using only the Python standard library. It does not need Microsoft Word, LibreOffice, COM, or any third-party package.
dsh plugin --profile web add gba-mep-docx-toc
This repository is also installable straight from source through pnpm's GitHub spec, and it is listed in the awesome-dsh-plugin catalog, so dsh-market can install it with one click.
After installing, restart dsh web once so the bundle layer is composed.
Given a .docx whose headings use the Heading 1–Heading 9 styles (or carry w:outlineLvl):
_Toc… bookmarks so every entry is clickable,TOC \o "1-3" \h \z \u field with one entry per heading — hyperlink anchor → title text → right-aligned tab with dot leader → PAGEREF field,100 and level 3 by 200 character units,word/document.xml and copies every other part of the package byte for byte,verify (entry count = bookmark count = PAGEREF count).skills service — the entry imports nothing from the harness, so it works on any host publishing that contract (checked against DSH 0.2.0-rc.2).node:fs, node:path and node:url.python scripts/docx_toc.py build 输入.docx -o 输出.docx --title "目 录" --page-break both
python scripts/docx_toc.py verify 输出.docx
python scripts/docx_toc.py selftest
In a session you can also just describe the task — the skill's description is what the agent routes on.
Ctrl+A, then F9, choose Update page numbers only). Until then every entry reads 1.PAGEREF result depends on the Word section setup and is not guaranteed.TOC field gets a second one; delete the old one first.lib/index.js bundle entry — registers the skill via ctx.skills.register()
cordis.patch.yml loader patch: one insert row pointing at this package by name
SKILL.md skill body (frontmatter: name / description / whenToUse)
scripts/docx_toc.py the implementation (stdlib only)
references/OOXML-TOC.md notes on the OOXML table-of-contents field
tests/ offline tests: entry behaviour and installability contract
screenshots.json screenshots shown by plugin storefronts
node --test tests/
tests/entry.test.mjs runs apply() against a minimal context and asserts the registered fields, the resourceBase, and that the referenced files ship with the package — including a CRLF regression for the frontmatter parser. tests/bundle-contract.test.mjs asserts the installability contract: dsh.bundle declared, patch row naming the package, files whitelist complete, entry importing only node: builtins.
MIT — see LICENSE.md.