Skip to content

feat(cot-peek): 新增思考小窗插件 - #144

Open
cobaltna wants to merge 3 commits into
zai-org:mainfrom
cobaltna:feat/cot-peek
Open

cobaltna wants to merge 3 commits into
zai-org:mainfrom
cobaltna:feat/cot-peek

Conversation

@cobaltna

@cobaltna cobaltna commented Oct 30, 2026 •

Copy link
Copy Markdown

Plugin type (required) / 插件类型(必填)

  • UI Plugin / 是 UI 插件 — provides MCP Apps interactive pages / 提供 MCP Apps 交互页面
  • Standard plugin / 普通插件(非 UI) — does not provide MCP Apps interactive pages / 不提供 MCP Apps 交互页面
  • Not applicable / 不适用 — repository-only changes; no plugin content changed / 仅仓库级改动,不涉及插件内容

Affected plugin name(s) / 涉及的插件名称:cot-peek

What / 改动内容

新增社区插件 cot-peek / 思考小窗,解决一个具体问题:模型输出的思维链是英文的,又长又密,读完它 AI 已经继续干了三件事。本插件在屏幕右侧放一颗圆形悬浮球,AI 每写完一轮思考,中文译文半秒内上屏;窗口开着时复制英文,1 秒内出中文。

用户可见行为与测试方式:

  • 悬浮球贴屏幕右缘,点球展开双标签窗口:思考流翻译、划词翻译;点 × 收起回球,收起即暂停。
  • 思维链实时翻译:用 ReadDirectoryChangesW 监听 rollout 目录,事件驱动,写入到出译文实测 0.05 到 0.5 秒;长思考切千字段三路并发逐段上屏。
  • 翻译接口三级降级:火山翻译网页版、cn.bing.com、MyMemory,全挂保留原文标红;代码块、URL、路径、常见术语占位保护。
  • 空闲 CPU 实测 0.00%:所有等待都在内核里,无轮询、无子进程;ZCode 退出时对根进程句柄 WaitForSingleObject,即时跟随退出。
  • 复现步骤:安装插件 → 运行 /cot-peek:start → 等 ZCode 完成一次 API 往返 → 悬浮窗出现中文译文;复制英文 → 划词页自动切页并出中文。

版本与市场注册: cot-peek 1.0.2,注册于根 marketplace.json 末尾,source 指向 ./external_plugins/cot-peek。

依赖、网络请求、权限和副作用:

  • 网络请求仅发往三个免费翻译接口,无需 key,无遥测;全部失败时保留原文并标红。
  • 只读 ~/.zcode/cli/rollout/ 会话文件与系统进程列表;只写插件自身目录内的日志、配置、锁文件。
  • 运行 pythonw.exe cot_peek.py;install.ps1 通过 schtasks.exe 注册每分钟检查的当前用户计划任务,-Remove 可卸载。
  • 无 hook、无 MCP server、不注入模型上下文、不写 ZCode 数据。仅支持 Windows。

第三方材料来源与许可证: 翻译由火山翻译、微软必应、MyMemory 公共网页接口提供,可用性随对方策略变化,工具自动降级。其余代码全部原创,MIT 协议,仅用 Python 标准库加 tkinter。代码主仓库:https://github.com/cobaltna/cot-peek

Self-check / 自查清单

  • Plugin name is unique kebab-case; new external plugin in external_plugins/<name>/ / 插件名唯一且 kebab-case,位于 external_plugins/cot-peek/
  • Usage category is set (productivity) / 分类已填写
  • Plugin type and affected names are declared above / 已声明插件类型与名称
  • version 1.0.2 consistent in BOTH plugin.json and marketplace.json / 两处版本号一致
  • README.md (EN) and README_CN.md (中文) both provided and equivalent / 中英文 README 齐备
  • description_i18n has both en and zh-CN / 双语描述齐备
  • No secrets, machine-specific paths, or private dependencies / 无密钥、无机器专属路径
  • Model/API/network dependencies documented / 网络依赖已写明
  • python3 scripts/validate.py passes locally: OK, 53 plugin(s) validated / 本地校验通过

@panda920

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically.

@panda920

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants