工具链 on Jinnchang

PlantUML

Sun, 15 Mar 2026 11:30:00 +0800

Sequence Diagram（时序图） Link to heading

@startuml 示例

== 一、声明参与者 ==

' participant（参与者）
' actor（角色）
' boundary（边界）
' control（控制）
' entity（实体）
' database（数据库）
' collections（集合）
' queue（队列）

participant Participant as A
actor Actor as B
boundary Boundary as C
control Control as D
entity Entity as E
' database Database as F
' collections Collections as G
' queue Queue as H

A -> A : To participant
A -> B : To actor
B -> C : To boundary
C -> D : To control
D -> E : To entity

' 可以把关键字 create 放在第一次接收到消息之前，以强调本次消息实际上是在创建新的对象

create I
A -> I

== 二、文本对齐 ==

' 箭头上的文本对齐可以用 skinparam sequenceMessageAlign，后接参数 left/right/center

skinparam sequenceMessageAlign center

' 让响应信息显示在箭头下面

skinparam responseMessageBelowArrow true

' 消息文字可以用 \n 来换行

A -> A : This is a signal to self. \nIt also demonstrates

' 您可以使用 sequenceMessageSpan 命令来让消息文本跨越涉及的参与者范围

!pragma teoz true
!pragma sequenceMessageSpan true

' 可以使用 ||| 来增加空间
' 可以使用数字指定增加的像素数量

A -> A : 空间示意
|||
A -> A : 空间示意
||60||
A -> A : 空间示意

' 可以使用 & teoz 命令显示并行信息

!pragma teoz true

A -> B : hello
& B -> C : hi

== 三、改变箭头样式 ==

' 添加最后的 x 表示丢失的信息
' 使用 \ 或 / 而不是 < 或 > 只拥有箭头的底部或顶部部分
' 重复箭头（例如 >> 或 // ），拥有一个薄的图纸
' 使用 -- 而不是 - 拥有一个点状箭头
' 在箭头头添加最后的 "o"
' 使用双向的箭头 <->

A ->x B
A -> B
A ->> B
A -\ B
A \\- B
A //-- B
A ->o B
A o\\-- B
A <-> B
A <->o B

' 修改箭头颜色

A -[#red]> B : hello
B -[#0000FF]-> A : ok

== 四、页面标题、页眉和页脚 ==

' title 关键字用于为页面添加标题
' 以下效果等同：title __Example__ Title \non several lines

title
__Example__ Title
on several lines
end title

' 页面可以使用 header 和 footer 显示页眉和页脚

header Page Header
footer Page %page% of %lastpage%

' 使用 hide footbox 关键字移除脚注

hide footbox

' 为了符合严格 UML 的标准（线头的形状必须是三角形，而不能是箭头形），你可以使用
skinparam style strictuml

== 五、组合消息 ==

' alt/else
' opt
' loop
' par
' break
' critical
' group，后面紧跟着消息内容
'
' 关键词 end 用来结束分组
' 分组可以嵌套使用

B -> C : 认证请求
alt 成功情况
 B -> C : 认证接受
else 某种失败情况
 C -> B : 认证失败
 group 我自己的标签
 B -> D : 开始记录攻击日志
 loop 1000次
 B -> C : DNS 攻击
 end
 B -> D : 结束记录攻击日志
 end
else 另一种失败
 C -> B : 请重复
end

' 可以使用 box 和 end box 画一个盒子将参与者包裹起来
' 可以在 box 关键字之后添加标题或者背景颜色

box "Internal Service" #LightBlue
create K
create L
K -> L
L --> K
end box

== 六、注释信息 ==

' 可以使用 note left 或 note right 关键字在信息后面加上注释
' 可以使用 end note 关键字有一个多行注释
' 可以使用 note left of，note right of 或 note over 在节点（participant）的相对位置放置注释
' 可以使用 note across 在所有参与者之间添加备注

C -> D : hello
note left : this is a first note
D -> C : ok
note right : this is another note
D -> D : I am thinking
note left
a note
can also be defined
on several lines
end note
note left of C
This is displayed
left of C.
end note
note right of C : This is displayed right of C.
note over C : This is displayed over C.
note over C, D #FFAAAA : This is displayed\n over D and C.
note over D, C
This is yet another
example of
a long note.
end note
note across : This is displayed across

' 可以使用 / 可以在同一级对齐多个备注

note over C : C 的初始状态
note over D : D 的初始状态
D -> C : hello

note over C : C 的初始状态
/ note over D : D 的初始状态
D -> C : hello

== 七、生命线的激活与撤销 ==

' 关键字 activate 和 deactivate 用来表示参与者的生命活动
' destroy 表示一个参与者的生命线的终结
' 可以使用嵌套的生命线，并且给生命线添加颜色

A -> B : DoWork
activate B #FFBBBB
B -> B : Internal call
activate B #DarkSalmon
B -> C : << createRequest >>
activate C
C -> D : DoWork
activate D
D --> C : WorkDone
destroy D
C --> B : RequestCreated
deactivate C
deactivate B
B -> A : Done
deactivate B

' 新命令 return 可以用于生成一个带有可选文本标签的返回信息
' 返回的点是导致最近一次激活生命线的点
' 语法是简单的返回标签，其中标签（如果提供）可以是传统信息中可以接受的任何字符串

A -> B : hello
activate B
B -> B : some action
return bye

' 在指定目标参与者后，可以立即使用以下快捷语法：
' ++ 激活目标（可选择在后面加上 #color）
' -- 撤销激活源
' ** 创建目标实例
' !! 摧毁目标实例

A -> B ++ : hello
B -> B ++ : self call
B -> C ++ #005500 : hello
B -> J ** : create
return done
return rc
B -> J !! : delete
return success

' 可以在一行上同时激活和撤销

A -> B ++ : hello1
B -> C --++ : hello2
C --> A -- : ok

A -> B ++ #gold : hello3
B -> A --++ #gold : ok
A -> B -- : hello4

== 八、锚点和持续时间 ==

' 使用teoz在图表中添加锚点，从而指定持续时间

!pragma teoz true

{start} A -> C : start doing things during duration
C -> E : something
E -> C : something else
{end} C -> A : finish

{start} <-> {end} : some time

@enduml

参考 Link to heading

[1] https://plantuml.com

Git

Thu, 05 Feb 2026 08:50:00 +0800

Git 是一种分布式版本控制系统，其核心概念在于跟踪文件变更、记录完整历史版本，并支持多人在不同分支上并行开发。它通过哈希值确保数据完整性，使团队能够高效协作、灵活合并代码，并随时回溯到任意历史状态。作为现代软件开发的基石，Git 不仅是代码托管平台（如 GitHub）的基础，也广泛应用于文档管理和配置控制，极大提升了项目迭代的可追溯性与可靠性。—— DeepSeek

简介 Link to heading

Git 和其它版本控制系统（包括 Subversion 和近似工具）的主要差别在于 Git 对待数据的方式。从概念上来说，其它大部分系统以文件变更列表的方式存储信息，这类系统（CVS、Subversion、Perforce 等等）将它们存储的信息看作是一组基本文件和每个文件随时间逐步累积的差异（它们通常称作基于差异（delta-based）的版本控制）。

存储每个文件与初始版本的差异

Git 不按照以上方式对待或保存数据。反之，Git 更像是把数据看作是对小型文件系统的一系列快照。在 Git 中，每当你提交更新或保存项目状态时，它基本上就会对当时的全部文件创建一个快照并保存这个快照的索引。为了效率，如果文件没有修改，Git 不再重新存储该文件，而是只保留一个链接指向之前存储的文件。 Git 对待数据更像是一个快照流。

存储项目随时间改变的快照

Workspace: 工作区
Index / Stage: 暂存区
Repository: 仓库区 ( 本地版本库 )
Remote: 远程仓库 ( 远程仓库 / 远程版本库 )

Git 工作流程

开始使用 Link to heading

创建新仓库：

Command Line Interface

Tue, 20 Jan 2026 16:20:00 +0800

用 Go 语言和 Cobra 框架，10 分钟构建可跨平台分发的命令行工具。

核心概念 Link to heading

Cobra 是 Go 生态中最流行的 CLI 框架，Hugo、Kubernetes、GitHub CLI 等知名项目均基于它构建。

CLI 工具由三个基本元素组成：

元素	说明	示例
Command	可执行的操作	`git clone` 中的 `clone`
Flag	控制行为的选项	`--verbose`、`-o output.txt`
Arg	命令的输入参数	`git commit -m "msg"` 中的 `"msg"`

Go 编译为单二进制文件，无需运行时环境，跨平台分发只需替换目标 GOOS/GOARCH。

安装配置 Link to heading

初始化项目并安装依赖：

mkdir greet-cli && cd greet-cli
go mod init greet-cli
go get -u github.com/spf13/cobra@latest
# 可选：安装脚手架工具
go install github.com/spf13/cobra-cli@latest
cobra-cli init

生成后的目录结构中，核心文件是 cmd/root.go，所有子命令在 cmd/ 下各自独立。

Claude Code

Thu, 15 Jan 2026 14:15:00 +0800

Anthropic 官方 CLI 编程助手，将 Claude 模型直接嵌入终端工作流，支持权限控制、Agent 编排和自动化 Hooks。

安装配置 Link to heading

# 通过 npm 全局安装
npm install -g @anthropic-ai/claude-code

# 或通过 Homebrew（macOS）
brew install claude-code

安装完成后，进入项目目录启动：

cd your-project
claude

首次运行会自动检测项目结构，加载 .claude/CLAUDE.md（如果存在），并提示配置 API 密钥或使用 Anthropic 账户登录。

权限策略在项目根目录的 .claude/settings.local.json 中管理，典型配置：

{
 "permissions": {
 "allow": [
 "Bash(npm install)",
 "Bash(npm test)",
 "Bash(git status)",
 "Bash(git diff)"
 ]
 }
}

将常用只读命令加入允许列表，可显著减少交互次数。

实际使用 Link to heading

场景一：快速问答 + 代码修改 Link to heading

启动 Claude Code 后，直接输入自然语言指令：