Poko:本地优先的角色化 AI 桌面助手
yohan-work/poko · A character-led local AI desktop agent, starting with workspace-aware chat.
ELI5:它是什么,解决什么问题
Poko 是一个角色化本地 AI 桌面代理,以工作区感知对话为起点,为本地编程代理工具提供友好的桌面交互界面。它把对话历史、任务和显式记忆保存在本机 SQLite 中,通过本地安装的 Codex CLI 或 Claude Code 执行只读的项目分析,并在执行命令或修改文件前弹出审批卡,编辑默认关闭且支持撤销。macOS 上还提供屏幕伙伴功能:查看指定窗口内容,或在 Safari、Chrome、Arc、Firefox、Edge 的网页中逐步代操作,每一步都需要用户批准。
核心能力与快速开始
★ 0 · TypeScript
- 能做什么
- 以角色化桌面应用的形式与用户对话,管理多会话、任务、活动和本地记忆;调用本地 Codex CLI 或 Claude Code 做只读项目分析并流式回复;对命令执行和文件修改提供逐项审批卡,编辑默认关闭、需按文件夹开启并以 diff 形式审批,支持撤销且撤销前会校验文件是否被改动;macOS 屏幕伙伴可查看选中窗口并用屏幕角色指向目标控件,或在浏览器网页中每次一步地点击、输入,每步均需用户确认;支持定时只读 Routines、语音口述提问、答案朗读、文件与图片拖入、快捷面板与全局快捷键、按标题和消息搜索会话;SQLite 数据本地保存,凭证不存入数据库。
- 适用场景
- 在本地项目中用自然语言向桌面角色询问代码或项目问题;让助手在审批与撤销保护下进行受限的项目分析和小范围文件编辑;在 macOS 上让助手查看指定窗口内容并解释;在浏览器中逐步授权助手完成搜索、打开页面并总结信息等任务;把偏好、项目信息和决策作为记忆保存并在后续对话中复用;按计划运行只读的日常请求。
- 项目形态
- 可直接使用的工具
- 部署方式
- 本地桌面应用,安装包为 macOS(Apple silicon)的 dmg,通过 pnpm 构建与打包;应用本身无账号与服务器,数据保存在 Electron 用户数据目录的本地 SQLite 中;屏幕伙伴需要 macOS 屏幕录制与辅助功能权限,并需要 Xcode 命令行工具。
- 主要依赖
- 需要本地已安装并登录的 Codex CLI(0.159.0 或更新)或 Claude Code,二者分别使用各自的 ChatGPT / Claude 登录;构建需 Node.js 24+ 与 pnpm 10+;屏幕相关功能仅限 macOS。
- 使用限制
- 项目自述为早期阶段;屏幕伙伴仅支持 macOS,且只对 Safari、Chrome、Arc、Firefox、Edge 中 http(s) 网页执行操作,其他应用与浏览器工具栏、设置页仅可查看;密码字段不会被输入,指向安装包或压缩包的链接被拒绝;Codex 的命令请求始终被拒绝;Claude Code 沙箱内命令的文件改动无法撤销;SQLite 内容在 v0.1 为本地未加密存储;屏幕任务会把某个窗口的截图与元素名称发送给 Codex(OpenAI),截图在任务结束后删除;未签名构建每次重新构建后需重新授权屏幕权限。
- 许可证
- MIT
- 最近推送
- 2026-10-08 14:46
资料检查:2026-10-09 07:00 · 卡片整理:2026-10-09 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证 · 本次更新未完成,保留上次成功内容
职业应用
程序员
在本地项目工作区中通过桌面角色界面进行只读的项目分析,由本地安装的 Codex CLI 或 Claude Code 执行;可在审批卡中逐条批准命令或文件修改,编辑默认关闭并支持撤销,还可运行测试、构建等已批准的项目命令。
查看内容依据
Poko sends read-only project-analysis requests to the locally installed Codex CLI, shows understandable progress, and reports the result.
由 AI 根据来源材料整理,未进行安装或运行验证
HR
在浏览器窗口中逐步代操作网页任务,例如查找公司官网并总结招聘菜单内容,每一步都需用户批准。
查看内容依据
Examples: "검색창에 오늘 날씨를 검색해 줘", "구글에서 OO 공식 사이트를 찾아 들어가서 채용 메뉴 내용을 요약해 줘", "받은편지함에서 9월 30일 OO에게 온 메일을 열어서 요약해 줘".
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。