Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -26,3 +26,7 @@ Thumbs.db

# 根目录聊天导出(私有)
Kiro聊天记录_*

# 本地优化工作副本与版本备份(不进仓库)
fable-opt/
fable-opt-backups/
109 changes: 86 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,110 @@
# 指北 TrueNorth

> 用 AI 工作的方向 —— 一个**单文件、离线、自包含**的 AI 工作导航站 + Skill-first 能力层。
> **用 AI 工作的方向。** 把每天扑面而来的 AI 信息,整理成你能直接用的工作打法——
> 一个**单文件、离线、自包含**的 AI 工作导航站 + Skill-first 可执行能力层。

## 这是什么
<p>
<img src="https://img.shields.io/badge/%E5%8D%95%E6%96%87%E4%BB%B6-713KB%20HTML-2f62ff" alt="单文件 713KB">
<img src="https://img.shields.io/badge/%E7%A6%BB%E7%BA%BF%E5%8F%AF%E7%94%A8-%E9%9B%B6%E4%BE%9D%E8%B5%96%20%C2%B7%20%E9%9B%B6%E6%9E%84%E5%BB%BA-1c7a4f" alt="离线可用">
<img src="https://img.shields.io/badge/Skill-45%20%E6%9D%A1%E5%85%A8%E5%A4%8D%E6%A0%B8-e8590c" alt="45 Skill">
<img src="https://img.shields.io/badge/%E6%96%B9%E6%A1%88-37%20%E5%A5%97%E5%B8%A6%E6%8C%87%E5%8C%97%E8%A7%A3%E8%AF%BB-7048e8" alt="37 方案">
</p>

指北 TrueNorth 把分散的 AI 信息整理成一条主线:**看懂 → 找到方法 → 看到案例 → 找到工具 / Skill → 尝试跑通**。
核心是一个**单 HTML 文件**(内联 CSS / JS,无构建、无后端、无依赖),双击即可打开,可整文件分享。
**🌐 在线体验:<https://true-north-ev.netlify.app>**(备用:<https://true-north-nu.vercel.app>)

## 怎么打开
> 线上站与仓库 `main` 之间可能相差一个内容小版本,以仓库为最新基线。

直接双击 `TrueNorth.html`(任意现代浏览器)。无需服务器、无需联网——logo 已 base64 内联。
---

## 为什么做这个

AI 内容太多,能落地的太少。多数人卡在同一条沟里:**看了很多,仍然不知道明天上班能改哪一步。**

指北的答案是把分散信息压成一条可以走的主线:

```
看懂趋势 → 找到方法 → 看到真实案例 → 拿到工具 / Skill → 今天就跑通一个
```

站内一切设计都服务这条主线:信号有出处、案例可溯源、方案带「指北解读」、Skill 给出装法与提示词——**不裸挂链接,不搬运焦虑**。

## 30 秒上手

1. 打开 [线上站](https://true-north-ev.netlify.app),或克隆本仓库后**直接双击 `TrueNorth.html`**(任意现代浏览器,无需服务器与联网,logo 已 base64 内联);
2. 按 `Ctrl / ⌘ K` 全站搜索,或从首页「开始」区选一条路线;
3. 赶时间就走最短路径:**Skill 库 → 挑一条「新手友好」 → 复制提示词 / 安装命令 → 去你的 AI 里跑**。

## 内容一览

| 模块 | 规模 | 一句话 |
|---|---|---|
| AI 信号雷达 | 21 条 | 近期真正有信息增量的论文 / 模型 / 工程实践,大白话重写 + 原始出处 |
| 关键洞察 | 4 章 | 从多来源内容中提炼的共识与变化方向 |
| 实战案例 | 12 个 | 企业、团队与个人真实用 AI 的方式,结构化解读 |
| 方案库 Toolkit | 37 套 | 开源 Agent / 工具 / 平台 / Skill 集合,每套配 5 页「指北解读」与怎么跑 |
| **Skill 库** | **45 条** | 最小可复用能力单元:场景 / 输入输出 / 装法 / 提示词,全部人工复核 |
| AI 词典 | 72 词条 | 知识图谱为主界面的概念网络,附类比与互链 |
| 深度解读 Deck | 17 篇 | 长内容的卡片化精读 |
| 来源图谱 | — | 这个库从哪里来:主题 × 机构双向联动,点来源可反查贡献 |
| 论文工作台 | — | 从选题到终稿的分阶段 AI 用法(`#paper`) |
| 公考备考 SOP | 测试 | 原创整理、非 Skill-first,不构成报考建议(`#gongkao`) |
| 全站搜索 | — | `Ctrl / ⌘ K`,跨信号 · 案例 · 方案 · Skill · 词条 |

## Skill-first 是什么意思

「Skill」是这个站的一等公民:**比文章小、比工具轻、拿来即用的一段可复用能力**(一条提示词、一个安装命令、一套追问节奏)。

入库标准(详见 `评审文档/`):

- **不原创、必接地**——每条 Skill 接地真实 GitHub 仓库或权威来源,可溯源(公考 SOP 为显式破例,已标注测试);
- **人工精选、全量复核**——45 条全部 `reviewed`,聚合库负责「多」,这里负责「能跑」;
- **不裸挂链接**——平台与工具必须带「指北解读」:它是什么、适合谁、不适合谁、我们的判断;
- **诚实边界**——风险等级、适用人群、不承诺效果。

## 工程形态:为什么是一个 HTML 文件

```
TrueNorth.html (~713 KB)
├── <style> × 1 全站样式
├── <script> × 1 数据层(内容即数据:SIGNALS / TOOLKIT / SKILL_LIBRARY / GLOSSARY…)
└── <script> × 1 渲染交互层(搜索 / 图谱 / Deck / 关系网络)
```

- **可整文件转发**:发一个文件 = 发整个站,收到就能开,不依赖我的服务器活着;
- **离线优先**:无构建、无后端、无外部依赖,飞机上也能用;
- **数据与渲染分离**:内容以结构化数组维护,改内容不碰渲染层。

## 模块
代价与取舍:单文件体积随内容增长、协作编辑门槛高——对「个人维护 + 整文件分发」的定位,这是划算的交换。Skill 已过 30 条阈值,评估后**暂不拆分**,待真有维护痛点再以可逆方式拆。

- AI 信号 · 关键洞察 · 实战案例 · 方案库 · Skill 库 · AI 词典 · 来源图谱
- 论文工作台(`#paper`)
- 公考备考 SOP(`#gongkao`,**测试模块**:原创整理、非 skill-first、不构成报考建议,一切以官方公告为准)
- 全站搜索(`Ctrl / ⌘ K`)
## 质量与验证

当前内容基线:深度解读 17 · 实战案例 12 · 方案 35 · 信号 21 · 词条 72 · 已复核 Skill 44。
- **系统级验收**:MVP v1 已 Review Freeze,无未解决 P0(`评审文档/Review_Report.md`);
- **每次改动**:抽出两个 `<script>` 过 `node --check`,再用 jsdom 真实加载复验,**0 error / 0 warning 才算过**;
- **外部走查**:浏览器走查报告与外部 reviewer 反馈均在 `评审文档/` 留档;
- **反馈闭环**:站内反馈表单(Netlify Forms)直达作者。

## 目录结构

| 路径 | 说明 |
|---|---|
| `TrueNorth.html` | 网站本体(核心资产,单文件) |
| `说明.md` | 一页式索引:什么是什么、从哪看起 |
| `评审文档/` | 开发文档 / Review_Report / P0_P1_P2_Issues / Browser_Walkthrough_Report / External_Review_Feedback |
| `内容流水线/` | 离线 Skill 提取 / 复核脚本与数据(非前端运行) |
| `评审文档/` | 开发文档 · Review_Report · P0/P1/P2 问题清单 · 浏览器走查 · 外部评审反馈 |
| `内容流水线/` | 离线 Skill 提取 / 复核脚本与数据(前端不运行) |
| `论文终稿Review-SOP/` | 独立交付物:论文终稿 review 可执行 SOP(HTML + MD) |
| `logos/` | 品牌 SVG(同时已 base64 内联进 HTML) |
| `logos/` | 品牌 SVG 源文件(已同步 base64 内联进 HTML) |

## 维护约定
## 常见问题

- **单文件是核心资产**:不拆分 `TrueNorth.html` 的数据层;保持一个 `<style>` + 两个 `<script>`(数据层 / 渲染层)。
- **不原创、必接地**:每个 Skill 接地真实 GitHub / 权威来源(公考 SOP 为显式破例,已标注「测试」)。
- **改完必验证**:抽出 `<script>` 跑 `node --check`;再用 jsdom 真实加载复验,0 error 才算过。
- 详见 `评审文档/开发文档.md`。
**为什么不做成多页站 / 加个后端?**
分发形态优先。单文件让「分享整个站」和「转发一个文件」是同一件事,且永远离线可用。

## 状态
**内容多久更新?**
不追热点节奏,按「有信息增量才入库」更新;每次扩容都走同一套复核与验证流程。

TrueNorth Skill-first MVP v1(已冻结,无未解决 P0)。详见 `评审文档/`。
**可以贡献吗?**
个人项目,暂不接 PR;欢迎用站内反馈表单或 Issue 提建议、报断链、荐 Skill。

---

私有仓库 · 个人项目
**个人独立项目 · 一个人从 0 到上线。** by [Evans He](https://github.com/evans777max) —— 姊妹仓库:[dev-skills](https://github.com/evans777max/dev-skills)(把「交付审美」写成 AI 能读的规则)
Loading