AI 助手与本地能力

1. 这份指南适合谁

本指南面向创业OS（SSOS）的企业用户、财务人员和需要处理业务资料的团队成员。网页端适合登录工作区、使用 AI 助手、上传资料和完成需要人工确认的业务流程。开发者也可以使用公开 CLI 将同一套受控工具接入本机 Agent。

税局登录、邮箱密码、验证码、证书、正式申报和缴款仍在对应网页中完成；AI 助手不会代替这些必须由本人确认的动作。

2. 从网页端进入

1. 打开 创业OS 登录页，使用自己的账号登录。
2. 按名称选择目标工作区，不需要输入工作区 UUID。
3. 在工作台中打开 AI 助手，按提示完成查询、资料整理或后续业务操作。

3. 网页端 AI 助手

网页端 AI 助手使用当前账号和工作区权限。它可以协助查询业务信息、整理资料和生成下一步建议；涉及写入、提交或资金与税务结果的操作仍会经过页面确认、服务端权限校验和审计记录。

AI 助手不依赖命令行包。CLI 与 MCP 接入是可选的开发者入口，首次实际调用仍会在浏览器中完成 OAuth 2.0 + PKCE 登录，并受当前工作区权限、操作确认和审计控制。

4. 上传与核对业务资料

在网页端上传发票、银行流水、底稿等资料后，先核对文件归属、条数、金额合计和异常记录，再决定是否进入后续账务处理。上传资料不会自动过账，也不会向税务机关提交。

5. Desktop 与本机 Agent 接入

签名 Desktop 构建可在受控工作区内使用 OpenCode 本地 Harness。公开 CLI 不替代 Desktop 运行时，而是为本机 MCP 客户端提供同一套受控工具入口。

一条命令接入（推荐）

1. 在要接入的项目目录打开终端。
2. 执行 npx -y @xaiverdeng/upos@latest setup --auto。
3. 命令只扫描当前项目中的配置标记和 PATH 中已安装的客户端，然后写入同一个 ssos MCP 配置与 ssos-tools Skill。
4. 重启对应客户端。首次使用工具时在浏览器中登录并选择有权限的工作区。

已全局安装 CLI 后

如果已经执行过 npm install -g @xaiverdeng/upos@latest，无需再次安装。进入要接入的项目目录，运行下面这条命令即可：

upos setup --auto

npm install -g 只安装 upos 命令；upos setup --auto 才会发现本机 Agent、注册 MCP bridge 并安装 Skill。两种入口最终写入相同的配置，不需要同时执行。

写入的配置使用 npx -y @xaiverdeng/upos-agent@latest mcp 启动本机 bridge，不保存邮箱密码、API Key 或访问令牌。Skill 默认写入当前项目的 .agents/skills/ssos-tools/SKILL.md；检测到 Claude Code 时也写入其 .claude/skills 兼容路径，让 Agent 知道从真实工具清单发现能力并遵守确认流程。如果已经存在同名 ssos 配置或 Skill，命令会停止，避免静默覆盖。

类型	说明
DeepSeek	模型提供商，不是独立 MCP 客户端。可由已支持 Harness 选用。
Hermes	官方流程需要交互式工具选择，因此不列入无人值守自动接入。
Z Code	名称不明确；如指 Zed，请使用已支持的 Zed 配置。

6. 常见问题

现象	处理
无法登录	确认浏览器可以访问创业OS，并使用受邀账号重新登录。
没有看到目标工作区	确认账号已加入该工作区；如仍未显示，请联系工作区管理员。
AI 助手没有某项能力	能力由当前工作区权限和发布状态决定，先确认账号权限或联系管理员。
提示找不到 upos	重新打开终端，确认 Node.js/npm 的全局 bin 目录已在 PATH 中；也可直接使用上面的 npx -y @xaiverdeng/upos@latest setup --auto。
执行后没有配置任何客户端	在目标项目目录运行命令，并确认目标 Agent 已安装或项目中已有其配置标记；未发现目标时不会写入无效配置。
资料金额不一致	暂停后回看原始银行或发票文件、重复记录和异常明细，再继续处理。

7. 需要本人确认的动作

• 输入邮箱密码、验证码或证书认证。
• 工作区授权、正式提交税表、电子签名和缴款。
• 对收入确认、重复发票、材料后补等会计口径作最终决定。

8. 相关入口

• 下载 PDF 版指南
• 登录创业OS网页端
• 网页端注册与登录
• 使用网页端 AI 助手
• 银行对账
• 上传票据与合同