CoStrict Cloud

CoStrict Cloud 是一款AI 驱动的云端编程工作空间，支持随时随地通过浏览器远程连接本地/私有服务器个人设备，内置对话式 AI 编程、项目文件管理、多会话留存、远程终端协作能力，实现浏览器无感远程开发、AI 实时编码调试、跨设备项目无缝流转。

快速开始

1. 登录账号

官方云端入口：https://zgsm.sangfor.com/cloud

打开上面默认云端地址进入网页端，先登录平台个人账号；未登录用户点击左侧边栏底部登录按钮完成账号登录。

重要注意： CoStrict CLI 命令行端 与 CoStrict Cloud 网页端必须登录同一个账号，账号不一致会导致设备无法在网页端设备列表中正常显示。

2. 注册设备

在需要被远程连接的个人电脑/服务器上，先安装 CoStrict CLI 工具。

CLI 执行账号登录：

cs auth login

登录完成后，执行设备注册启动命令：

cs cloud start

首次执行 cs cloud start 会自动从云端拉取依赖插件、运行时组件，耐心等待自动下载安装即可，无需手动干预。

注册成功后，当前设备会自动同步展示在网页端左侧设备列表中。

3. 创建工作空间

1. 访问默认云端地址：https://zgsm.sangfor.com/cloud，进入设备列表；
2. 找到已注册在线设备，点击设备卡片右侧 「+」按钮；
3. 选择设备上本地项目目标工作目录，即可完成工作空间创建；
4. 每个工作空间唯一对应设备上一个独立项目目录，支持多项目分别创建隔离工作空间。

4. 连接工作空间

工作空间状态为空闲时，点击工作空间卡片右侧连接图标即可一键建立远程连接。

连接成功后可使用核心能力：

• 远程对话编程：与 AI 助手实时交互，需求提问、代码生成、Bug 调试、逻辑重构；
• 多会话管理：自由新建、切换、回溯会话，完整保留历史对话上下文；
• 远程项目协作：浏览器端直接浏览、编辑、运行远程设备代码文件；
• 内置接口文档：自带 API 接口文档地址，可直接调试服务接口。

---

技能商店

🧩 技能商店（知识中心）

地址：https://zgsm.sangfor.com/cloud/store，是扩展 AI 编程能力的一站式平台，提供四类核心扩展能力：

1. 四大模块

模块	作用	典型场景
技能（Skill）	封装特定任务的指令、模板和工作流的能力包，AI 会自动匹配执行对应逻辑	需求分析、后端开发、前端设计、部署运维等标准化流程
子智能体（Subagent）	专注单一职责的 "专家角色"，可被主 AI 调用协作处理复杂任务	资深 Java 后端工程师、代码审计专家、测试工程师等角色化智能体
命令（Command）	可直接在 CLI / 对话中执行的快捷指令，封装常用操作的脚本 / 命令模板	一键部署、环境初始化、日志排查等重复操作
MCP 服务器	基于模型上下文协议的标准化工具连接器，让 AI 安全调用外部服务 / 数据	连接数据库、第三方 API、云服务等外部资源

2. 技能卡片关键信息

• 标题 / 描述：说明技能用途与场景（如 azure-servicebus-py 是 Python 消息队列开发工具封装）；
• 分类：快速筛选场景（需求分析、后端开发、前端开发、部署运维等）；
• 风险等级：标注「无风险 / 低风险 / 中风险」，帮助判断是否适合生产环境；
• 标签：如 development design，方便按关键词筛选；
• 来源平台 / 分值：标注社区来源与热度，识别优质资源；
• 收藏量 / 更新时间：反映社区认可度与维护状态，优先选择更新近、收藏高的技能。

3. 使用价值

• 开箱即用的专业能力：无需编写复杂 Prompt，一键加载即可让 AI 具备特定领域的专业能力；
• 降低重复造轮子成本：复用社区沉淀的最佳实践，提升开发效率；
• 灵活扩展工作流：通过子智能体、MCP 服务器，让 AI 适配复杂业务场景。

---

指标看板

核心价值主张

用真实数据量化 AI 对开发效率的提升，让"AI 提效"从感性认知变成可度量、可追踪、可优化的生产力指标。

关键能力

1. 自动采集，零打扰
   • 客户端自动采集 IDE 中的 AI 对话数据和 Git commit 数据，开发者无需额外操作
2. 智能预估，双轨对比
   • AI 分析代码复杂度，预估"传统开发所需时长"
   • 结合时间序列算法计算"AI 辅助实际耗时"
   • 自动生成提效比（传统时长 / 实际耗时）
3. 多维度下钻
   • 按任务(task) → 提交(commit) → 仓库(repo) → 项目(project) → 用户(user) → 组织(org) 逐层聚合
4. 人工校准，确保可信
   • 支持对 AI 预估时长和实际耗时进行人工修正，并记录修正理由，保证数据可靠性
5. 虚拟组与多级组织
   • 支持自定义虚拟组（如跨项目小组）
   • 适配多级组织架构（org1~org9），满足大型企业管理需求

Note: 指标看板涉及组织效能信息，需联系管理员开通查看权限。

---

常用运维命令

启动云端服务

首次注册/服务停止后，执行启动命令：

cs cloud start

重启云端服务

当设备掉线、连接异常、服务卡死时，可执行重启命令：

cs cloud restart

正常启动日志示例

➜  cs cloud start
  ✓ Device registered
  device_id: 21484ad96b82e1468cba65be0e55a666df1aba78834ffdeee19404a5e72b0ce9
  ✓ Device token validated
  → Starting daemon...
  ✓ cs-cloud started
  pid: 16571
  mode: cloud
  url: http://127.0.0.1:56973
  docs: http://127.0.0.1:56973/api/v1/docs
  logs: /User/user/.costrict/cs-cloud/app.log

关键信息说明：

• device_id：设备唯一标识；
• pid：后台守护进程号；
• url：本地服务访问地址；
• docs：接口文档地址；
• logs：日志文件路径，排查问题核心依据。

---

常见问题 FAQ

Q1：CLI 已启动，但网页端看不到已注册设备？

A1：

1. 务必使用默认云端地址访问：https://zgsm.sangfor.com/cloud；
2. 检查 cs auth login 登录账号 与 网页端登录账号完全一致；
3. 执行 cs cloud restart 重启服务，重新同步设备列表；
4. 检查本地网络是否能正常访问云端平台，防火墙未拦截端口。

Q2：首次执行 cs cloud start 卡住、下载缓慢？

A2：

1. 首次启动会自动拉取云端插件和依赖，属于正常流程；
2. 检查设备网络连通性，可切换网络重试；
3. 不要手动中断进程，等待自动完成初始化。

Q3：工作空间连接失败、频繁掉线？

A3：

1. 先执行 cs cloud restart 重启本地守护进程；
2. 查看日志文件：~/.costrict/cs-cloud/app.log 排查报错；
3. 确认设备本地防火墙、安全组未拦截服务端口。

Q4：使用异常、报错、功能不可用怎么排查？

A4：

所有异常问题优先通过日志文件定位原因，日志路径：

~/.costrict/cs-cloud/app.log

可查看进程启停、设备认证、网络连接、插件加载等全量日志，快速定位故障点。

Q5：如何查看本地运行的服务地址和接口文档？

A5：

执行 cs cloud start 启动成功后，终端会自动输出：

• 本地服务访问地址 url
• 接口文档地址 docs

直接复制到浏览器即可访问。

---

了解更多

• 官方云端默认入口：https://zgsm.sangfor.com/cloud
• 立即体验工作空间：CoStrict Cloud 云端工作空间
• 能力扩展：应用商店 - 技能/子代理/MCP 服务器
• 官方文档&动态：costrict.ai