klnote 0.1.0__tar.gz → 0.3.0__tar.gz

{klnote-0.1.0/klnote.egg-info → klnote-0.3.0}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: klnote
-Version: 0.1.0
+Version: 0.3.0
 Summary: Stock note management tool
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: click>=8.0.0
+Requires-Dist: prettytable>=3.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 
@@ -37,12 +38,17 @@ pip install klnote
 klnote stk ls              # 列出所有股票
 klnote stk add 000001 -n 平安银行    # 添加股票
 klnote stk get 000001       # 查看股票（支持 id/code/name）
-klnote stk delete 000001    # 删除股票
+klnote stk del 000001      # 删除股票
+klnote stk get-meta 000001  # 查看 metadata
+klnote stk set-meta 000001 --name 平安银行 --country CN  # 更新 metadata
 
 # 笔记操作
 klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
 klnote note ls 000001       # 列出笔记
-klnote note delete 000001 0 # 删除第0条笔记
+klnote note read 000001 0  # 读取第0条笔记
+klnote note edit 000001 0 -c "新内容"  # 编辑笔记
+klnote note edit 000001 0 -e  # 弹出 GUI 编辑器
+klnote note del 000001 0 # 删除第0条笔记
 ```
 
 ## 数据库
@@ -62,10 +68,18 @@ klnote --help
 ### 股票操作 (stk)
 
 ```
-klnote stk ls                       # 列出所有股票
+klnote stk ls                       # 列出所有股票（表格对齐）
 klnote stk add <code> [-n name] [-d desc]   # 添加股票
 klnote stk get <identifier>         # 查看股票详情
-klnote stk delete <identifier>      # 删除股票
+klnote stk del <identifier>         # 删除股票
+klnote stk get-meta <identifier>   # 查看 metadata
+klnote stk set-meta <identifier>    # 更新 metadata
+```
+
+**输出示例：**
+```
+ id                                code    name      description  note_num  created_at                   updated_at 
+ 38578199c19644ebab18ce7b5c16d699  688102  斯瑞新财   None         1         2026-06-04T15:52:20.853674Z  None 
 ```
 
 ### 笔记操作 (note)
@@ -73,7 +87,9 @@ klnote stk delete <identifier>      # 删除股票
 ```
 klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
 klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
-klnote note delete <stock_identifier> <index>   # 删除指定笔记
+klnote note read <stock_identifier> <index>   # 读取单条笔记
+klnote note edit <stock_identifier> <index> [-c 内容] [-s 摘要] [-e]  # 编辑笔记
+klnote note del <stock_identifier> <index>   # 删除指定笔记
 ```
 
 ### 高级操作 (admin)

klnote-0.1.0/PKG-INFO → klnote-0.3.0/README.md

@@ -1,100 +1,105 @@
-Metadata-Version: 2.4
-Name: klnote
-Version: 0.1.0
-Summary: Stock note management tool
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-
-# KLNote
-
-股票笔记管理工具，为专注股票投资的人群设计。
-
-## 背景
-
-投资股票时，每次决策都需要记录：为什么买、为什么卖、当时想到了什么。这些记录是后续复盘的核心素材。但普通笔记软件太通用，无法围绕"股票"这个实体组织信息——查一只股票的笔记，要翻半天。
-
-KLNote 的核心思路是：**先有股票，再有笔记**。每条笔记属于某只股票，每次查看都围绕股票展开。
-
-## 核心概念
-
-- **股票**：用 code（代码）或 name（名称）标识，如 `000001`、平安银行
-- **笔记**：附属于某只股票，每条包含 summary（摘要） 和 content（内容）
-- **标识符**：支持三种方式定位股票 — UUID、股票代码、股票名称
-
-## 安装
-
-```bash
-pip install klnote
-```
-
-## 使用
-
-```bash
-# 股票操作
-klnote stk ls              # 列出所有股票
-klnote stk add 000001 -n 平安银行    # 添加股票
-klnote stk get 000001       # 查看股票（支持 id/code/name）
-klnote stk delete 000001    # 删除股票
-
-# 笔记操作
-klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
-klnote note ls 000001       # 列出笔记
-klnote note delete 000001 0 # 删除第0条笔记
-```
-
-## 数据库
-
-默认路径: `~/.KLNote/KLNote.db`
-
-可通过环境变量 `KLNOTE_DB_PATH` 自定义路径。
-
-## 命令指南
-
-### 全局命令
-
-```
-klnote --help
-```
-
-### 股票操作 (stk)
-
-```
-klnote stk ls                       # 列出所有股票
-klnote stk add <code> [-n name] [-d desc]   # 添加股票
-klnote stk get <identifier>         # 查看股票详情
-klnote stk delete <identifier>      # 删除股票
-```
-
-### 笔记操作 (note)
-
-```
-klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
-klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
-klnote note delete <stock_identifier> <index>   # 删除指定笔记
-```
-
-### 高级操作 (admin)
-
-```
-klnote admin match_and_read <value> <field>    # 按字段匹配读取
-klnote admin match_and_update <value> <field> <update_field>   # 按字段匹配更新（危险）
-```
-
-### 标识符说明
-
-所有 `<identifier>` 位置均支持三种写法：
-
-| 格式 | 示例 | 解析方式 |
-|------|------|---------|
-| UUID (32位十六进制) | `a1b2c3d4e5f6...` | 精确匹配 id |
-| 纯数字 | `000001` | 匹配 code |
-| 字母/中文混合 | `平安银行` | 先试 code，再试 name |
-
-## 环境变量
-
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
-| `KLNOTE_DB_PATH` | 数据库文件路径 | `~/.KLNote/KLNote.db` |
+# KLNote
+
+股票笔记管理工具，为专注股票投资的人群设计。
+
+## 背景
+
+投资股票时，每次决策都需要记录：为什么买、为什么卖、当时想到了什么。这些记录是后续复盘的核心素材。但普通笔记软件太通用，无法围绕"股票"这个实体组织信息——查一只股票的笔记，要翻半天。
+
+KLNote 的核心思路是：**先有股票，再有笔记**。每条笔记属于某只股票，每次查看都围绕股票展开。
+
+## 核心概念
+
+- **股票**：用 code（代码）或 name（名称）标识，如 `000001`、平安银行
+- **笔记**：附属于某只股票，每条包含 summary（摘要） 和 content（内容）
+- **标识符**：支持三种方式定位股票 — UUID、股票代码、股票名称
+
+## 安装
+
+```bash
+pip install klnote
+```
+
+## 使用
+
+```bash
+# 股票操作
+klnote stk ls              # 列出所有股票
+klnote stk add 000001 -n 平安银行    # 添加股票
+klnote stk get 000001       # 查看股票（支持 id/code/name）
+klnote stk del 000001      # 删除股票
+klnote stk get-meta 000001  # 查看 metadata
+klnote stk set-meta 000001 --name 平安银行 --country CN  # 更新 metadata
+
+# 笔记操作
+klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
+klnote note ls 000001       # 列出笔记
+klnote note read 000001 0  # 读取第0条笔记
+klnote note edit 000001 0 -c "新内容"  # 编辑笔记
+klnote note edit 000001 0 -e  # 弹出 GUI 编辑器
+klnote note del 000001 0 # 删除第0条笔记
+```
+
+## 数据库
+
+默认路径: `~/.KLNote/KLNote.db`
+
+可通过环境变量 `KLNOTE_DB_PATH` 自定义路径。
+
+## 命令指南
+
+### 全局命令
+
+```
+klnote --help
+```
+
+### 股票操作 (stk)
+
+```
+klnote stk ls                       # 列出所有股票（表格对齐）
+klnote stk add <code> [-n name] [-d desc]   # 添加股票
+klnote stk get <identifier>         # 查看股票详情
+klnote stk del <identifier>         # 删除股票
+klnote stk get-meta <identifier>   # 查看 metadata
+klnote stk set-meta <identifier>    # 更新 metadata
+```
+
+**输出示例：**
+```
+ id                                code    name      description  note_num  created_at                   updated_at 
+ 38578199c19644ebab18ce7b5c16d699  688102  斯瑞新财   None         1         2026-06-04T15:52:20.853674Z  None 
+```
+
+### 笔记操作 (note)
+
+```
+klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
+klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
+klnote note read <stock_identifier> <index>   # 读取单条笔记
+klnote note edit <stock_identifier> <index> [-c 内容] [-s 摘要] [-e]  # 编辑笔记
+klnote note del <stock_identifier> <index>   # 删除指定笔记
+```
+
+### 高级操作 (admin)
+
+```
+klnote admin match_and_read <value> <field>    # 按字段匹配读取
+klnote admin match_and_update <value> <field> <update_field>   # 按字段匹配更新（危险）
+```
+
+### 标识符说明
+
+所有 `<identifier>` 位置均支持三种写法：
+
+| 格式 | 示例 | 解析方式 |
+|------|------|---------|
+| UUID (32位十六进制) | `a1b2c3d4e5f6...` | 精确匹配 id |
+| 纯数字 | `000001` | 匹配 code |
+| 字母/中文混合 | `平安银行` | 先试 code，再试 name |
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `KLNOTE_DB_PATH` | 数据库文件路径 | `~/.KLNote/KLNote.db` |

klnote-0.3.0/klnote/__init__.py

@@ -0,0 +1,3 @@
+__version__ = "0.3.0"
+__author__ = "zimvir"
+__email__ = "zimvir@qq.com"

klnote-0.3.0/klnote/cli.py

@@ -0,0 +1,284 @@
+
+import click
+
+from prettytable import PrettyTable
+
+from .core import Service
+from .core.utils.time_1 import format_iso
+
+
+service = Service()
+
+
+@click.group()
+def cli():
+    """KLNote - 股票笔记管理"""
+    pass
+
+
+
+
+# ============= stock 组 =============
+@cli.group()
+def stk():
+    """股票操作"""
+    pass
+
+
+@stk.command()
+def ls():
+    """列出所有股票"""
+    stocks = service.stock_list()
+    if not stocks:
+        click.echo("暂无股票")
+        return
+    headers = ['id', 'code', 'name', 'description', 'note_num', 'created_at', 'updated_at']
+    pt = PrettyTable(headers)
+    pt.align = "l"
+    pt.horizontal_char = '-'
+    pt.border = False
+
+    rows =[[
+        s.get("id") or "None",
+        s.get("code") or "None",
+        s.get("name") or "None",
+        s.get("description") or "None",
+        str(len(s.get("notes") or [])),
+        s.get("created_at") or "None",
+        s.get("updated_at") or "None"
+        ]for s in stocks]
+    pt.add_rows(rows)
+    click.echo(pt)
+
+
+@stk.command()
+@click.argument('code')
+@click.option('-n', '--name', default='', help='股票名称')
+@click.option('-d', '--description', default='', help='描述')
+def add(code, name, description):
+    """新增股票"""
+    service.stock_add(code=code, name=name, description=description)
+    click.echo(f"已添加: {code}")
+
+
+@stk.command()
+@click.argument('identifier')
+def get(identifier):
+    """查看股票详情（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(identifier)
+    if not stock_ids:
+        click.echo("未找到")
+        return
+    for stock_id in stock_ids:
+        s = service.stock_show(stock_id)
+        click.echo(f"ID: {s['id']}")
+        click.echo(f"代码: {s['code']}")
+        click.echo(f"名称: {s.get('name', '')}")
+        click.echo(f"描述: {s.get('description', '')}")
+        notes = s.get('notes', [])
+        click.echo(f"笔记数: {len(notes)}")
+        click.echo("-"*50)
+
+
+@stk.command()
+@click.argument('identifier')
+def get_meta(identifier):
+    """查看股票 metadata（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(identifier)
+    if not stock_ids:
+        click.echo("未找到")
+        return
+    for stock_id in stock_ids:
+        s = service.stock_show(stock_id)
+        metadata = s.get("metadata", {})
+        click.echo(f"ID: {stock_id}")
+        for k, v in metadata.items():
+            click.echo(f"  {k}: {v}")
+        click.echo("-"*50)
+
+
+@stk.command()
+@click.argument('identifier')
+@click.option('--code', default=None, help='股票代码')
+@click.option('--name', default=None, help='股票名称')
+@click.option('--country', default=None, help='国家')
+@click.option('--label', default=None, help='标签, 如中国A股：A')
+def set_meta(identifier, code, name, country, label):
+    """更新股票 metadata（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(identifier)
+    if not stock_ids:
+        click.echo("未找到")
+        return
+    for stock_id in stock_ids:
+        kwargs = {}
+        if code is not None:
+            kwargs["code"] = code
+        if name is not None:
+            kwargs["name"] = name
+        if country is not None:
+            kwargs["country"] = country
+        if label is not None:
+            kwargs["label"] = label
+        if not kwargs:
+            click.echo("请至少指定一个要更新的字段")
+            continue
+        service.update_metadata(stock_id, **kwargs)
+        click.echo(f"已更新 metadata")
+        click.echo("-"*50)
+
+
+@stk.command('del')
+@click.argument('identifier')
+def delete(identifier):
+    """删除股票（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(identifier)
+    if not stock_ids:
+        click.echo("未找到")
+        return
+    for stock_id in stock_ids:
+        service.stock_delete(stock_id)
+        click.echo(f"已删除: {stock_id}")
+        click.echo("-" * 50)
+
+# ============= note 组 =============
+@cli.group()
+def note():
+    """笔记操作"""
+    pass
+
+
+@note.command()
+@click.argument('stock_identifier')
+@click.option('-s', '--summary', default='', help='笔记摘要')
+@click.option('-c', '--content', default='', help='笔记内容')
+def add(stock_identifier, summary, content):
+    """添加笔记（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        service.note_add(stock_id, content=content, summary=summary)
+        click.echo(f"'id' = '{stock_id}' 笔记已添加")
+        click.echo("-" * 50)
+
+@note.command()
+@click.argument('stock_identifier')
+def ls(stock_identifier):
+    """列出股票的所有笔记（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        notes = service.note_read(stock_id)
+        if not notes:
+            click.echo(f"[{stock_id}] 暂无笔记")
+            continue
+        for i, n in enumerate(notes):
+            click.echo(f"索引： {i}")
+            click.echo(f"创建时间: {format_iso(n.get('created_at', ''))}")
+            click.echo(f"更新时间: {format_iso(n.get('updated_at', ''))}")
+            click.echo(f"摘要: {n.get('summary', '')}")
+            if n.get('content'):
+                click.echo(f"内容： \n    {n.get('content', '')}")
+
+            click.echo("-"*50)
+
+
+@note.command()
+@click.argument('stock_identifier')
+@click.argument('index', type=int)
+def read(stock_identifier, index):
+    """读取单条笔记（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        notes = service.note_read(stock_id)
+        if index < 0 or index >= len(notes):
+            click.echo(f"索引 {index} 不存在")
+            continue
+        n = notes[index]
+        click.echo(f"索引： {index}")
+        click.echo(f"创建时间: {format_iso(n.get('created_at', ''))}")
+        click.echo(f"更新时间: {format_iso(n.get('updated_at', ''))}")
+
+        click.echo(f"摘要: {n.get('summary', '')}")
+        if n.get('content'):
+            click.echo(f"内容：\n    {n.get('content', '')}")
+
+        click.echo("-"*50)
+
+
+@note.command('del')
+@click.argument('stock_identifier')
+@click.argument('index', type=int)
+def delete(stock_identifier, index):
+    """删除笔记（支持 id/code/name）"""
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        service.note_delete(stock_id, index)
+        click.echo(f"已删除第 {index} 条笔记")
+        click.echo("-" * 50)
+
+
+@note.command()
+@click.argument('stock_identifier')
+@click.argument('index', type=int)
+@click.option('-s', '--summary', default=None, help='笔记摘要')
+@click.option('-c', '--content', default=None, help='笔记内容')
+@click.option('-e', '--editer', is_flag=True, help='弹出 GUI 编辑器')
+def edit(stock_identifier, index, summary, content, editer):
+    """编辑笔记（支持 id/code/name）"""
+    if not content and not summary and not editer:
+        click.echo("请指定 --content 或 --summary 或 --editer")
+        return
+    stock_ids = service.match_by_identifier(stock_identifier)
+    if not stock_ids:
+        click.echo("未找到股票")
+        return
+    for stock_id in stock_ids:
+        service.note_edit(stock_id, index, content=content, summary=summary, editer=editer)
+        click.echo(f"已编辑第 {index} 条笔记")
+        click.echo("-" * 50)
+
+# ============= admin 组 =============
+@cli.group()
+def admin():
+    """高级操作（直接操作数据库字段）"""
+    pass
+
+
+@admin.command()
+@click.argument('value')
+@click.argument('field')
+def match_and_read(value, field):
+    """按字段匹配并读取所有匹配的股票"""
+    results = service.match_and_read(value, field)
+    if not results:
+        click.echo("未找到匹配结果")
+        return
+    for stock_id, data in results.items():
+        click.echo(f"ID: {stock_id}")
+        click.echo(f"  code: {data.get('code', '')}")
+        click.echo(f"  name: {data.get('name', '')}")
+        click.echo("-" * 50)
+
+
+@admin.command()
+@click.argument('value')
+@click.argument('field')
+@click.argument('update_field')
+def match_and_update(value, field, update_field):
+    """按字段匹配并更新（危险操作）"""
+    service.match_and_update(value, field, update_field)
+    click.echo(f"已更新 field={update_field} 的所有匹配记录")
+
+
+if __name__ == '__main__':
+    cli()

klnote-0.3.0/klnote/core/__init__.py

@@ -0,0 +1,3 @@
+from .service import Service
+
+

{klnote-0.1.0 → klnote-0.3.0}/klnote/core/service.py

@@ -1,5 +1,5 @@
 import json
-
+import re
 from .database import Database
 from .constants import DB_PATH
 from .utils import get_iso_timestamp
@@ -10,7 +10,8 @@ class Service:
         self.db = db or Database(DB_PATH)
 
 
-    def search(self,id:str=None, code:str=None, name:str=None):
+
+    def match_by_id_code_name(self,id:str=None, code:str=None, name:str=None):
         """
          id code name 三选一 查询,若多填， 优先 找 id 其次 code 最后 name
 
@@ -26,10 +27,49 @@ class Service:
 
         return ids
 
+    def match_by_identifier(self,identifier: str):
+        """
+        股票标识符解析，返回 stock id 列表
+
+        解析逻辑:
+          1. UUID格式(32位十六进制) → search(id=)
+          2. 纯数字               → search(code=)
+          3. 其他(字母/中文混合)   → search(code=) 优先，search(name=) 兜底
+        """
+
+        # UUID → id
+        if re.fullmatch(r'[0-9a-f]{32}', identifier):
+            return self.match_by_id_code_name(id=identifier)
+
+        # 纯数字 → code
+        if identifier.isdigit():
+            return self.match_by_id_code_name(code=identifier)
+
+        # 其他（字母混合）→ 先试 code，再试 name
+        ids = self.match_by_id_code_name(code=identifier)
+        if not ids:
+            ids = self.match_by_id_code_name(name=identifier)
+        return ids
+
     # stock
     def stock_add(self, code: str, id: str = None, name: str = None, description: str = None):
         """新建股票条目"""
         self.db.create_and_add_new_stock_row(code=code, id=id, name=name, description=description)
+        stock_ids = self.match_by_id_code_name(id=id, code=code, name=name)
+        if stock_ids:
+            self.update_metadata(stock_ids[0], code=code, name=name)
+        return self
+
+    def update_metadata(self, stock_id: str, **kwargs):
+        """更新股票的 metadata 字段
+
+        :param stock_id: 股票 ID
+        :param kwargs: 任意 key=value，如 code="000001", name="平安银行", country="CN"
+        """
+        stock = self.stock_show(stock_id)
+        metadata = stock.get("metadata", {})
+        metadata.update(kwargs)
+        self.db.update(stock_id, "metadata", json.dumps(metadata))
         return self
 
     def stock_delete(self, id: str):
@@ -57,6 +97,10 @@ class Service:
             "extra": extra or {}
         }
 
+    def touch_updated_at(self, stock_id: str):
+        """更新股票的 updated_at 时间戳"""
+        self.db.update(stock_id, "updated_at", get_iso_timestamp())
+
     def note_add(self, stock_id: str, content: str, summary: str = None, extra: dict = None):
         """给股票添加一条笔记"""
         stock = self.stock_show(stock_id)
@@ -64,6 +108,7 @@ class Service:
         note = self._build_note(content, summary, extra)
         notes.append(note)
         self.db.update(stock_id, "notes", json.dumps(notes))
+        self.touch_updated_at(stock_id)
         return self
 
     def note_delete(self, stock_id: str, index: int):
@@ -72,6 +117,30 @@ class Service:
         notes = stock.get("notes", [])
         notes.pop(index)
         self.db.update(stock_id, "notes", json.dumps(notes))
+        self.touch_updated_at(stock_id)
+        return self
+
+    def note_edit(self, stock_id: str, index: int, content: str = None, summary: str = None, editer: bool = False):
+        """编辑股票指定索引的笔记"""
+        stock = self.stock_show(stock_id)
+        notes = stock.get("notes", [])
+        if index < 0 or index >= len(notes):
+            raise IndexError(f"笔记索引 {index} 不存在")
+        if editer:
+            from .utils.editor import edit_in_editor
+            edited = edit_in_editor(initial_content=notes[index].get("content") or "")
+            if edited is None:
+                return self
+            content = edited
+        now = get_iso_timestamp()
+        if content is not None:
+            notes[index]["content"] = content
+            notes[index]["updated_at"] = now
+        if summary is not None:
+            notes[index]["summary"] = summary
+            notes[index]["updated_at"] = now
+        self.db.update(stock_id, "notes", json.dumps(notes))
+        self.touch_updated_at(stock_id)
         return self
 
     def _read_notes(self, stock_id: str) -> list:

klnote-0.3.0/klnote/core/utils/time_1.py

@@ -0,0 +1,21 @@
+import os
+from datetime import datetime, timezone
+
+
+def get_iso_timestamp(microseconds=True):
+    """自定义是否包含微秒"""
+    if microseconds:
+        return datetime.now(timezone.utc).isoformat(timespec='microseconds').replace('+00:00', 'Z')
+    else:
+        return datetime.now(timezone.utc).isoformat(timespec='seconds').replace('+00:00', 'Z')
+
+
+def format_iso(iso_str: str | None) -> str:
+    """将 ISO 时间戳解码为本地可读格式，如 '2026-06-09 14:30:00'"""
+    if not iso_str:
+        return ""
+    try:
+        dt = datetime.fromisoformat(iso_str.replace('Z', '+00:00'))
+        return dt.strftime("%Y-%m-%d %H:%M:%S")
+    except (ValueError, TypeError):
+        return iso_str

klnote-0.1.0/README.md → klnote-0.3.0/klnote.egg-info/PKG-INFO

@@ -1,90 +1,116 @@
-# KLNote
-
-股票笔记管理工具，为专注股票投资的人群设计。
-
-## 背景
-
-投资股票时，每次决策都需要记录：为什么买、为什么卖、当时想到了什么。这些记录是后续复盘的核心素材。但普通笔记软件太通用，无法围绕"股票"这个实体组织信息——查一只股票的笔记，要翻半天。
-
-KLNote 的核心思路是：**先有股票，再有笔记**。每条笔记属于某只股票，每次查看都围绕股票展开。
-
-## 核心概念
-
-- **股票**：用 code（代码）或 name（名称）标识，如 `000001`、平安银行
-- **笔记**：附属于某只股票，每条包含 summary（摘要） 和 content（内容）
-- **标识符**：支持三种方式定位股票 — UUID、股票代码、股票名称
-
-## 安装
-
-```bash
-pip install klnote
-```
-
-## 使用
-
-```bash
-# 股票操作
-klnote stk ls              # 列出所有股票
-klnote stk add 000001 -n 平安银行    # 添加股票
-klnote stk get 000001       # 查看股票（支持 id/code/name）
-klnote stk delete 000001    # 删除股票
-
-# 笔记操作
-klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
-klnote note ls 000001       # 列出笔记
-klnote note delete 000001 0 # 删除第0条笔记
-```
-
-## 数据库
-
-默认路径: `~/.KLNote/KLNote.db`
-
-可通过环境变量 `KLNOTE_DB_PATH` 自定义路径。
-
-## 命令指南
-
-### 全局命令
-
-```
-klnote --help
-```
-
-### 股票操作 (stk)
-
-```
-klnote stk ls                       # 列出所有股票
-klnote stk add <code> [-n name] [-d desc]   # 添加股票
-klnote stk get <identifier>         # 查看股票详情
-klnote stk delete <identifier>      # 删除股票
-```
-
-### 笔记操作 (note)
-
-```
-klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
-klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
-klnote note delete <stock_identifier> <index>   # 删除指定笔记
-```
-
-### 高级操作 (admin)
-
-```
-klnote admin match_and_read <value> <field>    # 按字段匹配读取
-klnote admin match_and_update <value> <field> <update_field>   # 按字段匹配更新（危险）
-```
-
-### 标识符说明
-
-所有 `<identifier>` 位置均支持三种写法：
-
-| 格式 | 示例 | 解析方式 |
-|------|------|---------|
-| UUID (32位十六进制) | `a1b2c3d4e5f6...` | 精确匹配 id |
-| 纯数字 | `000001` | 匹配 code |
-| 字母/中文混合 | `平安银行` | 先试 code，再试 name |
-
-## 环境变量
-
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
-| `KLNOTE_DB_PATH` | 数据库文件路径 | `~/.KLNote/KLNote.db` |
+Metadata-Version: 2.4
+Name: klnote
+Version: 0.3.0
+Summary: Stock note management tool
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: prettytable>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# KLNote
+
+股票笔记管理工具，为专注股票投资的人群设计。
+
+## 背景
+
+投资股票时，每次决策都需要记录：为什么买、为什么卖、当时想到了什么。这些记录是后续复盘的核心素材。但普通笔记软件太通用，无法围绕"股票"这个实体组织信息——查一只股票的笔记，要翻半天。
+
+KLNote 的核心思路是：**先有股票，再有笔记**。每条笔记属于某只股票，每次查看都围绕股票展开。
+
+## 核心概念
+
+- **股票**：用 code（代码）或 name（名称）标识，如 `000001`、平安银行
+- **笔记**：附属于某只股票，每条包含 summary（摘要） 和 content（内容）
+- **标识符**：支持三种方式定位股票 — UUID、股票代码、股票名称
+
+## 安装
+
+```bash
+pip install klnote
+```
+
+## 使用
+
+```bash
+# 股票操作
+klnote stk ls              # 列出所有股票
+klnote stk add 000001 -n 平安银行    # 添加股票
+klnote stk get 000001       # 查看股票（支持 id/code/name）
+klnote stk del 000001      # 删除股票
+klnote stk get-meta 000001  # 查看 metadata
+klnote stk set-meta 000001 --name 平安银行 --country CN  # 更新 metadata
+
+# 笔记操作
+klnote note add 000001 -s "摘要" -c "内容"   # 添加笔记
+klnote note ls 000001       # 列出笔记
+klnote note read 000001 0  # 读取第0条笔记
+klnote note edit 000001 0 -c "新内容"  # 编辑笔记
+klnote note edit 000001 0 -e  # 弹出 GUI 编辑器
+klnote note del 000001 0 # 删除第0条笔记
+```
+
+## 数据库
+
+默认路径: `~/.KLNote/KLNote.db`
+
+可通过环境变量 `KLNOTE_DB_PATH` 自定义路径。
+
+## 命令指南
+
+### 全局命令
+
+```
+klnote --help
+```
+
+### 股票操作 (stk)
+
+```
+klnote stk ls                       # 列出所有股票（表格对齐）
+klnote stk add <code> [-n name] [-d desc]   # 添加股票
+klnote stk get <identifier>         # 查看股票详情
+klnote stk del <identifier>         # 删除股票
+klnote stk get-meta <identifier>   # 查看 metadata
+klnote stk set-meta <identifier>    # 更新 metadata
+```
+
+**输出示例：**
+```
+ id                                code    name      description  note_num  created_at                   updated_at 
+ 38578199c19644ebab18ce7b5c16d699  688102  斯瑞新财   None         1         2026-06-04T15:52:20.853674Z  None 
+```
+
+### 笔记操作 (note)
+
+```
+klnote note add <stock_identifier> [-s 摘要] [-c 内容]   # 添加笔记
+klnote note ls <stock_identifier>     # 列出某只股票的所有笔记
+klnote note read <stock_identifier> <index>   # 读取单条笔记
+klnote note edit <stock_identifier> <index> [-c 内容] [-s 摘要] [-e]  # 编辑笔记
+klnote note del <stock_identifier> <index>   # 删除指定笔记
+```
+
+### 高级操作 (admin)
+
+```
+klnote admin match_and_read <value> <field>    # 按字段匹配读取
+klnote admin match_and_update <value> <field> <update_field>   # 按字段匹配更新（危险）
+```
+
+### 标识符说明
+
+所有 `<identifier>` 位置均支持三种写法：
+
+| 格式 | 示例 | 解析方式 |
+|------|------|---------|
+| UUID (32位十六进制) | `a1b2c3d4e5f6...` | 精确匹配 id |
+| 纯数字 | `000001` | 匹配 code |
+| 字母/中文混合 | `平安银行` | 先试 code，再试 name |
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `KLNOTE_DB_PATH` | 数据库文件路径 | `~/.KLNote/KLNote.db` |

{klnote-0.1.0 → klnote-0.3.0}/klnote.egg-info/requires.txt

@@ -1,4 +1,5 @@
 click>=8.0.0
+prettytable>=3.0.0
 
 [dev]
 pytest>=8.0.0

{klnote-0.1.0 → klnote-0.3.0}/pyproject.toml

@@ -4,11 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "klnote"
-version = "0.1.0"
+version = "0.3.0"
 description = "Stock note management tool"
 requires-python = ">=3.10"
 dependencies = [
     "click>=8.0.0",
+    "prettytable>=3.0.0",
 ]
 readme = "README.md"
 

klnote-0.1.0/klnote/cli.py

@@ -1,188 +0,0 @@
-import click
-from klnote.core.service import Service
-
-service = Service()
-
-
-@click.group()
-def cli():
-    """KLNote - 股票笔记管理"""
-    pass
-
-
-def search_by_identifier(identifier: str):
-    """
-    股票标识符解析，返回 stock id 列表
-
-    解析逻辑:
-      1. UUID格式(32位十六进制) → search(id=)
-      2. 纯数字               → search(code=)
-      3. 其他(字母/中文混合)   → search(code=) 优先，search(name=) 兜底
-    """
-    import re
-    # UUID → id
-    if re.fullmatch(r'[0-9a-f]{32}', identifier):
-        return service.search(id=identifier)
-
-    # 纯数字 → code
-    if identifier.isdigit():
-        return service.search(code=identifier)
-
-    # 其他（字母混合）→ 先试 code，再试 name
-    ids = service.search(code=identifier)
-    if not ids:
-        ids = service.search(name=identifier)
-    return ids
-
-
-# ============= stock 组 =============
-@cli.group()
-def stk():
-    """股票操作"""
-    pass
-
-
-@stk.command()
-def ls():
-    """列出所有股票"""
-    stocks = service.stock_list()
-    if not stocks:
-        click.echo("暂无股票")
-        return
-    for s in stocks:
-        click.echo(f"{s['id']}: {s['code']} {s.get('name', '')}")
-
-
-@stk.command()
-@click.argument('code')
-@click.option('-n', '--name', default='', help='股票名称')
-@click.option('-d', '--description', default='', help='描述')
-def add(code, name, description):
-    """新增股票"""
-    service.stock_add(code=code, name=name, description=description)
-    click.echo(f"已添加: {code}")
-
-
-@stk.command()
-@click.argument('identifier')
-def get(identifier):
-    """查看股票详情（支持 id/code/name）"""
-    stock_ids = search_by_identifier(identifier)
-    if not stock_ids:
-        click.echo("未找到")
-        return
-    for stock_id in stock_ids:
-        s = service.stock_show(stock_id)
-        click.echo(f"ID: {s['id']}")
-        click.echo(f"代码: {s['code']}")
-        click.echo(f"名称: {s.get('name', '')}")
-        click.echo(f"描述: {s.get('description', '')}")
-        notes = s.get('notes', [])
-        click.echo(f"笔记数: {len(notes)}")
-        click.echo("-"*50)
-
-
-@stk.command()
-@click.argument('identifier')
-def delete(identifier):
-    """删除股票（支持 id/code/name）"""
-    stock_ids = search_by_identifier(identifier)
-    if not stock_ids:
-        click.echo("未找到")
-        return
-    for stock_id in stock_ids:
-        service.stock_delete(stock_id)
-        click.echo(f"已删除: {stock_id}")
-        click.echo("-" * 50)
-
-# ============= note 组 =============
-@cli.group()
-def note():
-    """笔记操作"""
-    pass
-
-
-@note.command()
-@click.argument('stock_identifier')
-@click.option('-s', '--summary', default='', help='笔记摘要')
-@click.option('-c', '--content', default='', help='笔记内容')
-def add(stock_identifier, summary, content):
-    """添加笔记（支持 id/code/name）"""
-    stock_ids = search_by_identifier(stock_identifier)
-    if not stock_ids:
-        click.echo("未找到股票")
-        return
-    for stock_id in stock_ids:
-        service.note_add(stock_id, content=content, summary=summary)
-        click.echo(f"'id' = '{stock_id}' 笔记已添加")
-        click.echo("-" * 50)
-
-@note.command()
-@click.argument('stock_identifier')
-def ls(stock_identifier):
-    """列出股票的所有笔记（支持 id/code/name）"""
-    stock_ids = search_by_identifier(stock_identifier)
-    if not stock_ids:
-        click.echo("未找到股票")
-        return
-    for stock_id in stock_ids:
-        notes = service.note_read(stock_id)
-        if not notes:
-            click.echo(f"[{stock_id}] 暂无笔记")
-            continue
-        for i, n in enumerate(notes):
-            click.echo(f"[{i}] {n.get('summary', '')}")
-            click.echo(f"    {n.get('content', '')}")
-            click.echo(f"    created: {n.get('created_at', '')}")
-        click.echo("-"*50)
-
-
-@note.command()
-@click.argument('stock_identifier')
-@click.argument('index', type=int)
-def delete(stock_identifier, index):
-    """删除笔记（支持 id/code/name）"""
-    stock_ids = search_by_identifier(stock_identifier)
-    if not stock_ids:
-        click.echo("未找到股票")
-        return
-    for stock_id in stock_ids:
-        service.note_delete(stock_id, index)
-        click.echo(f"已删除第 {index} 条笔记")
-        click.echo("-" * 50)
-
-# ============= admin 组 =============
-@cli.group()
-def admin():
-    """高级操作（直接操作数据库字段）"""
-    pass
-
-
-@admin.command()
-@click.argument('value')
-@click.argument('field')
-def match_and_read(value, field):
-    """按字段匹配并读取所有匹配的股票"""
-    results = service.match_and_read(value, field)
-    if not results:
-        click.echo("未找到匹配结果")
-        return
-    for stock_id, data in results.items():
-        click.echo(f"ID: {stock_id}")
-        click.echo(f"  code: {data.get('code', '')}")
-        click.echo(f"  name: {data.get('name', '')}")
-        click.echo("-" * 50)
-
-
-@admin.command()
-@click.argument('value')
-@click.argument('field')
-@click.argument('update_field')
-def match_and_update(value, field, update_field):
-    """按字段匹配并更新（危险操作）"""
-    service.match_and_update(value, field, update_field)
-    click.echo(f"已更新 field={update_field} 的所有匹配记录")
-
-
-if __name__ == '__main__':
-    cli()

klnote-0.1.0/klnote/core/utils/time_1.py

@@ -1,8 +0,0 @@
-import os
-from datetime import datetime, timezone
-def get_iso_timestamp(microseconds=True):
-    """自定义是否包含微秒"""
-    if microseconds:
-        return datetime.now(timezone.utc).isoformat(timespec='microseconds').replace('+00:00', 'Z')
-    else:
-        return datetime.now(timezone.utc).isoformat(timespec='seconds').replace('+00:00', 'Z')