@gyoungwe/pi-connectors

中文文档
0.1.1发布于 2026/10/21MITTypeScriptES Module近 30 天下载 1万

主机中性、只读连接器声明和本地 Pi 的出处收据

中文使用文档

@gyoungwe/pi-connectors

@gyoungwe/pi-connectors 是本地 Pi 和 Drone 桌面的可移植连接器边界。 船舶申报、登记、作业规划和出处接收合同的:

  • Zotero 引用元数据
  • WebDAV 存储已读
  • 仅可读的通用MCP发现/引用
  • 机构访问和经核准的浏览器交割
  • 已声明的公共搜索提供者
  • 已核准浏览器源已读

该包裹是有意免载的. 它的工具只列出或检查连接器申报. 主机组成 root 拥有网络请求、 认证查询、 浏览器会话、 写、 删除、 回读和通过重试策略 ConnectorExecutionPort,证书字段是不透明的引用;秘密从来不是描述词或收据的一部分.

每个描述者都声明:

  • 能力和支持的主机(native-pi, (中文(简体) ), drone-desktop(中文(简体) )
  • 网络模式和明确的主机许可列表标签
  • 证书要求和接受的东道主自有来源
  • 读取/写入/删除访问(所有内置默认只读)
  • 授权行动
  • 外部副作用,包括浏览器导航

ConnectorRegistry 核实这些申报,并提供确定性列名和许可审计预测. planConnectorOperation 无法关闭未申报的写/删除以及缺少主机授权引用的操作 . createConnectorReceipt 财务报告和审定财务报表 createConnectorReceiptChain 让一个主机记录源 hashes, 不透明的授权处理, 和写/ read back/ 删除相, 而不需要这个软件包执行这些动作 .

构建和验证

npm run typecheck -w @gyoungwe/pi-connectors
npm run check -w @gyoungwe/pi-connectors

包件会释放一个自成一体 dist/index.mjs;它没有运行时间依赖 Electron, Drone后端, 或 Pi SDK. scripts/smoke-pi-connectors.mjs 将包打包,将柏油球安装到新的临时前缀中,用Pi资源加载器发现扩展,检查两种只读工具,并解装. 烟雾不使用证书,网络传输,浏览器状态,也不使用外部写作.

版本与发布记录

@gyoungwe/pi-connectors 共发布 3 个版本,首次发布于 2026/10/18;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.1.1latest2026/10/2126 天前
0.1.02026/10/1829 天前
0.0.0-stage2026/10/1829 天前

关于 @gyoungwe/pi-connectors 的常见问题

@gyoungwe/pi-connectors 是什么?

主机中性、只读连接器声明和本地 Pi 的出处收据

如何安装 @gyoungwe/pi-connectors?

在项目目录运行 npm install @gyoungwe/pi-connectors,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@earendil-works/pi-coding-agent(>=1.1.0 <2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gyoungwe/pi-connectors 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gyoungwe/pi-connectors 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gyoungwe/pi-connectors 可以商用吗?

@gyoungwe/pi-connectors 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gyoungwe/pi-connectors 的下载量有多少?

根据 npm 官方下载统计,@gyoungwe/pi-connectors 在 2026/10/17 – 2026/11/15 这 30 天内被下载 10,135 次,日均约 338 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gyoungwe/pi-connectors 还在维护吗?

最新版本 0.1.1 发布于 2026/10/21(26 天前);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/10/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。