nuolingmo/dsh-market-notes

插件中文备注（Market Notes）

给 dshmarket 里还没有备注的插件自动写一句人话中文说明，让你在插件卡片上扫一眼就知道它是干嘛的、什么时候用得上。已有备注（尤其是你手写的）一律不动，只填空。

⚠️ 前置条件（必读）：它不是独立插件

本插件是 dshmarket（插件市场本体）的扩展，两者必须在同一个 DSH profile 里，否则它没有任何作用：

• 它没有自己的数据存储、没有独立页面，也不翻译网页、聊天或任意文本；
• 它读取的是 dshmarket 的「已安装插件列表」和「备注数据」，写备注也走 dshmarket 的本机接口；
• 没有安装或没有启用 dshmarket 时：本插件可以装上，但扫描会提示「dshmarket 未安装或未运行」，不会写任何东西；
• 它只做一件事：给 dshmarket 里已安装的插件补一句中文备注，显示在市场的插件卡片上。

先装好并启用 dshmarket，再装本插件；生成备注还需要在 DSH 里配置好可用的默认模型。

GitHub 仓库：https://github.com/nuolingmo/dsh-market-notes · 安装包：https://github.com/nuolingmo/dsh-market-notes/releases

安装

在 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 秒内会自动扫一次；也可以打开 设置 → 通用 → 插件中文备注 点「立即扫描」。

它怎么工作

1. 读取当前 profile 的依赖列表，只挑 dshmarket 里还没有备注的插件；
2. 从本地读取每个插件的 package.json 描述和 README*.md 第一段（缺 README 用描述，都缺则跳过并记录）；
3. 把待补插件按 10 个一批分块，每批一次模型调用，要求返回 JSON 数组（仅对不合规项追加一次修复调用）；单批失败不会拖垮其他批次；
4. 通过 dshmarket 自己的 POST /dsh-market/note 接口逐条写回；每个包写入前重新读一次备注，运行中被你手写的备注不会被覆盖；
5. 单个插件失败不影响其他插件，最后汇总生成/跳过/失败数量。

所有插件资料来自本地磁盘，不抓任何目录站点。

重新生成 AI 备注

AI 写的备注带 🤖 前缀。如果某条 AI 备注质量不满意，可以在 设置 → 通用 → 插件中文备注 里点 「重新生成 AI 备注」（或请求 POST /dsh-market-notes/scan 时带上 {"force":"ai"}）：

• 只重写以 🤖 开头的备注；
• 你手写的备注（没有 🤖）在默认模式和重新生成模式下都不会被改动；
• 默认的「立即扫描」仍然只补空白备注。

备注标准

50–120 个汉字（硬上限 200，市场会截断）；前 20 字必须能独立看懂；结构是「它是干什么的 → 你什么时候用得上 →（可选）要注意什么」；用第二人称、说人话，不出现英文包名和 API/peer/bundle 这类术语；句号断句、不换行；禁止营销词。AI 生成的备注带 🤖 前缀，便于和你手写的内容区分。

数据与隐私

• 本插件只读本机 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，脚本会把 cordis.patch.yml 里的 name 对齐 package.json 并解包校验
• 临时报告：%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