前言¶
DSH 的插件生态里，dshmarket 提供了插件市场和安装管理能力，但很多插件卡片上只有英文描述或空空如也。在已经安装了一大堆插件之后，想快速知道某个插件是干什么的、什么时候用得上，往往要打开多个 README 或去目录站翻页。本文介绍的插件就是针对这个场景：它不翻译任意文本，只给 dshmarket 里还没有中文备注的插件补一句人话说明，显示在市场的插件卡片上。
它是什么¶
dsh-market-notes 是一个扩展插件，依赖 dshmarket（插件市场本体）才能发挥作用。两者必须在同一个 DSH profile 里，否则它没有任何作用。它没有自己的数据存储，也不提供翻译、聊天等通用能力。它的职责是：读取当前 profile 已安装的插件列表，找出那些在 dshmarket 中还没有备注的项目，从本地读取它们的 package.json 描述和 README 第一段，生成一段 50–120 个汉字的中文备注，并通过 dshmarket 的本地接口写回。已有备注（尤其是你手写的）一律不动，只做补空。
安装与启用¶
在 DSH 插件页 → 安装插件，输入包名：
dsh-market-notes
或使用 CLI：
dsh plugin --profile web add dsh-market-notes
也可以从 GitHub 安装：下载 Release 中的 dsh-market-notes-1.0.1.tgz 到本地，在插件页安装框填路径；或填 Git 地址 git+https://github.com/nuolingmo/dsh-market-notes.git。
安装后 DSH 启动 30 秒内会自动扫一次；也可以打开 设置 → 通用 → 插件中文备注，点「立即扫描」。
它怎么工作¶
- 读取当前 profile 的依赖列表，只挑 dshmarket 里还没有备注的插件；
- 从本地读取每个插件的 package.json 描述和 README*.md 第一段（缺 README 用描述，都缺则跳过并记录）；
- 把待补插件按 10 个一批分块，每批一次模型调用，要求返回 JSON 数组；对不合规项追加一次修复调用；单批失败不会拖垮其他批次；
- 通过 dshmarket 的 POST /dsh-market/note 接口逐条写回；每个包写入前重新读一次备注，运行中被你手写的备注不会被覆盖；
- 单个插件失败不影响其他插件，最后汇总生成/跳过/失败数量。
所有插件资料来自本地磁盘，不抓任何目录站点。
重新生成 AI 备注¶
AI 写的备注带 🤖 前缀。如果某条 AI 备注质量不满意，可以在 设置 → 通用 → 插件中文备注 里点「重新生成 AI 备注」（或请求 POST /dsh-market-notes/scan 时带上 {"force":"ai"}）：
- 只重写以 🤖 开头的备注；
- 你手写的备注（没有 🤖）在默认模式和重新生成模式下都不会被改动；
- 默认的「立即扫描」仍然只补空白备注。
备注标准¶
- 50–120 个汉字（硬上限 200，市场会截断）；
- 前 20 字必须能独立看懂；
- 结构是「它是干什么的 → 你什么时候用得上 →（可选）要注意什么」；
- 用第二人称、说人话，不出现英文包名和 API/peer/bundle 这类术语；
- 句号断句、不换行；
- 禁止营销词。
数据与隐私¶
- 只读本机 profile 依赖、node_modules 里的插件描述和 README；
- 只调用本机 dshmarket 的接口写备注；
- 除把插件描述/README 发给你自己配置的模型用于生成备注外，不向任何外部服务器发送数据；
- 不收集遥测、不写日志到远端；
- 不包含任何账号、密钥或硬编码路径。
兼容性¶
- DSH：peerDependencies: @deepseek-ai/dsh ^0.2.1-rc.1（在 0.2.1-rc.2 上验证通过）；
- 平台：Web GUI（客户端半个区只在 Web 端加载；Host 半个区在带 webServer 的 profile 中工作）；
- 生成备注需要已配置可用的默认模型；断网/无模型时扫描会报错退出，不会写坏备注。
卸载¶
插件页关闭或卸载即可。已写入 dshmarket 的备注会保留（可在市场里手动清空）。
开发¶
- Host：index.js（扫描、分块模型调用、校验、写备注；force=ai 时只重写 AI 备注）
- Client：client/client.js（设置里的「立即扫描」和「重新生成 AI 备注」）
- 打包：node scripts/build-dist.mjs –out <目录> 生成 tgz/zip
- 临时报告：%TEMP%\dsh-market-notes\last-run.json、last-model-output.txt
- 接口：GET /dsh-market-notes/status、POST /dsh-market-notes/scan（body 或 query 支持 force=ai）；两个接口都校验 Origin，跨站请求返回 403
适用场景¶
- 你已经通过 dshmarket 安装了一批插件，但卡片上缺乏中文说明；
- 你希望用 AI 帮你快速补全中文备注，而不想一个个手动写；
- 你在意隐私，只希望数据在本地处理，不向外部服务器发送。
注意事项¶
- 本插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证；
- 它依赖 dshmarket 必须在同一 profile 中安装并运行，否则扫描会提示「dshmarket 未安装或未运行」；
- 生成备注需要配置好可用的默认模型，断网或无模型时扫描会报错退出。
小结¶
dsh-market-notes 把 AI 生成中文备注的能力集中到 dshmarket 的插件卡片上，帮你快速扫一眼就知道某个插件是干什么的、什么时候用得上。安装后它会自动扫描已有插件，只补空；你也可以在设置里手动触发「立即扫描」或「重新生成 AI 备注」。所有数据只在本机和 dshmarket 接口之间流转，不会向外发送。如果你正在用 dshmarket 管理一堆插件，这个插件能帮你把卡片变成一眼可读的中文说明。
链接¶
- 目录页：https://www.skillhub.cn/plugins/nuolingmo/dsh-market-notes
- GitHub：https://github.com/nuolingmo/dsh-market-notes
