Jiey 工作方法论

本页解释 Jiey 桌面 App 在「打开新项目」时默认启用的 AI 工作方法论。你不需要单独安装任何东西，下载 Jiey App 即可。

这是什么

Jiey 内置一套面向 AI 代理的全栈代码生成方法论。它告诉你的 AI 编辑器（Cursor / Claude / VS Code / Codex …）如何驱动 Jiey 引擎 来产出 Java 后端、Vue 管理后台、UniApp 移动端、营销官网。

详细的 DNA 模式、代码规范、设计 token、质量检查清单不在静态提示词里 — 它们存在 Jiey 引擎内部，登录后通过 MCP 工具按需返回。这样 AI 始终拿到引擎的当前规则，而不是过时快照。

架构

AI 代理（Cursor / Claude / VS Code / …）
       │
       │  Jiey 已自动写入 MCP 配置 + 注入工作方法论
       │
       ▼
本地 Jiey 桌面 App
       │  通过 stdio 提供 MCP 工具：
       │   • ListTools → 实时工具 schema
       │   • playbook → 详细方法论章节
       │   • trigger_codegen / validate_dna / …
       ▼
生成 Java 后端 + Vue 管理后台 + UniApp 移动端 + 营销官网

前置 — 打开 Jiey 并登录

Jiey 本地 MCP 服务 未登录不会启动。首次打开 Jiey 时，App 会引导你在默认浏览器完成 Jiey 账号登录，并把会话自动写回 App。详细安装见下载与首次启动。

全栈开发方法论

你驱动一个内嵌在 Jiey 里的代码生成引擎，它把声明式的 DNA 定义转换成 Java 后端、Vue 管理后台、UniApp 移动端、营销官网代码。

不要凭记忆

详细的 schema、工具参数、DNA 模式、代码规范、设计 token、质量检查清单 不在本页里。它们由 MCP 工具在运行时返回（ListTools 拿工具 schema，playbook(slice=...) 拿任何方法论章节）。不要从外部知识里编造 shape、env flag、内部路径、类名 — 从引擎读取。

第 0 步 — 登录（必须）

Jiey 本地 MCP 服务 未登录不会启动。如果 MCP 失败或出现 NotLoggedInError，让用户打开 Jiey App 并完成浏览器登录，然后停下，直到用户确认。不要盲目重试。

登录后可调用 jiey_whoami 验证身份 / 套餐。

核心理念

API 是 Action 的投影。 在 DNA 里声明实体 + 动作，控制器、请求体、状态机转换、归属检查、副作用、事件全部由编译器派生。永远不要手写控制器。
三层严格分离。 Language（DNA，不写 SQL / Java 类型）→ Compiler（映射规则，不写业务逻辑）→ Codegen（文件发射，不带领域语义）。
Entity = 纯模型。 实体只承载 name、identity、label、attributes、aggregateRoot、members。它们绝不携带 API 路径、UI 配置、菜单。
Action = 语义动词。 每个动作从引擎的动词词表里取一个动词；动词驱动意图（command vs query）与下游接线。
Page 是意图驱动，不是实体驱动。用 compositionIntent 描述页面是 为什么 而存在，而不是 基于什么实体。
消费端移动端 / 官网由 AI 填充。 Codegen 发射基础设施 + 空 stub + 每页 spec 切片。代理从切片填写页面内容 — 永远不要手写管理 CRUD 页。

工作流

Step 1 Clarify    →  一轮 AskQuestion，最少问题集
Step 2 Industry   →  industry_match + industry_apply（可选，架构师档位）
Step 3 DNA        →  generate_dna / save_dna_module / infer_layout
Step 4 Codegen    →  trigger_codegen targets="*"（返回填充指令）
Step 4.5 Fill     →  组件优先，页面其次，在同一回复内完成
Step 5 Preflight  →  preflight_and_start autofix=true
Step 6 Verify     →  verify_deployment

引擎通过 MCP ListTools 返回精确的工具参数 shape。引擎随每个目标返回 spec 切片，含页面填充协议。信任运行时契约，不要信记忆。

硬规则

总是先登录。 永远不改 MCP 配置、永远不重试工具、用户未登录时永远不静默回退。
永远不改带 @generated 标记的文件。 改 DNA 然后重跑 codegen。
永远不手写 DNA。 用 init_project / generate_dna / infer_layout。
永远不绕过 trigger_codegen 去手写 Java / Vue / SQL。引擎拥有文件布局与质量门。
页面填充和 trigger_codegen 在同一回复内完成 — 空 stub 永远不是可接受的结果。组件先填，页面后填。
永远不静默吞掉 checkoutHint / PaymentRequiredError。 把价格、套餐、支付链接告诉用户；让用户决定是否重试。
插件已安装（frozen）模块 会被 codegen 自动跳过。不要重复执行。
重新滚领域前先逛市场 — plugin_search / plugin_recommend。
填页面前先读 spec 切片。 切片由 codegen 写到已知路径；如果看不到切片，不要凭记忆编排布局。

需要详细信息时

如果你需要某个工具的详细 shape、DNA 模式、代码规范、设计 token 列表、质量检查清单：

调用 ListTools 拿工具 schema（登录后随时可用）。
调用 playbook(slice="<name>") 拿方法论章节。可用章节由 playbook(slice="index") 返回。常见章节包括 dna-patterns、vue-patterns、java-conventions、visual-craft、visual-checklist、anti-ai-slop、example-workflow、mcp-tools。
对于即将要填的页面：读 per-target spec 切片（路径由 trigger_codegen 返回）。

这样静态系统提示词体积保持最小，并且代理始终看到引擎的当前规则，而不是陈旧快照。

在 AI 编辑器中使用

下载 Jiey 桌面 App 后，它会自动检测已安装的编辑器（Cursor / Claude Desktop / VS Code / Windsurf …）并把 MCP 服务写入对应的配置文件。你不需要手工编辑任何 JSON。打开编辑器，跟 AI 说"帮我做一个 XX 系统"即可。

如有高级需求（脚本化调用、自托管引擎），见下载与首次启动末尾的命令行接入说明。

Jiey 工作方法论 ​

这是什么 ​

架构 ​

前置 — 打开 Jiey 并登录 ​

全栈开发方法论 ​

第 0 步 — 登录（必须） ​

核心理念 ​

工作流 ​

硬规则 ​

需要详细信息时 ​

在 AI 编辑器中使用 ​

相关链接 ​