Skip to content
Back to search

Lingbo-Desk

A Windows desktop voice agent with real-time conversation, a Live2D avatar, and background tasks for files, Office documents, and the web.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/liguozheng-ac/Lingbo-Desk with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/liguozheng-ac/Lingbo-Desk'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liguozheng-ac--lingbo-desk/badge.svg)](/listings/liguozheng-ac--lingbo-desk)

HTML

<a href="/listings/liguozheng-ac--lingbo-desk"><img src="/api/listings/liguozheng-ac--lingbo-desk/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 180 lines
  1. <p align="center">
  2. <img src="docs/media/readme-banner.svg" alt="Lingbo Desk — Your work, in motion" width="100%" />
  3. </p>
  4. <p align="center"><strong>简体中文</strong> · <a href="README.en.md">English</a></p>
  5. <p align="center">
  6. <a href="#从一份要求到可复核的交付">真实案例</a> ·
  7. <a href="#让-agent-工作可控的设计">产品设计</a> ·
  8. <a href="#技术架构">技术架构</a> ·
  9. <a href="#快速开始">快速开始</a> ·
  10. <a href="docs/verification.md">验证记录</a>
  11. </p>
  12. <p align="center">
  13. <img src="https://img.shields.io/badge/Platform-Windows-64748b?style=flat-square" alt="Windows" />
  14. <img src="https://img.shields.io/badge/Agent-Tool%20Calling-b87592?style=flat-square" alt="Agent · Tool Calling" />
  15. <img src="https://img.shields.io/badge/Voice-ZH%20%2F%20JA%20%2F%20EN-8e7aae?style=flat-square" alt="Chinese, Japanese and English voice" />
  16. <a href="LICENSE"><img src="https://img.shields.io/badge/Code-MIT-64748b?style=flat-square" alt="Original code · MIT; third-party and asset terms apply separately" /></a>
  17. </p>
  18. # 聆泊 · Lingbo Desk
  19. **用自然对话发起桌面工作,在执行过程中调整要求,获得可追溯的文件交付。**
  20. 聆泊是 Windows 桌面语音 Agent 原型,将持续对话、原创 Live2D 角色和后台执行结合起来。面向个人资料整理与文档工作:任务运行时继续交流,需要调整时暂停改要求,涉及已有文件的修改先查看具体动作,最后下载并复核实际产物。
  21. <table>
  22. <tr>
  23. <td width="74%" align="center" valign="middle">
  24. <a href="docs/images/task-workbench.png"><img src="docs/images/task-workbench.png" alt="真实任务工作台:要求版本、执行回执、来源与 Word / Markdown 产物" width="100%" /></a>
  25. <sub>真实工作台 · 要求版本 / 执行回执 / 来源 / 文件交付</sub>
  26. </td>
  27. <td width="26%" align="center" valign="middle">
  28. <img src="docs/media/lingbo-original-live2d.png" alt="聆泊原创 Live2D 角色 B" width="100%" />
  29. <br /><strong>原创角色 B</strong><br />
  30. <sub>自动眨眼 · 基础语音嘴型<br />持续监听 · 自然插话</sub>
  31. </td>
  32. </tr>
  33. </table>
  34. *工作台截图来自合成报价资料的真实模型测试;截图中的桌面角色未连接,不代表角色与工作台同场语音验收。右侧为独立角色导出预览。*
  35. 当前本机安装版为 **0.3.7**;最新源码另含默认关闭的输入诊断与后续联测记录,尚未发布新版安装包。本仓库提供源码,安装包暂不公开。[版本更新](CHANGELOG.md) · [已知问题](#验证与当前边界)
  36. ## 一分钟看实际流程
  37. [![打开真实任务演示:资料、暂停改要求、复核交付](docs/media/workflow-preview.svg)](docs/media/lingbo-workflow-demo.webm)
  38. [**▶ 打开真实任务演示(约一分钟,无音频)**](docs/media/lingbo-workflow-demo.webm)
  39. GitHub 文件页可下载视频后用浏览器播放。
  40. 上传资料、后台执行、暂停改版,再查看实际摘要与 Word 下载。剪辑取自约 153 秒的原始录屏,省略中段逐项确认,并用说明卡标注;含本机路径的确认画面未公开。**这是文字操作与真实模型执行,不是语音演示,也不是任务耗时基准。** [剪辑与验证范围](docs/homepage-showcase.md)
  41. ## 从一份要求到可复核的交付
  42. > “比较这两份中日文供应商报价,说明数量、税费、运费和交期差异,生成中文 Word 报告,附日文摘要与待确认事项。”
  43. | 环节 | 用户怎么参与 | 系统实际做什么 |
  44. | --- | --- | --- |
  45. | 提供资料 | 上传一份中文、一份日文报价,说明交付要求 | 保存只读编号快照,创建归属于当前会话的任务 |
  46. | 后台执行 | 查看进展,继续与角色交流 | 独立工作进程运行工具调用循环,以实际回执更新任务 |
  47. | 调整要求 | 暂停,补充“运费税费口径未明确,不要直接判断谁更便宜” | 保存新版本要求,检查状态后恢复;暂停不会回滚已发生的操作 |
  48. | 审阅修改 | 查看拟修改的文件与内容,确认具体动作 | 检查权限和原文件 SHA256,备份后执行,记录回执 |
  49. | 取得结果 | 下载 Word 与 Markdown,核对引用和待确认项 | 检查声明产物及固定验收条件,保留来源、版本与执行证据 |
  50. 该案例使用**虚构资料与真实 DeepSeek**,通过文字操作工作台完成。它展示任务控制与交付流程,不是采购决策准确率评测,也不代表真人语音完成整条任务链。
  51. [完整案例与产品取舍](docs/HR-展示案例.md) · [输入资料](docs/demo-inputs) · [真实后台文字联测](docs/headless-text-verification.md)
  52. ## 让 Agent 工作可控的设计
  53. | 设计 | 要解决的使用问题 | 实现依据 |
  54. | --- | --- | --- |
  55. | **对话与工作分开调度** | 长任务运行时,用户仍能交流与查询进度 | 前台对话编排 + 独立 Agent 工作进程 |
  56. | **暂停后修改要求** | 执行过程中发现遗漏,不必只依靠重新提问 | 任务状态机、要求版本、检查后恢复 |
  57. | **具体动作确认** | “帮我改文档”不能等同于任意修改授权 | 目录权限、动作预览、SHA256、备份和执行回执 |
  58. | **用证据确认交付** | 模型说“完成”不代表文件真的存在或符合要求 | `work_finish`、当前版本回执、产物哈希与声明条件检查 |
  59. | **保留人的复核位置** | 有引用和文件仍可能存在业务理解错误 | 只读资料快照、段落编号、产物预览和待确认事项 |
  60. 产品工作包括需求定义、交互流程、架构取舍和验收设计,工程实现与验证使用 Codex 辅助。具体能力由本地集成层、引入的执行引擎及第三方组件共同提供;原创代码、第三方代码与角色素材的授权分别见[许可说明](#许可证)。
  61. ## 能力概览
  62. | 方向 | 当前范围 |
  63. | --- | --- |
  64. | 语音交流 | 中 / 日 / 英识别与合成、持续监听、自然插话、停止旧播报;音频切分后识别,不是端到端音频模型 |
  65. | 桌面角色 | 原创 Live2D 角色、眨眼、基础动作、音频强度驱动的嘴部开合与窗口拖动 |
  66. | 后台工作 | 文件与 Office 处理、独立浏览器会话、进度查询、暂停 / 修改 / 取消 / 检查后恢复 |
  67. | Skills | 本地导入、启停、内容版本及任务版本绑定;尚无跨 Agent 自动同步或在线技能市场 |
  68. | 记忆与模型 | 明确保存的长期记忆;DeepSeek 云端 API / 本机 Ollama 切换,语音服务单独配置 |
  69. ## 技术架构
  70. ```mermaid
  71. flowchart TB
  72. desktop["桌面交互 · Electron / Vue<br/>角色 / 对话 / 音频 / 工作台"]
  73. gateway["本地后端 · Node.js<br/>任务管理 / 模型路由 / 语音适配<br/>权限校验 / 工具执行"]
  74. worker["独立 Agent 工作进程<br/>模型决策 / 工具调用循环"]
  75. providers["模型与语音服务<br/>DeepSeek / Ollama / ASR / TTS"]
  76. storage["本地数据与产物<br/>来源 / 记忆 / Skills / 回执 / 文件"]
  77. desktop <-->|HTTP / 流式响应 / SSE| gateway
  78. gateway <-->|进程 IPC / 本机 HTTP| worker
  79. gateway <-->|服务 API| providers
  80. gateway <--> storage
  81. ```
  82. 模型与语音适配模块位于本地服务内,实际请求对应的服务商或本机 Ollama;图中分支不代表独立微服务。桌面端仍负责对话编排、音频采集、播放与打断。工作进程通过网关调用模型与工具,真实文件操作由后端校验后执行。
  83. | 源码入口 | 关注点 |
  84. | --- | --- |
  85. | [桌面启动器](desktop/launcher/package-bootstrap.mjs) / [工作台窗口](desktop/launcher/workspace-window.mjs) | 单实例、服务生命周期与统一入口 |
  86. | [网关](backend/server.mjs) / [模型路由](backend/model-router.mjs) | 会话归属、流式响应、模型选择与请求取消 |
  87. | [任务服务](backend/work-service.mjs) / [工作进程](backend/work-worker.mjs) | 任务状态、版本、子进程与工具调用循环 |
  88. | [工具执行](backend/work-tools.mjs) / [权限策略](backend/work-policy.mjs) | 文件、Office、浏览器、动作确认与执行证据 |
  89. | [完成检查](backend/work-finalize.mjs) / [工具契约](backend/work-schema.mjs) | 工具预算、完成回执与产物验收 |
  90. | [Skills](backend/personal-skills.mjs) / [个人存储](backend/personal-store.mjs) | 技能导入、版本与明确记忆 |
  91. [后端架构详解](docs/backend-architecture.md) · [源码目录](docs/source-layout.md) · [工具执行边界](docs/work-execution-hardening.md)
  92. ## 验证与当前边界
  93. | 证据 | 能说明什么 | 不能据此推导什么 |
  94. | --- | --- | --- |
  95. | 142 项后端自动化检查;诊断源码上传时另复核 3 项监测测试 | 各自测试范围内的逻辑行为 | 真实任务成功率或桌面流畅度 |
  96. | 11 个真实模型文字联测检查点 | 多轮对话、任务控制、文件交付、取消和重启读状态的固定样本 | 11 个独立业务任务、长期稳定性或语音端到端通过 |
  97. | 69 项对话运行时 + 7 项打断逻辑模拟测试 | 模拟 provider / 回执条件下的轮次归属与旧输出隔离 | 物理麦克风、回声抑制或实际声音停止 |
  98. | 0.3.5 真人反馈与历史集成记录 | 该版本连续交流、嘴型、自然打断等已确认体验 | 最新版本完整语音任务链的验收或性能基准 |
  99. **仍需完善**:隔离桌面测试中出现的聊天聚焦卡顿、空白窗口与退出原因尚未确定;真实模型样本曾出现完成说明与后台状态不一致。长期记忆尚无自动提炼与向量检索;复杂 Office、睡眠唤醒和跨设备部署需继续验证。独立工作进程不是操作系统沙箱,Skills 脚本具有当前用户权限。
  100. [完整验证记录](docs/verification.md) · [后台文字联测](docs/headless-text-verification.md) · [桌面问题排查](docs/chat-input-investigation.md) · [版本更新](CHANGELOG.md)
  101. ## 快速开始
  102. 环境:Windows x64、Node.js 24、pnpm 11、Python 3.12。首次配置、原生依赖与角色素材说明见[环境与启动](docs/setup.md)。
  103. ```powershell
  104. pnpm --dir desktop install --frozen-lockfile
  105. pnpm --dir engine install --frozen-lockfile
  106. pnpm --dir speech install --frozen-lockfile
  107. python -m venv .venv
  108. .venv/Scripts/python -m pip install -r requirements.txt
  109. Copy-Item .env.example .env
  110. # 编辑 .env,填写自己的服务凭据;也可启动后在本机配置页面加密保存
  111. pnpm start
  112. ```
  113. 后端与任务工作台默认地址为 `http://127.0.0.1:3850`。以上命令启动后端;桌面角色需要另行构建,并导入本人已接受适用条款的 Cubism Core。仓库不包含 Core、第三方角色或语言模型权重。
  114. <details>
  115. <summary>桌面构建与检查命令</summary>
  116. ```powershell
  117. pnpm --dir desktop run build:modules
  118. $env:LIVE2D_CORE_PATH="C:/your-sdk/Core/live2dcubismcore.min.js"
  119. pnpm run prepare:desktop
  120. pnpm run build:desktop
  121. pnpm test
  122. pnpm run verify:task
  123. pnpm run check:source
  124. pnpm --dir desktop run typecheck
  125. ```
  126. 检查结果需结合相应验证记录理解;运行自动化测试不等同于真实桌面任务验收。
  127. </details>
  128. ## 关键词
  129. `AI Agent` · `Voice Agent` · `Desktop Automation` · `Tool Calling` · `Human-in-the-loop` · `Task Orchestration` · `Agent Skills` · `Electron` · `Vue 3` · `TypeScript` · `Node.js` · `Live2D` · `DeepSeek` · `Ollama`
  130. ## 许可证
  131. 聆泊原创且由项目权利人有权授权的代码采用 [MIT 许可证](LICENSE)。引入的第三方代码及组件适用各自的许可证及版权声明;这不表示全部代码均由本项目原创。字体、图标、模型与 SDK 遵循各自条款。原创 Live2D 素材及预览用于项目展示,复用需另行取得授权,详见[第三方组件与素材说明](THIRD-PARTY-NOTICES.md)。
  132. 仓库不包含个人配置、密钥、聊天记录或已安装依赖。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.