Skip to content
Back to search

make-ppt

SkillWorks with Claude CodeGitHub

生成、修改、合并 PowerPoint:照模板造新 PPT、改已有 PPTX(换文字/移页/删页/统一校徽/写备注/重编号)、几份素材合成一包、交付前结构校验与排版体检、无渲染器时的 PNG 预览;含教学示意图/电路图(原生形状绘制)拓扑自检清单与课程课件场景。纯 Python 直接操作 OOXML,不依赖 python-pptx / Office / 网络。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kongbai-lab--dsh-skill-make-ppt/badge.svg)](/listings/kongbai-lab--dsh-skill-make-ppt)

HTML

<a href="/listings/kongbai-lab--dsh-skill-make-ppt"><img src="/api/listings/kongbai-lab--dsh-skill-make-ppt/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- Python 3.10+。 - 把 `engine/` 放到任意位置即可;`build` / `edit` / `merge` / `check` / `read` / `units` 只用标准库。 - `preview.py` 的文字渲染需要可选依赖 `fontTools`(`pip install fonttools`) 和一个中文 TTF 字体;字体路径可用环境变量 `MAX_PPT_FONT` 指定。 - 把 `engine/` 加入 `sys.path` 后**平铺导入**(`import edit`),不要写 `from engine import edit`:`engine` 是常见包名,容易与别的项目撞名。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 248 lines
  1. ---
  2. name: make-ppt
  3. description: 生成、修改、合并 PowerPoint:照模板造新 PPT、改已有 PPTX(换文字/移页/删页/统一校徽/写备注/重编号)、几份素材合成一包、交付前结构校验与排版体检、无渲染器时的 PNG 预览;含教学示意图/电路图(原生形状绘制)拓扑自检清单与课程课件场景。纯 Python 直接操作 OOXML,不依赖 python-pptx / Office / 网络。
  4. whenToUse: 用户要给课程/报告/汇报做 PPT,或要改一份已有 .pptx,或说"照这个模板做一份""把这几份 PPT 合起来""PPT 里有叠字/断链/打不开/校徽重复""帮我检查一下这份 PPT"时。只做数据图(柱状/流程/时间轴)用 diagram,不做页面排版。
  5. ---
  6. # make-ppt:PPTX 生成 · 原位改造 · 交付前自检
  7. 三件事:**造新页**(照模板)、**改旧页**(原位改造)、**交付前查错**(结构 + 排版)。
  8. 全部能力由 `engine/` 下的模块提供:核心只依赖标准库,
  9. 不依赖 python-pptx / Office / 网络。
  10. ## 0. 先选路径
  11. | 任务 | 用什么 | 入口 |
  12. |---|---|---|
  13. | 照一份模板造新 PPT | `build.py` | `Template.from_pptx` + `DeckBuilder` |
  14. | 改已有 PPT:换字、移页、删页、复制页、统一校徽、写备注 | `edit.py` | `Editor` |
  15. | 把几份素材的页合成一个包(跨母版) | `merge.py` | `merge.merge` / `merge_many` |
  16. | 交付前查错(断链、单位、重复元素、溢出) | `check.py` | `check.check` |
  17. | 看见排版(PNG 渲染) | `preview.py` | `preview.render` |
  18. | 读现有文件的结构与文字 | `read.py` | `Deck.load` |
  19. | 只要数据图(柱/线/饼/流程/时间轴) | 不是本 skill | 用 `diagram` skill |
  20. **判断口诀**:原文件要保留、只换内容 → 改造(edit);要多份并一份 → 合并(merge);
  21. 从零/照模板排版 → 生成(build)。三者都要在最后跑一遍 check。
  22. ## 1. 三十秒上手
  23. ```python
  24. import sys
  25. E = "/path/to/make-ppt/engine"
  26. sys.path.insert(0, E)
  27. import units, read, edit, check, preview, merge, build
  28. ```
  29. **必须平铺导入**(`import edit`),不要写 `from engine import edit`:
  30. `engine` 是常见包名,容易与别的项目撞名。
  31. ```python
  32. # 读
  33. d = read.Deck.load("a.pptx")
  34. print(d.summary()) # 页数、每页形状/文字/图片/备注量
  35. # 改
  36. ed = edit.Editor.open("a.pptx")
  37. ed.set_text(2, contains="旧标题", text="新标题")
  38. ed.move_slide(5, 2)
  39. ed.set_notes(2, "讲稿…")
  40. ed.unify_element() # 顺带清掉"页面里重复的版式元素"(双图标)
  41. ed.save("b.pptx", verify="strict") # 交付用 strict:结构/单位/继承/布局全硬失败
  42. # 查
  43. rep = check.check("b.pptx")
  44. print(rep.as_text()) # ERROR 必须为 0;WARN 逐条看
  45. # 看
  46. pngs = preview.render("b.pptx", "out/preview", pages=[1, 2], width=1400)
  47. # 交付
  48. # 把 b.pptx 交给用户,或按你的发布方式上传
  49. ```
  50. 每个模块都有 `--self-test`,换环境后先跑一遍。**写法注意**:若宿主执行器不注入
  51. `__file__`(例如把源码交给 `exec`),engine 模块级的路径定位会报
  52. `NameError: name '__file__' is not defined`;用 `runpy.run_path` 可以正确设置
  53. `__file__`:
  54. ```python
  55. # 推荐:runpy 会正确设置 __file__
  56. import runpy, sys
  57. E = "/path/to/make-ppt/engine"
  58. sys.argv = ["check.py", "--self-test"]
  59. runpy.run_path(E + "/check.py", run_name="__main__")
  60. # 其它模块同理:sys.argv = ["units.py", "--self-test"]; runpy.run_path(E + "/units.py", run_name="__main__")
  61. ```
  62. ## 2. 三条铁律(全部来自 2026-10 的返工)
  63. **铁律一:单位只走 `units.py`。**
  64. `a:rPr/@sz` 是 1/100 pt(7.5pt = `"750"`);`a:spcPct/@val` 是 1/1000 %
  65. (100% = `"100000"`,写成 `"100"` 就是 0.1 倍行距,行与行直接叠在一起)。
  66. 生成用 `units.sz_of_pt / spc_pct_of_ratio`,解析用 `units.pt_of_sz / ratio_of_spc_pct`,
  67. 写完一页立刻 `units.guard_xml(xml)`。**任何模块不许自己写第二套常量。**
  68. **铁律二:改完必查,查出必看。**
  69. `check.py` 的 ERROR 清零才算结构可信;`check` 的 WARN 是估算,必须配合
  70. `preview.py` 渲染 + `read_image` 真看一眼。只看数字不看图,等于没看。
  71. **铁律三:原子写 + 先备份。**
  72. `save()` 写 `<dst>.tmp`,校验通过才 `os.replace`;改造前把原文件复制一份
  73. `<name>.bak.pptx`。生成器与修补器分离,不要让"重建"覆盖"手修"。
  74. 交付用 `save(dst, verify="strict")`(结构/单位/继承/布局全部硬失败);
  75. `verify=True` 只对结构/单位硬失败,用于"源文件本身就有内容缺陷"的场景。
  76. ## 3. 模块速查
  77. ### units.py
  78. ```python
  79. units.cm(2), units.pt_emu(12), units.inch(1) # → EMU
  80. units.sz_of_pt(12) # "1200"
  81. units.pt_of_sz("750") # 7.5
  82. units.spc_pct_of_ratio(1.0) # "100000"
  83. units.text_height_emu("一段中文", 框宽EMU, 14, spacing_ratio=1.0) # 保守 1.5 倍行高
  84. units.guard_xml(xml, "slide3") # 返回问题列表
  85. units.assert_sz / assert_spc_pct / assert_canvas
  86. ```
  87. ### read.py
  88. `Deck.load(path)` → `deck.slides[i]`(`Slide.index` 从 1 起,列表下标从 0 起)、
  89. `slide.shapes`(页面自身元素)、`slide.inherited`(**版式/母版上的固定元素**,
  90. 查"双图标"就看这里)、`shape.paras/runs`、`slide.notes`。
  91. ### edit.py(原位改造)
  92. `set_text` / `replace_text` / `move_slide` / `delete_slide` / `duplicate_slide` /
  93. `set_notes` / `unify_element` / `fit_images` / `renumber_superscripts` /
  94. `save(dst, verify="strict")` / `diff(other)`。详见 `refs/edit-ops.md`。
  95. ### build.py(照模板生成)
  96. ```python
  97. tpl = build.Template.from_pptx("模板.pptx")
  98. b = build.DeckBuilder(tpl)
  99. n = b.add_slide(layout="内容页") # 版式名或序号;模板没有名字就用序号
  100. b.text(n, units.cm(2), units.cm(3), units.cm(20), units.cm(2), "标题", pt=28, bold=True)
  101. b.rect(n, units.cm(2), units.cm(6), units.cm(10), units.cm(3), fill="F5F7FA")
  102. b.image(n, "图.png", units.cm(22), units.cm(6), units.cm(9), units.cm(6)) # contain,不拉伸
  103. b.page_numbers(True) # 右下角页码(字段,放映按实际页序)
  104. b.set_notes(n, "讲稿…")
  105. b.save("out.pptx") # 写入前逐页 guard_xml
  106. ```
  107. 模板的母版、版式、主题、字体、版式里的图片全部继承;新页形状用绝对坐标,
  108. 不走占位符(避免 lstStyle 继承的连锁问题)。
  109. ### merge.py(跨母版合并)
  110. ```python
  111. merge.merge("目标.pptx", "素材.pptx", "输出.pptx", pages=[3, 4, 5])
  112. merge.merge_many("目标.pptx", [("a.pptx", None), ("b.pptx", [2, 3])], "输出.pptx")
  113. ```
  114. 深度收集依赖 → 重编号 → 重写 rels 与内容类型 → 追加页序。
  115. 丢弃 `ppt/tags`(同时删 slide 里的 `custDataLst`,否则断链)。
  116. ### check.py(交付前校验)
  117. ```python
  118. rep = check.check("a.pptx") # level="all"
  119. rep.ok / rep.errors / rep.warnings / rep.stats
  120. print(rep.as_text())
  121. ```
  122. 四类检查:结构(XML/断链/内容类型/页序)、单位(guard_xml)、继承(版式与页面
  123. 重复元素 = 双图标)、排版(越界/溢出/文字相交/图片拉伸)。
  124. ERROR = 打开一定异常或量级一定错;WARN = 估算,必须带"估算值 vs 阈值"数字。
  125. ### preview.py(无渲染器时看图)
  126. ```python
  127. pngs = preview.render("a.pptx", "out/preview", pages=None, width=1400)
  128. preview.contact_sheet(pngs, "out/overview.png", cols=2)
  129. ```
  130. PNG 能解码;JPEG 画等比占位框并标注尺寸(不依赖 PIL,不硬解 JPEG)。
  131. **定位问题是够用的,最终版面以 WPS 打开为准。**
  132. ## 4. 标准流程(改一份已有 PPT)
  133. 1. **读**:`read.Deck.load`,把 `summary()` 和每页标题列出来,确认页序与目标页;
  134. 2. **备份**:`cp a.pptx a.bak.pptx`;
  135. 3. **列操作**:把要改的页/元素/新文字写成清单(页号 + 元素名 + 新值),一次改完;
  136. 4. **改**:`Editor` 逐个操作,`save(dst, verify="strict")`;
  137. 5. **查**:`check.check(dst)`,ERROR 清零;WARN 逐条判断要不要动;
  138. 6. **看**:`preview.render` 出图,`read_image` 抽查首页、最密的一页、最满的一页;
  139. 7. **交付**:`publish` 到下载目录 + `present`。
  140. 全量回归(换环境/改过 engine 后先跑;八项:units / read / build / merge / edit / check / preview / end2end)。
  141. 示例语料可选:设置环境变量 `MAKEPPT_CORPUS` 指向语料目录,文件不齐时会打印 SKIP:
  142. ```python
  143. import runpy, sys
  144. sys.argv = ["run_all.py"] # 只跑单元自测传 ["run_all.py", "--quick"]
  145. runpy.run_path("/path/to/make-ppt/tests/run_all.py", run_name="__main__")
  146. ```
  147. ## 4b. 教学示意图 / 电路图(用原生形状画,可编辑)
  148. 教学示意图——尤其**电路图**——不要用 `diagram` 出图凑,也不要用图片:用 `build.py` 的**原生形状**画,用户/同事能在 WPS 里直接拖动修改。
  149. 可用图元(2026-11-07 实测):`b.line(n, x1, y1, x2, y2, color=, width_pt=)` 画任意两点线段(导线,可斜线);`b.rect(n, x, y, w, h, fill=, line=, geom=)` 的 `geom` 直通 OOXML `prstGeom`——`"rect"` / `"ellipse"` / `"triangle"` / `"rightArrow"` / `"roundRect"` 都可用;`b.text` 写标号。**没有箭头端(`headEnd/tailEnd`)支持**,箭头用 `triangle` 拼,或干脆不画箭头(变阻器用四接线柱画法已够)。
  150. **固定符号库(约定俗成,别自创画法)**:
  151. | 元件 | 画法约定 |
  152. |---|---|
  153. | 电源(电池组) | 长短线成对:**长线为正极、画在上/左**;多节串联重复该对 |
  154. | 开关 | **串在干路**(除非题意就是支路开关);断开状态画成抬起的斜线 |
  155. | 电流表 | **串联**接入被测支路,圈内写 A;量程标在旁边 |
  156. | 电压表 | **并联**在被测元件两端,圈内写 V |
  157. | 滑动变阻器 | **四个接线柱画全**(上下各两),注清实际接入的是"一上一下"哪两个柱 |
  158. **拓扑自检清单(必须逐条打勾,不是"看一眼")**:
  159. 1. 每条导线的**两端都落在符号端点上**(不悬空、不越过端点);
  160. 2. 不存在**无元件的闭合回路**(= 短路);电源两极不经负载直接相连更是硬错;
  161. 3. **并联母线不得画成闭合矩形**(矩形四边都连就是短路环);
  162. 4. 开关在**干路还是支路**符合题意,且与文字描述一致;
  163. 5. 电表接入方式(电流表串联 / 电压表并联)与量程正确、正负接线柱方向对;
  164. 6. 文字不压图形/导线,元件标号(R1、E、K)齐全。
  165. **结论以"节点-边表"为准**:先在代码里列 `节点 → 边(元件)` 表,再照表画;检查也照表查。`preview` + `read_image` **只能看排版(叠字/出界/美观),看不出电气错误**——导线连错、短路环、电表接反在图上看不出来(本轮电路图**返工 6 轮**的教训)。改完必须回到节点-边表逐条复核 + 上面 6 条打勾,再交付。
  166. ## 4c. 课程课件(16:9 教学 PPT)
  167. - **画布 16:9 = 33.87 × 19.05 cm**(12192000 × 6858000 EMU)。画布由**模板**决定:`build.Template.from_pptx(模板)` 继承模板的 `sldSz`,不要手改画布;选模板前先验证:
  168. ```python
  169. d = read.Deck.load("模板.pptx")
  170. print(d.summary()["canvas_cm"]) # 16:9 应为 [33.87, 19.05]
  171. ```
  172. - **公式**:课件页不经过 md2docx、没有 OMML 转换,**禁止把 LaTeX 源码(`$...$`、`\frac`、`\alpha`)留在页面上**,会原样显示。用普通文本 + Unicode 数学符号:`α β γ Δ Σ ∫ × ≥ ≈ ± ° ½`。注意 `DeckBuilder.text()` 目前**没有 italic 参数**(2026-11-07 实测),需要变量斜体时用后处理给对应 `a:r` 补 `<a:i val="1"/>`(改 slideN.xml,同 md2docx「后处理」章的原子替换做法);复杂公式建议先 md2docx 生成 docx 再截图嵌图(保真、可读),备注里写明公式来源。
  173. - **教师备注**:每页 `b.set_notes(n, "讲稿要点…")` 必写(含时间提示、提问点、易错点);交付前 `read.Deck.load` 抽查备注都在。
  174. - **页数节奏**:**25–30 页 / 2 小时课**(含封面、目录、小结、练习);每 5–7 页一个"停顿点"(小结/提问页),一页一个知识点,别把一节课塞进两页。
  175. - **交付前**:`check.check` ERROR=0 + `preview.render` 抽看封面/最密页/公式页 + `read_image` 确认公式没显示成 `\frac{}{}`。
  176. ## 5. 常见坑
  177. | 现象 | 根因 | 处理 |
  178. |---|---|---|
  179. | 行与行叠在一起 | `spcPct` 写成 100(应 100000) | `units.guard_xml` 会报;全包扫一遍 |
  180. | 自查报 0 问题但 WPS 有病 | 自查脚本自己解析单位错了 | 只用 `units.pt_of_sz`,禁止各写各的 |
  181. | 右下角两个校徽 | 版式里自带一个,页面里又放一个 | 图标只在版式定义一次;`check` 的 inherit 项会报 |
  182. | 文字溢出框外 | 用框高当文字高度 | 用 `units.text_height_emu`(1.5 倍保守) |
  183. | 元素跑出画布 | 正则把 y 拼进 cx | 保存前后各跑一次 `guard_xml` |
  184. | 图片被拉长/压扁 | 框尺寸与像素纵横比不一致 | `check` 的 layout 项报 IMAGE_STRETCH;`edit.fit_images()` 按像素比例修正(支持裁切) |
  185. | 修好的页被重建覆盖 | 生成器与修补器混在一起 | 生成到 tmp → 校验 → 原子替换 |
  186. | 合并后 WPS 打不开 | rels 断链 / 缺 Content_Types | `merge` 保存前有路径断言,仍要跑 `check` |
  187. | 讲稿写进备注但放映看不到 | 没建 notesMaster | `build`/`edit` 的 set_notes 会补 notesMaster |
  188. ## 6. 参考文档
  189. - `refs/ir.md`:IR 与模块接口契约(改接口时必须同步改它)
  190. - `refs/units.md`:OOXML 单位速查与六个坑
  191. - `refs/edit-ops.md`:改造操作手册(每个操作改哪些部件)
  192. - `refs/checklist.md`:交付前 12 项检查
  193. ## 7. 依赖与限制
  194. - 依赖:Python 3.10+;`build` / `edit` / `merge` / `check` / `read` / `units`
  195. 仅用标准库。
  196. - `preview.py` 的 PNG 文字渲染需要可选依赖 `fontTools`(`pip install fonttools`)
  197. 和一个中文 TTF 字体:默认使用 `/system/fonts/FZHeiT-SC-Regular.ttf`
  198. (HarmonyOS 等系统自带),其它环境用环境变量 `MAX_PPT_FONT` 指定
  199. (常规/粗体用 `os.pathsep` 分隔两个路径)。
  200. - 不依赖 LibreOffice / WPS CLI / PIL / numpy / python-pptx,不联网。
  201. 渲染是近似实现,精度以"能定位问题"为准。
  202. - 不支持:SmartArt、动画时间轴、渐变、3D、图表对象(graphicFrame 只按占位处理)。
README.md · README · 124 lines
  1. # make-ppt
  2. 纯 Python 直接读写 PPTX(OOXML)的工具包:**照模板造新页**、**原位改造已有文件**、
  3. **交付前查错**。核心模块只用标准库,不依赖 python-pptx / Office / 网络。
  4. ## 三件事
  5. | 任务 | 入口 | 说明 |
  6. |---|---|---|
  7. | 造页:照一份模板生成新 PPT | `engine/build.py` | `Template.from_pptx` + `DeckBuilder`,继承模板的母版、版式、主题与字体 |
  8. | 改页:换字、移页、删页、复制页、统一图标、写备注 | `engine/edit.py` | `Editor`,只改局部字节,原子写 |
  9. | 查错:断链、单位、重复元素、越界/溢出 | `engine/check.py` | `check.check`,ERROR / WARN 分级 |
  10. | 合并:把几份素材的页并成一包 | `engine/merge.py` | 跨母版,自动重编号 rels 与内容类型 |
  11. | 预览:没有 Office 时看排版 | `engine/preview.py` | PPTX → PNG 近似渲染 |
  12. | 读取:看现有文件的结构与文字 | `engine/read.py` | `Deck.load` |
  13. 判断口诀:原文件要保留、只换内容 → `edit`;多份并一份 → `merge`;
  14. 从零/照模板排版 → `build`。三者最后都跑一遍 `check`。
  15. ## 目录结构
  16. ```
  17. make-ppt/
  18. ├── SKILL.md # 面向 AI agent 的完整说明书
  19. ├── README.md
  20. ├── LICENSE
  21. ├── engine/
  22. │ ├── units.py # OOXML 单位唯一真源
  23. │ ├── read.py # pptx → 只读 IR
  24. │ ├── build.py # 模板生成
  25. │ ├── edit.py # 原位改造
  26. │ ├── merge.py # 跨母版合并
  27. │ ├── check.py # 结构/单位/继承/布局校验
  28. │ └── preview.py # 近似 PNG 渲染
  29. ├── refs/
  30. │ ├── ir.md # 模块接口契约
  31. │ ├── units.md # 单位速查与六个坑
  32. │ ├── edit-ops.md # 改造操作手册
  33. │ └── checklist.md # 交付前 12 项检查
  34. └── tests/
  35. └── run_all.py # 回归测试
  36. ```
  37. ## 安装
  38. - Python 3.10+。
  39. - 把 `engine/` 放到任意位置即可;`build` / `edit` / `merge` / `check` / `read` /
  40. `units` 只用标准库。
  41. - `preview.py` 的文字渲染需要可选依赖 `fontTools`(`pip install fonttools`)
  42. 和一个中文 TTF 字体;字体路径可用环境变量 `MAX_PPT_FONT` 指定。
  43. - 把 `engine/` 加入 `sys.path` 后**平铺导入**(`import edit`),不要写
  44. `from engine import edit`:`engine` 是常见包名,容易与别的项目撞名。
  45. ## 最小示例(照模板造页)
  46. ```python
  47. import sys
  48. sys.path.insert(0, "/path/to/make-ppt/engine")
  49. import units, build
  50. tpl = build.Template.from_pptx("模板.pptx")
  51. b = build.DeckBuilder(tpl)
  52. n = b.add_slide(layout="内容页") # 版式名或序号;模板没有名字就用序号
  53. b.text(n, units.cm(2), units.cm(3), units.cm(20), units.cm(2), "标题", pt=28, bold=True)
  54. b.rect(n, units.cm(2), units.cm(6), units.cm(10), units.cm(3), fill="F5F7FA")
  55. b.image(n, "图.png", units.cm(22), units.cm(6), units.cm(9), units.cm(6)) # contain,不拉伸
  56. b.page_numbers(True) # 右下角页码(字段,放映按实际页序)
  57. b.set_notes(n, "讲稿…")
  58. b.save("out.pptx") # 写入前逐页 guard_xml
  59. ```
  60. 改已有文件与交付前查错:
  61. ```python
  62. import edit, check
  63. ed = edit.Editor.open("a.pptx")
  64. ed.set_text(2, contains="旧标题", text="新标题")
  65. ed.set_notes(2, "讲稿…")
  66. ed.save("b.pptx", verify="strict") # 结构/单位/继承/布局全硬失败
  67. rep = check.check("b.pptx")
  68. print(rep.as_text()) # ERROR 必须为 0;WARN 逐条看
  69. ```
  70. ## 测试
  71. ```bash
  72. python tests/run_all.py # 全量
  73. python tests/run_all.py --quick # 只跑单元自测
  74. ```
  75. 示例语料不随仓库分发。把 `deck-a.pptx`、`deck-b.pptx`、`deck-merged.pptx`
  76. 放进 `tests/corpus/`,或设置环境变量 `MAKEPPT_CORPUS` 指向语料目录(也可指向
  77. 其中一份 `.pptx`)。未设置或文件不齐时,测试会打印 `SKIP`,只跑不依赖语料的
  78. `units` 与 `build` 无模板分支,不会报错。
  79. ## 限制
  80. - `preview.py` 是近似渲染:不支持渐变、阴影、旋转、艺术字、JPEG 解码、EMF/WMF,
  81. 也不画版式里的占位提示框。它能定位叠字、出界、图片拉伸等问题,最终版面以
  82. PowerPoint / WPS 打开为准。
  83. - 不支持 SmartArt、动画时间轴、3D、图表对象(`graphicFrame` 只按占位处理)。
  84. - 没有渲染器依赖:不调用 LibreOffice / WPS CLI / PIL / numpy。
  85. - 示例语料是可选的外部文件,仓库不自带 `.pptx`。
  86. ## 运行环境(DSHM / DSH)
  87. - **DSHM(鸿蒙端侧)**:DeepSeek Harness 的鸿蒙发行版,数据目录位于应用沙箱内,本文记为 `$DSH_HOME`。把本技能放到 `$DSH_HOME/skills/<name>.md`(单文件)或 `$DSH_HOME/skills/<name>/SKILL.md`(带 `refs/`、`scripts/` 等附属目录),新开会话后生效。
  88. - **DSH 桌面版(macOS / Windows / Linux)**:技能目录按对应版本文档(通常为 `~/.dsh/skills/`),结构与 DSHM 相同;区别只是 `$DSH_HOME` 不在鸿蒙应用沙箱内。
  89. - 两种环境的 `SKILL.md` 完全通用;**不要**把 DSHM 沙箱内的绝对路径写进配置或脚本,需要可移植路径时用环境变量。
  90. ## 版权、第三方依赖与商标
  91. - **本项目**:MIT,见 [LICENSE](LICENSE)。示例图、示例数据由本项目程序生成,随 MIT 许可发布。
  92. - **第三方依赖**:默认只用 Python 标准库(PSF License);`preview.py` 的文字渲染可选依赖 `fontTools`(MIT)。
  93. - **字体不随包分发**:程序读取系统已安装字体。Noto 系列为 SIL OFL 1.1;DejaVu 系列为 Bitstream Vera 许可;Windows / macOS 商业字体需你在本机自行取得授权,仓库不附带任何字体文件。
  94. - **商标与归属**:DSH、DSHM、DeepSeek Harness 是其各自所有者的产品名或商标;本项目是独立的第三方开源工具,与官方无隶属、赞助或背书关系。GitHub 为其所有者商标。
  95. - **代码来源**:本仓库代码为原创实现;如果后续引入第三方代码,会在此列出其来源与许可。
  96. ## 许可
  97. MIT,见 [LICENSE](LICENSE)。Copyright (c) 2026 KongBai-lab。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.