@gavinc-cn/touchstone-dsh 0.1.0 → 0.2.0

package/db.py

@@ -206,11 +206,18 @@ CREATE TABLE IF NOT EXISTS feishu_user_cfgs (
     user_id INTEGER PRIMARY KEY,
     json    TEXT NOT NULL DEFAULT '{}'
 );
+-- 飞书号绑定（一行 = 一个飞书号 ↔ 一个 Touchstone 用户）；后四列是「当前会话」
+-- 绑定态（2026-10-08 飞书通用对话）：私聊普通文本按它路由到 agent 会话，
+-- 换绑/解绑一律归零（见 set_feishu_binding 的「换绑归零」语义）
 CREATE TABLE IF NOT EXISTS feishu_bindings (
     open_id            TEXT PRIMARY KEY,
     user_id            INTEGER NOT NULL UNIQUE,
     default_project_id INTEGER NOT NULL DEFAULT 0,
-    bound_at           TEXT NOT NULL DEFAULT (datetime('now', 'localtime'))
+    bound_at           TEXT NOT NULL DEFAULT (datetime('now', 'localtime')),
+    cur_sid        TEXT    NOT NULL DEFAULT '',   -- 当前会话 id（空=未绑定会话）
+    cur_project_id INTEGER NOT NULL DEFAULT 0,    -- 当前会话所属项目（投递队列归属）
+    cur_title      TEXT    NOT NULL DEFAULT '',   -- 绑定时标题快照
+    cur_bound_at   TEXT    NOT NULL DEFAULT ''    -- 绑定时刻（localtime）
 );
 CREATE INDEX IF NOT EXISTS idx_board_cards_project ON board_cards(project_id);
 CREATE INDEX IF NOT EXISTS idx_board_comments_card ON board_comments(card_id);
@@ -491,6 +498,17 @@ CREATE UNIQUE INDEX idx_projects_user_name ON projects(user_id, name);
         if "user_id" not in cols:
             conn.execute("ALTER TABLE feishu_outbox"
                          " ADD COLUMN user_id INTEGER NOT NULL DEFAULT 0")
+    # feishu_bindings 补「当前会话」四列（2026-10-08 飞书通用对话：绑定到某个会话）。
+    # 旧库的 feishu_bindings 由 CREATE TABLE IF NOT EXISTS 原样保留（不含这四列），
+    # 只能在此 ALTER 补齐；幂等：列已存在则跳过，存量行取空默认值（未绑定会话）。
+    with connect() as conn:
+        cols = {r["name"] for r in conn.execute("PRAGMA table_info(feishu_bindings)")}
+        for name, ddl in (("cur_sid", "TEXT NOT NULL DEFAULT ''"),
+                          ("cur_project_id", "INTEGER NOT NULL DEFAULT 0"),
+                          ("cur_title", "TEXT NOT NULL DEFAULT ''"),
+                          ("cur_bound_at", "TEXT NOT NULL DEFAULT ''")):
+            if name not in cols:
+                conn.execute(f"ALTER TABLE feishu_bindings ADD COLUMN {name} {ddl}")
     # 旧全局飞书配置迁移（2026-09-09 起飞书设置用户级）：旧的 app_settings['feishu']
     # 由 admin 在后台管理页配置，迁移给 admin 自己的用户配置（已有私户配置则不覆盖）
     with connect() as conn:
@@ -570,13 +588,17 @@ def _ensure_users_columns(conn):
 def seed_admin():
     """无任何用户时插入 admin，返回是否实际创建（bool，供启动横幅决定是否提示）。
 
-    口令来源（2026-10-02 起）：
+    口令来源（按优先级）：
       - 环境变量 TS_ADMIN_PASSWORD 非空：用之（部署方自定义初始口令，视为有意设定，
         不强制改密）——保持 CI/隔离实例夹具的既有行为；
-      - 未设置：用 secrets 随机生成 16 位一次性初始口令（URL-safe），并置
+      - 环境变量 TS_ADMIN_PASSWORDLESS=1（插件形态，薄壳下发，2026-10-08）：种**空口令**
+        admin、不强制改密。面板本来就是免登 admin（信任头），口令只用于独立形态/直连
+        登录；用户之后在设置页设了密码就按设置的来（change_password 存 MD5）；
+      - 都没有：用 secrets 随机生成 16 位一次性初始口令（URL-safe），并置
         must_change_pw=1，登录后必须先改密才能调用其他 API。
     随机口令经 take_seed_password() 交启动横幅打印一次，不落库明文、不常态打印。
-    PBKDF2 哈希 + 随机盐（哈希算法为需求约定，勿改）。
+    哈希：自定义口令/随机口令沿用 PBKDF2 哈希 + 随机盐（哈希算法为需求约定，勿改）；
+    空口令走 auth.md5_password("")（与「新写入密码统一 MD5」同口径，且登录时空串即通过）。
     """
     global _SEED_PASSWORD
     import auth
@@ -587,10 +609,12 @@ def seed_admin():
         _ensure_users_columns(conn)
         env_pw = os.environ.get("TS_ADMIN_PASSWORD")
         if env_pw:
-            password, must_change = env_pw, 0
+            password, must_change, seed_hash = env_pw, 0, None
+        elif os.environ.get("TS_ADMIN_PASSWORDLESS") == "1":
+            password, must_change, seed_hash = "", 0, auth.md5_password("")
         else:
-            password, must_change = secrets.token_urlsafe(12), 1
-        pw_hash, salt = auth.hash_password(password)
+            password, must_change, seed_hash = secrets.token_urlsafe(12), 1, None
+        pw_hash, salt = seed_hash or auth.hash_password(password)
         conn.execute(
             "INSERT INTO users(username, pass_hash, salt, must_change_pw, created_at)"
             " VALUES(?,?,?,?,?)",
@@ -1089,7 +1113,7 @@ def update_board_card(card_id, mark_unread=True, **fields):
 
 
 def mark_card_viewed(card_id):
-    """清卡片「状态有更新·用户未打开」标记（用户打开卡片详情时调用）。
+    """清卡片「状态有更新·用户未打开」标记（用户打开卡片详情 / 点卡面操作行按钮时调用）。
 
     只写 `unread=0`，**刻意不刷 updated_at**：查看不是卡片内容变更，顺带刷时间
     会污染「更新新→旧」排序口径与 `list_queued_board_cards` 的排队顺序（该查询
@@ -1377,13 +1401,18 @@ def get_feishu_binding_by_user(user_id):
 
 def set_feishu_binding(open_id, user_id, default_project_id=0):
     """绑定飞书号 ↔ 用户（双向一对一）：user_id 已绑其他 open_id 时先清旧绑
-    （换号重绑语义）；open_id 重绑直接覆盖（UPDATE）。"""
+    （换号重绑语义）；open_id 重绑直接覆盖（UPDATE）。
+
+    2026-10-08 起「换绑归零」：写入与覆盖都把「当前会话」四列清空——绑定态不能
+    跨身份继承（同一用户换飞书号、同一飞书号换用户，都必须重新显式绑定会话）。"""
     with connect() as conn:
         conn.execute("DELETE FROM feishu_bindings WHERE user_id=?", (user_id,))
         conn.execute(
-            "INSERT INTO feishu_bindings(open_id, user_id, default_project_id)"
-            " VALUES(?,?,?) ON CONFLICT(open_id) DO UPDATE SET"
-            " user_id=excluded.user_id, default_project_id=excluded.default_project_id",
+            "INSERT INTO feishu_bindings(open_id, user_id, default_project_id,"
+            " cur_sid, cur_project_id, cur_title, cur_bound_at)"
+            " VALUES(?,?,?,'',0,'','') ON CONFLICT(open_id) DO UPDATE SET"
+            " user_id=excluded.user_id, default_project_id=excluded.default_project_id,"
+            " cur_sid='', cur_project_id=0, cur_title='', cur_bound_at=''",
             (open_id, user_id, default_project_id))
 
 
@@ -1405,3 +1434,25 @@ def set_feishu_default_project(open_id, project_id):
         conn.execute(
             "UPDATE feishu_bindings SET default_project_id=? WHERE open_id=?",
             (project_id, open_id))
+
+
+def set_feishu_cur_session(open_id, project_id, sid, title=""):
+    """写「当前会话」绑定（open_id 行必须已存在；时刻取本地时间字符串）。
+
+    当前会话 = 该飞书号私聊普通文本的投递目标：`cur_sid` 空表示未绑定（走默认
+    项目/引导指令），`cur_project_id` 是投递队列的归属项目。sid/title 传空即等价
+    于清空对应字段（None 也按空串落库，避免行上出现 NULL）。
+    """
+    with connect() as conn:
+        conn.execute(
+            "UPDATE feishu_bindings SET cur_sid=?, cur_project_id=?, cur_title=?,"
+            " cur_bound_at=? WHERE open_id=?",
+            (sid or "", int(project_id or 0), title or "", now_str(), open_id))
+
+
+def clear_feishu_cur_session(open_id):
+    """清「当前会话」绑定（保留默认项目；未绑定时为 no-op）。"""
+    with connect() as conn:
+        conn.execute(
+            "UPDATE feishu_bindings SET cur_sid='', cur_project_id=0,"
+            " cur_title='', cur_bound_at='' WHERE open_id=?", (open_id,))

package/dsh-plugin/cordis.patch.yml

@@ -8,14 +8,18 @@
 #   面板里就会出现 Touchstone 卡片与该行开关（开关写回 profile patch 的 disabled）。
 #
 # config 约定: repoDir 是**机器相关**路径（Touchstone 平台根，须含 server.py 与 webui/dist-plugin），
-#   不写死在这里 —— 由各 profile 的 cordis.patch.yml 用 `- id: touchstone` + `config:` 覆盖提供
+#   不写死在这里 —— 由各 profile 的 cordis.patch.yml 用 `- id: touchstone-dsh` + `config:` 覆盖提供
 #   （覆盖是整键替换，且 profile 层后于 bundle 层应用）。**2026-10-07 起 repoDir 可省**:
 #   包已自包含（Python 平台 + 预构建 webui/dist-plugin 都在包内），薄壳缺省回退到**包自身目录**
 #   （lib/index.js 里 PACKAGE_DIR），只有要指向别的检出、或指定 pythonPath 时才写 config。
 #   pythonPath 缺省 python3。
 #
 # name 必须是**完整包名**（与仓库根 package.json 的 name、scripts/build.mjs 生成的
-# client.bundle.js 里的模块 id 三者逐字一致）；条目 id 仍是 touchstone（profile 覆盖按 id 命中）。
+# client.bundle.js 里的模块 id 三者逐字一致）；条目 id 是 touchstone-dsh（= 包名去掉 scope）。
+# id 只是组合树里的**本地行键**（profile 覆盖行按它命中、Plugins 面板行开关按它写回），
+# **不是包名**，改它必须与各 profile 的覆盖行同步 —— 否则覆盖落空（repoDir/pythonPath/disabled
+# 全丢，回落包自身目录 + python3），面板开关还会在 profile patch 里追加一行、把旧行留成孤儿。
+# 2026-10-09 由旧名 touchstone 改名（旧名是 2026-10-07 包改名前的残留）。
 - insert:
-    - id: touchstone
+    - id: touchstone-dsh
       name: "@gavinc-cn/touchstone-dsh"

package/dsh-plugin/install.sh

@@ -15,8 +15,8 @@
 #
 # 机器相关配置（repoDir / pythonPath）**可省**（2026-10-07 自包含包起）: 缺省 repoDir = 包自身目录,
 # 包里就有 server.py 与 webui/dist-plugin; 只有要指向别的检出、或指定解释器时才在 profile 覆盖:
-#   - id: touchstone
-#     config: { pythonPath: <解释器> }        # 条目 id 仍是 touchstone
+#   - id: touchstone-dsh
+#     config: { pythonPath: <解释器> }        # 条目 id 是 touchstone-dsh（= 包名去掉 scope）
 # 环境变量: TS_DSH_PROFILE(默认 web) / TS_DSH_PYTHON(显式指定解释器, 优先)
 set -euo pipefail
 
@@ -27,9 +27,11 @@ PROFILE_DIR="$HOME/.dsh/profiles/$PROFILE"
 PKG_NAME="$(node -p "require('$REPO_DIR/package.json').name")"
 
 # 解释器探测链（2026-10-02 去硬编码，原写死某个 conda 环境的解释器绝对路径）:
-#   TS_DSH_PYTHON / TS_PYTHON 显式指定 → 常见 conda 环境 → PATH 上的 python3 → 报错;
+#   TS_DSH_PYTHON / TS_PYTHON 显式指定 → 常见 conda 环境 → PATH 上的 python → python3 → 报错;
 #   conda/PATH 候选里优先「能导入运行依赖（zstandard/requests）」的那个, 避免选中
 #   同机其他缺依赖的环境; 全都不满足时回落到首个存在的解释器。
+#   PATH 档的顺序 2026-10-11 改为 python 优先（用户口径「兜底应该用 python」）, 与插件薄壳
+#   lib/index.js 的 PYTHON_CANDIDATES 同序; Linux 上两者通常都在, 改序不改变命中结果。
 _depline() { "$1" -c 'import zstandard, requests' >/dev/null 2>&1; }
 
 pick_python() {
@@ -39,6 +41,7 @@ pick_python() {
   done
   for cand in "$HOME"/{mini,ana}conda3/envs/*/bin/python3 \
               /opt/{mini,ana}conda3/envs/*/bin/python3 \
+              "$(command -v python || true)" \
               "$(command -v python3 || true)"; do
     [[ -n "$cand" && -x "$cand" ]] || continue
     [[ -n "$fallback" ]] || fallback="$cand"
@@ -48,7 +51,7 @@ pick_python() {
   return 1
 }
 PYTHON_PATH="$(pick_python)" || {
-  echo "错误: 未找到可用的 python3；请用 TS_DSH_PYTHON=/path/to/python3 显式指定" >&2
+  echo "错误: 未找到可用的 Python 解释器（依次试过 python、python3）；请用 TS_DSH_PYTHON=/path/to/python 显式指定" >&2
   exit 1
 }
 
@@ -75,5 +78,5 @@ echo "完成（包名 $PKG_NAME）。重启 dsh web 生效（package.json 变更
 echo "之后侧栏 Plugins 面板里会出现 Touchstone 卡片与该行开关。"
 echo "repoDir 不再必填（缺省 = 包自身目录, 包里自带 Python 平台与预构建前端）;"
 echo "只有要指向本机开发检出、或指定解释器时才在 $PROFILE_DIR/cordis.patch.yml 里加:"
-echo "  - id: touchstone"
+echo "  - id: touchstone-dsh"
 echo "    config: { repoDir: $REPO_DIR, pythonPath: $PYTHON_PATH }"