Skip to content

xgg-cycle

Verified

xgg-cycle · v0.3.1 · MIT · Web UI

Workspace project-cycle panel for DeepSeek Harness Desktop

Install

dsh plugin add xgg-cycle

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Creators

Readme


description: "面向用户的 xgg-cycle 工作区流程面板,用于通过关联会话管理需求、原型、开发、测试、修复与部署,并支持只读接入已经存在的项目。" kind: "package-bundle"

@deepseek-ai/dsh-client-ui-xgg-cycle

English | 中文

概述

dsh-client-ui-xgg-cycle 为 Web Client 添加按工作区隔离的项目流程面板。面板记录项目信息与需求,把需求扩展为功能分组,并向会话投递结构化的原型、开发、测试、修复与部署轮次。随附的 web Profile 已包含本包;自定义 Profile 可以安装它的 Bundle 层。面板数据按工作区持久化到浏览器存储,而会话消息与回复仍是 agent 实际执行工作的权威记录。已经存在的项目可以由一次只读梳理轮接入:它会把项目事实与已实现功能登记成账本。

目录


使用本包

从会话头部打开需求面板。添加项目事实与需求,扩展每条需求,确认需要的功能点,然后单独运行各阶段或启动无人值守流程。投递会选择目标会话,因为只有已打开的会话才会接受用于判断完成状态的实时事件。

已经存在的仓库不必手工录入:在「需求」阶段点接入已有项目会投递一次只读梳理,确认后的结果成为账本里的项目信息、需求与功能点。

安装到 Profile

web Profile 已包含该配置行。对于其他兼容的 Web Profile,安装或移除 Bundle 后重启 Profile:

dsh plugin --profile <name> add @deepseek-ai/dsh-client-ui-xgg-cycle
dsh plugin --profile <name> remove @deepseek-ai/dsh-client-ui-xgg-cycle

Bundle patch 会插入 ui-xgg-cycle 配置行。它的浏览器半边依赖会话与工作区控制器、Conversation 与 Workspace UI 服务、slot renderer 和 locale runtime。

你会得到什么

面板为每个工作区保存独立的项目状态。「记录」阶段统计这个项目做过什么 —— 原型、开发、测试、修复、上线、接入梳理、需求扩展与全自动流程的次数,以及每次全自动的结局 —— 单调计数加最近 50 条操作;它与轮次记录分开保存,所以删掉一条轮次记录不会改写历史。从更早的版本接入的项目,会按面板上已有的轮次回填计数。每条最近操作还会显示来源和时间;关联到交付轮次后,还会显示会话、阶段与轮次、记录状态和结果摘要。最近一次全自动流程的节点记录也保留在该页,包含总结、执行步骤、关键文件、验证结果与剩余事项。「数据库」阶段以可编辑的 ER 图画布展示已完成原型与开发轮次报告的表和字段。用户可以拖动表、恢复自动布局、在 25% 至 400% 之间缩放、让设计适应可用区域、全屏打开画布、编辑或删除表和字段,并查看按 user_id 或 userId 常用命名连到目标表的关系线。用户也可以保存和删除任意两个字段之间的关联;删除任一端点时,对应的手动关联会一并删除。后续生成结果会保留手工修改的值、关联与画布位置,同时加入新报告的字段。标题栏可以在中文和英文之间切换持久化的应用语言,面板中的标签、选择器、状态和确认对话框都会跟随当前语言。每个规划或交付轮次都会先要求 agent 读取仓库指令、项目文档、清单、相关源码与测试以及 Git 状态;agent 在提出功能点或修改文件前会先总结当前实现。合并后的「原型与开发」阶段为手动操作提供 Mock 和完整项目两种方式。两种方式、后续修复与重复迭代都复用项目流程 · 原型与开发,因此一个项目不会拆成原型和开发两条会话。每个工作区有四个随当前语言命名的交付会话,中文名称分别是项目流程 · 功能点、项目流程 · 原型与开发、项目流程 · 测试和项目流程 · 上线。需求扩展与接入梳理共用功能点会话,只有本阶段没有会话时才会新建。已经关闭但没有归档的阶段会话仍可复用;重新打开时会保留原有记录,并把旧的自动标题规范为对应的阶段标题。「全自动流程」是带有「新项目」和「已有项目」两个入口的独立菜单阶段;它的看板会显示启动条件、完整运行路径、当前节点、测试与修复轮次、运行中变更的接入规则,以及持久化节点记录。无人值守流程始终开发完整项目:先生成缺失的功能点,再执行完整项目开发,并交替执行测试与修复,直到不再有 P0/P1 问题或完成五轮修复。每个节点进入下一节点前,都会保存一份可展开的详细记录,包含总结、执行步骤、关键文件、验证结果与剩余事项。节点运行期间新增或扩展的需求与功能点会在该节点结束后接入;流程会扩展尚未拆解的需求,用更新后的账本再次执行完整项目开发,然后继续测试。停止的流程会记住自己从新项目还是已有项目开始,因此在开发会话尚未创建时继续,也会从正确入口重启。接入梳理只有在给出证据文件时才把功能点标为「已有实现」;没有证据的说法仍然算待做,所以标错的代价是多做一轮,而不是悄悄漏掉一个功能。再次梳理只做增量合并,不会删除账本里已经记录的需求或功能点。服务器密码不会进入浏览器持久化,但直连服务器部署在投递时会把密码写入持久会话消息。


理解实现

实现细节——点击展开

浏览器插件在 conversation.session.header.utilities 注册一个流程入口,由会话头将它与其它会话操作一起排列。根作用域控制器可跨会话导航存活,并拥有持久化 store 与自动循环。它按已有轮次记录与显式名称解析阶段会话;原型、开发和修复记录只有一个开发会话归属,已保存项目中的旧原型和开发会话名仍然可以识别。面板通过注册注入的 hooks 通道取得 store;它的动作与徽标使用共享的 ui-primitives Button 与 Tag,因此控件尺寸、hover、disabled 与色调都由设计系统决定,而不是本包自建;对话框使用共享的 Modal(遮罩、焦点、Esc 与关闭语义都由它提供);瞬时提示托管在面板外部的 shell.overlay 中,因为失败的那次投递已经把面板导航掉了。通过 portal 呈现的 Modal 在打开时拥有指针关闭行为,因此确认或取消嵌套删除不会关闭后面的流程面板。文本框、多行追加框、原生下拉、相位导航栏与虚线的「新增」入口保留插件本地样式,因为没有对应 primitive。session-ask.ts 观察会话生命周期和事件窗口,直到出现新的 assistant 消息,或一个无消息轮次在队列为空时结束。协议解析器按预期键扫描每个 JSON 代码块,因此无关的 package 或配置 JSON 不会遮挡流程结果。其余部分合法的载荷若只缺少至多四个末尾对象或数组闭合符,解析器会补齐这些符号;括号错配、字符串未结束、尾随逗号及其它语法错误仍视为未完成。控制器把报告的数据库表合并到工作区 store;用户重命名表或字段后,生成名称仍作为后续结果的匹配键。接入梳理走同一条投递链路,确认后的结果以容错方式并入账本;已被开发轮次报告过的功能点会保留原有来源标记。

文件 职责
src/client/controller.ts 工作区 store、会话投递、完成监听与自动循环
src/client/project-model.ts 项目类型、规则、提示构造、接入合并与结果应用
src/client/session-ask.ts 会话提交、结束判断与 JSON 提取
src/client/PopupPanel.tsx 本地化流程界面与用户操作
src/client/toast.ts 由控制器与面板写入的瞬时提示 store
src/client/ToastHost.tsx 渲染当前提示的 shell.overlay 宿主
cordis.patch.yml 可安装的 Profile 层

进一步探索


模型体验

流程轮次消息

模型看到什么

每个已投递阶段都会成为所选会话中的普通用户消息。本包会组装仓库梳理指令、当前项目事实、需求、已确认功能点、可编辑的数据库设计、适用的实现或部署规则、未解决的手动问题,以及该阶段的 JSON 回复约定。梳理指令要求在阶段工作前给出当前状态摘要、保护用户未提交改动、让已有实现覆盖面向新项目的默认选型,并把需求规划限制为只读检查。完成的轮次会在阶段结果旁报告 {"roundComplete":true};原型与开发结果还会报告当前 databaseTables,开发结果还会报告已完成的功能点名称。续接消息会要求同一会话补齐缺失的必要结果。接入梳理是唯一在任何阶段记录存在之前读取仓库的轮次:它报告项目信息与按模块分组的功能点,每个功能点要么标明「已有实现」并给出证据文件,要么标为仍然缺失。

Token 影响

每次投递都会把完整组装后的阶段消息(包括梳理指令)加入所选会话,并保留 assistant 回复。开发、测试和上线每次投递都会携带当前项目账本,因此独立会话复用时不会遗漏两轮之间新增的需求;测试还会携带当前可编辑的数据库设计。自动节点回复包含结构化的 stepRecord,面板会先把它持久保存到流程记录,再投递下一节点。复用的会话可以确认仓库没有变化,而不必重复完整梳理。接入梳理增加的是它自己执行的仓库阅读;其后的阶段用常规段落携带已经登记的账本。本包不注册隐藏提示段或工具 schema。

KV Cache 影响

每个阶段会话内都只追加:重复的功能规划;原型、开发或修复;测试;以及上线轮次,都只扩展各自归属的请求前缀。Mock 与完整项目开发共用开发请求前缀。如果阶段目标不可用,会创建一个命名会话且没有可复用的记录前缀;首轮的完整阶段消息会把当前账本带入新会话。

已知限制与延期工作

  • 浏览器本地项目清单——需求、选择、数据库设计、轮次记录与自动循环状态不会在不同浏览器或设备之间同步。
  • 投递时导航——每次等待回复的投递都会打开其会话,因此流程运行期间当前对话会发生切换。
  • 依赖结构化回复——流程 JSON 缺失或格式错误会中止轮次或写入说明;容错提取不会推断省略字段。
  • 直连服务器凭据进入历史——密码不进入 local storage,面板记录中也会打码,但部署消息会持久写入所属会话。
  • 没有回滚——停止循环会中止面板等待与后续轮次;已经完成的文件修改、部署或 agent 工作不会撤销。
  • 梳理范围受模型上下文限制——大型仓库是在模型上下文内阅读的,不是穷尽读取;梳理没有覆盖到的功能会被登记为待做,而不会从账本里消失。
  • 再次梳理只做合并——梳理会新增与更新需求、功能点与项目信息;删除仍然需要手工操作。
  • 同一需求内同名共用一个勾选——同一条需求下两个同名的功能点共用一次勾选。
  • 失败提示是瞬时的——投递失败、接入梳理失败与自动流程的终态都以 toast 报告;提示淡出后,只剩该轮自己的记录与「全自动流程」页作为痕迹。
  • 重载会丢失进行中的等待——需求扩展与接入梳理会从记住的规划会话中恢复已经到达、完成且可解析的结果;如果没有匹配结果,受影响的控件会重置,而不是继续显示忙碌。投递出去但一直没有任何可观察变化的轮次,会在静默窗口后带着原因放弃,而不是无限转圈。

开发备注

维护者的工作上下文——点击展开

无。