1. 先把痛点说清楚：补全会写下一行，但不会替你收尾

很多团队对 AI 编码的体验，其实还停在这一层：

敲到一半，下一行出现了；写单测时，能补个方法骨架；偶尔让聊天窗口「解释这段代码」，还算顺手。

这些能力有价值，但它们解决的是 局部敲键成本 ，不是 任务交付成本 。

真正耗掉工程师半天到几天的，往往是另一类工作：

读懂陌生模块，再动刀；跨多个文件改接口与调用方；跑构建 / 测试，看报错，再改；整理 diff，写清楚「改了什么、怎么验」；修完还要盯着回归、文档、重复杂务。

补全几乎不会替你做完这些。它不会主动打开工作区、不会规划步骤、不会在终端里迭代到「可 review」，更不会在你通勤时继续把任务往前推。

所以，当市面上开始讲 Coding Agent 时，如果仍用「更强的智能补全」去理解它，就会系统性低估——也会系统性用错。

2. 行业在跃迁：补全 → 结对 → 可委派的执行体

不必堆一长串竞品名字，只需要记住一条几乎成为共识的演进线：

阶段典型形态你得到的是什么你仍然要做的补全行内 / 块级建议更少击键目标、结构、正确性几乎全靠人结对侧边聊天 + 选中代码解释、草稿、局部改写粘贴上下文、串步骤、收尾验证可委派 Agent在工作区里读文件、改代码、跑命令多步任务的推进与交付物定方向、定边界、做审核

关键变化不是「模型更会聊天」，而是：

上下文从「你粘贴的片段」变成「工作区与仓库」；动作从「生成文本」变成「调用利器并迭代」（读、搜、改、执行）；产出从「一段建议」变成「可 review 的改动与说明」。

同行宣传里反复出现的母题也是同一句： 人升维做架构与判断，agent 在可控边界里干实现与脏活。 不是「替代编程人员」，而是「把开发者从逐行实现里抽出来」。

理解了这层，再看 SolonCode，才不会把它装成「又一个聊天框」。

3. SolonCode 的身份句：开放源代码、中文驱动、模型自由、多端上岗的编码智能体

官方在「和 Claude Code 有什么不同」里写得很克制，差异点可以压缩成五条（原文精神，非营销扩写）：

Java 实现，100% 开源；兼容毕昇 JDK、鸿蒙 PC 等企业常见环境诉求。全中文提示词驱动与构建（官方明确：如果不会中文，不建议使用）。不绑定特定模型提供商——没有预置绑架，按需配置；可走信任的供应商或内部网关，也强调离线/私有化配置空间。同一成果多外壳：终端 CLI、浏览器 Web、桌面 Desktop。远程协作入口：兼容 Web，以及ACP协议做远程通讯。

在公开传播里，团队还常用一个更口语的人设：

全中文驱动的数字员工 ——能理解需求、规划步骤、编写代码；不挑模型、不挑服务体系，打开终端就能上岗。

「数字员工」不是说它有工号，而是强调工作方式： 接任务 → 在环境里干活 → 交出可检查的结果 ，而不是只在对话框里「像人一样说话」。

隐私口径同样来自官网，写文章时必须忠实复述：

SolonCode 不会存储 你的代码或上下文信息；处理在本地完成，或通过 直接 API 调用 发送到你配置的 AI 提供商。 因此，安全边界很大程度上取决于： 你是否信任该提供商或内部 AI 网关 。

这与「云端默认托管你的仓库」类作品是不同的信任模型——不是自动更安全，而是 路径更可说明、选择权在你 。

4. 「数字员工」实际在做的四件事

把 SolonCode 当员工用，比当补全用，心智要对齐下面四步。这四步都能在官方文档体系里找到对应能力，而不是口号。

4.1 理解需求与工作区

启动目录即工作区。官方快速开始建议在方案根目录运行，并可以先让它观察项目：

请先阅读当前项目结构，告诉我这是一个什么科技栈，并说明构建和测试命令。

若方案里已有 .soloncode/CODE.md ，智能体会优先参考其中的工程规范；没有则可以让它生成构建/测试/修改注意事项。 身份与行为规则则落在 AGENTS.md （全局 ~/.soloncode/AGENTS.md 或工作区 .soloncode/AGENTS.md ）——这是把「团队怎么干活」写成可执行上下文的入口，而不是每次聊天从头说教。

4.2 规划步骤（必要时分工）

复杂任务不会只靠一轮生成糊弄过去。文档体系里有：

任务清单（TODO）：会话级进度，避免长任务失忆；子代理（subagent）：把探索、规划、命令执行等委派给不同权限的专家角色（如explore/plan/bash/general）；Loop / Goal：从「聊一次」升级到「冲着目标循环推进」，适合巡检、回归、周期性杂务（需配合预算与停止条件，避免空转）。

这些能力的共同点是： 步骤可见、可中断、可继续 ，而不是黑盒一次吐完。

4.3 改代码、跑命令、用助手

Agent 的价值在助手闭环：读文件、搜索、编辑、终端命令、网络检索、技能（Skills）、MCP 等。 官方效果测试从简到难，本身就是在教你「怎么交任务」：

你好—— 确认对话与模型通路；带网络与技能的调研/产出任务；带设计文档 + 后端 + 前端的多文件工程任务。

CLI 提示里也能看到交互语义： (esc) interrupt 、 /(tab) command 、 $(tab) skill 、 @(tab) agent ——说明作品把 中断、命令、技能、指定代理 当成一等公民，而不是隐藏彩蛋。

4.4 等人审核（Human-in-the-loop）

可委派不等于可放飞。工程上合理的默认姿态是：

危险或高影响操作需要人确认（HITL 相关开关与工具权限在 Web 设置与文档中有专门说明）；最终合并权、生产推出权始终在人；好的任务描述应显式写出目标 / 范围 / 限制 / 验证方式。

官方快速开始给的提示词模板，几乎可以直接当团队规范：

目标：修复使用者登录接口的空指针问题。 范围：只允许修改 user 模块。 限制：不要改变接口返回结构。 验证：修改后运行相关单测；如果没有单测，请说明原因。

数字员工交出的是「待你签字的活」，不是「替你盖章的结论」。

5. 人升维之后，你的日常会变成什么样

如果补全时代你的时间结构是：

想 → 敲 → 补全 → 再敲 → 本地跑一下 → 提交

Agent 时代更接近：

定义完成标准 → 委派 → 看 diff / 日志 → 纠正边界 → 验收合并

你仍然是工程师，只是工种重心上移：

你更应该花时间的更适合交给 SolonCode 推进的需求取舍与接口契约按契约改多文件实现风险判断与回滚策略编译错误清扫、测试修复迭代Code Review 与规范沉淀按AGENTS.md/CODE.md执行约定生产与权限决策在授权范围内跑命令、整理变更说明

这也解释了为什么「会写提示词」突然变关键——你不是在跟自动完成讨价还价，而是在 给同事派工 。派工越清楚，返工越少。

6. 三条最小证据：别靠形容词相信它

宣传最容易飘。下面三条都可以在你自己的机器上 15 分钟内核对，全部来自官方安装与运行说明。

证据 A：一条安装命令，系统命令形态上岗

macOS / Linux / Harmony PC：

curl -fsSL https://solon.noear.org/soloncode/setup.sh | bash

Windows PowerShell：

irm https://solon.noear.org/soloncode/setup.ps1 | iex

soloncode version

前置条件很务实： Java 8+ ，以及一个你自己的大型语言模型接口（OpenAI / Anthropic / Gemini / Ollama 等兼容形态均可，按你的网络与合规选择）。

证据 B：推荐新手路径——先 Web 配模型，再进方案干活

soloncode web 0

进入页面后： 设置 → 大语言模型 → 添加模型 → 测试连接 。 这是官方对「新客户」的明确推荐，避免一上来就和配置文件死磕。

cd your-project soloncode web 0 # 或 soloncode cli

Web 更适合长会话、看文件树、看 Git 变更、管设置；CLI 更适合终端流与 SSH 场景。它们是 同一套智能体能力的不同外壳 ，不是三套互不相干的作品。

证据 C：一个「可演示」的小任务，而不是空洞 Demo

在工程根目录，用官方风格的小任务验证闭环：

请帮我检查 README 中是否有过时的安装说明，只修改文档，不改代码。完成后告诉我改了哪些内容。

成功判据建议写成可检查的三条：

它是否先读了仓库再改；diff 是否落在约定范围内；是否用中文清楚说明了变更与未做事项。

若你还要验证「远程上岗」叙事，可在跑通本地之后，再看官方文档《如何使用 web 绑定钉钉、飞书、微信》：把任务入口延伸到 IM，本质仍是 同一会话体系上的通道 ，而不是另一个黑盒机器人。

7. 边界：什么时候不该把它当数字员工

真实可靠的宣传必须写「不适合什么」。至少记住这些：

不会中文的团队：官方已提示不建议使用（提示词体系以中文构建）。无模型、无网络策略的环境：它不绑供应商，但你仍需自备可用模型或内网网关。期望「一句话重写核心架构且无人审核就上生产」：多步 agent 仍会犯错；没有范围与验证的委派，等于没有管理的外包。把安全完全外包给助手：数据是否出域，取决于你配置的提供商与网关；开放源代码可审计 ≠ 自动合规。只要行内补全、拒绝改变工作流的人：Agent 的收益来自「委派—审核」闭环；若只想要 Tab 补全，它可能不是最短路径。

这些边界不是示弱，而是 降低误装退坑率 ——装对的人留下，装错的人少骂。

8. 你若只做一件事：今天完成「第一次可演示成功」

按官方最短路径走即可：

安装（上文 curl / irm）；soloncode web 0配好模型并测试连接；cd到真实仓库，再启动 Web 或 CLI；用「只改文档 / 小范围修复 + 明确验证」完成一单；顺手写 10 行工作区AGENTS.md（构建命令、测试命令、禁止事项），让下一次委派更稳。

延伸阅读（均为官网文档树，便于深挖，不必一次读完）：

主题文档总入口https://solon.noear.org/article/soloncode安装到第一次对话https://solon.noear.org/article/1467工作区与 AGENTS.md / CODE.mdhttps://solon.noear.org/article/1411Skillshttps://solon.noear.org/article/1408子代理https://solon.noear.org/article/1413Loop / Goalhttps://solon.noear.org/article/1477IM 绑定https://solon.noear.org/article/1454源码仓库https://github.com/opensolon/soloncode

9. 收束：一句话记住 SolonCode

补全减少击键；结对减少卡壳；SolonCode 这类编码智能体，要减少的是「从意图到可 review 交付」之间的往返。

它想做的不是更会陪聊的编辑器插件，而是：

在你自己的工作区里，用中文听懂任务，在模型自由与开放源代码可审计的前提下，多步推进实现，并把结果交还给你审核的—— 数字员工 。

你负责方向、边界与签字；它负责在授权范围内把活干完、干到能看。