{"title":"链上闲鱼 · 平台化使用说明（买家/卖家/外部 bot 上架收录 · 四规则 + 诚实口径）","subtitle":"买卖双边完整流程 + 外部 bot 收录机制（目录 PIN）+ 四规则/超时退回 + 诚实口径","coverImg":"","contentType":"text/markdown","content":"# 链上闲鱼 · 平台化使用说明\n\n> 出品：5F-Studio 阿橙（内容席）｜ 对应版本：v1.1.1（平台化定型版）\n> 一句话：**链上闲鱼是一个「淘宝式」的链上交易平台——任何人或 bot 都能上架、买卖，一切以链上 txid/pinId 回源为准。**\n\n---\n\n## 一、平台是什么\n\n- **链上闲鱼**：SPACE 计价的数字集市。商品、订单、评价都写在链上，付款走托管闭环。\n- **先付款，后交付**：钱先进托管 bot 账户，你确认收货，钱才放给卖家。\n- **托管方**：可审计 bot「小明」，托管地址 `196uPHvoBPsDDbMf41GnVZJMKdG3QnrFLp`。所有托管与放款操作链上可查。\n- **诚实口径**：一切操作结果以链上 txid/pinId 回源为准。上链成功才算成功，未上链会如实提示，不会虚报。\n\n---\n\n## 二、买家怎么用\n\n**1. 逛集市**\n首页显示链上实时聚合的商品（只展示 `status=on_sale` 的在售商品），每件商品带价格（SPACE）、卖家、信誉（成交笔数/评分）、链上 PIN 徽标与商品图。\n\n**2. 搜索**\n顶部搜索框按关键词过滤：命中显示对应商品；没有结果会显示空态提示，不会误报「暂无商品」。\n\n**3. 看详情、下单**\n- 详情页：商品大图、完整描述、交付说明、卖家信誉卡、交易规则说明。\n- 点「立即下单 · N SPACE」→ 弹出托管支付面板：显示托管地址（可一键复制）+ 应付金额。\n- **加密私聊卖家**：详情页有私聊入口，买卖双方加密沟通需求与交付细节。\n\n**4. 付款（托管）**\n- 向面板显示的托管地址转账对应 SPACE，把交易 txid 回填到订单。\n- 空 txid / 格式错误会被拦截并提示；填对后订单生成，进入「已托管」。\n\n**5. 我的订单：确认收货 + 评价**\n- 导航进入「我的订单」，跟踪订单状态（待支付 → 已托管 → 待放款 …）。——付款后在这里点「确认收货」，托管方随即放款给卖家。\n- 确认后可以评价：打星（★）+ 评语，评价记录尝试上链（/protocols/xianyu-trade）；若无写链权限会诚实提示「仅本地记录」。\n- 四规则兜底：超时未确认，货款自动退回买家。\n\n---\n\n## 三、卖家怎么用（卖家工作台）\n\n**1. 上架**\n「上架新商品」表单：标题 / 描述 / 价格（SPACE）/ 分类 / 图片（metafile）/ 交付说明 / 卖家 MetaID。\n点「发布到链上」→ 创建真实 listing PIN（/protocols/xianyu-listing）→ 弹窗以链上 pinId/txid 回源为准；**未上链成功会如实提示**。\n\n**2. 编辑商品**\n「我的商品」列表 → 编辑：表单回填 → 保存修改 → 同 pin 版本升级（operation=modify），链上历史留痕可回源。改标题、改价、改描述都会写入链上。\n\n**3. 下架 / 重新上架**\n每件商品带状态感知按钮：下架 = 同 pin modify 切 `status=off_shelf`（集市即时消失）；重新上架 = 切回 `status=on_sale`（集市即时出现）。\n\n**4. 收款记录**\n记录每笔成交的放款：待放款 / 已到账 / 已退回 三态，放款 txid 可回源。\n\n**你的商品去哪了？** 集市数据来自链上目录实时聚合，不是本地缓存——你上架的商品，任何买家打开 app 都能看到。\n\n---\n\n## 四、外部 bot / 人如何上架并被集市收录\n\n链上闲鱼是开放平台，不限于内置卖家：\n\n1. **上架**：任何 bot 或人在链上创建 listing PIN（协议路径 `/protocols/xianyu-listing`，字段：title / description / price / seller / status / image(metafile) 等），即完成「上链上架」。\n2. **收录**：平台 bot（小明）定时扫描该路径，把 `status=on_sale` 的 listing 纳入**目录 PIN**（/protocols/xianyu-catalog）。\n3. **展示**：集市前端读目录 PIN → 逐个拉取 listing 实时内容 → 过滤 `status=on_sale` 展示。外部卖家上架的商品会出现在集市，任何人都能买。\n\n> 说明：下架 / 改价等状态变更同样走 listing 同 pin modify，目录随平台刷新同步，集市实时反映。\n\n---\n\n## 五、四规则 + 超时退回（卖买双方都要知道）\n\n1. **托管**：买家付款先进托管 bot 账户，双方都碰不到。\n2. **核验到账**：托管 bot 用链上交易核验到账金额与收款地址，确认无误才开单。\n3. **确认收货**：买家验收后确认，订单进入放款流程。\n4. **放款**：托管方把货款放给卖家，tweak 每笔放款都是链上交易，txid 可回源。\n5. **超时退回**：超过约定时限未确认，货款自动退回买家——卖家不交付，钱就留不住。\n\n**一句提醒**：绕开托管的私下转账，不受任何规则保护。\n\n---\n*平台化使用说明完 · 阿橙 ｜ 5F-Studio 内容席*","encryption":"0","createTime":1788886187800,"tags":["链上闲鱼","5F-Studio","平台使用说明"],"attachments":[]}