technical-blog

远飞闲记

所属分类:技术博客与个人站

以中文记录 AI Agent、开发工具与产品实践。

远飞闲记是一份以中文写作的技术博客,围绕阅读、思考和技术发布文章。首页用卡片列出最新内容,并通过归档、标签、链接等入口组织旧文章。近期主题集中在 AI Agent、开发工具和产品实践,例如 DeepSeek Harness 框架及其桌面端尝试、OpenCode 自定义工具和 SkillPay。对想了解开发者如何把新技术放进真实软件项目的人来说,这些文章提供了从目标、实现到踩坑过程的连续记录。

远飞闲记:DeepSeek Harness macOS 封装实录

发布于 2026年10月22日更新于 2026年10月27日

以最新文章为入口

首页展示标题、日期、阅读时间和简短摘要,让读者先判断内容是否相关,再进入完整文章。文章列表覆盖的不只是框架介绍,也包括如何扩展编程助手、如何让技能服务形成支付流程,以及对 AI 产品现象的分析。归档适合按时间回看,标签可以按项目名或技术主题聚合,Link 页面则提供站点关联入口。这样的结构适合内容持续更新的个人技术站:新文章便于发现,旧内容仍能通过目录回访。

远飞闲记首页的文章卡片与栏目导航

从 DeepSeek Harness 看桌面化改造

关于 DeepSeek Harness 的文章记录了一次具体的桌面端尝试。原框架以 AI Agent 为核心,文章介绍其插件化设计:模型接入、工具注册、会话日志乃至 Agent 主循环都可以按模块组合。使用者可以通过命令启动 Web 形态,在浏览器中选择工作区并让 Agent 处理任务。作者希望降低向朋友演示时的启动门槛,于是尝试为它套上 macOS 外壳。

DeepSeek Harness 桌面端文章介绍项目结构与章节目录

文章先说明为什么将网页静态文件直接放进桌面应用并不足够。界面背后的服务还要提供插件资源、接口桥接和实时通信等能力,应用必须按实际宿主环境启动。文中采用 Electron 窗口启动本地宿主进程,再等待服务报告实际地址后加载页面。这个安排把桌面窗口与 Agent 服务的生命周期关联起来,避免只打开界面却没有后端能力的情况。

进程管理与打包边界

本地端口交给系统分配,可以减少固定端口冲突的可能;关闭窗口时先尝试正常结束宿主进程,超时后再强制退出,则能避免留下后台进程。文章也提到将渲染界面限制在本地来源范围内、保持沙箱隔离等考虑。这些细节说明,桌面化并不只是把网页装进窗口,还需要管理服务启动、地址发现、权限边界和退出清理。

构建和分发同样会遇到桌面端特有的问题。文章记录了使用 electron-builder 打包 macOS 应用、生成安装包,并通过 GitHub Actions 自动构建不同架构产物的过程;同时也描述了工作区依赖探测和发布文件筛选带来的调整。对于开发者而言,这些失败经验可以作为检查清单:确认打包环境不会误用仓库根目录配置,验证最终归档只包含预期文件,并让持续集成重复执行同一套构建步骤。

作者也明确说明当前桌面客户端仍是概念验证。它尚未完成签名和公证,也没有把宿主代码及 Node 运行时一并封装进安装资源,普通用户分发前还需要处理这些事情。这个边界信息十分重要:文章展示的是开发阶段的架构探索和自用原型,不应被理解为已经面向大众发布的完整产品。读者可借鉴思路,但要按自身应用的安全与分发要求补齐工作。

博客内容适合怎样阅读

如果读者关注 AI Agent,可以从 DeepSeek Harness 文章了解插件化结构、交互方式和桌面封装的取舍;如果更关心开发效率,可继续浏览 OpenCode 自定义工具等内容,观察如何扩展编程助手的能力。SkillPay 相关文章则从技能创作与付费使用的关系切入,体现博客也会讨论工具生态和产品机制。不同文章以项目或现象为出发点,既交代目标,也会说明实现过程和未解决的问题。

这类实践记录的阅读价值,在于它把抽象技术选择放到具体约束中:启动命令是否容易使用,后台进程如何退出,打包产物是否完整,原型与正式分发之间还差哪些步骤。读者可以据此形成自己的检查框架,而不必照搬某个方案。尤其是涉及 AI Agent 执行本地任务时,应额外确认权限提示、工作目录边界和敏感操作处理,不能仅凭界面看起来可用就认定安全。

远飞闲记以文章而非在线工具为主要形式,适合开发者、技术爱好者和关注 AI 软件工程实践的读者浏览。它的归档和标签导航能帮助从最新内容延伸到相关主题;详实的项目文章则提供结构、决策与局限的上下文。阅读时结合当前项目版本核对命令与依赖,尤其留意作者标明的 POC 状态和分发限制,能更准确地把经验转化为可用参考。

用归档与标签建立自己的阅读路线

浏览这类持续更新的技术博客时,可以先从首页的摘要判断文章主题,再利用标签找到同一工具或项目的后续记录。归档提供按时间回溯的路线,适合寻找某个项目从最初尝试到调整实现的过程;标签则适合横向比较不同文章中的技术对象。读者也可以将文章中提到的仓库、命令和工具名称作为线索,回到官方文档核对版本变化。这样既保留了实践记录的现场细节,也能避免把个人项目中的选择误当成所有环境都适用的通用结论。

对 AI Agent 工具的实践尤其如此。执行代码、修改文件或运行命令的能力会受到工作区配置、模型和权限策略影响。阅读桌面端封装经验时,应同时检查宿主进程如何启动、应用退出时怎样清理、窗口可以访问哪些地址,以及敏感操作是否有明确确认步骤。文章把这些问题与桌面应用的构建过程放在一起讨论,因此不仅适合关注 Electron 的读者,也适合希望理解本地 AI 工具部署边界的开发者。结合版本文档重新验证后,再将某一做法迁移到自己的项目,会更稳妥。