JY Docs

Appearance

JY Agent 开发规范 ​

开工前 ​

  1. 判断改哪个子项目：见 jy-architecture 决策树
  2. 加载对应 Skill：
    • 改管理端表单 → .cursor/skills/jy-admin-antd
    • 改部署/发布 → docs/skills/jy-deploy-* / jy-publish-flow
    • 任何代码改动 → .cursor/skills/jy-safe-edits
  3. 先 Read 再改：目标函数/组件块完整读取后再 StrReplace
  4. 最小 diff：不顺手重构无关代码

改之后验证 ​

bash
cd jy-admin && pnpm check    # 管理端 TS
cd jy-site && pnpm check     # 博客 TS

涉及构建时额外：

bash
cd jy-admin && pnpm build
cd jy-site && pnpm build:static

Svelte 组件：用 Svelte MCP svelte-autofixer。

端口与地址 ​

服务端口
jy-admin dev5174
jy-site dev5175（非 5173）
jy-admin 生产127.0.0.1:5174（仅本机）

密钥与 Git ​

禁止应该
提交 .env用 .env.example 作模板
在回复中打印 PAT/密码只说「已配置」或变量名
把密钥写进 Skill/文档用占位符 <PAT>

Server Action 注意（jy-admin） ​

  • 'use server' 文件只导出 async 函数
  • 客户端报 reading 'call' → pnpm dev:reset
  • Modal 关闭不要 resetFields；用 afterOpenChange 填表

部署相关 Agent 动作 ​

用户请求Agent 应做
更新管理端代码到服务器build standalone → tar（排除 .env）→ scp → 保留服务器 .env → restart
只改服务器 GITHUB_TOKEN写 .env + restart，不必重 build
更新线上博客触发 Actions 或 build:static + scp 到 jysite
更新文档站docs && pnpm build → scp 到 doc.jysite

远程命令用 ssh jy-test，需 required_permissions: ["all"]。

Skill 路由表 ​

用户话题读取
项目结构、三端关系jy-architecture
为什么静态/为什么分离保存与构建jy-principles
SSH、日志、服务器目录jy-ops
部署博客jy-deploy-site
部署管理端jy-deploy-admin
文章不上线、构建并部署jy-publish-flow
改代码规范jy-agent-dev（本文）+ jy-safe-edits

完成标准 ​

  • [ ] pnpm check 通过（相关子项目）
  • [ ] 未引入无关文件变更
  • [ ] 用户路径已自测或说明未测原因
  • [ ] 部署类任务区分了「改代码」vs「改 env」

JY 项目文档

内部运维手册，请勿把密钥写进仓库