Code Space on elonnzhang

neat-annotations 上手指南

Sun, 20 Sep 2026 00:00:00 +0800

neat-annotations 是一套纯 CSS 标注：给正文里的短语加高亮，需要时再伸出一支手绘箭头和一行手写标签。本站已经接到 ann shortcode，文章 Markdown 里直接写即可。

标注是视觉补充，不要把关键信息只放在箭头上。

最小例子

The dashboard updates in real time.

源码：

The dashboard updates {{< ann n amber "无需刷新" >}}in real time{{< /ann >}}.

三个位置参数依次是方向、颜色、标签。被包裹的 inner 是箭头指向的目标。

方向

方向类表示箭头指向目标的那一侧。ann-n 把标签放在目标下方，箭头朝北指回去。

类名	标签位置	箭头朝向
`n`	下	北
`ne`	左下	东北
`e`	左	东
`se`	左上	东南
`s`	上	南
`sw`	右上	西南
`w`	右	西
`nw`	右下	西北

写了 note 但没写方向时，默认 n。

target 适合句中短语。

Claude Code 上手指南

Mon, 01 Jan 0001 00:00:00 +0000

Claude Code 在终端中读取项目、编辑文件并运行开发命令。下面以 macOS、Linux 和 WSL 为主，完成安装后直接从一个 Git 仓库开始。

安装

官方推荐使用原生安装器：

curl -fsSL https://claude.ai/install.sh | bash

macOS 也可以通过 Homebrew 安装稳定版本：

brew install --cask claude-code

检查安装结果：

claude --version
claude doctor

claude doctor 只读取安装和配置状态，可以用于检查版本、配置文件错误和更新问题。Windows、Linux 软件源及其他安装方式参见 Claude Code 安装文档。

登录并开始会话

进入项目后运行：

cd ~/code/my-project
claude

按照浏览器提示完成登录。也可以显式执行：

claude auth login
claude auth status --text

进入会话后先让 Claude Code 阅读项目，不要马上进行大范围修改：

说明项目入口、主要目录、本地启动方式和测试命令。先不要修改文件。

这一步可以尽早发现工作目录不对、构建命令缺失或项目结构理解错误。

建立 CLAUDE.md

在交互会话中运行：

/init

Claude Code 会分析仓库并生成 CLAUDE.md 草稿。建议检查后保留真正有用的内容：

# Project Guide

## Commands
- Install: `pnpm install`
- Dev: `pnpm dev`
- Test: `pnpm test`

## Project layout
- `src/api/` 存放接口处理代码。
- `src/components/` 存放可复用组件。
- `tests/` 的目录结构与 `src/` 保持一致。

## Working rules
- 修改行为时补充对应测试。
- 不要修改生成文件和锁文件，除非任务需要。
- 完成后运行受影响模块的测试。

项目规则可以放在仓库根目录的 CLAUDE.md 或 .claude/CLAUDE.md。个人全局规则位于 ~/.claude/CLAUDE.md，只在本地生效的项目规则可以放进 CLAUDE.local.md，并加入 .gitignore。

Codex CLI 上手指南

Mon, 01 Jan 0001 00:00:00 +0000

Codex CLI 适合直接在终端里处理本地仓库。它可以阅读代码、修改文件、运行项目已有的命令，并在操作超出当前权限时请求确认。

安装

macOS 和 Linux 可以使用官方安装脚本：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

确认命令已经进入 PATH：

codex --version

也可以通过 npm 安装：

npm install --global @openai/codex

安装方式和支持的平台可能调整，遇到差异时以 Codex CLI 官方文档为准。

登录并进入项目

切换到项目根目录后启动 Codex：

cd ~/code/my-project
codex

第一次运行会提示登录，可以选择 ChatGPT 账号或界面中提供的其他登录方式。进入会话后先检查当前目录、模型和权限：

/status
/permissions

Codex 默认会限制文件写入范围和网络访问。刚开始使用时保留默认权限即可，不要为了少一次确认就直接开放完整系统权限。

建立项目规则

在仓库根目录运行：

/init

该命令会生成一份 AGENTS.md 草稿。它会在 Codex 开始工作前自动载入，适合记录项目中长期有效的信息：

# Repository Guide

## Commands
- Build: `make build`
- Test: `make test`
- Lint: `make lint`

## Conventions
- 修改公共接口时同步更新测试和文档。
- 不要提交生成文件。
- 增加生产依赖前先说明原因。

## Verification
- 完成修改后运行与改动范围对应的测试。
- 最终回复列出改动文件和未执行的检查。

规则应当具体、可验证。类似“保持代码优雅”的描述没有执行标准，最好改成项目真实使用的命令、目录约束和检查方式。大型仓库可以在子目录继续放置 AGENTS.md，距离目标文件更近的规则优先。