🧩 PI-Desktop 插件征集（第一期）：文件编辑器 / 色卡选择器 / 录屏 & 截图 / 命令行终端

[Tioit-Wang]

背景

PI-Desktop 插件生态公开征集，欢迎认领开发或在评论区提创意。

• 官方插件市场（客户端内：插件 → 市场）：https://plugins.aiuo.net
• 插件源码 / GitHub 镜像：https://github.com/vastsa/pi-desktop-plugins
• 已上架：Git Lens、Terminal、Pi Markdown 笔记、便签、小清新待办、剪贴板历史、草稿计算器、SSH Manager、超级域名侠、Token Insights 等
• 开发：docs/zh-CN/plugin-development.md，或应用内「插件 → 从模板新建插件」快速起步
• 插件可贡献：工作面板视图 / 命令 / Agent 工具 / 技能 / 主题 / MCP / 后台服务

征集方向

1️⃣ 文件编辑器（目标：替代内置 Files 面板）

在右侧工作面板完成文件展示与处理，不只是浏览。

• 侧边栏文件树 + 打开 / 编辑 / 保存
• 语法高亮、编码识别、大文件兜底
• 与 Agent 联动：选中片段发给会话、查看 AI 改动 diff
• 加分项：Markdown 预览、格式化、多标签

内置 Files 面板本身即通过公开扩展点 contributes.views 挂载，替代在架构上可行。所需白名单 API（文件写入、声明式文件范围、编辑器组件等）请在帖内提出，维护者评估后开放。

2️⃣ 色卡选择器

面向前端 / 设计的取色与配色工具。

• 色彩搭配展示：预设色板、渐变、Tailwind / Material 色系
• 截图吸色笔，一键复制 HEX / RGB / HSL
• AI 配色：按主色生成搭配方案并实时预览
• 加分项：复制为 CSS 变量 / Tailwind 配置

3️⃣ 录屏 & 截图助手（可拆分）

• 截图：区域 / 窗口 / 全屏，标注、复制、保存
• 录屏：区域录制，导出 MP4 / GIF，帧率可调
• 入口：命令面板 / 快捷键 / 工作面板

4️⃣ 命令行插件（终端）

功能完善的终端，注册在右侧工作面板。已有 pi.terminal（标签页、shell profiles、复制粘贴）可增强，也可重做。

• contributes.views 挂载，不弹独立窗口，支持多标签
• 跨平台 shell profiles：PowerShell / CMD / WSL / bash / zsh
• 滚回缓冲、搜索、链接识别、复制粘贴、快捷键、主题跟随宿主明暗色
• 加分项：Agent 联动（输出发会话、报错解释）、SSH 远程标签、分屏

宿主已移除内置终端（ADR 0108），暂无官方插件 PTY API。认领时请一并给出实现方案与权限需求，维护者评估后开放白名单。

参与

1. 认领：评论区留言方向编号，避免重复
2. 开发：按文档或模板起步，API / 权限需求随时在本帖提出
3. 发布：在 plugins.aiuo.net 用 GitHub 登录申请 publisher → pi-plugin pack → pi-plugin publish --registry https://plugins.aiuo.net → 审核通过进入官方市场（发布指南）

其他

• 功能点为初步设想，最终形态由作者决定
• 清单外的创意，欢迎直接开 Issue

[muzimu217]

来交个作业：一体化会话导入插件（清单外方向，背景见 #132 / #134）——v0.2.0 已开发完成并开源，.piplug 已打包，等市场开放注册即上架。

📦 源码：https://github.com/muzimu217/pi-desktop-session-import

把六个外部工具的本地会话统一迁入 PI-Desktop：ZCode / WorkBuddy / Claude Code / Codex / OpenCode / Pi。其中 Claude Code / Codex / OpenCode / Pi 正是 core 现有的内置导入来源——按 #134 里 @vastsa 的规划，core 移除内置导入逻辑后由插件统一承载，正好提前把这个「集大成」版本做出来了。

体验与原生导入一致：扫描本机工具自动探测来源 → 按项目分组勾选、完整对话预览 → 一键导入后左侧项目列表即刻可见。

几个技术点，供想做「读本地数据」类插件的同学参考：

• 六种来源、两种存储：JSONL 家族（Claude Code / Codex / OpenCode / WorkBuddy / Pi）+ SQLite（ZCode）。零原生依赖——ZCode 用 utilityProcess 里的 node:sqlite（Electron 43 内嵌 Node 24）只读打开，实测可用
• WorkBuddy 适配做了 <system-reminder> 注入剥离、超长工具结果外置回读、ai-title 标题提取
• 实测：WorkBuddy 116 个会话 / 11301 条消息全量转换 100% 成功；ZCode / WorkBuddy 双端实时扫描正常

一个坦率的说明：「导入后出现在侧栏」依赖宿主侧一个尚不存在的桥接通道（session.import + sessionsChanged 事件）。我们在本地 dev 构建里做了原型（#134 有反馈和实测结论），并愿意把这部分整理成 PR 贡献给主程序；桥接落地前，插件在正式版宿主上可以扫描和预览，最后一步导入会提示不可用。

有迁移需求的同学可以先克隆仓库用「插件 → Load dev plugin」体验，反馈直接提 issue。等 plugins.aiuo.net 开放即注册 publisher 正式上架。

[Tioit-Wang]

认领 1️⃣ 文件编辑器（评论区目前只有上面那条清单外方向，这个还没人占）。

已经做完并提了 PR：vastsa/pi-desktop-plugins#24 → vastsa/pi-desktop-plugins#24

📦 源码：https://github.com/Tioit-Wang/pi-desktop-plugin-file-manager

---

插件介绍：pi.file-manager 文件管理器

挂在右侧工作面板（contributes.views + ui.view），不替换内置「文件」视图，而是并列一行——内置只读，这一行可编辑。

• 完整目录树：懒加载、目录优先、键盘导航；行图标随文件类型变化（代码/配置/样式/标记/数据/脚本/图片/压缩包/字体/锁文件各有字形与配色，package.json、Dockerfile、LICENSE 这类特殊文件名优先判定）；选中态与悬停态明确区分。
• 左右分栏：左列表右内容，分隔条可拖拽并记住宽度。
• 代码高亮编辑：CodeMirror 6，行号 / 查找替换 / 多光标 / 括号匹配 / 折叠；按文件名加载语法高亮，覆盖 30+ 语言，全部随包内置、离线可用。Ctrl/Cmd+S 保存。
• Markdown 预览 / 编辑切换（加分项 ✅）：围栏代码块复用编辑器同一套高亮；预览渲染为 React 元素而非 innerHTML，结构上没有注入面。
• 右键菜单：新建文件 / 新建文件夹 / 重命名 / 移动 / 打开 / 刷新。
• 按文件名分页搜索、按 .gitignore / .ignore 过滤（有规则才过滤，没有就全展示）。
• 亮/暗与中英文跟随宿主。

关于「所需白名单 API」——实际做下来只有 2 个真缺口

按帖子的邀请反馈一下，都是实测结论：

1. manifest.fs 在语法上无法表达「整树写入」，这是通用编辑器绕不开的坎。
plugin-sdk/fs-policy.ts 的 isWholeTreePattern 把 **、**/*、*/**、./* 全部拒掉——这个设计对「写死几个目录」的插件是对的，但文件管理器的写目标就是「用户此刻打开的那个文件」，无法静态枚举。结果只有两条路：每次保存弹一次 Deny/Allow（体验不可接受），或者绕过网关。我选了后者（插件进程内 Node fs），代价是审计、越界校验、凭据路径拒绝全部要自己重做一遍——我补了路径包含 + realpath 双重校验、凭据黑名单、原子写、mtime+size 乐观锁、写入审计日志。

如果将来想让这类插件也走网关，可能需要的是「整树写 + 其它约束」的组合（例如按扩展名/按目录白名单，或一次授权覆盖整个会话），而不是每次弹窗。

2. 没有「插件 → 视图」的推送通道。
PluginPanelHost.broadcast() 只遍历独立面板窗（this.windows），PluginViewHost 根本没有 send 方法。所以 fs.watch 做了也推不进 UI，文件管理器只能靠「保存后刷新 + 手动刷新」。要做到「外部改动实时可见」需要一个 view 级的推送出口。

另外两个小的，顺手报一下：

• docked view 收不到 appearance:changed：preload/plugin-panel.ts 在 isEmbeddedPanel() 时提前 return，既不注入 chrome 也不订阅外观事件（ADR 0104 也是这么写的）。所以面板内主题/语言只能轮询 app.getAppearance。不确定是有意还是遗漏。
• 插件无法用命令打开自己的视图：pi.ui 只有 openPanel/closePanel，没有 openView。所以「快捷键打开文件管理器」做不到，我也就没声明 contributes.commands（声明了也打不开，反而误导）。

已知限制（写清楚了，没藏）

• 不删除文件/目录：破坏性操作，且 fs.remove 没有开放给视图桥，只能走原生 rm——本期没做。
• 没有「在文件夹中显示」/「用系统程序打开」：这两个通道要 fs.read 权限，而本插件有意不申报任何 fs 权限。
• 不监听文件变化（原因见上）。
• 二进制与图片不进编辑器。

验证

• security_audit.py --check-packages：本插件 0 blocker，3 条 manual-review 信号（filesystem mutation / credential / destructive），都是文件管理器的固有能力。
• 新增 tests/pi-file-manager.test.mjs：10 项全过，含反向用例——路径穿越、凭据路径、符号链接逃逸、外部改动后的冲突写入（断言磁盘未被改动）、无工作区时的拒绝。
• 全量套件 114 项 / 106 过 / 8 挂，那 8 项在 pristine main 上同样挂（浅克隆缺 git 历史 + 原生 helper 未构建），与本次改动无关。
• catalog.json 用 rebuild_catalog.py 生成后收敛成最小 diff（44 增 / 1 删），没有把其它 18 个条目的 publishedAt 一起刷掉。

等 plugins.aiuo.net 开放就去注册 publisher 正式上架。

[catDforD]

我想认领 2️⃣ 色卡选择器。评论区目前只有会话导入和文件编辑器两条,这个方向暂时还没人做。

交付范围

• 色板浏览:预设配色、渐变、Tailwind / Material 色系,在工作面板里直接翻看,不用再开浏览器查色值。
• 取色:打开项目里的设计稿、截图、素材图,在上面点一下就能取到颜色;也支持从剪贴板历史里的图片取色。
• AI 配色:给一个主色或一句风格描述("科技感、深色、偏紫"),生成整套搭配并实时预览;也可以让 Agent 直接调用。
• 一键复制:HEX / RGB / HSL、CSS 变量、Tailwind 配置。
• 生成并一键换主题:配色满意后,可以把 PI-Desktop 界面本身换成这套颜色。

需要开放的能力

• 屏幕放大镜吸色:按快捷键唤起,放大镜跟随光标移动,点击取色并复制色值。我可以单独提交一个 pr ，作者到时候审一下看行不行。

可行性依据: 基本都基于现有 API——图片读取用 pi.fs.readPreview(图片以 data URL 返回)、剪贴板图片用 pi.clipboard.getHistory、AI 用 pi.agent.complete、复制导出用 clipboard.write 与 fs.writeText、主题用 pi.themes.upsert。目录通过 fs.requestDirectory() 由用户选定,一期不申报任何 fs 写权限。

[Tioit-Wang]

我想认领 2️⃣ 色卡选择器。评论区目前只有会话导入和文件编辑器两条,这个方向暂时还没人做。

交付范围

• 色板浏览:预设配色、渐变、Tailwind / Material 色系,在工作面板里直接翻看,不用再开浏览器查色值。
• 取色:打开项目里的设计稿、截图、素材图,在上面点一下就能取到颜色;也支持从剪贴板历史里的图片取色。
• AI 配色:给一个主色或一句风格描述("科技感、深色、偏紫"),生成整套搭配并实时预览;也可以让 Agent 直接调用。
• 一键复制:HEX / RGB / HSL、CSS 变量、Tailwind 配置。
• 生成并一键换主题:配色满意后,可以把 PI-Desktop 界面本身换成这套颜色。

需要开放的能力

• 屏幕放大镜吸色:按快捷键唤起,放大镜跟随光标移动,点击取色并复制色值。我可以单独提交一个 pr ，作者到时候审一下看行不行。

可行性依据: 基本都基于现有 API——图片读取用 pi.fs.readPreview(图片以 data URL 返回)、剪贴板图片用 pi.clipboard.getHistory、AI 用 pi.agent.complete、复制导出用 clipboard.write 与 fs.writeText、主题用 pi.themes.upsert。目录通过 fs.requestDirectory() 由用户选定,一期不申报任何 fs 写权限。

支持，请大胆创作。

[catDforD]

我想认领 2️⃣ 色卡选择器。评论区目前只有会话导入和文件编辑器两条,这个方向暂时还没人做。

交付范围

• 色板浏览:预设配色、渐变、Tailwind / Material 色系,在工作面板里直接翻看,不用再开浏览器查色值。
• 取色:打开项目里的设计稿、截图、素材图,在上面点一下就能取到颜色;也支持从剪贴板历史里的图片取色。
• AI 配色:给一个主色或一句风格描述("科技感、深色、偏紫"),生成整套搭配并实时预览;也可以让 Agent 直接调用。
• 一键复制:HEX / RGB / HSL、CSS 变量、Tailwind 配置。
• 生成并一键换主题:配色满意后,可以把 PI-Desktop 界面本身换成这套颜色。

需要开放的能力

• 屏幕放大镜吸色:按快捷键唤起,放大镜跟随光标移动,点击取色并复制色值。我可以单独提交一个 pr ，作者到时候审一下看行不行。

可行性依据: 基本都基于现有 API——图片读取用 pi.fs.readPreview(图片以 data URL 返回)、剪贴板图片用 pi.clipboard.getHistory、AI 用 pi.agent.complete、复制导出用 clipboard.write 与 fs.writeText、主题用 pi.themes.upsert。目录通过 fs.requestDirectory() 由用户选定,一期不申报任何 fs 写权限。

---

更新一下插件进展:交付范围里的五项都已完成,清单之外还做了几件事;现在只剩一项需要宿主支持。

仓库:https://github.com/catDforD/pi-desktop-color-picker(plugin id io.github.catdford.color-picker;尚未上架,当前按开发插件加载。打包与校验已按 devkit 跑通,准备走 pi-desktop-plugins 的上架流程)

已完成：

• 色板浏览:Tailwind CSS v4 全部 26 个色系(50–950,官方 OKLCH 原值)、Material Design 19 个色系、15 套预设配色、12 条渐变
• 取色:打开文件夹里的图片,或直接用剪贴板历史里的最新图片;放大镜给出真实像素(像素网格 + 十字准星 + 实时色值),方向键 1px 微调(Shift 一次 10px),点击取色
• AI 配色:给一个主色或一句风格描述,生成整套带名字的配色;模型在面板里选,凭据由宿主解析,插件碰不到
• 一键复制:HEX / RGB / HSL / OKLCH、CSS 变量、Tailwind v4 @theme、Tailwind v3 配置、JSON
• 生成并一键换主题:配色满意后一键装成 PI-Desktop 主题,侧栏 / 编辑器 / 设置页一起换色,可随时切换或卸载(用 ADR 0260 的 pi.themes.upsert + pi.app.setTheme,不需要新增宿主能力)
• 清单之外还有:和谐配色与 50–950 色阶生成、WCAG 对比度与三种色盲模拟、suggest_palette 工具 + skill、Alt+Shift+C 全局快捷键

还需要宿主开放的能力：

• 一次性截屏 screen.capture，宿主侧我可以自己准备实现并提一个小 PR 来实现，目前没有该权限相应功能会默认置灰，不影响插件大部分功能。

最后附上插件当前声明的权限清单,方便评估这个插件的授权面:ui.panel、ui.view、ui.theme、clipboard.write、clipboard.read、fs.read(root 为 userSelected,不申报 workspace 范围也没有写权限)、keyboard.globalShortcut、agent.complete、models.list、agent.tool.register、agent.prompt.inject。

[Tioit-Wang]

我想认领 2️⃣ 色卡选择器。评论区目前只有会话导入和文件编辑器两条,这个方向暂时还没人做。

交付范围

• 色板浏览:预设配色、渐变、Tailwind / Material 色系,在工作面板里直接翻看,不用再开浏览器查色值。
• 取色:打开项目里的设计稿、截图、素材图,在上面点一下就能取到颜色;也支持从剪贴板历史里的图片取色。
• AI 配色:给一个主色或一句风格描述("科技感、深色、偏紫"),生成整套搭配并实时预览;也可以让 Agent 直接调用。
• 一键复制:HEX / RGB / HSL、CSS 变量、Tailwind 配置。
• 生成并一键换主题:配色满意后,可以把 PI-Desktop 界面本身换成这套颜色。

需要开放的能力

• 屏幕放大镜吸色:按快捷键唤起,放大镜跟随光标移动,点击取色并复制色值。我可以单独提交一个 pr ，作者到时候审一下看行不行。

可行性依据: 基本都基于现有 API——图片读取用 pi.fs.readPreview(图片以 data URL 返回)、剪贴板图片用 pi.clipboard.getHistory、AI 用 pi.agent.complete、复制导出用 clipboard.write 与 fs.writeText、主题用 pi.themes.upsert。目录通过 fs.requestDirectory() 由用户选定,一期不申报任何 fs 写权限。

更新一下插件进展:交付范围里的五项都已完成,清单之外还做了几件事;现在只剩一项需要宿主支持。

仓库:https://github.com/catDforD/pi-desktop-color-picker(plugin id io.github.catdford.color-picker;尚未上架,当前按开发插件加载。打包与校验已按 devkit 跑通,准备走 pi-desktop-plugins 的上架流程)

已完成：

• 色板浏览:Tailwind CSS v4 全部 26 个色系(50–950,官方 OKLCH 原值)、Material Design 19 个色系、15 套预设配色、12 条渐变
• 取色:打开文件夹里的图片,或直接用剪贴板历史里的最新图片;放大镜给出真实像素(像素网格 + 十字准星 + 实时色值),方向键 1px 微调(Shift 一次 10px),点击取色
• AI 配色:给一个主色或一句风格描述,生成整套带名字的配色;模型在面板里选,凭据由宿主解析,插件碰不到
• 一键复制:HEX / RGB / HSL / OKLCH、CSS 变量、Tailwind v4 @theme、Tailwind v3 配置、JSON
• 生成并一键换主题:配色满意后一键装成 PI-Desktop 主题,侧栏 / 编辑器 / 设置页一起换色,可随时切换或卸载(用 ADR 0260 的 pi.themes.upsert + pi.app.setTheme,不需要新增宿主能力)
• 清单之外还有:和谐配色与 50–950 色阶生成、WCAG 对比度与三种色盲模拟、suggest_palette 工具 + skill、Alt+Shift+C 全局快捷键

还需要宿主开放的能力：

• 一次性截屏 screen.capture，宿主侧我可以自己准备实现并提一个小 PR 来实现，目前没有该权限相应功能会默认置灰，不影响插件大部分功能。

最后附上插件当前声明的权限清单,方便评估这个插件的授权面:ui.panel、ui.view、ui.theme、clipboard.write、clipboard.read、fs.read(root 为 userSelected,不申报 workspace 范围也没有写权限)、keyboard.globalShortcut、agent.complete、models.list、agent.tool.register、agent.prompt.inject。

提交PR, 马上Review , https://plugins.aiuo.net/ 这里发布

[catDforD]

我想认领 2️⃣ 色卡选择器。评论区目前只有会话导入和文件编辑器两条,这个方向暂时还没人做。

交付范围

• 色板浏览:预设配色、渐变、Tailwind / Material 色系,在工作面板里直接翻看,不用再开浏览器查色值。
• 取色:打开项目里的设计稿、截图、素材图,在上面点一下就能取到颜色;也支持从剪贴板历史里的图片取色。
• AI 配色:给一个主色或一句风格描述("科技感、深色、偏紫"),生成整套搭配并实时预览;也可以让 Agent 直接调用。
• 一键复制:HEX / RGB / HSL、CSS 变量、Tailwind 配置。
• 生成并一键换主题:配色满意后,可以把 PI-Desktop 界面本身换成这套颜色。

需要开放的能力

• 屏幕放大镜吸色:按快捷键唤起,放大镜跟随光标移动,点击取色并复制色值。我可以单独提交一个 pr ，作者到时候审一下看行不行。

可行性依据: 基本都基于现有 API——图片读取用 pi.fs.readPreview(图片以 data URL 返回)、剪贴板图片用 pi.clipboard.getHistory、AI 用 pi.agent.complete、复制导出用 clipboard.write 与 fs.writeText、主题用 pi.themes.upsert。目录通过 fs.requestDirectory() 由用户选定,一期不申报任何 fs 写权限。

更新一下插件进展:交付范围里的五项都已完成,清单之外还做了几件事;现在只剩一项需要宿主支持。
仓库:https://github.com/catDforD/pi-desktop-color-picker(plugin id io.github.catdford.color-picker;尚未上架,当前按开发插件加载。打包与校验已按 devkit 跑通,准备走 pi-desktop-plugins 的上架流程)

已完成：

• 色板浏览:Tailwind CSS v4 全部 26 个色系(50–950,官方 OKLCH 原值)、Material Design 19 个色系、15 套预设配色、12 条渐变
• 取色:打开文件夹里的图片,或直接用剪贴板历史里的最新图片;放大镜给出真实像素(像素网格 + 十字准星 + 实时色值),方向键 1px 微调(Shift 一次 10px),点击取色
• AI 配色:给一个主色或一句风格描述,生成整套带名字的配色;模型在面板里选,凭据由宿主解析,插件碰不到
• 一键复制:HEX / RGB / HSL / OKLCH、CSS 变量、Tailwind v4 @theme、Tailwind v3 配置、JSON
• 生成并一键换主题:配色满意后一键装成 PI-Desktop 主题,侧栏 / 编辑器 / 设置页一起换色,可随时切换或卸载(用 ADR 0260 的 pi.themes.upsert + pi.app.setTheme,不需要新增宿主能力)
• 清单之外还有:和谐配色与 50–950 色阶生成、WCAG 对比度与三种色盲模拟、suggest_palette 工具 + skill、Alt+Shift+C 全局快捷键

还需要宿主开放的能力：

• 一次性截屏 screen.capture，宿主侧我可以自己准备实现并提一个小 PR 来实现，目前没有该权限相应功能会默认置灰，不影响插件大部分功能。

最后附上插件当前声明的权限清单,方便评估这个插件的授权面:ui.panel、ui.view、ui.theme、clipboard.write、clipboard.read、fs.read(root 为 userSelected,不申报 workspace 范围也没有写权限)、keyboard.globalShortcut、agent.complete、models.list、agent.tool.register、agent.prompt.inject。

提交PR, 马上Review , https://plugins.aiuo.net/ 这里发布

sry，我还没来得及做 hhh，明天补上hhh

[Tioit-Wang]

这四个方向都是插件形态，宿主侧载体今天已经发布：工作面板视图（contributes.views + ui.view，文件编辑器 / 终端 / 色卡都挂这里）、插件命令、插件工具（contributes.agentTools，取色 / 截图可让 Agent 直接调）、后台服务、全局快捷键（contributes.globalShortcuts + keyboard.globalShortcut 权限）。

还要往会话界面里伸的部分，对应两份需求稿：

• 快捷键唤起的录屏 / 截图面板或悬浮 HUD → 插件 UI 插槽需求 — 组件插槽（14 项） #545 第 12 项「全局浮层（Global Overlay）」，权限 ui.shell.overlay
• 取色 / 截图结果一键贴进草稿 → 插件 UI 插槽需求 — 组件插槽（14 项） #545 第 8 项「改写草稿（输入框文本读写）」，权限 ui.composer.draft

终端需要的 PTY 不在这两份清单里（属白名单新增，按帖内要求附实现方案与权限）。上层计划 #528；两份目前都还是需求确认稿（v0.15.0 尚未实现）。

[Tioit-Wang]

已集齐，感谢各位