什么是 OpenSpec？

你可以将其理解为一套工程化协议。它强制让你和 AI 在写代码之前，先通过标准化的 Markdown 文档就“做什么”和“怎么做”达成共识（Spec-Driven Development, SDD）。通过积累的Spec，AI可以大大缓解“由于缺乏上下文而产生幻觉”的问题。

• 传统模式：Prompt -> Code (vibe code)
• OpenSpec 模式：Prompt -> Proposal (提议) -> Spec (规范) -> Code

安装openspec并初始化项目

安装工具

在微服务开发中，我们经常遇到这样的场景：项目 A（如主业务系统）和 项目 B（如独立的工具服务、MCP Server）位于不同的代码仓库，由不同的 docker-compose.yml 管理，但它们需要通过内网互相通信。

本文将介绍如何优雅地打通两个 Docker Compose 项目的网络，并避开常见的“坑”。

核心原理

Docker 网络隔离是基于 Network Namespace 的。要让两个独立 Compose 项目通信，必须让它们的容器加入同一个 Docker Network。通常的做法是：一方负责创建（Create），另一方负责引入（External）。

使用fpm的方式部署

使用docker-compose部署服务

docker-compose.yaml

version: '2'

services:
  app:
    container_name: nextcloud
    image: docker.superpig.win/library/nextcloud:30.0-fpm
    restart: always
    volumes:
      - ./nextcloud/custom_apps:/var/www/html/custom_apps
      - ./nextcloud/config:/var/www/html/config

问题描述

• 现象：Cline 无法看到输出，或者频繁弹出新的 shell 窗口。
• 一般来说，这不是 VSCode 版本的问题。

解决方法

1. 打开官方文档：Troubleshooting – Shell Integration Unavailable
2. 下拉至 Still Having Trouble? 部分。
3. 按照文档建议，在你的 ~/.zshrc 文件中添加以下内容：

前言

本文将以YOLO模式为例，分享一次使用 gemini-cli 编写简单 python 程序来解析 md 文件的过程。

我所说的“YOLO模式”，是借鉴了“You Only Look Once”的概念，指代一种高效的AI辅助开发工作流：我们只提出高层次的目标，让AI自主完成大部分实现、测试和修正的细节。

准备工作

• 工具：gemini-cli
• 需求：解析 markdown 目录下的 postmortem_0705.md 文件。

别再终端、浏览器来回切换了。gemini-cli 能让你的命令行直接思考。

快速上手

gemini-cli 是 Google 官方工具，安装配置很简单。

1. 安装: npm install -g @google/gemini-cli

2. 配置: gemini init (根据提示，粘贴从 Google AI Studio 获取的免费 API 密钥)

3. 试用: gemini "mac 如何查看端口占用？"

它会直接返回 lsof -i : 这样的实用命令。更多用法见官方文档。

目标

• 实现基于 RESTful API 路径的细粒度权限控制，确保系统安全性。
• 简化权限管理：仅使用 User、Group、Permission 模型，提供简单易用的权限管理。
• 有一定的扩展性：可对 Permission 种类进行扩展，可将多个 Permission 进行分组，便于权限管理。

方案示例

实体

User（用户）： - User 代表系统中的用户身份，可以是： - 基础的带用户名、密码、邮箱、姓名的账户 - API 令牌账户

Permission（权限）： - Permission 由 RESTful 实体派生出来，例如 DBInstance 是一种资源实体，它的定义如下：

引言

在 Django 开发过程中，有时由于手动删除历史迁移文件（migrate files）或其它原因，可能导致数据库结构与模型定义不匹配，从而引发数据异常。此时，需要重建数据库并恢复数据。

1. 备份源数据库

首先，我们需要备份源数据库中的业务数据。

1.1 获取表名

使用 SQLite 命令行工具，列出源数据库中的所有表名：

sqlite3 db.sqlite3
.tables

1.2 排除系统表

由于 Django 的系统表（以 django_ 开头）和权限表 auth_group_permissions 可以通过迁移文件重建，因此在备份时应排除这些表。

tag: 命令行/乱码/编码 这个问题很难弄。还会影响到python的系统函数os.stat等。 解决方法如下： 执行命令：

apt-get install -y locales
locale-gen en_US.UTF-8

修改配置文件：

vim ~/.bashrc
## 写入
export PYTHONIOENCODING=utf-8

export LANG='en_US.UTF-8'
export LC_ALL='en_US.UTF-8'

有时，它会报错：

warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)

此时需要：