xpcool/workbuddy.xpcool.com
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
b0b40aabfc
workbuddy.xpcool.com/.workbuddy/memory/MEMORY.md
夏犀麟 b0b40aabfc docs: 记录备案号更正，并记下子站缺备案号的遗留项 
- xpcool.com 与 admin.xpcool.com 备案号更正为 黔ICP备2026003933号，
  两处生效点与 DEPLOY/日志同步记录；
- MEMORY.md 索引补一行「站点备案号」常驻信息，便于下次改号时一次找齐；
- 遗留：home / tool 两个子站目前完全没有展示备案号，待用户决定是否补。
2026-09-14 01:11:10 +08:00

3.9 KiB
Raw Blame History

xpcool.com 工作空间 · 统一规则与项目索引

随会话自动加载。本文件只放规则与索引；生产部署、服务器/容器/站点清单、nginx 与证书约定、安全加固与告警去重、本机工具链坑位，全部见同目录 DEPLOY.md。

三条铁律（全项目通用）

  1. 中文注释：写/改代码时，在应有处（函数、复杂逻辑、配置项、非显然分支）加中文注释。
  2. 做记录：每次请求/变更/修复/文档动作，在对应项目 CHANGELOG.md 顶部追加一条 YYYY-MM-DD | 类型 | 一句话摘要（REQ/CHG/FIX/DOC/CFG/DEP）。
  3. 中文优先：思考、输出、交流能中文就中文。

接口设计规范（2026-08-27 起 · 强制）

  • 新建 HTTP 接口一律 POST；URL 不带任何参数（查询参数、路径参数 {id} 都禁止）；入参全部走 body(JSON)。
  • 路由用静态 path（如 /recruitment/info/update），id 等也放 body。
  • 同时约束 service 后端（g.Meta method:"post"）与 admin 前端（requestClient.post(url, data)，url 无参）。
  • 范本模块：service.xpcool.com recruitment；存量接口逐步迁移。

界面开发约定（2026-08-26 起）

  • admin.xpcool.com 写 TDesign 组件前先用 TDesign MCP 查官方文档（tdesign-mcp-server，配在 ~/.workbuddy/mcp.json），用官方封装属性，避免自造轮子。
  • 树形表格必须用 t-enhanced-table；异步数据后需 await nextTick() + tableRef.value.expandAll()（defaultExpandAll 只在首次渲染生效）。

工作空间与项目索引

  • 本仓库 workbuddy.xpcool.com（规则+索引+每日日志），远程 https://git.xpcool.com/xpcool/workbuddy.xpcool.com.git。
  • 布局约定：所有项目与工作空间位于同一父目录下（workbuddy.xpcool.com、admin.xpcool.com、service.xpcool.com、tool.xpcool.com、home.xpcool.com、xpcool.com），换设备按此布局 clone，索引即生效。
项目 类型 变更记录 远程仓库
admin.xpcool.com Vue 管理后台前端 ../admin.xpcool.com/.workbuddy/memory/CHANGELOG.md git.xpcool.com/xpcool/admin.xpcool.com.git
service.xpcool.com Go 后端服务 ../service.xpcool.com/.workbuddy/memory/CHANGELOG.md git.xpcool.com/xpcool/service.xpcool.com.git
tool.xpcool.com 前端工具站 ../tool.xpcool.com/.workbuddy/memory/CHANGELOG.md git.xpcool.com/xpcool/tool.xpcool.com.git
home.xpcool.com 前端服务台（公开服务入口） ../home.xpcool.com/.workbuddy/memory/CHANGELOG.md 本地 git init/commit，远程待建
xpcool.com 主域名：随机壁纸站（浏览器实时生成，可导出 4K；中英日韩 + 日夜主题） ../xpcool.com/.workbuddy/memory/CHANGELOG.md 2026-09-13 上线；本地 git init/commit，远程待建

站点备案号（同域名子站通用）：黔ICP备2026003933号 —— 集中写在 xpcool.com src/config.ts 的 SITE.icp，跳转核验 https://beian.miit.gov.cn/；admin.xpcool.com 在 packages/preferences/src/index.ts 的 appCopyrightPreferences。改号时两处一起改。待办：home / tool 两个子站尚未展示备案号。

命中流程

判断涉及哪个项目 → 读该项目 CHANGELOG 头部 10–15 条 → 处理后于顶部追加本次记录 → 新增项目时同步更新上方索引表。

协作约定

  • 只 commit、不要 push（推送由用户自行完成，避免凭据交互失败）。换设备开工前先 git pull 各仓库。
  • 验证分工：AI 能做的（类型检查、构建、冒烟测试）照做；浏览器交互体验、视觉效果交给用户手动验证，不反复折腾自动化。
  • 服务器操作走 SSH：193.112.118.168:22025，用户 xxcool，密钥 ~/.ssh/xpcool_ed25519。尽量把多个操作合并成一次 SSH 调用，减少权限弹窗。