插件中文备注（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 秒内会自动扫一次；也可以打开 设置 → 通用 → 插件中文备注 点「立即扫描」。
它怎么工作
- 读取当前 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 这类术语；句号断句、不换行；禁止营销词。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
No comments yet. Be the first to write one.