docs: 更新项目文档并归档 OpenSpec proposal

- 更新 README.md，添加特性列表和配置说明
- 完善 openspec/project.md 项目上下文
- 归档 add-source-link-and-license proposal
- 创建 post-details spec

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: xkcoding

README.md

@@ -2,10 +2,22 @@
 
 xkcoding 的代码成长日记 - 基于 [Astro](https://astro.build/) + [AstroPaper](https://github.com/satnaing/astro-paper) 主题构建。
 
+## 特性
+
+- 🚀 基于 Astro 5.x 构建，性能优异
+- 🎨 基于 AstroPaper 主题定制，简洁美观
+- 🔍 Pagefind 全文搜索
+- 📖 目录侧边栏（TOC）
+- 🖼️ 文章封面图 & 动态 OG 图片
+- 📝 查看原文（跳转 GitHub raw 文件）
+- ⚖️ CC BY-NC-SA 4.0 协议声明
+- 🌙 深色模式支持
+
 ## 技术栈
 
 - **框架**: Astro 5.x
 - **主题**: AstroPaper
+- **样式**: Tailwind CSS 4.x
 - **搜索**: Pagefind
 - **部署**: GitHub Pages + GitHub Actions
 
@@ -36,11 +48,27 @@ pnpm run preview
 │   ├── data/blog/       # 博客文章 (Markdown)
 │   ├── layouts/         # 布局组件
 │   ├── pages/           # 页面路由
+│   ├── utils/           # 工具函数
 │   └── config.ts        # 站点配置
+├── openspec/            # OpenSpec 规范文档
 ├── astro.config.ts      # Astro 配置
 └── package.json
 ```
 
+## 配置说明
+
+站点配置位于 `src/config.ts`，主要配置项：
+
+- `website`: 站点 URL
+- `author`: 作者信息
+- `showToc`: 是否显示目录
+- `dynamicOgImage`: 是否启用动态 OG 图片
+- `editPost`: 编辑文章链接配置
+- `viewSource`: 查看原文链接配置
+- `license`: 协议声明配置
+
 ## License
 
-MIT
+文章内容采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh-hans) 协议
+
+代码采用 MIT 协议

…/add-source-link-and-license/proposal.md …-add-source-link-and-license/proposal.mdopenspec/changes/add-source-link-and-license/proposal.md renamed to openspec/changes/archive/2026-01-20-add-source-link-and-license/proposal.md openspec/changes/add-source-link-and-license/proposal.md renamed to openspec/changes/archive/2026-01-20-add-source-link-and-license/proposal.md

@@ -1,31 +1,60 @@
 # Project Context
 
 ## Purpose
-[Describe your project's purpose and goals]
+xkcoding 的个人技术博客，记录代码成长历程、技术分享和学习笔记。
 
 ## Tech Stack
-- [List your primary technologies]
-- [e.g., TypeScript, React, Node.js]
+- **框架**: Astro 5.x
+- **主题**: 基于 AstroPaper 定制
+- **样式**: Tailwind CSS 4.x
+- **搜索**: Pagefind (静态搜索)
+- **部署**: GitHub Pages + GitHub Actions
+- **包管理**: pnpm
 
 ## Project Conventions
 
 ### Code Style
-[Describe your code style preferences, formatting rules, and naming conventions]
+- 使用 Prettier 格式化代码
+- 组件文件使用 PascalCase 命名 (如 `ViewSource.astro`)
+- 工具函数使用 camelCase 命名 (如 `getPath.ts`)
+- 中文注释，英文变量名
 
 ### Architecture Patterns
-[Document your architectural decisions and patterns]
+- Astro 组件位于 `src/components/`
+- 布局组件位于 `src/layouts/`
+- 博客文章位于 `src/data/blog/`（Markdown 格式）
+- 全局配置位于 `src/config.ts`
+- 工具函数位于 `src/utils/`
 
 ### Testing Strategy
-[Explain your testing approach and requirements]
+- 依赖 TypeScript 类型检查
+- 使用 `pnpm run build` 验证构建
+- 通过 GitHub Actions CI 自动检查
 
 ### Git Workflow
-[Describe your branching strategy and commit conventions]
+- 主分支: `master`
+- 功能分支: `feature/xxx`
+- 提交信息使用中文，格式: `类型: 描述`
+  - feat: 新功能
+  - fix: 修复
+  - style: 样式调整
+  - docs: 文档更新
+  - chore: 其他
 
 ## Domain Context
-[Add domain-specific knowledge that AI assistants need to understand]
+- 博客文章使用 Markdown 编写，支持 frontmatter 配置
+- 支持动态 OG 图片生成
+- 支持文章封面图（用户设置 ogImage 时显示）
+- 支持目录（TOC）侧边栏
+- 支持 CC BY-NC-SA 4.0 协议声明
+- 支持查看原文（跳转 GitHub raw 文件）
 
 ## Important Constraints
-[List any technical, business, or regulatory constraints]
+- 保持与 AstroPaper 主题的兼容性
+- 图片资源优先使用 WebP 格式
+- 文章 URL 使用日期格式（如 /2024-01-01-title）
 
 ## External Dependencies
-[Document key external services, APIs, or systems]
+- GitHub API: 用于部署和 raw 文件访问
+- Creative Commons: CC 协议徽章图片
+- Google Fonts: 字体资源

…k-and-license/specs/post-details/spec.md …k-and-license/specs/post-details/spec.mdopenspec/changes/add-source-link-and-license/specs/post-details/spec.md renamed to openspec/changes/archive/2026-01-20-add-source-link-and-license/specs/post-details/spec.md openspec/changes/add-source-link-and-license/specs/post-details/spec.md renamed to openspec/changes/archive/2026-01-20-add-source-link-and-license/specs/post-details/spec.md

@@ -0,0 +1,67 @@
+# post-details Specification
+
+## Purpose
+TBD - created by archiving change add-source-link-and-license. Update Purpose after archive.
+## Requirements
+### Requirement: View Source Link
+
+The system SHALL provide a "View Source" link on article detail pages that opens the raw Markdown file in the GitHub repository (blob view, not edit mode).
+
+#### Scenario: User clicks View Source link
+
+- **WHEN** user clicks the "View Source" link on an article page
+- **THEN** a new tab opens with the GitHub blob URL for the article's Markdown file
+- **AND** the URL format is `https://github.com/{owner}/{repo}/blob/{branch}/{filePath}`
+
+#### Scenario: View Source link visibility
+
+- **WHEN** `SITE.viewSource.enabled` is `true`
+- **THEN** the View Source link is displayed on the article page
+- **WHEN** `SITE.viewSource.enabled` is `false`
+- **THEN** the View Source link is hidden
+
+### Requirement: CC License Declaration
+
+The system SHALL display a Creative Commons license declaration (CC BY-NC-SA 4.0) at the bottom of each article's content area.
+
+#### Scenario: License display position
+
+- **WHEN** an article page is rendered
+- **THEN** the CC license declaration appears after the article content
+- **AND** before the share links section
+
+#### Scenario: License content elements
+
+- **WHEN** the license component is rendered
+- **THEN** it displays:
+  - The CC BY-NC-SA 4.0 license icon/badge
+  - A brief license description in Chinese
+  - A link to the full license text on Creative Commons website
+
+#### Scenario: License visibility control
+
+- **WHEN** `SITE.license.enabled` is `true`
+- **THEN** the license declaration is displayed
+- **WHEN** `SITE.license.enabled` is `false`
+- **THEN** the license declaration is hidden
+
+### Requirement: Configuration Options
+
+The system SHALL provide configuration options in `src/config.ts` for View Source and License features.
+
+#### Scenario: viewSource configuration
+
+- **WHEN** configuring the View Source feature
+- **THEN** the following options are available:
+  - `enabled`: boolean to show/hide the link
+  - `text`: display text for the link (default: "查看原文")
+  - `url`: base URL for the repository blob path
+
+#### Scenario: license configuration
+
+- **WHEN** configuring the License feature
+- **THEN** the following options are available:
+  - `enabled`: boolean to show/hide the license
+  - `type`: license type identifier (e.g., "CC BY-NC-SA 4.0")
+  - `url`: URL to the full license text
+