docs(mcp): watchface transp/hier, NET_PIC uniqueness, analog pointers

BAILIAN_MCP_SUBMISSION_READY.md

@@ -1,42 +1,46 @@
 # 阿里云百炼（Model Studio）— MCP 接入说明
 
-百炼的 MCP 能力分散在 **MCP 广场**（挑选官方/已上架服务）与 **MCP 管理**（自定义部署）两处。以下为 **`mcp-divoom-lan`** 的推荐配置与文档索引。
+百炼的 MCP 能力分散在 **MCP 广场**（挑选官方/已上架服务）与 **MCP 管理**（自定义部署）两处。以下为 `**mcp-divoom-lan`** 的推荐配置与文档索引。
 
 ## 官方文档（建议收藏）
 
-| 主题 | 链接 |
-|------|------|
-| MCP 简介与计费 | [模型上下文协议（MCP）](https://help.aliyun.com/zh/model-studio/mcp-introduction) |
-| 官方 MCP 开通与智能体配置 | [官方 MCP 服务](https://help.aliyun.com/zh/model-studio/official-and-third-party-mcp) |
-| **自定义 MCP（脚本 npx / uvx、AI 网关、OpenAPI）** | [**自定义 MCP 服务**](https://help.aliyun.com/zh/model-studio/custom-mcp) |
-| 快速开始（广场开通示例） | [官方 MCP 服务快速入门](https://help.aliyun.com/zh/model-studio/mcp-quickstart) |
-| 外部调用 | [外部调用 MCP 服务](https://help.aliyun.com/zh/model-studio/mcp-external-calls) |
+
+| 主题                                      | 链接                                                                                |
+| --------------------------------------- | --------------------------------------------------------------------------------- |
+| MCP 简介与计费                               | [模型上下文协议（MCP）](https://help.aliyun.com/zh/model-studio/mcp-introduction)          |
+| 官方 MCP 开通与智能体配置                         | [官方 MCP 服务](https://help.aliyun.com/zh/model-studio/official-and-third-party-mcp) |
+| **自定义 MCP（脚本 npx / uvx、AI 网关、OpenAPI）** | **[自定义 MCP 服务](https://help.aliyun.com/zh/model-studio/custom-mcp)**              |
+| 快速开始（广场开通示例）                            | [官方 MCP 服务快速入门](https://help.aliyun.com/zh/model-studio/mcp-quickstart)           |
+| 外部调用                                    | [外部调用 MCP 服务](https://help.aliyun.com/zh/model-studio/mcp-external-calls)         |
+
 
 ## 控制台入口
 
 - **MCP 广场（市场）**：[百炼控制台 MCP](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market)  
-- **MCP 管理（创建自定义服务）**：[MCP 管理](https://bailian.console.aliyun.com/?tab=app#/mcp-manage)  
+- **MCP 管理（创建自定义服务）**：[MCP 管理](https://bailian.console.aliyun.com/?tab=app#/mcp-manage)
 
 说明：帮助中心写的是「在 **MCP 市场** 搜寻服务，以**自定义 MCP 服务**形式部署」——即多数第三方开源服务是 **你自己在 MCP 管理里创建**，而非一定有「对外开放上架到广场」的自助入口。若要把服务做成 **广场首页可检索的公开条目**，通常需 **阿里云运营/合作渠道**，以最新控制台与协议为准。
 
 ---
 
 ## 在百炼中创建「自定义 MCP」（脚本部署 · npx）
 
-适用于已发布到 npm、支持 **`npx -y <包名>`** 的 Node MCP（本仓库 **0.1.2+** 已配置 `bin`）。
+适用于已发布到 npm、支持 `**npx -y <包名>`** 的 Node MCP（本仓库 **0.1.2+** 已配置 `bin`）。
 
 ### 1. 进入创建流程
 
-1. 打开 [MCP 管理](https://bailian.console.aliyun.com/?tab=app#/mcp-manage)。  
-2. **创建 MCP 服务** → 选择 **使用脚本部署** → **部署服务**。  
+1. 打开 [MCP 管理](https://bailian.console.aliyun.com/?tab=app#/mcp-manage)。
+2. **创建 MCP 服务** → 选择 **使用脚本部署** → **部署服务**。
 
 ### 2. 表单建议填写
 
-| 配置项 | 建议值 |
-|--------|--------|
+
+| 配置项      | 建议值                                       |
+| -------- | ----------------------------------------- |
 | **服务名称** | `Divoom LAN Watchface` 或 `mcp-divoom-lan` |
-| **描述** | 见下 **「详细描述（控制台 ≤500 字）」**，可直接粘贴。 |
-| **安装方式** | **npx** |
+| **描述**   | 见下 **「详细描述（控制台 ≤500 字）」**，可直接粘贴。          |
+| **安装方式** | **npx**                                   |
+
 
 #### 详细描述（控制台 ≤500 字）
 
@@ -49,7 +53,7 @@ mcp-divoom-lan 是基于模型上下文协议（MCP）的 Divoom 局域网工具
 
 ### 3. MCP 服务配置（JSON）
 
-百炼控制台里 **NPX 配置** 常与 **高德等官方卡片** 相同：仅 `command` / `args` / `env`，**不带 `type`**。帮助中心 [自定义 MCP](https://help.aliyun.com/zh/model-studio/custom-mcp) 文档模板里则写有 **`"type": "stdio"`**。若一种格式校验失败，可换另一种。
+百炼控制台里 **NPX 配置** 常与 **高德等官方卡片** 相同：仅 `command` / `args` / `env`，**不带 `type`**。帮助中心 [自定义 MCP](https://help.aliyun.com/zh/model-studio/custom-mcp) 文档模板里则写有 `**"type": "stdio"**`。若一种格式校验失败，可换另一种。
 
 **A. 与控制台高德示例一致（推荐先试）**
 
@@ -111,7 +115,7 @@ mcp-divoom-lan 是基于模型上下文协议（MCP）的 Divoom 局域网工具
 - 百炼 **脚本部署**会将 MCP 跑在 **函数计算 FC** 等云端环境，**默认无法访问你家里路由器后面的 IP**。  
 - **因此：** 若无 **专线 / VPN / 内网穿透 / 设备公网可达地址**，云端智能体**无法**稳定驱动实机；更适合的场景是：  
   - **本地开发机 / 同局域网主机**上跑 MCP（Cursor、Claude 等），或  
-  - 自行在 **可访问设备网段**的环境部署 **Streamable HTTP** MCP，再在百炼用 **`type: sse/streamableHttp`** 填 URL（需你先有远端 MCP 网关；本仓库默认 **stdio**）。  
+  - 自行在 **可访问设备网段**的环境部署 **Streamable HTTP** MCP，再在百炼用 `**type: sse/streamableHttp`** 填 URL（需你先有远端 MCP 网关；本仓库默认 **stdio**）。
 
 若仅希望在百炼里 **演示协议与工具列表**，可将 `DIVOOM_DEVICE_HOST` 指向测试中可达的地址；真实用户需理解 **网络可达性** 是前提。
 
@@ -123,10 +127,12 @@ mcp-divoom-lan 是基于模型上下文协议（MCP）的 Divoom 局域网工具
 
 **这是预期现象。**
 
-| 位置 | 含义 |
-|------|------|
-| **[MCP 管理](https://bailian.console.aliyun.com/?tab=app#/mcp-manage) → 自定义服务** | 当前账号下**自行创建/部署**的 MCP（如脚本 npx），状态「已部署」表示**本账号内**可用的自定义服务。 |
-| **[MCP 广场](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market)** | 平台**对外展示、可检索**的服务目录，多为**官方预置或与阿里云合作上架**；**不会**因为你在管理里部署成功就自动出现在广场。 |
+
+| 位置                                                                            | 含义                                                                 |
+| ----------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| **[MCP 管理](https://bailian.console.aliyun.com/?tab=app#/mcp-manage) → 自定义服务** | 当前账号下**自行创建/部署**的 MCP（如脚本 npx），状态「已部署」表示**本账号内**可用的自定义服务。          |
+| **[MCP 广场](https://bailian.console.aliyun.com/?tab=mcp#/mcp-market)**         | 平台**对外展示、可检索**的服务目录，多为**官方预置或与阿里云合作上架**；**不会**因为你在管理里部署成功就自动出现在广场。 |
+
 
 **使用方式：** 在 **应用管理** 里给智能体/工作流 **添加 MCP** 时，从 **自定义服务** 列表里选用你部署的服务（例如 `mcp-divoom`），无需在广场搜同名条目。
 
@@ -135,11 +141,12 @@ mcp-divoom-lan 是基于模型上下文协议（MCP）的 Divoom 局域网工具
 ### 其它说明
 
 - **广场**：浏览已收录服务，点卡片可复制 **NPX** 等示例。  
-- **`mcp-divoom-lan`** 未上广场时，仍用 **MCP 管理 → 自定义 MCP（脚本部署）** 即可。  
+- `**mcp-divoom-lan`** 未上广场时，仍用 **MCP 管理 → 自定义 MCP（脚本部署）** 即可。  
 - 若贵司推动 **入驻广场**，请以控制台与阿里云最新政策为准。
 
 ## 相关（本仓库）
 
 - npm：`mcp-divoom-lan`（推荐 0.1.2+，`npx -y mcp-divoom-lan`）  
-- 源码：<https://github.com/DivoomDevelop/mcp-divoom-lan>  
-- 其他目录：`MCP_SO_SUBMISSION_READY.md`、`VOLCENGINE_SUBMISSION_READY.md`  
+- 源码：[https://github.com/DivoomDevelop/mcp-divoom-lan](https://github.com/DivoomDevelop/mcp-divoom-lan)  
+- 其他目录：`MCP_SO_SUBMISSION_READY.md`、`VOLCENGINE_SUBMISSION_READY.md`
+

COZE_SUBMISSION_READY.md

@@ -1,26 +1,28 @@
 # 扣子（Coze）— 插件发布与上架说明
 
-扣子生态以 **插件（Plugin）** 为核心：每个插件包含一个或多个 **工具（Tool）**，通过 **HTTP API**（REST）与外部服务通信。这与 **`mcp-divoom-lan`** 使用的 **stdio / MCP** 不是同一套协议；要「在扣子上可用」，通常需要 **HTTP 封装**或 **平台当前支持的 MCP 扩展能力**（以控制台为准）。
+扣子生态以 **插件（Plugin）** 为核心：每个插件包含一个或多个 **工具（Tool）**，通过 **HTTP API**（REST）与外部服务通信。这与 `**mcp-divoom-lan`** 使用的 **stdio / MCP** 不是同一套协议；要「在扣子上可用」，通常需要 **HTTP 封装**或 **平台当前支持的 MCP 扩展能力**（以控制台为准）。
 
 ## 官方文档入口
 
-| 主题 | 链接 |
-|------|------|
+
+| 主题                                | 链接                                                                                     |
+| --------------------------------- | -------------------------------------------------------------------------------------- |
 | 从 API 搭建插件全流程（创建 → 添加工具 → **发布**） | [快速搭建智能体列表查询插件](https://www.coze.cn/api/open/docs/tutorial/build_a_agent_query_plugin) |
-| 鉴权与访问令牌 | [鉴权方式概述](https://docs.coze.cn/api/open/docs/developer_guides/authentication) |
-| 扣子编程 / 资源库 | [扣子编程](https://code.coze.cn/home) |
+| 鉴权与访问令牌                           | [鉴权方式概述](https://docs.coze.cn/api/open/docs/developer_guides/authentication)           |
+| 扣子编程 / 资源库                        | [扣子编程](https://code.coze.cn/home)                                                      |
+
 
 教程摘要：**资源库** → **+ 资源 → 插件** → **云侧插件 - 基于已有服务创建** → 填写插件 URL、Header、授权方式 → **创建工具**（路径、方法、入参/出参、试运行）→ 点击 **发布**（版本号、是否收集个人信息）。
 
 ---
 
 ## 一、在自己空间里「发布」插件（必做）
 
-1. 登录 **[扣子编程](https://code.coze.cn/home)**，选好 **工作空间**。  
-2. 左侧 **资源库** → 右上角 **+ 资源** → **插件**。  
-3. 填写名称、描述；**插件工具创建方式** 选 **基于已有服务创建**；填写你的 **API 根 URL**（需 **HTTPS** 公网可达，除非产品说明支持 HTTP/私网）。  
-4. **创建工具**：为每个 API 配置路径、Method、入参、出参；**试运行** 成功。  
-5. 点击 **发布**：填写版本说明，选择是否涉及用户个人信息收集，确认发布。  
+1. 登录 **[扣子编程](https://code.coze.cn/home)**，选好 **工作空间**。
+2. 左侧 **资源库** → 右上角 **+ 资源** → **插件**。
+3. 填写名称、描述；**插件工具创建方式** 选 **基于已有服务创建**；填写你的 **API 根 URL**（需 **HTTPS** 公网可达，除非产品说明支持 HTTP/私网）。
+4. **创建工具**：为每个 API 配置路径、Method、入参、出参；**试运行** 成功。
+5. 点击 **发布**：填写版本说明，选择是否涉及用户个人信息收集，确认发布。
 
 发布后，插件可被本空间 **智能体（Bot）** 在 **插件 / 工具** 中添加使用（官方教程：**插件只有发布后，才可以被智能体使用**）。
 
@@ -30,7 +32,7 @@
 
 常见流程分两层：
 
-1. **发布**：见上一节，插件处于「已发布」，本账号/本空间可用。  
+1. **发布**：见上一节，插件处于「已发布」，本账号/本空间可用。
 2. **上架到商店**：在扣子/扣子编程控制台查找 **上架插件、提交审核、插件商店** 等入口（**文案随版本变化**），填写类目、介绍、是否收费/授权，**提交审核**；通过后其他用户可在商店发现。
 
 若控制台无「上架」项，可能受 **空间类型、企业认证、地区或灰度** 限制，需查阅 **帮助中心** 或 **工单**。
@@ -39,16 +41,18 @@
 
 ## 三、和 `mcp-divoom-lan` 的关系（重要）
 
-| 能力 | mcp-divoom-lan | 扣子插件（默认） |
-|------|----------------|------------------|
-| 协议 | MCP over **stdio** | **HTTP/HTTPS** 工具定义 |
-| 典型部署 | 本地 / MCP 客户端主机 | 公网 API 服务地址 |
-| Divoom 设备 | 多为 **局域网 IP** | Bot 调插件时，你的服务须 **能访问设备**（内网穿透、边缘网关、同局域服务器等） |
+
+| 能力        | mcp-divoom-lan     | 扣子插件（默认）                                    |
+| --------- | ------------------ | ------------------------------------------- |
+| 协议        | MCP over **stdio** | **HTTP/HTTPS** 工具定义                         |
+| 典型部署      | 本地 / MCP 客户端主机     | 公网 API 服务地址                                 |
+| Divoom 设备 | 多为 **局域网 IP**      | Bot 调插件时，你的服务须 **能访问设备**（内网穿透、边缘网关、同局域服务器等） |
+
 
 **可选路线：**
 
-1. **自研 HTTP 桥**：用 Node/Python 等把 Divoom LAN HTTP 包一层 REST，部署在可达设备的机器上，再按扣子教程建插件。  
-2. **产品若支持 MCP 扩展**：以扣子 **当前** 控制台与文档为准；**不能**想当然把本地 `node dist/index.js` 当作「插件 URL」。  
+1. **自研 HTTP 桥**：用 Node/Python 等把 Divoom LAN HTTP 包一层 REST，部署在可达设备的机器上，再按扣子教程建插件。
+2. **产品若支持 MCP 扩展**：以扣子 **当前** 控制台与文档为准；**不能**想当然把本地 `node dist/index.js` 当作「插件 URL」。
 3. **内部使用**：仅团队 Bot 使用，也要满足控制台对 URL 与安全的要求。
 
 ---
@@ -57,10 +61,10 @@
 
 - 插件说明、边界与是否收集个人信息  
 - 稳定 API 基地址、鉴权说明  
-- 各工具的请求/响应示例  
+- 各工具的请求/响应示例
 
 ---
 
 ## 五、本仓库其它目录
 
-- `BAILIAN_MCP_SUBMISSION_READY.md`、`VOLCENGINE_SUBMISSION_READY.md`、`MCP_SO_SUBMISSION_READY.md`、`GLAMA_SUBMISSION_READY.md`  
+- `BAILIAN_MCP_SUBMISSION_READY.md`、`VOLCENGINE_SUBMISSION_READY.md`、`MCP_SO_SUBMISSION_READY.md`、`GLAMA_SUBMISSION_READY.md`

MCP_SO_SUBMISSION_READY.md

@@ -4,29 +4,13 @@ Submit at: [mcp.so/submit](https://mcp.so/submit) (sign in if required).
 
 ## Form fields (copy-paste)
 
-| Field | Value |
-| ----- | ----- |
-| **Type** | MCP Server |
-| **Name** | `mcp-divoom-lan` |
-| **URL** | `https://github.com/DivoomDevelop/mcp-divoom-lan` |
-| **Description** | See §Description (full paragraph) below — copy into multi-line “Description” if the form has one. |
-| **Tags** | `MCP,Model Context Protocol,Divoom,watchface,clock face,customization,LAN,local network,IoT,smart clock,gadget,Node.js,stdio,HTTP API,multipart upload` |
 
-## Description (for “Description” textarea)
+| Field    | Value                                             |
+| -------- | ------------------------------------------------- |
+| **Type** | MCP Server                                        |
+| **Name** | `mcp-divoom-lan`                                  |
+| **URL**  | `https://github.com/DivoomDevelop/mcp-divoom-lan` |
 
-**mcp-divoom-lan** is an open-source Model Context Protocol (MCP) server that exposes Divoom watchface customization over **local LAN HTTP**. AI assistants can read and patch the current on-device watchface JSON, manage fonts and store market lists, switch the active dial, adjust brightness, and run **multipart** flows for background replacement, file upload, and creating a local clock—while following a **read-before-write** workflow and explicit warnings for destructive actions (e.g. reset-from-cloud). Requires network access to the Divoom device; configure `DIVOOM_DEVICE_HOST` (and optionally port/timeout). MIT license; Node.js 20+; stdio transport.
-
-**One-liner (if the form has a strict length limit):** MCP server for **Divoom** devices: customize watchfaces over **LAN** (read/patch config, dial/brightness, multipart uploads). Node 20+, stdio—set `DIVOOM_DEVICE_HOST` on your network.
-
-## Tags (comma-separated)
-
-Shorter list:
-
-`MCP,Divoom,watchface,LAN,IoT,smart-device,Node.js,stdio,home-automation`
-
-Longer list (more discoverability):
-
-`MCP,Model Context Protocol,Divoom,watchface,clock face,customization,LAN,local network,IoT,smart clock,gadget,Node.js,stdio,HTTP API,multipart upload`
 
 ## Server Config (paste into the form)
 
@@ -52,7 +36,7 @@ Use **one** of the following JSON blocks (mcp.so may expect the full `mcpServers
 }
 ```
 
-> **npm:** From **0.1.2** on, the published package includes `bin` and a `dist/index.js` shebang so **`npx -y mcp-divoom-lan`** works. **Variant A** is the default recommendation for MCP.so and end users. Use **Variant B** / **C** for contributors (local `node_modules`, git clone, or pinned paths).
+> **Note:** The `npx -y mcp-divoom-lan` entry requires a published npm version that includes the `bin` field in `package.json` (present in this repo from the `bin` + shebang change). Until you publish that version to npm, use **Variant B** or **C** below on the form.
 
 ### Variant B — `node` + local `node_modules` path
 
@@ -92,7 +76,11 @@ After `npm install mcp-divoom-lan` in a project directory:
 }
 ```
 
-## Long description (optional extra field)
+## Short description (if the site has a free-text field)
+
+MCP server for Divoom LAN watchface customization: read/patch local clock config, multipart background upload, brightness and dial selection — with read-before-write safety notes.
+
+## Long description (optional)
 
 `mcp-divoom-lan` wraps Divoom device HTTP/LAN APIs as MCP tools (`watchface_get_local`, `watchface_patch_local`, multipart dial/upload helpers, etc.) and ships markdown resources for protocol constraints. Requires LAN access to the watch; set `DIVOOM_DEVICE_HOST` (or pass `target.host` per call). See repository `README.md` and `SECURITY.md` (`developer@divoom.com`).
 
@@ -101,3 +89,4 @@ After `npm install mcp-divoom-lan` in a project directory:
 - Directory template: `MCP_DIRECTORY_LISTING_TEMPLATE.md`
 - npm package: `mcp-divoom-lan`
 - MCP Registry id: `io.github.DivoomDevelop/mcp-divoom-lan`
+