AI Workspace Hub

Turn Codex, Claude Code, Cursor, and Cline into a persistent research workspace.

把 AI 编程助手变成一套能长期记忆、持续研究、自动沉淀的工作台。

30 秒上手 · 六大能力 · 第一周怎么用 · 故障排查

演示动图按安装协议与 首次股票研究流程脚本化生成（生成脚本），非实录。

对话很聪明，但工作流没有记忆；今天做完，明天又从头解释。

AI Workspace Hub 解决这个问题。六大能力开箱即用——核心工作流不需要 API key。

📖 想先了解设计思路？看作者的公众号长文：《从0构建 AI 协作系统（一）：从最小可运行的 MVP 开始》

⚡ 30 秒上手

把下面这句话发给你的 AI agent（Codex / Claude Code / Cursor / Cline）：

帮我按这个协议安装 AI Workspace Hub：
https://raw.githubusercontent.com/Benboerba620/ai-workspace-hub/main/INSTALL-FOR-AI.md
抓不到协议全文就先 git clone 本仓库，再读其中的 INSTALL-FOR-AI.md 逐字执行。

Agent 会问你 3 个问题，然后自动创建完整工作区。装好后，先用样例确认安装：

把 inbox/first-note.md 整理进 personal wiki。

预期：agent 读 AGENTS.md → 按 wiki/_schema.md 整理 → 写入 wiki/sources/ → 在 active-context.md 记录进度。

不需要 API key，不需要联网，不需要写任何代码。

样例通过后，开始第一份真实股票研究：

研究一家公司，同时帮我建立第一版研究偏好。
公司是：____；我现在关注它是因为：____。

这次会同时产出研究报告、研究偏好 v0.1、可验证假设和后续跟踪指标。以后研究其他公司会复用并继续校准这套方法，而不是每次从空白开始。

任选其一，都有免费或试用档：

• Claude Code（推荐）：先装 Node.js，然后终端运行 npm install -g @anthropic-ai/claude-code，在任意目录输入 claude 登录 Claude 账号。
• Codex CLI：npm install -g @openai/codex，输入 codex 登录 ChatGPT 账号。
• Cursor：去 cursor.com 下载安装，打开一个文件夹后用内置对话。

装好后回到上面，把那句话发给它就行。

git clone https://github.com/Benboerba620/ai-workspace-hub.git my-ai-workspace
cd my-ai-workspace

用 AI agent 打开这个目录，直接试跑 inbox/first-note.md → wiki。

验证安装状态：

python3 system/scripts/check_workspace.py    # Windows: python system/scripts/check_workspace.py

Core Mode 显示 READY 即可开始使用。

📈 股票研究主流程

首次研究引导 → 研究偏好 v0.1 → 研究结论 → 可验证假设
      → 跟踪指标 → daily-watch 日报 → 独立证据 → 假设复盘 → 长期知识

START-HERE.md 是安装后的用户首页。信息摄入只是输入环节；系统的主线是让研究结论进入假设，并通过日报持续验证。

每份研究、假设和证据都有稳定 ID；当前状态只保存在 Markdown frontmatter。需要用户确认的 wiki 沉淀、假设调整、股票池新增和研究偏好变化会进入持久待确认队列。直接说：

看看我的研究系统现在有什么需要处理。

Agent 会汇总进行中的研究、待复盘证据、到期假设和待确认动作，并给出下一步。

🧩 六大能力

零 key 可用：wiki 仍可摄入，但跳过脚本自动标签；research、hypothesis、screen（websearch 模式）、daily-watch（报告骨架 + 美股降级源）照常可用。

默认建议配置：自己的 DeepSeek / Kimi / GLM / Qwen key 用于 wiki 自动标签和播客摘要；tushare（A 股）· FMP（全球行情）· Longbridge Skill（多市场查询）按需开启。

🔄 工作流程

flowchart LR
    IN["inbox / web"] --> TAG["统一自动标签"]
    TAG --> KB["wiki 知识库"]
    KB --> R["research R*"]
    R --> H["hypothesis H*"]
    H --> W["唯一执行股票池"]
    W --> D["daily-watch 日报"]
    D --> E["evidence E-*"]
    E -->|"用户确认后复盘"| H
    R --> Q["review-queue Q-*"]
    H --> Q
    Q -->|"确认后执行"| KB
    S["workspace status"] -.-> R
    S -.-> H
    S -.-> E
    S -.-> Q

核心不是"文件夹长什么样"，而是：agent 进入目录后知道先读什么、做研究时先查本地 wiki、输出时事实与推测分开、证据和判断不混写、待确认动作不会随对话消失、明天继续时能从断点接上。

wiki 变大后也不会每次全量加载。每次研究先运行 Research Preflight：按 rule -> pattern -> exploration 加载相关可复用知识，同时扫描 entities / concepts / sources，只返回少量命中页面、命中理由和过期/冲突提示，再决定哪些问题需要联网。扫描不调用大模型，并生成可检查的回执。知识按 source -> exploration -> pattern -> rule 逐级提炼；每次晋级、降级或退役都保留用户确认、复审日期和失效条件。

材料进入 wiki 时由同一个打标器补齐 domain / ticker / concepts / related / entity_salience / tags。新材料直接写入，历史补标默认只预览；已有人工字段不会被覆盖。

系统不在某个模型里，而在这套文件协议里。谁读懂这套协议，谁就接上你的工作流。

⚙️ Core Mode / Enhanced Mode

推荐路径：安装后运行 check_workspace.py → 把自己的 LLM key 填到 config/pod2wiki.env → 用第一篇材料验证自动标签。暂时没有 key 时仍可先跑 Core Mode。

📅 第一周怎么用

适合谁？

适合：投资研究员、个人投资者、内容创作者、AI power user、Markdown / Obsidian 用户、想做长期项目而不是一次性对话的人。

不适合：想要 GUI 应用、自动交易系统，或不愿意用 Markdown 管理知识的人。

ai-workspace-hub/
├── AGENTS.md                 # Codex 入口路由
├── CLAUDE.md                 # Claude Code 入口路由
├── INSTALL-FOR-AI.md         # 交给 AI agent 的安装协议
├── SMOKE-TEST.md             # 冒烟测试
├── ARCHITECTURE.md           # 架构说明
├── TROUBLESHOOTING.md        # 故障排查
├── workspace/                # 项目配置、断点续传、待确认队列
├── inbox/                    # 临时输入材料
├── wiki/                     # personal wiki（exploration / pattern / rule）
├── output/                   # 研究、筛选、播客等输出
├── monitoring/               # 用户阅读的监控看板
├── hypothesis/               # 投资假设和复盘
├── evidence/                 # 独立证据账本
├── daily-watchlist-reports/  # 日报输出
├── portfolio/                # 交易记录
├── config/                   # 用户配置，不入 git
├── tools/                    # podcast / daily-watch 工具
└── system/                   # skills / integrations / scripts / templates

重要边界：本项目不做自动交易，不承诺数据源永远免费，不把 AI 输出包装成投资建议。缺少 API key 时优雅降级，不会让用户误以为工作区坏了。

python3 system/scripts/check_workspace.py          # 总检查
python3 system/scripts/workspace_status.py         # 当前研究、证据和待办
python3 system/scripts/research_preflight.py --root . --context "你的研究问题和关键词" --research-id R-... --research-file output/research/报告.md --record  # 扫描 Wiki 并更新研究报告
python3 system/scripts/knowledge_lifecycle.py --root . summary  # 知识状态、到期复审和晋级候选
python3 system/scripts/knowledge_lifecycle.py --root . rebuild-index --apply  # 重建三个短索引
python3 system/scripts/review_queue.py list        # 查看持久待确认队列
python3 system/scripts/wiki_tagger.py --root . backfill wiki  # 预览历史 wiki 补标
python3 -m unittest discover -s tests -v            # 运行测试
python3 tools/daily-watch/scripts/check_setup.py --init  # 初始化日报配置
python3 tools/podcast/scripts/fetch_podcasts.py --help   # 播客工具帮助

Python 工具需要 3.10+。Windows 用户用 python 代替 python3，或 py -3 指定版本。

Q：我不会写代码，能用这个项目吗？ 可以。Core Mode 只需要把文本放进 inbox/，然后用自然语言告诉 AI agent 做什么。

Q：一定要用 Codex / Claude Code 吗？ 不一定。任何能读写文件的 AI agent 都可以。Codex 和 Claude Code 效果最好，Cursor 和 Cline 也可以。

Q：wiki 越来越大怎么办？ 用 Obsidian 打开 wiki/ 目录做可视化管理，或让 AI agent 帮你整理归档。

Q：API key 会不会泄露？ config/ 已被 .gitignore 排除，不会被 git 提交。

Q：自动标签会把什么发给大模型？ 会把当前 wiki 页面的 frontmatter 和正文发送给你在 config/pod2wiki.env 选择的模型服务商，只用于返回结构化标签。敏感材料应先确认所选服务商的数据政策，或跳过自动标签。

Q：可以和 Obsidian 一起用吗？ 可以。把 wiki/ 添加为 Obsidian vault 即可，所有笔记都是标准 Markdown。

更多问题见 TROUBLESHOOTING.md。

Roadmap

• 更多真实研究工作流样例
• 更强的 screen 预设
• 更完善的 daily-watch 降级策略
• 更好的 Obsidian 兼容说明
• 证据来源质量分级和跨来源事件去重
• 知识索引的自动健康检查与过期提示

Contributing

欢迎提 issue / PR，尤其是新 agent 适配、研究报告模板、数据源接入、真实使用摩擦点、README / 教程 / 安装流程改进。

Star History

如果这个项目对你有帮助，欢迎点一下 ⭐ Star。它会帮助更多需要"长期 AI 工作流"的人发现这个项目，也会让我知道哪些方向值得继续做。

Disclaimer

AI Workspace Hub 是个人研究与知识管理工具，不构成投资建议。所有市场数据、公司信息、财务数字、新闻和监管信息都应以原始来源为准。