About

关于 Comondex

以模块为单位:点进一个模块,查看它的开发成员与开发方式。

← 返回关于

Pushor

开发成员与开发方式。

开发方式

Vibe Coding

Projects

项目

每个项目都有能跑起来的产品,而不是教程 Demo。

← 返回项目列表
v0.1.1 · 已完成

FlowDesk

AI 驱动的个人与小团队工作管理平台——桌面客户端 + 云端服务端,联网协作、数据自控。

FlowDesk 是 Comondex 的核心桌面应用:把散落在表格、聊天和网盘里的项目、任务、文件与讨论,收拢到一条完整闭环——建立空间 → 创建项目 → 拆解任务 → 成员执行 → 评论/文件协作 → 仪表盘汇总 → AI 理解项目状态。

产品以桌面客户端(Electron)+云端服务端双形态交付:本机一键运行即为单机版;部署服务端后,同局域网设备通过 UDP 自动发现即可联网协作,服务端不在线时自动降级本地模式,数据始终由自己掌控(SQLite / 自部署服务端)。跨网络场景还可通过 Tailscale 组网获得永久固定地址。

工程上,FlowDesk 已完整走完 M1–M9 九个里程碑:项目 CRUD、账户体系(scrypt 密码哈希 + 登录限流)、空间与成员权限矩阵、任务全生命周期(If-Match 乐观锁)、文件管理、仪表盘聚合、评论与活动留痕,以及原生内置的 AI Copilot——基于 OpenAI 兼容 API,能理解项目状态并生成任务提案,且所有提案经确认后才落库。

每一次改动都要通过 43 个后端测试才能合并,这让 FlowDesk 不只是“能用”,而是可维护、可信赖。

backend/auth.pyscrypt 密码哈希 · 登录限流 · 会话管理
def throttle():
    # 每 60 秒窗口内最多 30 次密码校验,防止暴力破解
    now = time.monotonic()
    while requests and now - requests[0] > 60:
        requests.popleft()
    if len(requests) >= 30:
        raise HTTPException(429, '操作太频繁,请一分钟后再试',
                            headers={'Retry-After': '60'})
    requests.append(now)

def current_user(request: Request):
    raw = request.cookies.get(cookie_name)
    if not raw or len(raw) > 128:
        raise HTTPException(401, '请先登录 FlowDesk')
    with Session(engine) as db:
        session = db.get(LoginSession, token_digest(raw))
        if not session or aware(session.expires_at) <= utcnow():
            raise HTTPException(401, '登录已过期,请重新登录')
        user = db.get(User, session.user_id)
        if not user:
            raise HTTPException(401, '请重新登录')
        return user
backend/routers/ai.pyOpenAI 兼容 LLM 调用(AI Copilot 核心)
def call_llm(settings, messages, system_prompt, json_mode=False) -> str:
    """调用 OpenAI 兼容 /chat/completions,返回回答文本。"""
    base_url = (settings.base_url or DEFAULT_BASE_URL).rstrip('/')
    payload = {
        'model': settings.model or DEFAULT_MODEL,
        'messages': [{'role': 'system', 'content': system_prompt}]
                    + [{'role': m['role'], 'content': m['content']}
                       for m in messages],
        'temperature': 0.3,
    }
    if json_mode:
        payload['response_format'] = {'type': 'json_object'}
    with httpx.Client(timeout=60) as client:
        response = client.post(
            f'{base_url}/chat/completions',
            headers={'Authorization': f'Bearer {settings.api_key}'},
            json=payload,
        )
        response.raise_for_status()
        data = response.json()
    return data['choices'][0]['message']['content']
backend/routers/tasks.py任务更新 · If-Match 乐观锁防冲突
@router.patch('/tasks/{task_id}', response_model=TaskOutput)
def update_task(task_id: int, body: TaskPatch, request: Request,
                user: User = Depends(current_user)):
    with Session(engine) as db:
        task, project, _role = task_access(db, task_id, user.id)
        # 乐观锁:If-Match 携带 version,不匹配即冲突
        expected = request.headers.get('if-match')
        if expected and expected != str(task.version):
            raise HTTPException(409, '任务已在其他页面修改,请刷新后重试')
        changes = body.model_dump(exclude_unset=True)
        if 'assignee_id' in changes:
            validate_assignee(db, project, changes['assignee_id'])
        for key, value in changes.items():
            setattr(task, key, value)
        touch_completed_at(task)
        task.updated_at = datetime.now(timezone.utc)
        try:
            db.commit()
        except StaleDataError:
            raise HTTPException(409, '任务已被修改,请刷新后重试')
        db.refresh(task)
        return task
frontend/src/views/AIView.vueAI 设置弹窗 · showModal() 修复
<script setup>
const settingsDialog = ref(null)

// 修复:设置按钮此前只切换 v-if、未真正打开 dialog
// 现在通过原生 <dialog>.showModal() 打开模态框
function openSettings() {
  settingsDialog.value?.showModal()
}
</script>

更新日志

v0.1.1 2026-09-25 凌晨 · 首次更新
  • 登录 / 注册输入框的 placeholder 黑字全部移除,保持界面干净;「在此浏览器保持登录」改为「保持登录」。
  • 活动页顶部新增「← 返回空间」按钮,补齐离开路径。
  • 仪表盘 SVG 小字由 8px 提升至 9px / 18px,浅灰 #999 / #aaa 加深为 #6b7280 色系,字符清晰度修复。
  • 仪表盘 / 表格板块接入全局设计语言:卡片 + 阴影 + 主色 #5c56db,统一三板块 UI。
  • 修复 AI 助手「设置」无响应 bug——设置 dialog 此前只以 v-if 挂载、未真正调用 showModal(),已修复。

当前状态

v0.1.1,已完成 M1–M9

技术栈

Python FastAPI Electron Vue 3 SQLite AI Copilot

功能要点

  • M1–M9 九大模块全部完成
  • AI Copilot 原生内置
  • 局域网 UDP 自动发现联网
  • If-Match 乐观锁防冲突
  • 43 个后端测试守护

对 FlowDesk 感兴趣?

想了解进展、参与开发或提需求,欢迎加入项目组一起讨论。

下载 FlowDesk v0.2.3 GitHub 仓库
← 返回项目列表
已上线 · pushor.pages.dev

Pushor

截图打卡提交与人工审核系统——成员上传凭证,管理员在终端风格后台逐条审核。

Pushor 是 Comondex 的协作实践项目:成员在自学、复习、运动等活动结束后上传打卡截图;管理员在一个终端风格的 Web 后台里查看待审截图,给出通过或驳回(必须写原因)。系统只做截图的提交与人工审核——不计算金额、不记账、不做日结、没有余额、不能转账、不接任何支付。

工程上,Pushor 是 Next.js 14 App Router 的纯静态导出:构建产物只有 HTML/JS/CSS,托管在 Cloudflare Pages,不需要任何 Node 服务器。所有 Supabase 交互(登录、查询、上传、审核)都在浏览器端完成,安全边界完全落在数据库层——每条 SQL 都带着当前登录用户的会话,Postgres 的 RLS 策略决定他能看到和改动什么。

截图存放在私有 bucket 中,页面渲染时换成 10 分钟有效的签名 URL;驳回后重新提交通过 replaces_id 形成可追溯链条。仓库内置 30 条 RLS / 流程验收用例,直接打 Supabase API,全部通过才允许合并。

supabase/migrations/0002_rls.sqlRLS 是唯一真边界 · 成员只能提交 pending · 审核驳回必须写原因
create policy "submissions_member_insert_pending" on submissions
  for insert to authenticated
  with check (
    member_id = auth.uid() and status = 'pending'
    and admin_note is null and reviewed_at is null
    and (storage.foldername(image_url))[1] = auth.uid()::text
    and exists (select 1 from tasks t where t.id = submissions.task_id and t.member_id = auth.uid())
    and (replaces_id is null or exists (
      select 1 from submissions s where s.id = submissions.replaces_id
        and s.member_id = auth.uid() and s.status = 'rejected')));

create policy "submissions_admin_review" on submissions
  for update to authenticated
  using (is_admin() and status = 'pending')
  with check (
    is_admin() and status in ('approved','rejected')
    and (status <> 'rejected' or coalesce(btrim(admin_note),'') <> ''));
RLS 自测 · 浏览器控制台成员改不动自己的 status · 命中 0 行即仍是 pending
const { createClient } = await import("https://esm.sh/@supabase/supabase-js@2");
const sb = createClient("<URL>", "<ANON KEY>");

const res = await sb.from("submissions")
  .update({ status: "approved" })
  .eq("id", "<你自己的 submission id>")
  .select();

console.log(res);   // data: [] —— 命中 0 行,数据库里那条仍是 pending

当前状态

已上线,运行于 pushor.pages.dev

技术栈

Next.js 14 TypeScript Tailwind + shadcn/ui Supabase Cloudflare Pages

功能要点

  • 成员提交打卡截图,一次最多 10 个附件
  • 管理员待审队列 + 逐条人工审核
  • 驳回必须写原因,重提交经 replaces_id 可追溯
  • Postgres RLS 为唯一安全边界
  • 30 条 RLS / 流程验收用例守护

对 Pushor 感兴趣?

想体验或参与开发,访问线上站点或 GitHub 仓库。

访问 Pushor GitHub 仓库